DBMS_CLOUD 程序包格式选项

DBMS_CLOUD 中的 format 参数指定源文件的格式。

指定格式参数的两种方法为：

format => '{"format_option" : "format_value" }'

和

format => json_object('format_option' value 'format_value')

示例：

format => json_object('type' VALUE 'CSV')

要指定多个格式选项，请使用“,”分隔值，如下所示：

format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true',
                           'dateformat' value 'YYYY-MM-DD-HH24-MI-SS', 'blankasnull' value 'true', 'logretention' value 7)

注：有关 Avro、ORC 或 Parquet 格式选项，请参阅 DBMS_CLOUD Package Format Options for Avro、ORC 或 Parquet 。

如格式选项列中所述，如果 format type 为 JSON，则一组有限的格式选项对 DBMS_CLOUD.COPY_COLLECTION 或 DBMS_CLOUD.COPY_DATA 有效。

格式选项说明语法

格式选项	说明	语法
`blankasnull`	设置为 `true` 时，由空格组成的字段加载为空值。	`blankasnull` `: true` 默认值：`False`
`characterset` 使用 `format` JSON 和 `COPY_DATA` 有效	指定源文件的字符集合	`characterset`: string 默认值：数据库字符集
`columnpath` 仅与 `format` JSON 和 `COPY_DATA` 一起使用	对应于需要从 JSON 记录中提取的字段的 JSON 路径表达式数组。数组中的每个 JSON 路径表达式都应遵循 Oracle Database 19c JSON Developer's Guide 或 Oracle Database 26ai JSON Developer's Guide 中 SQL/JSON Path Expressions 中所述的规则。仅用于格式 JSON 和 `DBMS_CLOUD.COPY_DATA`。	以字符串格式表示的 json 路径表达式的 JSON 数组。例如，'columnpath' 值 `'["$.WEATHER_STATION_ID", "$.WEATHER_STATION_NAME"]'`
`compression` 选项对 JSON 数据有效	指定源文件的压缩类型。不支持 ZIP 归档格式。指定值 `auto` 将检查压缩类型：`gzip, zlib, std, bzip2`。	`compression`: `auto\|gzip\|zlib\|bzip2` 默认值：Null 值，表示无压缩。
`conversionerrors`	如果行因数据类型转换错误而被拒绝，则相关列将存储为空值或相应行被拒绝。	`conversionerrors` : `reject_record \| store_null` 默认值：`reject_record`
`dateformat`	指定源文件中的日期格式。格式选项 `AUTO` 将搜索以下格式： J MM-DD-YYYYBC MM-DD-YYYY YYYYMMDD HHMISS YYMMDD HHMISS YYYY.DDD YYYY-MM-DD	`dateformat`: string 默认值：数据库日期格式
`delimiter`	指定字段分隔符。要使用特殊字符作为分隔符，请指定字符的 ASCII 代码的 HEX 值。例如，以下项将 TAB 字符指定为分隔符： `format => json_object('delimiter' value 'X''9''')`	`delimiter`: character 默认值 `\|`（管道字符）
`detectfieldorder`	指定外部数据文件中的字段的顺序与表中的列不同。使用每个外部数据文件的第一行检测字段的顺序，并将其映射到表的列。将以不区分大小写的方式将外部数据文件中的字段名称与表列的名称进行比较。此格式选项适用于以下过程： `DBMS_CLOUD.COPY_DATA` `DBMS_CLOUD.CREATE_EXTERNAL_TABLE` `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` `DBMS_CLOUD.CREATE_HYBRID_PART_TABLE` `detectfieldorder` 的限制：数据文件中的字段名称必须显示在第一个记录行中，并且不能在字段名称之间包含任何空格。字段名称记录中的字段分隔符必须与文件中数据的字段分隔符相同。不支持带引号的字段名称。将以不区分大小写的方式将数据文件中的字段名称与外部表列的名称进行比较。字段名称中不允许使用嵌入式字段分隔符。表中的列数必须与数据文件中的字段数匹配。此格式选项不适用于 Bigdata 或 Oracle Data Pump 格式，因为这些格式具有二进制文件格式的精确列元数据信息。当第一行包含字段名称时，文本格式（CSV、JSON、Parquet 或 XML）可以受益于此自动现场工单检测。有关详细信息，请参阅 Oracle Database 19c Utilities 或 Oracle Database 23ai Utilities 中的 FIELD NAMES 以及 `ALL FILES` 的说明。	`detectfieldorder: true` 默认值：`false`
`enablelogs`	格式选项 `enablelogs` 与以下 `DBMS_CLOUD` 过程一起使用： `COPY_DATA` `COPY_COLLECTION` `EXPORT_DATA` `enablelogs` 指定布尔值，当设置为 `TRUE` 时，将生成日志。设置为 `FALSE` 时，不会生成日志。例如： `format => JSON_OBJECT('enablelogs' value FALSE)`	`enablelogs: false` 默认值：`true`
`encryption`	格式选项 `encryption` 指定用于将数据导出和导入到对象存储以及从对象存储导入数据的加密和解密选项。使用 `encryption` 指定以下参数以加密和解密： `user_defined_function`：指定用于解密或加密指定 BLOB（二进制大对象）的全限定用户定义函数。它返回解密或加密的 BLOB。`user_defined_function` 与 `encryption` 的其他参数互斥。例如，`ADMIN.DECRYPTION_CALLBACK`。 `type`：指定要解密或加密的 `DBMS_CRYPTO` 加密算法。 `type` 接受块密码算法 + 块密码链接修饰符 + 块密码填充修饰符格式的值。支持的块密码算法包括： `DBMS_CRYPTO.ENCRYPT_AES256` 支持的块密码链接修饰符包括： `DBMS_CRYPTO.CHAIN_CBC` `DBMS_CRYPTO.CHAIN_CFB` `DBMS_CRYPTO.CHAIN_ECB` `DBMS_CRYPTO.CHAIN_OFB` 支持的块密码填充修饰符包括： `DBMS_CRYPTO.PAD_PKCS5` `DBMS_CRYPTO.PAD_NONE` `DBMS_CRYPTO.PAD_ZERO` `DBMS_CRYPTO.PAD_ORCL` `credential_name`：指定用于存储加密密钥的身份证明。如果不为这些参数指定值，块密码链接修饰符和块密码填充修饰符的值将默认为 `DBMS_CRYPTO.CHAIN_CBC` 和 `DBMS_CRYPTO.PAD_PKCS5`。格式选项 `encryption` 与以下 `DBMS_CLOUD` 过程一起使用：用于为以下过程传递要解密的参数： `DBMS_CLOUD.COPY_DATA` `DBMS_CLOUD.CREATE_EXTERNAL_TABLE` `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` `DBMS_CLOUD.CREATE_HYBRID_PART_TABLE` 对于 `DBMS_CLOUD.CREATE_HYBRID_PART_TABLE`，此选项仅适用于对象存储文件。 `DBMS_CLOUD.COPY_COLLECTION` 用于为以下过程传递要加密的参数： `DBMS_CLOUD.EXPORT_DATA` 例如： `format => JSON_OBJECT('encryption' value json_object ('type' value DBMS_CRYPTO.ENCRYPT_AES256 + DBMS_CRYPTO.CHAIN_CBC + DBMS_CRYPTO.PAD_PKCS5, 'credential_name' value 'ENCRYPTION_CRED'))`	`encryption:value` 其中 value 是为加密提供其他参数的 JSON 字符串： `type`：值指定加密类型。 `credential_name`: `value` 指定用于存储加密密钥的身份证明。 `user_defined_function: value` 指定用于解密或加密指定 BLOB（二进制大对象）的全限定用户定义函数。
`endquote`	数据可以用 `quote` 和 `endquote` 指定在两个分隔符之间。指定 `quote` 和 `endquote` 字符将在加载期间删除。例如： `format => JSON_OBJECT('quote' value '(', 'endquote' value ')')`	`endquote:character` 默认值：Null，表示无 `endquote`。
`escape`	指定了此项后，字符 "\" 用作转义符。	`escape` `: true` 默认值：`false`
`ignoreblanklines` 选项对 JSON 数据有效	当“忽略空行”设置为 true 时，将忽视空行。	`ignoreblanklines` `: true` 默认值：`False`
`ignoremissingcolumns`	如果 `field_list` 中的列多于源文件中的列，则多多余的列将存储为空值。	`ignoremissingcolumns` `: true` 默认值 `False`
`jsonpath` 仅与 `COPY_COLLECTION` 一起使用	用于标识要加载的文档的 JSON 路径。此选项仅对具有 `DBMS_CLOUD.COPY_COLLECTION` 的 JSON 收集数据有效。	`jsonpath`：字符串默认值：Null
` 关键作业 ` 仅与 `COPY_COLLECTION` 一起使用	指定是将新集合创建为与 mongo 兼容的集合还是 SODA 集合。将该值设置为 `embedded_oid` 时，将创建新集合作为与 mongo 兼容的集合。默认情况下不设置此参数，这意味着新集合将创建为 SODA 集合。	`keyassignment`: `embedded_oid` 默认值：未设置 `keyassignment`
`keypath` 仅与 `COPY_COLLECTION` 一起使用	指定要加载为 `'_id'` 值的数据中的属性。如果指定了 `keypath`，则还必须将 `keyassignment` 值指定为 `embedded_oid`。将值设置为路径（例如 `'$.mykey'`），以将路径的值选为 `'_id'` 值。此参数是可选的，仅适用于加载到与 mongo 兼容的集合中。如果未指定，则 Oracle 将生成一个 12 字节的唯一系统 ID，并将该 ID 填充为 `'_id'` 属性（如果加载的数据中尚未存在 `'_id'` 属性）。	`keypath`: `string` 默认值：`keypath` 未设置。设置 `keypath` 时，缺省字符串值为 `NULL`。
`language`	指定语言名称（例如，FRENCH），从该语言可以派生区域设置相关信息。	`language`：字符串默认值：Null 有关 Oracle 支持的语言的列表，请参阅 Oracle Database 19c Database Globalization Support Guide 中的 Locale Data 或 Oracle Database 23ai Database Globalization Support Guide 。
`logdir`	指定用于确定保存 `logfile_table` 或 `badfile_table` 文件的目录对象名称的字符串值。缺省情况下，`logdir` 不区分大小写，但当指定值括在双引号中时，会保留大小写。例如： `format => JSON_OBJECT ('logdir' value 'test_log')` 上例中指定的 `logdir` 格式选项将 `logfile_table` 或 `badfile_table` 文件保存在 `TEST_LOG` 目录对象中。 `format => JSON_OBJECT ('logdir' value '"test_log"')` 上例中指定的 `logdir` 格式选项将 `logfile_table` 或 `badfile_table` 文件保存在 `test_log` 目录对象中。	`logdir`：字符串默认值：`DATA_PUMP_DIR`
`logprefix`	指定用于确定 `logfile_table` 和 `badfile_table` 文件前缀的字符串值。日志表名称格式为：logprefix`$`operation_id 缺省情况下，logprefix 以大写形式显示，但当指定值用双引号括起来时，会保留大小写。例如： `format => JSON_OBJECT ('logprefix' value 'TEST')` 然后，日志文件使用 `TEST` 前缀，例如：`TEST$2_LOG` 和 `TEST$2_BAD`。	`logprefix`：字符串默认值：`COPY`
`logretention`	指定保留 `logfile_table` 和 `badfile_table` 文件的正整数持续时间（天）。有效值：`0` 到 `99999` 例如： `format => JSON_OBJECT ('logretention' value 7)`	`logretention`：编号默认值：`2`
`maxdocsize` 此选项仅对 JSON 数据有效	JSON 文档的最大大小。	`maxdocsize`：编号默认值：1 MB 允许的最大值：2 千兆字节
`numericcharacters`	指定要用作组分隔符和小数字符的字符。 decimal_character：小数将数字的整数部分与小数部分分隔开。 group_separator：组分隔符分隔整数组（即千、百万、十亿等）。	`numericcharacters: 'decimal_character group_separator'` 默认值：`".,"` 有关详细信息，请参阅 NLS_NUMERIC_CHARACTERS Oracle Database 19c Database Globalization Support Guide Oracle Database 23ai Database Globalization Support Guide 。
`numberformat`	指定数字格式模型。数字格式样式会导致数字舍入到指定的有效位数。数字格式模型由一个或多个数字格式元素组成。这与 `numericcharacters` 结合使用。	`numberformat: number_format_model` 默认值：派生自 `NLS_TERRITORY` 参数的设置有关详细信息，请参阅 Oracle Database 19c SQL Language Reference 或 Oracle Database 23ai SQL Language Reference 中的 Number Format Models 。
`partition_columns`	当分区列从文件路径派生时，格式选项 `partition_columns` 与 `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` 一起使用，以指定分区列的列名称和数据类型，具体取决于数据文件的类型（结构化或非结构化）：当 `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` 包含 `column_list` 参数并且数据文件是非结构化的（例如 CSV 文本文件）时，`partition_columns` 不包括数据类型。例如，对于此类型的 `partition_columns` 规范，请使用如下格式： `'"partition_columns":["state","zipcode"]'` 数据类型不是必需的，因为它是在 `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` `column_list` 参数中指定的。如果 `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` 不包含 `column_list` 参数并且数据文件是结构化的（例如 Avro、ORC 或 Parquet 文件），则 `partition_columns` 选项包括数据类型。例如，以下内容显示了 `partition_columns` 规范： `'"partition_columns":[{"name":"country", "type":"varchar2(10)"}, {"name":"year", "type":"number"}, {"name":"month", "type":"varchar2(10)"}]'` 如果数据文件是非结构化的，并且 `type` 子子句与 `partition_columns` 一起指定，则忽略 `type` 子子句。对于不基于 hive 格式的对象名称，`partition_columns` 指定列的顺序必须与 `file_uri_list` 中对象名称中出现的顺序匹配。
`quote`	指定字段的引码字符，如果指定了此项，在加载期间会删除 `quote` 字符。	`quote`：字符默认值：空值表示无引号
`recorddelimiter` 选项对 JSON 数据有效	指定记录分隔符。缺省情况下，`DBMS_CLOUD` 会尝试自动查找正确的换行符作为分隔符。它首先在文件中搜索 Windows 新行字符 "`\r\n`"。如果找到 Windows 换行符，则此字符将用作该过程中所有文件的记录分隔符。如果未找到 Windows 新行字符，则搜索 UNIX/Linux 新行字符 "`\n`"，如果找到新行字符，则使用 "`\n`" 作为该过程中所有文件的记录分隔符。如果要覆盖缺省行为，请显式指定此参数，例如： `format => json_object('recorddelimiter' VALUE '''\r\n''')` 要指示没有记录分隔符，可以指定输入文件中未出现的 `recorddelimiter`。例如，要指示没有分隔符，请指定控制字符 0x01 (SOH) 作为 `recorddelimiter` 的值，并将 `recorddelimiter` 值设置为 `"0x''01''"`（此字符不出现在 JSON 文本中）。例如： `format => '{"recorddelimiter" : "0x''01''"}'` `recorddelimiter` 在每个过程调用中设置一次。如果使用默认值 `detected newline`，则所有文件都使用相同的记录分隔符（如果检测到）。	`recorddelimiter`：字符默认值：检测到换行符
`regexuri`	格式选项 `regexuri` 与以下 DBMS_CLOUD 过程一起使用： `COPY_COLLECTION` `COPY_DATA` `CREATE_EXTERNAL_TABLE` `CREATE_EXTERNAL_PART_TABLE` `CREATE_HYBRID_PART_TABLE` 如果将 `regexuri` 的值设置为 `TRUE`，则可以在云源文件 URI 中的文件名中使用通配符和正则表达式。当 `regexuri` 参数设置为 `FALSE` 时，字符 "" 和 "?" 被视为通配符。当 `regexuri` 参数设置为 `TRUE` 时，字符 "" 和 "?" 是指定正则表达式模式的一部分。仅 URI 中的文件名或子文件夹路径支持正则表达式模式，模式匹配与 `REGEXP_LIKE` 函数执行的模式匹配相同。目录名称不支持正则表达式模式。对于外部表，仅对象存储中的某个文件上创建的表支持此选项。例如： `format => JSON_OBJECT('regexuri' value TRUE)` 有关 `REGEXP_LIKE` 条件的更多信息，请参见 Oracle Database 19c SQL Language Reference 中的 REGEXP_LIKE Condition 或 Oracle Database 23ai SQL Language Reference 。	`regexuri`: `True` 默认值：`False`
`rejectlimit`	在拒绝了指定数量的行后，操作将出错。	`rejectlimit`：编号默认值：`0`
`removequotes`	删除源文件中任何字段周围的引码。	`removequotes`: `true` 默认值：`False`
`skipheaders`	指定应从文件开头跳过多少行。	`skipheaders`：编号默认值：0（如果未指定），1（如果未指定值）
`territory`	指定地区名称以进一步确定输入数据特征。	`territory`：字符串默认值：Null 有关 Oracle 支持的语言的列表，请参阅 Oracle Database 19c Database Globalization Support Guide 中的 Locale Data 或 Oracle Database 23ai Database Globalization Support Guide 。
`timestampformat`	指定源文件中的的时间戳格式。格式选项 `AUTO` 将搜索以下格式： YYYY-MM-DD HH:MI:SS.FF YYYY-MM-DD HH:MI:SS.FF3 YYYY-MM-DD HH24:MI:SS.FF3 MM/DD/YYYY HH:MI:SS.FF3	`timestampformat`：字符串默认值：数据库时间戳格式该字符串可以包含通配符，例如 "$"。
`timestampltzformat`	指定源文件中带本地时区的时间戳格式。格式选项 `AUTO` 将搜索以下格式： DD Mon YYYY HH:MI:SS.FF TZR MM/DD/YYYY HH:MI:SS.FF TZR YYYY-MM-DD HH:MI:SS+/-TZR YYYY-MM-DD HH:MI:SS.FF3 DD.MM.YYYY HH:MI:SS TZR	`timestampltzformat`：字符串默认值：具有本地时区格式的数据库时间戳
`timestamptzformat`	指定源文件中带有时区的时间戳格式。格式选项 `AUTO` 将搜索以下格式： DD Mon YYYY HH:MI:SS.FF TZR MM/DD/YYYY HH:MI:SS.FF TZR YYYY-MM-DD HH:MI:SS+/-TZR YYYY-MM-DD HH:MI:SS.FF3 DD.MM.YYYY HH:MI:SS TZR	`timestamptzformat`：字符串默认值：具有时区格式的数据库时间戳
`trimspaces`	指定如何截截取字段中的前导空格和尾随空格。请参见 Oracle Database 19c Utilities 或 Oracle Database 23ai Utilities 中的 trim_spec 说明。	`trimspaces`: `rtrim\| ltrim\| notrim\| lrtrim\| ldrtrim` 默认值：`notrim`
`truncatecol`	如果文件中的数据太长，无法放在一个字段中，则此选项将截断该字段的值，而不是拒绝行。	`truncatecol`:`true` 默认值：`False`
`type`	指定源文件类型。请参阅 Oracle Database 19c Utilities 或 Oracle Database 23ai Utilities 中的 CSV 说明。如果 `type` 为 `datapump`，则唯一的其他有效格式选项为 `rejectlimit`。如果 `type` 为 `datapump`，则支持的唯一对象存储是 Oracle Cloud Infrastructure Object Storage 和 Oracle Cloud Infrastructure Object Storage Classic。有关 `type` 值 `avro`、`orc` 或 `parquet`，请参见 DBMS_CLOUD Package Format Options for Avro、ORC 或 Parquet 。对于具有 `DBMS_CLOUD.COPY_COLLECTION` `type` 的 JSON 数据，有两个有效值：`json`（默认值）和 `ejson`。对于 `DBMS_CLOUD.COPY_COLLECTION`，这两个值都指定输入是 JSON 数据。值 `ejson` 将导致文本 JSON 输入数据中的扩展对象转换为本机二进制 JSON 集合中的标量 JSON 值。值 `json` 不会执行此转换，并且输入数据中的所有对象都将转换为二进制 JSON 格式。对于 `DBMS_CLOUD.COPY_DATA` 为 `type` 的 JSON 数据，有一个有效值：`json`。此值指定输入是 JSON 数据。有关加载 JSON 对象的信息，请参见 COPY_COLLECTION Procedure 。 See Textual JSON Objects that Represent Extended Scalar Values for information about extended JSON objects, which are interpreted when parameter `type` has value `ejson`.	`type`: `csv` \| `csv with embedded` \| `csv without embedded` \| `avro` \| `datapump`\| `orc` \| `parquet` 注：并非所有 `DBMS_CLOUD` 过程都支持所有这些类型。 `csv` 与 `csv without embedded` 相同。默认值：Null 对于 JSON 数据，有两个用于 `DBMS_CLOUD.COPY_COLLECTION` 的有效 `type` 值：`json`\|`ejson`。在这种情况下，默认值为 `json`。对于带有 `DBMS_CLOUD.COPY_DATA` 的 JSON 数据，只有 `json` 有效。
`unpackarrays` 仅与 `COPY_COLLECTION` 一起使用	当设置为 `true` 时，如果加载的文档是数组，则数组的内容将作为文档而不是数组本身加载。这仅适用于顶层数组。设置为 `true` 时，整个数组将作为单个文档插入。此选项仅对具有 `DBMS_CLOUD.COPY_COLLECTION` 的 JSON 收集数据有效。	`unpackarrays: true` 默认值：`False`

