使用 DBMS_CLOUD.EXPORT_DATA 将数据导出到目录

使用 DBMS_CLOUD.EXPORT_DATA 将文件导出到目录。

导出文件的目录可以位于自治 AI 数据库文件系统或附加的外部文件系统中。有关详细信息，请参阅以下页面：

以 CSV 格式将数据导出至目录

通过指定查询，显示将表数据以 CSV 数据形式从自治 AI 数据库导出到目录的步骤。

连接到自治 AI 数据库实例。

有关详细信息，请参阅连接到自治 AI 数据库。
创建目录。

例如：
```
 CREATE DIRECTORY export_dir AS 'export_dir';
```
有关更多信息，请参见 Create a Directory 。
运行 DBMS_CLOUD.EXPORT_DATA 并使用值 json 指定 format 参数 type，以将结果作为 CSV 文件导出到目录。将输出发送到目录时，不要包含 credential 参数。
```
 BEGIN
  DBMS_CLOUD.EXPORT_DATA(
     file_uri_list => 'export_dir:sales.csv',
     format => JSON_OBJECT('type' value 'csv'),
     query => 'SELECT * FROM sales'
  );
 END;
 /
```
当记录分隔符包括转义符（如 \r\n 或 \t）时，将记录分隔符括在双引号中。例如，要使用记录分隔符 \r\n，请将值括在双引号中："\r\n"。
```
 BEGIN
   DBMS_CLOUD.EXPORT_DATA(
     file_uri_list => 'export_dir:sales.csv',
     query => 'SELECT * FROM sales',
     format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
 END;
 /
```
当目录名称用双引号括起来时，目录名称区分大小写。例如：
```
 BEGIN
  DBMS_CLOUD.EXPORT_DATA(
     file_uri_list => '"export_dir":sales.csv',
     format => JSON_OBJECT('type' value 'csv'),
     query => 'SELECT * FROM sales'
  );
 END;
 /
```
有关参数的详细信息，请参见 EXPORT_DATA Procedure 。

有关可以与 DBMS_CLOUD.EXPORT_DATA 一起使用的可用 format 参数的详细信息，请参见 DBMS_CLOUD Package Format Options for EXPORT_DATA 。

参数包括：
- file_uri_list：是以逗号分隔的导出文件列表。file_uri_list 不支持使用通配符和替代字符。
- format：指定所需的 type 参数。有效值为 json、xml 和 csv。
- query：指定 SELECT 语句，以便仅导出所需的数据。查询将确定转储文件的内容。
注：DBMS_CLOUD.EXPORT_DATA 过程将创建您在 file_uri_list 中指定的转储文件。该过程不会覆盖文件。如果 file_uri_list 中存在转储文件，则 DBMS_CLOUD.EXPORT_DATA 将生成另一个具有唯一名称的文件。DBMS_CLOUD.EXPORT_DATA 不会创建目录。

有关参数的详细信息，请参见 EXPORT_DATA Procedure 。

使用 DBMS_CLOUD.EXPORT_DATA 导出说明：

如果需要，您提供的 query 参数可以是高级查询，例如包含联接或子查询的查询。
使用 compression 选项指定 format 参数以压缩输出文件。

将数据导出为 JSON 目录

通过指定查询，显示将表数据作为 JSON 数据从自治 AI 数据库导出到目录的步骤。

连接到自治 AI 数据库实例。

有关详细信息，请参阅连接到自治 AI 数据库。
创建目录。

例如：
```
 CREATE DIRECTORY export_dir AS 'export_dir';
```
有关更多信息，请参见 Create a Directory 。
运行 DBMS_CLOUD.EXPORT_DATA 并使用值 json 指定 format 参数 type，以将结果作为 JSON 文件导出到目录。将输出发送到目录时，不要包含 credential 参数。
```
 BEGIN
  DBMS_CLOUD.EXPORT_DATA(
     file_uri_list => 'export_dir:sales.dmp',
     format => json_object('type' value 'json'),
     query => 'SELECT * FROM sales'
  );
 END;
 /
```
当记录分隔符包括转义符（如 \r\n 或 \t）时，将记录分隔符括在双引号中。例如，要使用记录分隔符 \r\n，请将值括在双引号中："\r\n"。
```
 BEGIN
   DBMS_CLOUD.EXPORT_DATA(
     file_uri_list => 'export_dir:sales.dmp',
     query => 'SELECT * FROM sales',
     format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
 END;
 /
```
如果将目录名称括在双引号中，则目录名称区分大小写。例如：
```
 BEGIN
  DBMS_CLOUD.EXPORT_DATA(
     file_uri_list => '"export_dir":sales.dmp',
     format => json_object('type' value 'json'),
     query => 'SELECT * FROM sales'
  );
 END;
 /
```
有关参数的详细信息，请参见 EXPORT_DATA Procedure 。

