从本地文件中加载数据

要将数据从本地文件加载到 Oracle Autonomous AI Database 中,请在“DATA LOAD(数据加载)”页面上选择 LOAD DATALOCAL FILE

从本地文件系统导航器中拖动一个或多个文件并将其放入数据加载购物车中。还可以单击选择文件或“选择文件”图标,从文件系统导航器中选择一个或多个文件,然后单击打开

您可以按以下文件格式添加文件:AVRO、CSV、JSON、GeoJSON、TSV、分隔的 TXT、XLS、XLSX、XML、PNG、JPEG 和 PDF。有关支持的文件格式的信息,请参见 Format Specifications for JSON,AVRO,and XML Files

每个文件的项将显示在购物车中。对于 XLS 或 XLSX 电子表格,电子表格的工作表显示为单个项。该项显示源文件或工作表的名称及其大小,以及作为数据加载目标的表的名称。当多工作表 XLSX 文件位于对象存储中时,数据加载工具仅支持从多工作表 XLSX 文件的第一个工作表加载表。

您可以通过单击 "Select Files"(选择文件)图标将更多文件添加到购物车。您可以将任意数量的文件添加到购物车,并在单个数据加载作业中加载所有文件的数据。

要从数据加载购物车中删除源文件,请单击源项的“删除”(垃圾桶)图标。要从购物车中删除所有源文件,请单击“数据加载购物车”菜单栏中的“全部删除”(垃圾桶)图标。

要返回到“数据加载”页,请单击“数据加载购物车”菜单栏上方的数据加载

指定处理选项

要指定数据加载作业的设置或预览源或目标中的数据,请选择“数据加载购物车”中项的“设置”(铅笔)图标。

在设置窗格的设置选项卡上,您可以在“加载数据”对话框的标题中查看文件的名称和大小。

名称字段指定目标表的名称。字段中的值因选项字段中的选择而异。如果选项为创建表,则默认目标值为源文件或工作表的名称。

要为目标表指定其他名称,请在名称字段中输入该名称。对于 Options(选项)字段中的其他目标表选项,默认值为 <None>。展开下拉列表并选择现有表作为目标。

选项字段中,选择创建表插入到表中替换数据删除表并创建新表合并到表中。指向问号图标以查看选定选项的简要说明。

Schema(方案)下拉列表中选择其他方案,以在另一方案中创建目标表。

注意:

仅当您具有 PDB_DBA 角色授权时,方案下拉列表才可用。

要向自己授予 PDB_DBA 角色,必须登录 Database Actions 实例并在 SQL 工作表区域中输入以下命令,该工作表区域显示在启动板中 Development 工具下的 SQL 选项卡中。

Grant PDB_DBA to Username;

此下拉列表可用于创建表删除表和创建新表选项。

源列名选项指定是从文件获取源列和目标列名,还是手动指定列名。从源文件的标题获取列名是默认设置。如果选择列标题选项,则文件中的第一行将作为列名进行处理。如果取消选择该选项,则第一行将作为数据进行处理。要手动指定列名,请在映射部分中为每个目标列输入一个名称。还可以为列选择数据类型。

开始处理行中的数据字段指定将源数据加载到目标中时要跳过的行数。如果选择了列标题选项,并且您在行开始处理数据字段中输入大于 0 的数字,则第一行之后的行数不会加载到目标中。如果已取消选择列标题选项,并且您在行开始处理数据字段中输入大于 0 的数字,则不包括第一行的行数不会加载到目标中。

要更改文件内容的字符集编码,请从 Encoding 下拉列表中选择一个值。

要指定包含文本的字符,请从文本附件下拉列表中选择双引号或单引号字符或 None

要更改分隔源中的列的分隔符字符,请展开字段分隔符下拉列表并选择字符。例如,如果文件具有以分号分隔的列,请将分隔符从默认逗号分隔符更改为分号。

要将数字源列中的任何无效值转换为目标列中的 NULL 值,请选择“数字”列将无效数据转换为 NULL 选项。

设置模板

保存设置功能以 JSON 文件的形式将配置集保存在购物车设置中。打开“设置”模板时,您具有以下选项:
  1. 加载设置模板:从本地系统加载设置模板。
  2. 保存设置模板:保存当前现有设置模板。
后面是 settings-template.png 的说明
插图 settings-template.png 的说明
如果要使用本地现有的自定义模板,则可以使用加载设置模板
  1. 从“加载数据”页的“设置”选项卡中的“设置模板”中,选择加载设置模板
  2. 您将看到“Load Settings Template(加载设置模板)”向导,单击“Settings Template JSON(设置模板)”以从系统加载 JSON 文件。
  3. 单击“设置”模板 JSON 将打开本地系统。单击确定以加载 JSON 文件。
  4. 加载 JSON 文件后,您可以查看自动应用于与从本地加载的 JSON 设置模板匹配的设置选项卡的更新。
您可以使用保存设置模板来保存现有的当前设置模板。
  1. 从“加载数据”页的“设置”选项卡中的“设置模板”中,选择保存设置模板
  2. 此时将显示模板文件编辑器。单击“Template File name(模板文件名)”并命名新模板。
  3. 单击确定以完成现有模板的新名称的保存。
  4. 您可以测试新模板的配置。