blankasnull

设置为 true 时，由空格组成的字段加载为空值。

blankasnull : true

默认值：False

characterset

使用 format JSON 和 COPY_DATA 有效

指定源文件的字符集合

characterset: string

默认值：数据库字符集

columnpath

仅与 format JSON 和 COPY_DATA 一起使用

对应于需要从 JSON 记录中提取的字段的 JSON 路径表达式数组。数组中的每个 JSON 路径表达式都应遵循 Oracle Database 19c JSON Developer's Guide 或 Oracle Database 26ai JSON Developer's Guide 中 SQL/JSON Path Expressions 中所述的规则。

仅用于格式 JSON 和 DBMS_CLOUD.COPY_DATA。

以字符串格式表示的 json 路径表达式的 JSON 数组。例如，'columnpath' 值 '["$.WEATHER_STATION_ID", "$.WEATHER_STATION_NAME"]'

compression

选项对 JSON 数据有效

指定源文件的压缩类型。

不支持 ZIP 归档格式。

指定值 auto 将检查压缩类型：gzip, zlib, std, bzip2。

compression: auto|gzip|zlib|bzip2

默认值：Null 值，表示无压缩。

conversionerrors

如果行因数据类型转换错误而被拒绝，则相关列将存储为空值或相应行被拒绝。

