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)
如格式选项列中所述,在 format
type
为 JSON 时,一组有限的格式选项对 DBMS_CLOUD.COPY_COLLECTION
或 DBMS_CLOUD.COPY_DATA
有效。
格式选项 | 说明 | 语法 |
---|---|---|
|
设置为 |
默认值: |
使用 |
指定源文件的字符集 |
默认值:数据库字符集 |
仅与 |
与需要从 JSON 记录中提取的字段相对应的 JSON 路径表达式的数组。数组中的每个 JSON 路径表达式都应遵循 Oracle Database 19c JSON Developer's Guide 或 Oracle Database 23ai JSON Developer's Guide 中 SQL/JSON Path Expressions 中所述的规则。 仅与 JSON 和 |
以字符串格式表示的 json 路径表达式的 JSON 数组。例如:'columnpath' value |
选项对 JSON 数据有效 |
指定源文件的压缩类型。 不支持 ZIP 归档格式。 指定值 |
默认值:空值,表示无压缩。 |
|
如果行因数据类型转换错误而被拒绝,则相关列将存储为空值或相应行被拒绝。 |
默认值: |
|
指定源文件中的日期格式。格式选项 J MM-DD-YYYYBC MM-DD-YYYY YYYYMMDD HHMISS YYMMDD HHMISS YYYY.DDD YYYY-MM-DD |
默认值:数据库日期格式 |
|
指定字段分隔符。 要使用特殊字符作为分隔符,请指定字符的 ASCII 代码的 HEX 值。例如,以下语句将 TAB 字符指定为分隔符:
|
默认值 |
|
指定外部数据文件中的字段的顺序与表中的列不同。使用每个外部数据文件的第一行检测字段的顺序,并将其映射到表的列。以不区分大小写的方式将外部数据文件中的字段名称与表列的名称进行比较。 此格式选项适用于以下过程:
有关详细信息,请参阅 Oracle Database 19c Utilities 或 Oracle Database 23ai Utilities 中的 FIELD NAMES 以及 |
默认值: |
|
格式选项
例如: format => JSON_OBJECT('enablelogs' value FALSE) |
默认值: |
|
格式选项 使用
如果未为这些参数指定值,则块密码链接修饰符和块密码填充修饰符值默认为 格式选项
encryption 与以下 DBMS_CLOUD 过程一起使用:
例如: 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 字符串:
指定加密类型。
指定用于存储加密密钥的身份证明。 user_defined_function: value 指定用于解密或加密指定 BLOB(二进制大对象)的全限定用户定义函数。 |
|
数据可以用 例如: format => JSON_OBJECT(‘quote’ value ‘(’, ‘endquote’ value ‘)’) |
默认值为 Null,表示无 |
|
指定此项后,字符 "\" 用作转义符。 |
默认值: |
选项对 JSON 数据有效 |
设置为 true 时,将忽略空行。 |
默认值: |
|
如果 |
默认值 |
仅与 |
用于标识要加载的文档的 JSON 路径。 此选项仅对具有 |
默认值:空值 |
keyassignment 仅与 |
指定是将新集合创建为与 mongo 兼容的集合还是 SODA 集合。 当该值设置为 默认情况下,不设置此参数,这意味着将创建一个新集合作为 SODA 集合。 |
默认值:未设置 |
仅与 |
指定要作为 如果指定了 将值设置为路径,例如 此参数是可选的,仅适用于加载到与 Mongo 兼容的集合。 如果未指定,则 Oracle 将生成一个 12 字节的唯一系统 ID,并将该 ID 填充为 |
默认值:未设置 设置 |
|
指定语言名称(例如,FRENCH),从语言可以派生区域设置相关信息。 |
默认值:空值 有关 Oracle 支持的语言列表,请参阅 Oracle Database 19c Database Globalization Support Guide 中的 Locale Data 或 Oracle Database 23ai Database Globalization Support Guide 。 |
|
指定用于确定保存 缺省情况下, 例如:
上面的示例中指定的
上面的示例中指定的 |
默认值: |
|
指定用于确定 日志表名称格式为: logprefix 默认情况下,logprefix 为大写,但当指定的值用双引号括起来时,会保留大小写。 例如: format => JSON_OBJECT ('logprefix' value 'TEST') 然后,日志文件使用 |
默认值: |
|
指定保留 有效值: 例如: format => JSON_OBJECT ('logretention' value 7) |
默认值: |
此选项仅对 JSON 数据有效 |
JSON 文档的最大大小。 |
默认值:1 兆字节 允许的最大值:2 GB |
|
指定要用作组分隔符和小数字符的字符。 decimal_character :小数将数字的整数部分与小数部分分隔开。 group_separator :组分隔符用于分隔整数组(即千、百万、数十亿等)。 |
默认值: 有关更多信息,请参见 NLS_NUMERIC_CHARACTERS Oracle Database 19c Database Globalization Support Guide Oracle Database 23ai Database Globalization Support Guide 。 |
|
指定数字格式模型。数字格式模型会导致数字舍入到指定的有效位数。数字格式模型由一个或多个数字格式元素组成。 这与 |
默认值:派生自 有关详细信息,请参阅 Oracle Database 19c SQL Language Reference 中的 Number Format Models 或 Oracle Database 23ai SQL Language Reference 。 |
|
格式选项
如果数据文件是非结构化的,并且使用 对于不基于蜂窝格式的对象名称, |
|
|
指定字段的引号字符,如果指定了此项,在加载期间将删除 |
默认值:Null 表示无引号 |
选项对 JSON 数据有效 |
指定记录分隔符。 缺省情况下, 如果要覆盖默认行为,请显式指定此参数,例如:
要指示没有记录分隔符,可以指定输入文件中未出现的
|
默认值:检测到换行符 |
|
格式选项
将 当 URI 中的文件名或子文件夹路径仅支持正则表达式模式,并且模式匹配与 对于外部表,仅对象存储中对文件创建的表支持此选项。 例如:
有关 |
默认值: |
|
在拒绝了指定数量的行后,操作将出错。 |
默认值: |
|
删除源文件中任何字段两端的引号。 |
默认值: |
|
指定应从文件开头跳过多少行。 |
默认值:0(如果未指定),1(如果未指定值) |
|
指定地区名称以进一步确定输入数据特性。 |
默认值:空值 有关 Oracle 支持的语言列表,请参阅 Oracle Database 19c Database Globalization Support Guide 中的 Locale Data 或 Oracle Database 23ai Database Globalization Support Guide 。 |
|
指定源文件中的时间戳格式。格式选项 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 |
默认值:数据库时间戳格式 字符串中可以包含通配符字符,例如 "$"。 |
|
指定源文件中具有本地时区格式的时间戳。格式选项 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 |
默认值:具有本地时区的数据库时间戳格式 |
|
指定源文件中具有时区格式的时间戳。格式选项 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 |
默认值:带时区的数据库时间戳格式 |
|
指定如何截取字段中的前导空格和尾随空格。 请参阅 Oracle Database 19c Utilities 或 Oracle Database 23ai Utilities 中 trim_spec 的说明。 |
默认值: |
|
如果文件中的数据太长,无法放在一个字段中,则此选项将截断该字段的值,而不是拒绝行。 |
默认值: |
|
指定源文件类型。 请参阅 Oracle Database 19c Utilities 或 Oracle Database 23ai Utilities 中 CSV 的说明。 如果 如果 有关 对于 对于
|
注意: 并非所有DBMS_CLOUD 过程都支持所有这些类型。
默认值:空值 对于 JSON 数据,有两个用于 |
仅与 |
设置为 设置为 此选项仅对具有 |
默认值: |