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

将数据作为 CSV 导出到目录

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

连接到 Autonomous AI Database 实例。

有关详细信息，请参阅连接到 Autonomous AI Database。
创建目录。
例如：
```
CREATE DIRECTORY export_dir AS 'export_dir';
```
有关更多信息，请参见创建目录。
运行 DBMS_CLOUD.EXPORT_DATA 并将 format 参数 type 指定为值 json，以将结果作为 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 数据从 Autonomous AI Database 导出到目录的步骤。

连接到 Autonomous AI Database 实例。

有关详细信息，请参阅连接到 Autonomous AI Database。
创建目录。
例如：
```
CREATE DIRECTORY export_dir AS 'export_dir';
```
有关更多信息，请参见创建目录。
运行 DBMS_CLOUD.EXPORT_DATA 并将 format 参数 type 指定为值 json，以将结果作为 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 数据从 Autonomous AI Database 导出到目录的步骤。

连接到 Autonomous AI Database 实例。

有关详细信息，请参阅连接到 Autonomous AI Database。
创建目录。
例如：
```
CREATE DIRECTORY export_dir AS 'export_dir';
```
有关更多信息，请参见创建目录。
运行 DBMS_CLOUD.EXPORT_DATA 并将 format 参数 type 指定为值 json，以将结果作为 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` 类型提供精度和小数位数，则默认情况下使用精度 38 和小数位数 20。 `NUMBER` 类型不支持负比例。
`Object Types`	不支持
`TIMESTAMP`	支持，但存在以下限制：如果有多个列具有不同的精度，则采用最高的精度。 `TIMESTAMP WITH TIME ZONE` Oracle 数据类型将仅使用时间戳。有关将 `TIMESTAMP` 导出到 Parquet 的 NLS 格式限制的详细信息，请参见 DBMS_CLOUD Package Oracle Data Type to Parquet Mapping 。

将数据作为 XML 导出到目录

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

连接到 Autonomous AI Database 实例。

有关详细信息，请参阅连接到 Autonomous AI Database。
创建目录。
例如：
```
CREATE DIRECTORY export_dir AS 'export_dir';
```
有关更多信息，请参见创建目录。
运行 DBMS_CLOUD.EXPORT_DATA 并将 format 参数 type 指定为值 json，以将结果作为 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 参数以压缩输出文件。