conversionerrors : reject_record | store_null

默认值：reject_record

dateformat

指定源文件中的日期格式。格式选项 AUTO 将搜索以下格式：

J
MM-DD-YYYYBC
MM-DD-YYYY
YYYYMMDD HHMISS
YYMMDD HHMISS
YYYY.DDD
YYYY-MM-DD

dateformat: string

默认值：数据库日期格式

delimiter

指定字段分隔符。

要使用特殊字符作为分隔符，请指定字符的 ASCII 代码的 HEX 值。例如，以下项将 TAB 字符指定为分隔符：

format => json_object('delimiter' value 'X''9''')

delimiter: character

默认值 |（管道字符）

detectfieldorder

指定外部数据文件中的字段的顺序与表中的列不同。使用每个外部数据文件的第一行检测字段的顺序，并将其映射到表的列。将以不区分大小写的方式将外部数据文件中的字段名称与表列的名称进行比较。

此格式选项适用于以下过程：

DBMS_CLOUD.COPY_DATA
DBMS_CLOUD.CREATE_EXTERNAL_TABLE
DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE
DBMS_CLOUD.CREATE_HYBRID_PART_TABLE

detectfieldorder 的限制：

数据文件中的字段名称必须显示在第一个记录行中，并且不能在字段名称之间包含任何空格。
字段名称记录中的字段分隔符必须与文件中数据的字段分隔符相同。
不支持带引号的字段名称。将以不区分大小写的方式将数据文件中的字段名称与外部表列的名称进行比较。
字段名称中不允许使用嵌入式字段分隔符。
表中的列数必须与数据文件中的字段数匹配。
此格式选项不适用于 Bigdata 或 Oracle Data Pump 格式，因为这些格式具有二进制文件格式的精确列元数据信息。
当第一行包含字段名称时，文本格式（CSV、JSON、Parquet 或 XML）可以受益于此自动现场工单检测。

