在UI中创建本地文件上传源连接器

本教程提供了创建本地文件上传源连接器以使用用户界面将本地文件摄取到平台的步骤。

快速入门

本教程需要对Platform的以下组件有一定的了解:

将本地文件上传到平台

在平台UI中,从左侧导航栏中选择​Sources​以访问Sources工作区。 Catalog屏幕显示可为其创建帐户的各种源。

您可以从屏幕左侧的目录中选择相应的类别。 或者,您可以使用搜索选项找到要处理的特定源。

在本地系统类别下,选择​本地文件上载,然后选择​配置

目录

使用现有数据集

在数据流详细信息页面中,您可以选择是要将CSV数据摄取到现有数据集还是新数据集。

要将CSV数据摄取到现有数据集,请选择​现有数据集。 您可以使用高级搜索选项检索现有数据集,也可以通过在下拉菜单中滚动浏览现有数据集列表来检索。

select-existing-dataset

选择数据集后,为数据流提供名称和可选描述。

在此过程中,您还可以启用错误诊断和部分摄取。 错误诊 断允许为数据流中发生的任何错误记录生成详细的错误消息,而 部 分摄取允许您摄取包含错误的数据,最高可以达到您手动定义的特定阈值。有关更多信息,请参阅部分批量摄取概述

数据流详细信息 — 现有

使用新数据集

要将CSV数据摄取到新数据集,请选择​New dataset ,然后提供输出数据集名称和可选描述。 接下来,使用高级搜索选项或通过滚动下拉菜单中现有架构的列表,选择要映射到的架构。

select-new-dataset

选择架构后,为数据流提供名称和可选描述,然后对数据流应用所需的错误诊断和部分摄取设置。 完成后,选择​Next

选择数据

此时将显示选择数据步骤,该步骤为您提供一个接口,用于上载本地文件并预览其结构和内容。 选择​选择文件​以从本地系统上传CSV文件。 或者,也可以将要上传的CSV文件拖放到拖放文件面板中。

小贴士

本地文件上传当前仅支持CSV文件。 每个文件的最大文件大小为1 GB。

选择文件

上传文件后,预览界面会随之更新,以显示文件的内容和结构。

preview-sample-data

根据您的文件,您可以为源数据选择列分隔符,如制表符、逗号、管道分隔符或自定义列分隔符。 选择​分隔符​下拉箭头,然后从菜单中选择相应的分隔符。

完成后,选择​Next

分隔符

映射

此时将显示映射步骤,为您提供一个界面,用于将源架构中的源字段映射到目标架构中相应的目标XDM字段。

映射接口

预览数据

选择​预览数据​可查看选定数据集中最多100行示例数据的映射结果。

预览映射

在预览期间,标识列将作为第一个字段按优先级排列,因为它是验证映射结果时必需的关键信息。 完成后,选择​关闭

预览面板

添加计算字段

计算量度字段允许根据输入架构中的属性创建值。 然后,可以将这些值分配给目标架构中的属性,并提供名称和说明,以便更便于引用。

选择​添加计算字段​按钮以继续。

add-calculated-field

出现创建计算字段面板。 左侧对话框包含计算字段中支持的字段、函数和运算符。 选择一个选项卡以开始向表达式编辑器添加函数、字段或运算符。

create-calculated-field

选项卡 描述
函数 函数选项卡列出了可用于转换数据的函数。 要进一步了解可在计算字段中使用的函数,请阅读上使用数据准备(映射器)函数的指南。
字段 字段选项卡列出了源架构中可用的字段和属性。
运算符 运算符选项卡列出了可用于转换数据的运算符。

选择表达式编辑器以手动添加字段、函数和运算符。 创建计算字段后,选择​保存​以继续。

expression-editor

筛选源架构映射树

要过滤源架构,请选择​所有源字段,然后从下拉菜单中选择要映射的特定字段。

下表显示了源架构树的排序选项:

源字段 描述
所有源字段 此选项显示源架构的所有源字段。 默认情况下,会显示此选项。
必填字段 此选项过滤源架构以仅显示完成映射所需的字段。
标识字段 此选项过滤源架构,以仅显示标记为“身份”的字段。
映射的字段 此选项过滤源架构以仅显示已映射的字段。
未映射的字段 此选项过滤源架构以仅显示尚未映射的字段。
包含推荐的字段 此选项过滤源架构以仅显示包含映射推荐的字段。

全源字段

智能推荐

Platform会根据您选择的目标架构或数据集,自动为自动映射的字段提供智能推荐。 您可以手动调整映射规则以适合您的用例。

source-schema-tree

要接受所有自动生成的映射值,请选择​接受所有目标字段

all-target-fields

有时,源架构有多个推荐可用。 发生这种情况时,映射卡会显示最突出的推荐,后跟一个蓝色圆圈,其中包含可用的其他推荐数量。 选择灯泡图标将显示其他推荐的列表。 您可以选中要映射到的推荐旁边的复选框,以选择其中一个替代推荐。

手动映射

或者,您也可以选择手动将源架构映射到目标架构。 为此,请将鼠标悬停在要映射的源架构上,然后选择加号(+)图标。

select-plus图标

出现​将源映射到目标字段​弹出窗口。 从此处,您可以选择要映射的字段,然后选择​Save​以添加新映射。

映射源到目标字段

完成后,选择​已完成

完成

监控数据摄取

映射和创建CSV文件后,您可以使用监控仪表板监控通过其摄取的数据。 有关更多信息,请参阅有关在UI中监视源数据流的教程。

后续步骤

通过阅读本教程,您已成功将平面CSV文件映射到XDM架构,并将其摄取到平台。 现在,下游Platform服务(如Real-time Customer Profile)可以使用此数据。 有关更多信息,请参阅Real-time Customer Profile概述。

在此页面上