有关可以与 DBMS_CLOUD.EXPORT_DATA 一起使用的可用 format 参数的详细信息，请参见 DBMS_CLOUD Package Format Options for EXPORT_DATA 。

参数包括：
- file_uri_list：是以逗号分隔的导出文件列表。file_uri_list 不支持使用通配符和替代字符。
- format：指定所需的 type 参数。有效值为 json、xml 和 csv。
- query：指定 SELECT 语句，以便仅导出所需的数据。查询将确定转储文件的内容。
注：DBMS_CLOUD.EXPORT_DATA 过程将创建您在 file_uri_list 中指定的转储文件。该过程不会覆盖文件。如果 file_uri_list 中存在转储文件，则 DBMS_CLOUD.EXPORT_DATA 将生成另一个具有唯一名称的文件。DBMS_CLOUD.EXPORT_DATA 不会创建目录。

有关参数的详细信息，请参见 EXPORT_DATA Procedure 。

使用 DBMS_CLOUD.EXPORT_DATA 导出说明：

如果需要，您提供的 query 参数可以是高级查询，例如包含联接或子查询的查询。
使用 compression 选项指定 format 参数以压缩输出文件。

将数据作为参数导出到目录

通过指定查询，显示将表数据作为 Parquet 数据从自治 AI 数据库导出到目录的步骤。

连接到自治 AI 数据库实例。

有关详细信息，请参阅连接到自治 AI 数据库。
创建目录。

例如：
```
 CREATE DIRECTORY export_dir AS 'export_dir';
```
有关更多信息，请参见 Create a Directory 。
运行 DBMS_CLOUD.EXPORT_DATA 并使用值 json 指定 format 参数 type，以将结果作为 Parquet 文件导出到目录。将输出发送到目录时，不要包含 credential 参数。
```
 BEGIN
  DBMS_CLOUD.EXPORT_DATA(
     file_uri_list => 'export_dir:sales.parquet',
     format => JSON_OBJECT('type' value 'parquet'),
     query => 'SELECT * FROM sales'
  );
 END;
 /
```
当目录名称用双引号括起来时，目录名称区分大小写。例如：
```
 BEGIN
  DBMS_CLOUD.EXPORT_DATA(
     file_uri_list => '"export_dir":sales.parquet',
     format => JSON_OBJECT('type' value 'parquet'),
     query => 'SELECT * FROM sales'
  );
 END;
 /
```
有关参数的详细信息，请参见 EXPORT_DATA Procedure 。

有关可以与 DBMS_CLOUD.EXPORT_DATA 一起使用的可用 format 参数的详细信息，请参见 DBMS_CLOUD Package Format Options for EXPORT_DATA 。

参数包括：
- file_uri_list：是以逗号分隔的导出文件列表。file_uri_list 不支持使用通配符和替代字符。
- format：指定所需的 type 参数。有效值为 datapump、json、xml、csv 和 parquet，还可以选择使用 ORACLE_DATAPUMP 访问驱动程序定义可以为导出指定的选项。
- query：指定 SELECT 语句，以便仅导出所需的数据。查询将确定转储文件的内容。
有关参数的详细信息，请参见 EXPORT_DATA Procedure 。

使用 DBMS_CLOUD.EXPORT_DATA 导出说明：

如果需要，您提供的 query 参数可以是高级查询，例如包含联接或子查询的查询。
使用 compression 选项指定 format 参数以压缩输出文件。

有关 Oracle 类型到参数类型的映射的详细信息，请参阅 DBMS_CLOUD Package Oracle Data Type to Parquet Mapping 。