有关详细信息，请参阅 Oracle Database 19c Utilities 或 Oracle Database 23ai Utilities 中的 FIELD NAMES 以及 ALL FILES 的说明。

detectfieldorder: true

默认值：false

enablelogs

格式选项 enablelogs 与以下 DBMS_CLOUD 过程一起使用：

COPY_DATA
COPY_COLLECTION
EXPORT_DATA

enablelogs 指定布尔值，当设置为 TRUE 时，将生成日志。设置为 FALSE 时，不会生成日志。

例如：

format => JSON_OBJECT('enablelogs' value FALSE)

enablelogs: false

默认值：true

encryption

格式选项 encryption 指定用于将数据导出和导入到对象存储以及从对象存储导入数据的加密和解密选项。

使用 encryption 指定以下参数以加密和解密：

user_defined_function：指定用于解密或加密指定 BLOB（二进制大对象）的全限定用户定义函数。它返回解密或加密的 BLOB。user_defined_function 与 encryption 的其他参数互斥。
例如，ADMIN.DECRYPTION_CALLBACK。
type：指定要解密或加密的 DBMS_CRYPTO 加密算法。
type 接受块密码算法 + 块密码链接修饰符 + 块密码填充修饰符格式的值。
支持的块密码算法包括：
- DBMS_CRYPTO.ENCRYPT_AES256
支持的块密码链接修饰符包括：
- DBMS_CRYPTO.CHAIN_CBC
- DBMS_CRYPTO.CHAIN_CFB
- DBMS_CRYPTO.CHAIN_ECB
- DBMS_CRYPTO.CHAIN_OFB
支持的块密码填充修饰符包括：
- DBMS_CRYPTO.PAD_PKCS5
- DBMS_CRYPTO.PAD_NONE
- DBMS_CRYPTO.PAD_ZERO
- DBMS_CRYPTO.PAD_ORCL

