导入补充数据

重要提示:此主题针对 Connect 最新版本的用户。如果您的账户仍然使用传统 Connect,请下载传统 Connect 用户指南

可以使用 Connect 将记录导入 Oracle Responsys 中的补充数据表中。

在导入作业运行之后,会在服务器上将上载文件存档。如果作业成功,将删除上载文件。如果作业失败,则仅在以下情况下删除上载文件:

  • 文件为空
  • 文件有数据问题,如数据格式无效
  • 上载文件与计数文件的记录数不同。

要创建“导入补充数据”作业,请执行以下操作:

  1. 单击侧边导航栏中的 Data(数据),然后选择 Connect
  2. Manage Connect(管理 Connect)页面上,单击 Create Job(创建作业)
  3. 从下拉列表中选择 Import Supplemental Data(导入补充数据)并为导入作业提供名称和描述。

    图像显示用来导入补充数据的“Create Job(创建作业)”对话框

    作业名称长度不能超过 100 个字符,并且只能包含以下字符:A-Z、a-z、0-9、空格、!、-、=、@、_、[、]、{、}

  4. 单击 Done(完成)

    此时将打开 Connect 向导。可以按任何顺序完成这些步骤,然后可以保存更改并稍后继续。

  5. 完成以下步骤:
  6. 在配置所有步骤后,单击 Save(保存)。要保存并激活作业,请单击 Activate(激活)
  7. 重要提示:必须先设置到期日期或将作业设置为从不过期,才能保存或激活该作业。要设置到期日期,请单击 Expiration(到期)旁边的 Edit(编辑)图像显示“编辑”图标。作业到期后,将被删除且不可恢复。单击此处的链接,可以了解有关管理到期日期的更多信息。

在完成后:

  • 在保存作业后,可以使用“Manage Connect(管理 Connect)”页面来管理作业。单击此处的链接,可以了解有关管理作业的更多信息。
  • 保存作业时,Connect 可能会返回错误。单击 Show Errors(显示错误)可查看错误并快速跳转到需要修复的页面。必须解决所有错误,然后才能激活作业。

    图像指出 Connect 作业的错误

步骤 1:源连接

在此步骤中,您指定用于检索源文件的文件服务器。

图像显示 Connect 导入向导的“源连接”步骤

选择以下选项之一:

  • Responsys File Server(Responsys 文件服务器):Connect 作业可以通过 Responsys SCP(Secure Copy Protocol,安全复制协议)账户文件服务器导入数据。该账户包含三个目录:上载、下载和存档。

    重要提示:Oracle Responsys 技术支持和您自己的 IT 团队需要合作来生成 SSH-2 公钥/私钥对(如果尚未建立)。这可以确保通过 SSH/SCP 客户机安全地访问您的 SCP 账户。还可以使用 SSH(安全 Shell)客户机创建您自己的目录。

  • 如果选择此选项,请单击“Change(更改)”来指定文件所在的目录。
  • External server by SFTP(使用 SFTP 的外部服务器):如果选择此选项,请提供以下信息:
    • Hostname(主机名):从下拉列表中选择主机名。
    • Directory Path(目录路径):输入关联目录的路径名。
    • Username(用户名):输入用于访问 SFTP 连接的用户名。
    • Authentication(身份验证):根据您的服务器的设置方式,选择 Password(密码)Key(密钥)

      如果这是使用密钥身份验证的第一个作业,请单击 Access or Generate Key Information(访问或生成密钥信息),然后输入用来接收公钥的电子邮件地址和用于将密钥添加到 SFTP 账户的说明。安装公钥后,单击“Test Connection(测试连接)”来确认您的 SFTP 连接配置有效。

    提示:有关密钥身份验证的信息,请参见选择、导入或生成公钥

步骤 2:源规格

在此步骤中,您提供有关要导入的文件的信息。

  • File to upload(要上载的文件):要导入的文件的文件名和文件扩展名。可以添加文件创建日期作为前缀或后缀。
  • Character set(字符集):文件的字符集。如果文件包含表情符号,则需要选择 Unicode (UTF-8) 作为字符集。
  • Field delimiter(字段分隔符):在文件中分隔字段(列)的分隔符。
  • Field enclosure(字段定界符):指定文本列和值是用单引号还是双引号括起。
  • Date format(日期格式):选择导入文件的日期格式。有关支持的日期格式的信息,请参见Connect 中支持的日期格式
  • First line contains column names(第一行包含列名):如果文件中的第一行包含字段名称,请选中此复选框。
  • File is encrypted with PGP/GPG key(使用 PGP/GPG 密钥对文件进行了加密):如果使用密钥对文件进行了加密并且在上载之前需要解密,请选中此复选框。
  • File is signed with PGP/GPG key(使用 PGP/GPG 密钥对文件进行了签署):如果使用密钥对文件进行了签署,请选中此复选框。
  • File to confirm expected record count(用于确认预计记录数量的文件):另外,还可以选中此复选框并指定要用于将记录数与导入的记录数进行比较的文件。例如,如果此文件中的预计记录数为 300,但导入的文件仅包含 100 条记录,则会记录传输错误并且上载过程将终止