批量编辑设置

您可以使用“批量编辑”设置一次更新映射表中的所有列。使用它可将更改应用于当前显示在结果窗格中的选择。您可以在搜索字段中搜索要编辑的列的值,然后单击放大镜图标。映射表将显示搜索的结果。选择“批量编辑”设置以更新列。使用“批量编辑”设置可以:
  • 更新组中所有字段的值。
  • 查找和替换、添加前缀并将后缀添加到目标列名。
  • 包括用于将数据加载到目标表的列。
  • 排除用于将数据加载到目标表的列。

搜索列

“批量编辑”设置将更新搜索字段返回的列。成批编辑映射向导上的可用列下面的搜索框将筛选要批量更新的列列表。还可以单击要从“可用列”列表中选择的列。选择任何可用的选项:
  • > :此选项使您可以将该列移动到选定列。
  • < :要从所选列中删除所选表,请选择此选项。
  • >> :此选项允许您将所有表移动到 "Selected Columns" 屏幕。
  • << :要从所选列中删除所有所选表,请选择此选项。
通过“批量编辑映射”,您可以为搜索字段返回的所有搜索更新以下列的值:
  • 数据类型
  • 目标列名称
  • 包含要加载的列
  • 排除要加载的栏

考虑在映射表中将前五行的数据类型从 VARCHAR2 更改为 CHAR。

后面是 bulk-edit1.png 的说明
插图 bulk-edit1.png 的说明

指定地图

您可以使用“快速筛选器”字段筛选映射表中的结果,以便筛选出表达式

选择添加表达式可对源数据执行情感分析关键短语提取。有关详细信息,请参阅在 Data Studio 中使用 OCI 语言服务功能

如果选择创建表删除表并创建新表选项,并且要从文件标题获取源列名,则映射部分将接受目标列和数据类型的默认值,或者指定不同的值。要指定不同的值,请在目标列中输入列的名称。在“数据类型”列中,从下拉列表中选择一种数据类型。如果不从文件标题获取源列名称,则对于每个源列,请为目标列指定名称,然后从“数据类型”下拉列表中选择数据类型。对于 "Date"(日期)数据类型,从 "Format"(格式)下拉列表中选择一个日期格式。

注意:

编辑单元格时,您将收到一则工具提示错误消息,其中包含错误消息的确切原因。映射网格单元格将以红色突出显示,以指示必须修复的无效值。修复无效值后,突出显示将被删除。例如,在未填写目标列名时,可以查看以下工具提示错误消息。后面是 tooltip-error.png 的说明
插图 tooltip-error.png 的说明

对于合并到表中选项,对于每个源列,从下拉列表中选择一个目标列。必须指定至少一个列作为关键字列。要将列指定为键列,请选中该列的合并键复选框。合并键是唯一标识表中各行的一个或多个列。合并键不能包含任何 Null 值。对于使用主键加载表,此选项自动允许选择主键列作为合并键。

对于插入到表中替换数据选项,对于每个源列,从现有列的下拉列表中选择一个目标列。

预览源数据

要查看源文件中的数据选择,请选择预览选项卡。“预览”选项卡显示“文件”菜单,该菜单以表格格式显示数据及其值。您可以复制表。加载预览选项卡显示源数据。

在源预览中进行的任何修改都不会影响从文件加载数据。

预览目标数据

对于除创建表之外的所有选项,要查看目标表中的现有数据,请选择加载预览选项卡。加载预览会在运行数据加载作业之前显示目标表中的数据。

要关闭设置窗格,请单击关闭

运行数据加载作业

为作业添加所有源并指定每个源的设置后,要运行作业,请单击“Data Load Cart(数据加载购物车)”菜单栏中的“Start(开始)”图标。在“运行数据加载作业”对话框中,单击开始。要停止数据加载作业,请单击“Stop(停止)”图标。

数据加载作业启动后,您可以在“数据加载”仪表盘中查看作业的进度。有关详细信息,请参阅“数据加载”页

数据加载作业完成时,“数据加载”仪表盘页将显示作业的结果。在表加载标题的顶部,可以查看表的名称以及表中存在的总列数。

单击报告可查看成功处理的行总数和已拒绝的行数。您还可以查看开始时间。报表的 SQL 窗格显示作业的等效 SQL 代码。

要查看作业中某个项的信息,请单击“表加载”上的操作图标。

要查看加载操作的日志,请单击“Logging(日志记录)”图标。您可以保存日志、清除日志或刷新日志。单击 OK 关闭日志。

“数据加载”页面上的表列表包含创建的任何新表。插入到表中替换数据删除表并创建新表合并到表中选项的目标表包含加载的数据。

修复数据加载作业

在数据加载作业之后,您可能会看到要更正的错误,或者在检查后发现您希望以不同的方式命名列。在这种情况下,您将在表加载中查看警告符号。单击重新加载图标以使用建议的修复重新加载源。单击表加载上的操作图标,然后选择编辑以对数据加载作业进行任何更改(即更改列名)。

单击应用以应用任何更改。单击关闭以返回“Database Actions(数据库操作)”页。