credential_name：指定用于存储加密密钥的身份证明。

如果不为这些参数指定值，块密码链接修饰符和块密码填充修饰符的值将默认为 DBMS_CRYPTO.CHAIN_CBC 和 DBMS_CRYPTO.PAD_PKCS5。

格式选项 encryption 与以下 DBMS_CLOUD 过程一起使用：

用于为以下过程传递要解密的参数：
- DBMS_CLOUD.COPY_DATA
- DBMS_CLOUD.CREATE_EXTERNAL_TABLE
- DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE
- DBMS_CLOUD.CREATE_HYBRID_PART_TABLE
  对于 DBMS_CLOUD.CREATE_HYBRID_PART_TABLE，此选项仅适用于对象存储文件。
- DBMS_CLOUD.COPY_COLLECTION
用于为以下过程传递要加密的参数：
- DBMS_CLOUD.EXPORT_DATA

例如：

format => JSON_OBJECT('encryption' value json_object ('type' value DBMS_CRYPTO.ENCRYPT_AES256 + DBMS_CRYPTO.CHAIN_CBC + DBMS_CRYPTO.PAD_PKCS5, 'credential_name' value 'ENCRYPTION_CRED'))

encryption:value

其中 value 是为加密提供其他参数的 JSON 字符串：

type：值