以下类型不受支持，或者对其使用 DBMS_CLOUD.EXPORT_DATA 导出 Parquet 的支持有限制：

Oracle 类型	说明
`BFILE`	不支持
`BLOB`	不支持
`DATE`	支持以下限制：`DATE` 格式仅支持日期、月份和年份。不支持小时、分钟和秒。有关将 `DATE` 导出到 Parquet 的 NLS 格式限制的详细信息，请参见 DBMS_CLOUD Package Oracle Data Type to Parquet Mapping 。
`INTERVAL DAY TO SECOND`	支持并在内部被视为字符串
`INTERVAL YEAR TO MONTH`	支持并在内部被视为字符串
`LONG`	不支持
`LONG RAW`	不支持
`NUMBER`	支持以下限制： - 最大精度可以为 38，小数位数可以小于精度。 - 如果没有为列 `NUMBER` 类型提供精度和小数位数，则默认使用精度和小数位数为 20。 - `NUMBER` 类型不支持负小数位数。
`Object Types`	不支持
`TIMESTAMP`	支持以下限制： - 如果有多个列具有不同的精度，将采用最高精度。 - `TIMESTAMP WITH TIME ZONE` Oracle 数据类型将仅使用时间戳。有关将 `TIMESTAMP` 导出到 Parquet 的 NLS 格式限制的详细信息，请参见 DBMS_CLOUD Package Oracle Data Type to Parquet Mapping 。

将数据作为 XML 导出到目录

通过指定查询，显示将表数据作为 XML 数据从自治 AI 数据库导出到目录的步骤。

连接到自治 AI 数据库实例。

有关详细信息，请参阅连接到自治 AI 数据库。
创建目录。

例如：
```
 CREATE DIRECTORY export_dir AS 'export_dir';
```
有关更多信息，请参见 Create a Directory 。
运行 DBMS_CLOUD.EXPORT_DATA 并使用值 json 指定 format 参数 type，以将结果作为 XML 文件导出到目录。将输出发送到目录时，不要包含 credential 参数。
```
 BEGIN
  DBMS_CLOUD.EXPORT_DATA(
     file_uri_list => 'export_dir:sales.csv',
     format => JSON_OBJECT('type' value 'csv'),
     query => 'SELECT * FROM sales'
  );
 END;
 /
```
当目录名称用双引号括起来时，目录名称区分大小写。例如：
```
 BEGIN
  DBMS_CLOUD.EXPORT_DATA(
     file_uri_list => '"export_dir":sales.xml',
     format => JSON_OBJECT('type' value 'xml'),
     query => 'SELECT * FROM sales'
  );
 END;
 /
```
有关参数的详细信息，请参见 EXPORT_DATA Procedure 。

有关可以与 DBMS_CLOUD.EXPORT_DATA 一起使用的可用 format 参数的详细信息，请参见 DBMS_CLOUD Package Format Options for EXPORT_DATA 。

参数包括：
- file_uri_list：是以逗号分隔的导出文件列表。file_uri_list 不支持使用通配符和替代字符。
- format：指定所需的 type 参数。有效值为 json、xml 和 csv。
- query：指定 SELECT 语句，以便仅导出所需的数据。查询将确定转储文件的内容。
注：DBMS_CLOUD.EXPORT_DATA 过程将创建您在 file_uri_list 中指定的转储文件。该过程不会覆盖文件。如果 file_uri_list 中存在转储文件，则 DBMS_CLOUD.EXPORT_DATA 将生成另一个具有唯一名称的文件。DBMS_CLOUD.EXPORT_DATA 不会创建目录。

有关参数的详细信息，请参见 EXPORT_DATA Procedure 。

使用 DBMS_CLOUD.EXPORT_DATA 导出说明：

如果需要，您提供的 query 参数可以是高级查询，例如包含联接或子查询的查询。
使用 compression 选项指定 format 参数以压缩输出文件。

使用 DBMS_CLOUD.EXPORT_DATA 将数据导出到目录

以 CSV 格式将数据导出至目录

将数据导出为 JSON 目录

将数据作为参数导出到目录

将数据作为 XML 导出到目录

相关内容