步骤 3:目标定义

在此步骤中,选择数据所要导入到的补充数据表。

注意:在步骤 4 中映射字段时还需要选择目标表。

图像显示 Connect 导入向导的“目标定义”步骤

要添加目标定义,请执行以下操作:

  1. Target Definition(目标定义)步骤中,单击 Add +(添加 +)并选择数据所要导入到的补充数据表。

  2. Configuration(配置)部分中,指定以下选项:
    • Remove all existing records and upload(删除所有现有记录并上载):选中此复选框会将现有记录替换为新上载的记录。
    • Merge into table using following field(使用以下字段合并到表):如果不删除所有现有记录,请选择用于将新记录合并到现有记录的字段。
    • If there is a match, overwrite all mapped fields in existing records(如果存在匹配项,则覆盖现有记录中所有已映射的字段):如果选中此复选框,当存在匹配的记录时,会将现有记录替换为新数据。如果不选中此复选框,则会忽略传入的记录。
    • If there is not a match, import new record(如果不存在匹配项,则导入新记录):如果选中此复选框,当不存在匹配项时将导入记录。如果不选中此复选框,则会忽略传入的记录。

步骤 4:字段映射

在此步骤中,您将源文件中的列映射到目标表中的字段。映射字段时,将指定哪个源字段对应于哪个目标字段。

可以手动映射字段、使用上载文件进行映射,或者自动生成字段映射。

请注意以下事项:

  • 长字段名称将截断至 30 个字符。
  • 字段名称必须以字母或数字开头,并且只能包含字母、数字和 _(下划线)。
  • 字段名称在创建时不区分大小写,但稍后会转换为全部大写。
  • 如果任何更改导致重复的字段名称,则需要手动对其进行重命名。
  • 所有系统字段名称(Oracle Responsys 定义和保留的名称)都以下划线字符结尾,例如 EMAIL_ADDRESS_。最佳做法:上载字段名称不应以下划线字符结尾,因为该字符保留供系统字段使用。
  • 尽可能将同名传入字段与现有字段进行匹配,例如,将 CUST_ID 匹配到 CUSTOMER_ID_。

有关数据类型和字段名称要求的更多详细信息,请参见数据类型和字段名称

要上载映射文件,请执行以下操作:

  1. Field Mapping(字段映射)步骤中,单击 Upload File(上载文件)
  2. 选择映射文件并填写详细信息。
    • Fields are delimited by(字段的分隔符号为):选择文件中用于分隔列的分隔符(通常为制表符或逗号)。
    • Fields are enclosed by(字段括起符号):指定文本列和值是用单引号还是双引号括起。
    • First line contains column names(第一行包含列名):如果第一行包含字段名称,请选中此复选框。

要映射字段,请执行以下操作:

  1. Field Mapping(字段映射)步骤中,单击 Add +(添加 +)
  2. 务必还要为相应字段选择目标表。
  3. 指定传入字段和与它匹配的字段。如果不希望匹配某个字段,请选择 skip this field(跳过此字段)

    图像显示传入字段映射

  4. 单击更新

步骤 5:后处理

在此步骤中,您可以在作业成功运行后启动市场活动。最多可以选择 40 个市场活动。

图像显示 Connect 导入向导的“后处理”步骤

要接收有关市场活动启动的进度通知,请确保每个市场活动的设置都指定一个或多个电子邮件地址以接收进度通知。

步骤 6:通知

在此步骤中,您设置作业的电子邮件通知。您可以选择在作业成功或失败后发送通知。

步骤 7:时间安排

在此步骤中,您安排作业的执行时间。作业可以在指定日期和时间运行一次,也可以按重复周期运行。要按需运行作业,请使用 Do not schedule(不进行时间安排)选项。

重要提示:为确保闰年和包含 31 天的月份不会引起问题,不能将每个月重复一次的运行安排在一个月的第 29、30 或 31 天。可以将作业安排为在月底所在周的某天运行,如该月的最后一个星期五。

设置作业的开始时间时,请选择一小时内的四个时段之一:0-14、15-29、30-44、45-59。对于安排的每个作业,系统会随机选择某一分钟(例如 0-14 段内的 12)。这样会更均匀地分配开始时间。

作业将在所选时段内的某个随机时间开始。如果您尝试在与当前时间重叠的时段中设置新作业,则系统可能会发出错误消息,指示所选的时间是过去的时间。因此,最佳做法是选择处于当前时段之后的时段。

相关主题

 Connect

管理 Connect 作业