指定加密类型。

credential_name: value

指定用于存储加密密钥的身份证明。

user_defined_function: value

指定用于解密或加密指定 BLOB（二进制大对象）的全限定用户定义函数。

endquote

数据可以用 quote 和 endquote 指定在两个分隔符之间。指定 quote 和 endquote 字符将在加载期间删除。

例如：

format => JSON_OBJECT('quote' value '(', 'endquote' value ')')

endquote:character

默认值：Null，表示无 endquote。

escape

指定了此项后，字符 "\" 用作转义符。

escape : true

默认值：false

ignoreblanklines

选项对 JSON 数据有效

当“忽略空行”设置为 true 时，将忽视空行。

ignoreblanklines : true

默认值：False

ignoremissingcolumns

如果 field_list 中的列多于源文件中的列，则多多余的列将存储为空值。

ignoremissingcolumns : true

默认值 False

jsonpath

仅与 COPY_COLLECTION 一起使用

用于标识要加载的文档的 JSON 路径。

此选项仅对具有 DBMS_CLOUD.COPY_COLLECTION 的 JSON 收集数据有效。

jsonpath：字符串

默认值：Null

` 关键作业 `

仅与 `COPY_COLLECTION` 一起使用

指定是将新集合创建为与 mongo 兼容的集合还是 SODA 集合。

将该值设置为 embedded_oid 时，将创建新集合作为与 mongo 兼容的集合。

默认情况下不设置此参数，这意味着新集合将创建为 SODA 集合。

keyassignment: embedded_oid

默认值：未设置 keyassignment

keypath

仅与 COPY_COLLECTION 一起使用

指定要加载为 '_id' 值的数据中的属性。

如果指定了 keypath，则还必须将 keyassignment 值指定为 embedded_oid。

将值设置为路径（例如 '$.mykey'），以将路径的值选为 '_id' 值。

此参数是可选的，仅适用于加载到与 mongo 兼容的集合中。

如果未指定，则 Oracle 将生成一个 12 字节的唯一系统 ID，并将该 ID 填充为 '_id' 属性（如果加载的数据中尚未存在 '_id' 属性）。

keypath: string

默认值：keypath 未设置。

设置 keypath 时，缺省字符串值为 NULL。

language

指定语言名称（例如，FRENCH），从该语言可以派生区域设置相关信息。

language：字符串

默认值：Null

有关 Oracle 支持的语言的列表，请参阅 Oracle Database 19c Database Globalization Support Guide 中的 Locale Data 或 Oracle Database 23ai Database Globalization Support Guide 。

logdir

指定用于确定保存 logfile_table 或 badfile_table 文件的目录对象名称的字符串值。

缺省情况下，logdir 不区分大小写，但当指定值括在双引号中时，会保留大小写。

例如：

format => JSON_OBJECT ('logdir' value 'test_log')

上例中指定的 logdir 格式选项将 logfile_table 或 badfile_table 文件保存在 TEST_LOG 目录对象中。

format => JSON_OBJECT ('logdir' value '"test_log"')

上例中指定的 logdir 格式选项将 logfile_table 或 badfile_table 文件保存在 test_log 目录对象中。

logdir：字符串

默认值：DATA_PUMP_DIR

logprefix

指定用于确定 logfile_table 和 badfile_table 文件前缀的字符串值。

日志表名称格式为：logprefix$operation_id

缺省情况下，logprefix 以大写形式显示，但当指定值用双引号括起来时，会保留大小写。

例如：

format => JSON_OBJECT ('logprefix' value 'TEST')

然后，日志文件使用 TEST 前缀，例如：TEST$2_LOG 和 TEST$2_BAD。

logprefix：字符串

默认值：COPY

logretention

指定保留 logfile_table 和 badfile_table 文件的正整数持续时间（天）。

有效值：0 到 99999

例如：

format => JSON_OBJECT ('logretention' value 7)

logretention：编号

默认值：2

maxdocsize

此选项仅对 JSON 数据有效

JSON 文档的最大大小。

maxdocsize：编号

默认值：1 MB

允许的最大值：2 千兆字节

numericcharacters

指定要用作组分隔符和小数字符的字符。

decimal_character：小数将数字的整数部分与小数部分分隔开。

group_separator：组分隔符分隔整数组（即千、百万、十亿等）。

numericcharacters: 'decimal_character group_separator'

默认值：".,"

有关详细信息，请参阅 NLS_NUMERIC_CHARACTERS Oracle Database 19c Database Globalization Support Guide Oracle Database 23ai Database Globalization Support Guide 。

numberformat

指定数字格式模型。数字格式样式会导致数字舍入到指定的有效位数。数字格式模型由一个或多个数字格式元素组成。

这与 numericcharacters 结合使用。

numberformat: number_format_model

默认值：派生自 NLS_TERRITORY 参数的设置

有关详细信息，请参阅 Oracle Database 19c SQL Language Reference 或 Oracle Database 23ai SQL Language Reference 中的 Number Format Models 。

partition_columns

当分区列从文件路径派生时，格式选项 partition_columns 与 DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE 一起使用，以指定分区列的列名称和数据类型，具体取决于数据文件的类型（结构化或非结构化）：

当 DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE 包含 column_list 参数并且数据文件是非结构化的（例如 CSV 文本文件）时，partition_columns 不包括数据类型。例如，对于此类型的 partition_columns 规范，请使用如下格式：
```
'"partition_columns":["state","zipcode"]'
```
数据类型不是必需的，因为它是在 DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE column_list 参数中指定的。
如果 DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE 不包含 column_list 参数并且数据文件是结构化的（例如 Avro、ORC 或 Parquet 文件），则 partition_columns 选项包括数据类型。例如，以下内容显示了 partition_columns 规范：
```
'"partition_columns":[{"name":"country", "type":"varchar2(10)"}, {"name":"year", "type":"number"}, {"name":"month", "type":"varchar2(10)"}]'
```

如果数据文件是非结构化的，并且 type 子子句与 partition_columns 一起指定，则忽略 type 子子句。

对于不基于 hive 格式的对象名称，partition_columns 指定列的顺序必须与 file_uri_list 中对象名称中出现的顺序匹配。

quote

指定字段的引码字符，如果指定了此项，在加载期间会删除 quote 字符。

quote：字符

默认值：空值表示无引号

recorddelimiter

选项对 JSON 数据有效

指定记录分隔符。

缺省情况下，DBMS_CLOUD 会尝试自动查找正确的换行符作为分隔符。它首先在文件中搜索 Windows 新行字符 "\r\n"。如果找到 Windows 换行符，则此字符将用作该过程中所有文件的记录分隔符。如果未找到 Windows 新行字符，则搜索 UNIX/Linux 新行字符 "\n"，如果找到新行字符，则使用 "\n" 作为该过程中所有文件的记录分隔符。

如果要覆盖缺省行为，请显式指定此参数，例如：

format => json_object('recorddelimiter' VALUE '''\r\n''')

要指示没有记录分隔符，可以指定输入文件中未出现的 recorddelimiter。例如，要指示没有分隔符，请指定控制字符 0x01 (SOH) 作为 recorddelimiter 的值，并将 recorddelimiter 值设置为 "0x''01''"（此字符不出现在 JSON 文本中）。例如：

format => '{"recorddelimiter" : "0x''01''"}'

recorddelimiter 在每个过程调用中设置一次。如果使用默认值 detected newline，则所有文件都使用相同的记录分隔符（如果检测到）。

recorddelimiter：字符

默认值：检测到换行符

regexuri

格式选项 regexuri 与以下 DBMS_CLOUD 过程一起使用：

COPY_COLLECTION
COPY_DATA
CREATE_EXTERNAL_TABLE
CREATE_EXTERNAL_PART_TABLE
CREATE_HYBRID_PART_TABLE

如果将 regexuri 的值设置为 TRUE，则可以在云源文件 URI 中的文件名中使用通配符和正则表达式。

当 regexuri 参数设置为 FALSE 时，字符 "*" 和 "?" 被视为通配符。当 regexuri 参数设置为 TRUE 时，字符 "*" 和 "?" 是指定正则表达式模式的一部分。

仅 URI 中的文件名或子文件夹路径支持正则表达式模式，模式匹配与 REGEXP_LIKE 函数执行的模式匹配相同。目录名称不支持正则表达式模式。

对于外部表，仅对象存储中的某个文件上创建的表支持此选项。

例如：

format => JSON_OBJECT('regexuri' value TRUE)

有关 REGEXP_LIKE 条件的更多信息，请参见 Oracle Database 19c SQL Language Reference 中的 REGEXP_LIKE Condition 或 Oracle Database 23ai SQL Language Reference 。

regexuri: True

默认值：False

rejectlimit

在拒绝了指定数量的行后，操作将出错。

rejectlimit：编号

默认值：0

removequotes

删除源文件中任何字段周围的引码。

removequotes: true

默认值：False

skipheaders

指定应从文件开头跳过多少行。

skipheaders：编号

默认值：0（如果未指定），1（如果未指定值）

territory

指定地区名称以进一步确定输入数据特征。

territory：字符串

默认值：Null

有关 Oracle 支持的语言的列表，请参阅 Oracle Database 19c Database Globalization Support Guide 中的 Locale Data 或 Oracle Database 23ai Database Globalization Support Guide 。

timestampformat

指定源文件中的的时间戳格式。格式选项 AUTO 将搜索以下格式：

YYYY-MM-DD HH:MI:SS.FF
YYYY-MM-DD HH:MI:SS.FF3
YYYY-MM-DD HH24:MI:SS.FF3
MM/DD/YYYY HH:MI:SS.FF3

timestampformat：字符串

默认值：数据库时间戳格式

该字符串可以包含通配符，例如 "$"。

timestampltzformat

指定源文件中带本地时区的时间戳格式。格式选项 AUTO 将搜索以下格式：

DD Mon YYYY HH:MI:SS.FF TZR
MM/DD/YYYY HH:MI:SS.FF TZR
YYYY-MM-DD HH:MI:SS+/-TZR
YYYY-MM-DD HH:MI:SS.FF3
DD.MM.YYYY HH:MI:SS TZR

timestampltzformat：字符串

默认值：具有本地时区格式的数据库时间戳

timestamptzformat

指定源文件中带有时区的时间戳格式。格式选项 AUTO 将搜索以下格式：

DD Mon YYYY HH:MI:SS.FF TZR  MM/DD/YYYY HH:MI:SS.FF TZR  YYYY-MM-DD HH:MI:SS+/-TZR  YYYY-MM-DD HH:MI:SS.FF3  DD.MM.YYYY HH:MI:SS TZR

timestamptzformat：字符串

默认值：具有时区格式的数据库时间戳

trimspaces

指定如何截截取字段中的前导空格和尾随空格。

请参见 Oracle Database 19c Utilities 或 Oracle Database 23ai Utilities 中的 trim_spec 说明。

trimspaces: rtrim| ltrim| notrim| lrtrim| ldrtrim

默认值：notrim

truncatecol

如果文件中的数据太长，无法放在一个字段中，则此选项将截断该字段的值，而不是拒绝行。

truncatecol:true

默认值：False

type

指定源文件类型。

请参阅 Oracle Database 19c Utilities 或 Oracle Database 23ai Utilities 中的 CSV 说明。

如果 type 为 datapump，则唯一的其他有效格式选项为 rejectlimit。

如果 type 为 datapump，则支持的唯一对象存储是 Oracle Cloud Infrastructure Object Storage 和 Oracle Cloud Infrastructure Object Storage Classic。

有关 type 值 avro、orc 或 parquet，请参见 DBMS_CLOUD Package Format Options for Avro、ORC 或 Parquet 。

对于具有 DBMS_CLOUD.COPY_COLLECTION type 的 JSON 数据，有两个有效值：json（默认值）和 ejson。对于 DBMS_CLOUD.COPY_COLLECTION，这两个值都指定输入是 JSON 数据。值 ejson 将导致文本 JSON 输入数据中的扩展对象转换为本机二进制 JSON 集合中的标量 JSON 值。值 json 不会执行此转换，并且输入数据中的所有对象都将转换为二进制 JSON 格式。

对于 DBMS_CLOUD.COPY_DATA 为 type 的 JSON 数据，有一个有效值：json。此值指定输入是 JSON 数据。

有关加载 JSON 对象的信息，请参见 COPY_COLLECTION Procedure 。
See Textual JSON Objects that Represent Extended Scalar Values for information about extended JSON objects, which are interpreted when parameter type has value ejson.

注：并非所有 DBMS_CLOUD 过程都支持所有这些类型。

csv 与 csv without embedded 相同。

默认值：Null

对于 JSON 数据，有两个用于 DBMS_CLOUD.COPY_COLLECTION 的有效 type 值：json|ejson。在这种情况下，默认值为 json。对于带有 DBMS_CLOUD.COPY_DATA 的 JSON 数据，只有 json 有效。

unpackarrays

仅与 COPY_COLLECTION 一起使用

当设置为 true 时，如果加载的文档是数组，则数组的内容将作为文档而不是数组本身加载。这仅适用于顶层数组。

设置为 true 时，整个数组将作为单个文档插入。

此选项仅对具有 DBMS_CLOUD.COPY_COLLECTION 的 JSON 收集数据有效。

unpackarrays: true

默认值：False

DBMS_CLOUD 程序包格式选项

相关内容