Opciones de formato del paquete DBMS_CLOUD

El argumento format en DBMS_CLOUD especifica el formato de los archivos de origen.

Las dos formas de especificar el argumento de formato son las siguientes:

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

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

Ejemplos:

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

Para especificar varias opciones del formato, separe los valores con una ",", como se muestra a continuación:

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

Nota: para las opciones de formato Avro, ORC o Parquet, consulte Opciones de formato de paquete DBMS_CLOUD para Avro, ORC o Parquet.

Como se indica en la columna Opción de formato, un juego limitado de opciones de formato es válido con DBMS_CLOUD.COPY_COLLECTION o con DBMS_CLOUD.COPY_DATA cuando format type es JSON.

Opción de formato Descripción Sintaxis

Opción de formato	Descripción	Sintaxis
`blankasnull`	Si se define en `true`, carga los campos formados por espacios como nulos.	`blankasnull` `: true` Valor por defecto: `False`
`characterset` Válido con JSON `format` y `COPY_DATA`	Especifica el juego de caracteres de los archivos de origen	`characterset`: cadena Valor por defecto: juego de caracteres de base de datos
`columnpath` Utilizar solo con JSON `format` y `COPY_DATA`	Matriz de expresiones de ruta de acceso JSON que corresponden a los campos que se deben extraer de los registros JSON. Cada una de las expresiones de ruta de acceso JSON de la matriz debe seguir las reglas descritas en SQL/JSON Path Expressions en Oracle Database 19c JSON Developer's Guide u Oracle Database 26ai JSON Developer's Guide. Utilice solo con formato JSON y `DBMS_CLOUD.COPY_DATA`.	Matriz de JSON de expresiones de ruta de json expresadas en formato de cadena. Por ejemplo: 'columnpath' value `'["$.WEATHER_STATION_ID", "$.WEATHER_STATION_NAME"]'`
`compression` Opción válida con datos JSON	Especifica el tipo de compresión del archivo de origen. El formato de archivado ZIP no está soportado. Al especificar el valor `auto`, se compueban los tipos de compresión: `gzip, zlib, std, bzip2`.	`compression`: `auto\|gzip\|zlib\|bzip2` Valor por defecto: valor nulo que no significa compresión.
`conversionerrors`	Si una fila se rechaza por errores de conversión de tipo de datos, las columnas relacionadas se almacenarán como nulas o bien la fila se rechazará.	`conversionerrors` : `reject_record \| store_null` Valor por defecto: `reject_record`
`dateformat`	Especifica el formato de fecha en el archivo de origen. La opción de formato `AUTO` busca los siguientes formatos: J MM-DD-YYYYBC MM-DD-YYYY YYYYMMDD HHMISS YYMMDD HHMISS YYYY.DDD YYYY-MM-DD	`dateformat`: cadena Valor por defecto: formato de fecha de base de datos
`delimiter`	Especifica el delimitador de campo. Para utilizar un carácter especial como delimitador, especifique el valor HEX del código ASCII del carácter. Por ejemplo, a continuación se especifica el carácter de tabulador como delimitador: `format => json_object('delimiter' value 'X''9''')`	`delimiter`: carácter Valor por defecto `\|` (carácter de pippe)
`detectfieldorder`	Especifica que los campos de los archivos de datos externos están en un orden diferente al de las columnas de la tabla. Detecte el orden de los campos mediante la primera fila de cada archivo de datos externo y asígnelo a las columnas de la tabla. Los nombres de campo de los archivos de datos externos se comparan de forma no sensible a mayúsculas/minúsculas con los nombres de las columnas de la tabla. Esta opción de formato se aplica a los siguientes procedimientos: `DBMS_CLOUD.COPY_DATA` `DBMS_CLOUD.CREATE_EXTERNAL_TABLE` `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` `DBMS_CLOUD.CREATE_HYBRID_PART_TABLE` Restricciones para `detectfieldorder`: Los nombres de campo del archivo de datos deben aparecer en la primera línea de registro y no deben contener espacios en blanco entre los nombres de campo. El delimitador de campo del registro de nombres de campo debe ser el mismo que el delimitador de campo para los datos del archivo. Los nombres de campo entre comillas no están soportados. Los nombres de campo de los archivos de datos se comparan, de forma no sensible a mayúsculas/minúsculas, con los nombres de las columnas de la tabla externa. Los delimitadores de campo incrustados no están permitidos en los nombres de campo. El número de columnas de la tabla debe coincidir con el número de campos de los archivos de datos. Esta opción de formato no se aplica a los formatos de Bigdata u Oracle Data Pump, ya que esos formatos tienen información de metadatos de columna precisa en el formato de archivo binario. Los formatos de texto, CSV, JSON, Parquet o XML pueden beneficiarse de esta detección automática del orden de los campos cuando la primera línea contiene los nombres de los campos. Consulte FIELD NAMES en Oracle Database 19c Utilities u Oracle Database 23ai Utilities y la descripción de `ALL FILES` para obtener más información.	`detectfieldorder: true` Valor por defecto: `false`
`enablelogs`	La opción de formato `enablelogs` se utiliza con los siguientes procedimientos `DBMS_CLOUD`: `COPY_DATA` `COPY_COLLECTION` `EXPORT_DATA` `enablelogs` especifica un valor booleano; cuando se define en `TRUE`, se generan logs. Cuando se define en `FALSE`, los logs no se generan. Por ejemplo: `format => JSON_OBJECT('enablelogs' value FALSE)`	`enablelogs: false` Valor por defecto: `true`
`encryption`	La opción de formato `encryption` especifica las opciones de cifrado y descifrado para exportar e importar datos desde y hacia el almacén de objetos. Utilice `encryption` para especificar los siguientes parámetros para cifrar y descifrar: `user_defined_function`: especifica una función definida por el usuario totalmente cualificada para descifrar o cifrar el BLOB especificado (objeto grande binario). Devuelve un BLOB descifrado o cifrado. `user_defined_function` se excluye mutuamente con otros parámetros para `encryption`. Por ejemplo, `ADMIN.DECRYPTION_CALLBACK`. `type`: especifica el algoritmo de cifrado `DBMS_CRYPTO` para descifrar o cifrar. `type` acepta valores en el formato Algoritmos de cifrado de bloque + Modificadores de encadenamiento de cifrado de bloque + Modificadores de relleno de cifrado de bloque. Los algoritmos de cifrado de bloques soportados son: `DBMS_CRYPTO.ENCRYPT_AES256` Los modificadores de encadenamiento de cifrado de bloques soportados son: `DBMS_CRYPTO.CHAIN_CBC` `DBMS_CRYPTO.CHAIN_CFB` `DBMS_CRYPTO.CHAIN_ECB` `DBMS_CRYPTO.CHAIN_OFB` Los modificadores de relleno de cifrado de bloque soportados son: `DBMS_CRYPTO.PAD_PKCS5` `DBMS_CRYPTO.PAD_NONE` `DBMS_CRYPTO.PAD_ZERO` `DBMS_CRYPTO.PAD_ORCL` `credential_name`: especifica la credencial utilizada para almacenar la clave de cifrado. Los valores de Modificadores de Encadenamiento de Cifrado de Bloques y Modificadores de Relleno de Cifrado de Bloques se definen por defecto en `DBMS_CRYPTO.CHAIN_CBC` y `DBMS_CRYPTO.PAD_PKCS5`, si no especifica valores para estos parámetros. La opción de formato `encryption` se utiliza con los siguientes procedimientos `DBMS_CLOUD`: Se utiliza para transferir parámetros para descifrar para estos procedimientos: `DBMS_CLOUD.COPY_DATA` `DBMS_CLOUD.CREATE_EXTERNAL_TABLE` `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` `DBMS_CLOUD.CREATE_HYBRID_PART_TABLE` Para `DBMS_CLOUD.CREATE_HYBRID_PART_TABLE`, esta opción solo se aplica a los archivos de Object Storage. `DBMS_CLOUD.COPY_COLLECTION` Se utiliza para transferir parámetros para cifrar para este procedimiento: `DBMS_CLOUD.EXPORT_DATA` Por ejemplo: `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` Donde el valor es una cadena JSON que proporciona parámetros adicionales para el cifrado: `type`: valor Especifica el tipo de cifrado. `credential_name`: `value` Especifica la credencial utilizada para almacenar la clave de cifrado. `user_defined_function: value` Especifica una función definida por el usuario totalmente cualificada para descifrar o cifrar el BLOB especificado (objeto grande binario).
`endquote`	Los datos se pueden incluir entre dos delimitadores, especificados con `quote` y `endquote`. Los caracteres `quote` y `endquote` se eliminan durante la carga cuando se especifica. Por ejemplo: `format => JSON_OBJECT('quote' value '(', 'endquote' value ')')`	`endquote:character` Valor predeterminado: nulo, lo que significa que no hay `endquote`.
`escape`	El carácter "\" se utiliza como carácter de escape cuando se especifica.	`escape` `: true` Valor por defecto: `false`
`ignoreblanklines` Opción válida con datos JSON	Las líneas en blanco se ignoran cuando están definidas en true.	`ignoreblanklines` `: true` Valor por defecto: `False`
`ignoremissingcolumns`	Si hay más columnas en `field_list` que en los archivos de origen, las columnas adicionales se almacenan como nulas.	`ignoremissingcolumns` `: true` Valor por defecto `False`
`jsonpath` Utilizar solo con `COPY_COLLECTION`	Ruta de JSON para identificar el documento que se va a cargar. Esta opción solo es válida para los datos de recopilación de JSON con `DBMS_CLOUD.COPY_COLLECTION`.	`jsonpath`: cadena Valor por defecto: Valores nulos
`keyassignment` Usar solo con `COPY_COLLECTION`	Especifica si una nueva recopilación se crea como una recopilación compatible con mongo o como una recopilación de SODA. Cuando el valor se define en `embedded_oid`, se crea una nueva recopilación como una recopilación compatible con mongo. Por defecto, este parámetro no está definido, lo que significa que se crea una nueva recopilación como una recopilación de SODA.	`keyassignment`: `embedded_oid` Valor por defecto: `keyassignment` no está definido
`keypath` Utilizar solo con `COPY_COLLECTION`	Especifica un atributo en los datos que se van a cargar como valor `'_id'`. Si se especifica `keypath`, también debe especificar el valor `keyassignment` como `embedded_oid`. Defina el valor en una ruta de acceso, por ejemplo, `'$.mykey'`, para seleccionar el valor de la ruta como valor `'_id'`. Este parámetro es opcional y solo es válido para cargar en recopilaciones compatibles con mongo. Si no se especifica, Oracle genera un ID de sistema único de 12 bytes y lo rellena como atributo `'_id'`, si un atributo `'_id'` aún no está presente en los datos que se están cargando.	`keypath`: `string` Valor por defecto: `keypath` no está definido. Cuando se define `keypath`, el valor de cadena por defecto es `NULL`.
`language`	Especifica un nombre de idioma (por ejemplo, FRENCH), a partir del cual se puede derivar información confidencial de la configuración regional.	`language`: cadena Valor por defecto: Valores nulos Consulte datos de configuración local en Oracle Database 19c Database Globalization Support Guide o Oracle Database 23ai Database Globalization Support Guide para obtener una lista de las lenguas soportadas por Oracle.
`logdir`	Especifica un valor de cadena que determina el nombre del objeto de directorio donde se guardan los archivos `logfile_table` o `badfile_table`. Por defecto, `logdir` no distingue entre mayúsculas y minúsculas, pero las mayúsculas y minúsculas se reservan cuando el valor especificado está entre comillas dobles. Por ejemplo: `format => JSON_OBJECT ('logdir' value 'test_log')` La opción de formato `logdir` especificada en el ejemplo anterior guarda los archivos `logfile_table` o `badfile_table` en el objeto de directorio `TEST_LOG`. `format => JSON_OBJECT ('logdir' value '"test_log"')` La opción de formato `logdir` especificada en el ejemplo anterior guarda los archivos `logfile_table` o `badfile_table` en el objeto de directorio `test_log`.	`logdir`: cadena Valor por defecto: `DATA_PUMP_DIR`
`logprefix`	Especifica un valor de cadena que determina el prefijo para los archivos `logfile_table` y `badfile_table`. El formato del nombre de la tabla de logs es: logprefix`$`operation_id Por defecto, el prefijo de log está en mayúsculas, pero el caso está reservado cuando el valor especificado está entre comillas dobles. Por ejemplo: `format => JSON_OBJECT ('logprefix' value 'TEST')` A continuación, los archivos log utilizan el prefijo `TEST`, como `TEST$2_LOG` y `TEST$2_BAD`.	`logprefix`: cadena Valor por defecto: `COPY`
`logretention`	Especifica una duración de entero positivo, en días, para la que se conservan los archivos `logfile_table` y `badfile_table`. Valores válidos: de `0` a `99999` Por ejemplo: `format => JSON_OBJECT ('logretention' value 7)`	`logretention`: número Valor por defecto: `2`
`maxdocsize` Esta opción solo es válida con datos JSON	Tamaño máximo de documentos JSON.	`maxdocsize`: número Valor por defecto: 1 megabyte Valor máximo permitido: 2 GB
`numericcharacters`	Especifica los caracteres que se van a utilizar como separador de grupo y carácter decimal. decimal_character: el decimal separa la parte entera de un número de la parte decimal. group_separator: el Separador de grupo separa grupos enteros (es decir, miles, millones, miles de millones), etc.).	`numericcharacters: 'decimal_character group_separator'` Valor por defecto: `".,"` Consulte NLS_NUMERIC_CHARACTERS Guía de soporte de globalización de bases de datos de Oracle Database 19c Guía de soporte de globalización de bases de datos de Oracle Database 23ai para obtener más información.
`numberformat`	Especifica el modelo de formato de número. Los modelos de formato de número hacen que el número se redondee al número especificado de dígitos significativos. Un modelo de formato de número está compuesto por uno o más elementos de formato de número. Se utiliza en combinación con `numericcharacters`.	`numberformat: number_format_model` Valor por defecto: se deriva de la configuración del parámetro `NLS_TERRITORY` Consulte Modelos de formato numérico en Referencia de lenguaje SQL de Oracle Database 19c o Referencia de lenguaje SQL de Oracle Database 23ai para obtener más información.
`partition_columns`	La opción de formato `partition_columns` se utiliza con `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` para especificar los nombres de columna y los tipos de dato de las columnas de partición cuando las columnas de partición se derivan de la ruta de archivo, según el tipo de archivo de datos, estructurado o no estructurado: Cuando `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` incluye el parámetro `column_list` y el archivo de datos no está estructurado, como los archivos de texto CSV, `partition_columns` no incluye el tipo de dato. Por ejemplo, utilice un formato como el siguiente para este tipo de especificación `partition_columns`: `'"partition_columns":["state","zipcode"]'` El tipo de dato no es necesario porque se especifica en el parámetro `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` `column_list`. Cuando `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` no incluye el parámetro `column_list` y los archivos de datos están estructurados, como archivos Avro, ORC o Parquet, la opción `partition_columns` incluye el tipo de dato. Por ejemplo, a continuación se muestra una especificación `partition_columns`: `'"partition_columns":[{"name":"country", "type":"varchar2(10)"}, {"name":"year", "type":"number"}, {"name":"month", "type":"varchar2(10)"}]'` Si los archivos de datos no están estructurados y la subcláusula `type` se especifica con `partition_columns`, se ignora la subcláusula `type`. Para los nombres de objeto que no se basan en el formato hive, el orden de las columnas especificadas `partition_columns` debe coincidir con el orden en el que aparecen en el nombre de objeto en `file_uri_list`.
`quote`	Especifica el carácter de comilla para los campos. Los caracteres de `quote` se eliminan durante el proceso de carga cuando se especifica.	`quote`: carácter Valor predeterminado: Null significa que no hay comillas
`recorddelimiter` Opción válida con datos JSON	Especifica el delimitador de registro. Por defecto, `DBMS_CLOUD` intenta buscar automáticamente el carácter de nueva línea correcto como delimitador. Primero busca el carácter de línea nueva "`\r\n`" de Windows en el archivo. Si encuentra el carácter en línea nueva de Windows, este se utiliza como delimitador de registro para todos los archivos del procedimiento. If a Windows newline character is not found, it searches for the UNIX/Linux newline character "`\n`" and if it finds one it uses "`\n`" as the record delimiter for all files in the procedure. Especifique este argumento explícitamente si desea sustituir el comportamiento por defecto, por ejemplo: `format => json_object('recorddelimiter' VALUE '''\r\n''')` Para indicar que no hay ningún delimitador de registro, puede especificar un `recorddelimiter` que no se produzca en el archivo de entrada. Por ejemplo, para indicar que no hay delimitador, especifique el carácter de control 0x01 (SOH) como valor para `recorddelimiter` y defina el valor `recorddelimiter` en `"0x''01''"` (este carácter no se produce en el texto JSON). Por ejemplo: `format => '{"recorddelimiter" : "0x''01''"}'` `recorddelimiter` se define una vez por llamada de procedimiento. Si utiliza el valor predeterminado, `detected newline`, todos los archivos utilizan el mismo delimitador de registro, si se detecta uno.	`recorddelimiter`: carácter Valor por defecto: nueva línea detectada
`regexuri`	La opción de formato `regexuri` se utiliza con los siguientes procedimientos DBMS_CLOUD: `COPY_COLLECTION` `COPY_DATA` `CREATE_EXTERNAL_TABLE` `CREATE_EXTERNAL_PART_TABLE` `CREATE_HYBRID_PART_TABLE` Cuando el valor de `regexuri` se define en `TRUE`, puede utilizar comodines y expresiones regulares en los nombres de archivo en los URI de archivo de origen de nube. Los caracteres "" y "?" se consideran caracteres comodín cuando el parámetro `regexuri` se define en `FALSE`. Cuando el parámetro `regexuri` se define en `TRUE`, los caracteres "" y "?" forman parte del patrón de expresión regular especificado. Los patrones de expresión regular solo están soportados para el nombre de archivo o la ruta de subcarpeta en los URI y la coincidencia de patrones es idéntica a la realizada por la función `REGEXP_LIKE`. Los patrones de expresión regular no están soportados para los nombres de directorio. En el caso de las tablas externas, esta opción solo está soportada con las tablas que se crean en un archivo de Object Storage. Por ejemplo: `format => JSON_OBJECT('regexuri' value TRUE)` Consulte Condición REGEXP_LIKE en Referencia de lenguaje SQL de Oracle Database 19c o Referencia de lenguaje SQL de Oracle Database 23ai para obtener más información sobre la condición `REGEXP_LIKE`.	`regexuri`: `True` Valor por defecto: `False`
`rejectlimit`	Esta operación dará error después de que se haya rechazado un número especificado de filas.	`rejectlimit`: número Valor por defecto: `0`
`removequotes`	Elimina todas las comillas que se encuentren en cualquier campo del archivo de origen.	`removequotes`: `true` Valor por defecto: `False`
`skipheaders`	Especifica cuántas filas se deberían omitir desde el principio del archivo.	`skipheaders`: número Valor predeterminado: 0 si no se ha especificado, 1 si se ha especificado sin un valor
`territory`	Especifica un nombre de territorio para determinar aún más las características de los datos de entrada.	`territory`: cadena Valor por defecto: Nulos Consulte datos de configuración local en Oracle Database 19c Database Globalization Support Guide o Oracle Database 23ai Database Globalization Support Guide para obtener una lista de las lenguas soportadas por Oracle.
`timestampformat`	Especifica el formato de registro de hora en el archivo de origen. La opción de formato `AUTO` busca los siguientes formatos: 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`: cadena Valor por defecto: formato de registro de hora de base de datos La cadena puede contener caracteres comodín como "$".
`timestampltzformat`	Especifica el registro de hora con formato de zona horaria local en el archivo de origen. La opción de formato `AUTO` busca los siguientes formatos: 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`: cadena Valor por defecto: Registro de hora de la base de Datos con formato de zona horaria local
`timestamptzformat`	Especifica el registro de hora con formato de zona horaria en el archivo de origen. La opción de formato `AUTO` busca los siguientes formatos: 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`: cadena Valor por defecto: Registro de hora de la base de Datos con formato de zona horaria
`trimspaces`	Especifica cómo se recortan los espacios iniciales y finales de los campos. Consulte la descripción de trim_spec en Oracle Database 19c Utilities u Oracle Database 23ai Utilities.	`trimspaces`: `rtrim\| ltrim\| notrim\| lrtrim\| ldrtrim` Valor por defecto: `notrim`
`truncatecol`	Si los datos del archivo son demasiado largos para un campo, esta opción truncará el valor del campo en lugar de rechazar la fila.	`truncatecol`:`true` Valor por defecto: `False`
`type`	Especifica el tipo de archivo de origen. Consulte la descripción de CSV en Oracle Database 19c Utilities u Oracle Database 23ai Utilities. Si `type` es `datapump`, la única otra opción de formato válida es `rejectlimit`. Si `type` es `datapump`, los únicos almacenes de objetos soportados son Oracle Cloud Infrastructure Object Storage y Oracle Cloud Infrastructure Object Storage Classic. Consulte Opciones de formato del paquete DBMS_CLOUD para Avro, ORC o Parquet para los valores `type` `avro`, `orc` o `parquet`. Para los datos JSON con `DBMS_CLOUD.COPY_COLLECTION`, `type` tiene dos valores válidos: `json` (valor por defecto) y `ejson`. Para `DBMS_CLOUD.COPY_COLLECTION`, estos valores especifican que la entrada es datos JSON. El valor `ejson` hace que los objetos ampliados de los datos de entrada JSON textuales se traduzcan a valores JSON escalares en la recopilación de JSON binaria nativa. El valor `json` no realiza esta transformación y todos los objetos de los datos de entrada se convierten al formato JSON binario. Para los datos JSON con `DBMS_CLOUD.COPY_DATA`, `type` tiene un valor válido: `json`. Este valor especifica que la entrada es datos JSON. Consulte Procedimiento COPY_COLLECTION para obtener información sobre la carga de objetos JSON. Consulte Objetos JSON textuales que representan valores escalares ampliados para obtener información sobre los objetos JSON ampliados, que se interpretan cuando el parámetro `type` tiene el valor `ejson`.	`type`: `csv` \| `csv with embedded` \| `csv without embedded` \| `avro` \| `datapump`\| `orc` \| `parquet` Nota: No todos los procedimientos `DBMS_CLOUD` admiten todos estos tipos. `csv` es lo mismo que `csv without embedded`. Valor por defecto: Nulos Para los datos JSON, hay dos valores `type` válidos para su uso con `DBMS_CLOUD.COPY_COLLECTION`: `json`\|`ejson`. En este caso, el valor por defecto es `json`. Para los datos JSON con `DBMS_CLOUD.COPY_DATA`, solo `json` es válido.
`unpackarrays` Utilizar solo con `COPY_COLLECTION`	Si se define en `true`, si un documento cargado es una matriz, el contenido de la matriz se carga como documentos en lugar de la propia matriz. Esto solo se aplica a la matriz de nivel superior. Cuando se define en `true`, toda la matriz se inserta como un solo documento. Esta opción solo es válida para los datos de recopilación de JSON con `DBMS_CLOUD.COPY_COLLECTION`.	`unpackarrays: true` Valor por defecto: `False`

blankasnull

Si se define en true, carga los campos formados por espacios como nulos.

blankasnull : true

Valor por defecto: False

characterset

Válido con JSON format y COPY_DATA

Especifica el juego de caracteres de los archivos de origen

characterset: cadena

Valor por defecto: juego de caracteres de base de datos

columnpath

Utilizar solo con JSON format y COPY_DATA

Matriz de expresiones de ruta de acceso JSON que corresponden a los campos que se deben extraer de los registros JSON. Cada una de las expresiones de ruta de acceso JSON de la matriz debe seguir las reglas descritas en SQL/JSON Path Expressions en Oracle Database 19c JSON Developer's Guide u Oracle Database 26ai JSON Developer's Guide.

Utilice solo con formato JSON y DBMS_CLOUD.COPY_DATA.

Matriz de JSON de expresiones de ruta de json expresadas en formato de cadena. Por ejemplo: 'columnpath' value '["$.WEATHER_STATION_ID", "$.WEATHER_STATION_NAME"]'

compression

Opción válida con datos JSON

Especifica el tipo de compresión del archivo de origen.

El formato de archivado ZIP no está soportado.

Al especificar el valor auto, se compueban los tipos de compresión: gzip, zlib, std, bzip2.

compression: auto|gzip|zlib|bzip2

Valor por defecto: valor nulo que no significa compresión.

conversionerrors

Si una fila se rechaza por errores de conversión de tipo de datos, las columnas relacionadas se almacenarán como nulas o bien la fila se rechazará.

conversionerrors : reject_record | store_null

Valor por defecto: reject_record

dateformat

Especifica el formato de fecha en el archivo de origen. La opción de formato AUTO busca los siguientes formatos:

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

dateformat: cadena

Valor por defecto: formato de fecha de base de datos

delimiter

Especifica el delimitador de campo.

Para utilizar un carácter especial como delimitador, especifique el valor HEX del código ASCII del carácter. Por ejemplo, a continuación se especifica el carácter de tabulador como delimitador:

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

delimiter: carácter

Valor por defecto | (carácter de pippe)

detectfieldorder

Especifica que los campos de los archivos de datos externos están en un orden diferente al de las columnas de la tabla. Detecte el orden de los campos mediante la primera fila de cada archivo de datos externo y asígnelo a las columnas de la tabla. Los nombres de campo de los archivos de datos externos se comparan de forma no sensible a mayúsculas/minúsculas con los nombres de las columnas de la tabla.

Esta opción de formato se aplica a los siguientes procedimientos:

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

Restricciones para detectfieldorder:

Los nombres de campo del archivo de datos deben aparecer en la primera línea de registro y no deben contener espacios en blanco entre los nombres de campo.
El delimitador de campo del registro de nombres de campo debe ser el mismo que el delimitador de campo para los datos del archivo.
Los nombres de campo entre comillas no están soportados. Los nombres de campo de los archivos de datos se comparan, de forma no sensible a mayúsculas/minúsculas, con los nombres de las columnas de la tabla externa.
Los delimitadores de campo incrustados no están permitidos en los nombres de campo.
El número de columnas de la tabla debe coincidir con el número de campos de los archivos de datos.
Esta opción de formato no se aplica a los formatos de Bigdata u Oracle Data Pump, ya que esos formatos tienen información de metadatos de columna precisa en el formato de archivo binario.
Los formatos de texto, CSV, JSON, Parquet o XML pueden beneficiarse de esta detección automática del orden de los campos cuando la primera línea contiene los nombres de los campos.

Consulte FIELD NAMES en Oracle Database 19c Utilities u Oracle Database 23ai Utilities y la descripción de ALL FILES para obtener más información.

detectfieldorder: true

Valor por defecto: false

enablelogs

La opción de formato enablelogs se utiliza con los siguientes procedimientos DBMS_CLOUD:

COPY_DATA
COPY_COLLECTION
EXPORT_DATA

enablelogs especifica un valor booleano; cuando se define en TRUE, se generan logs. Cuando se define en FALSE, los logs no se generan.

Por ejemplo:

format => JSON_OBJECT('enablelogs' value FALSE)

enablelogs: false

Valor por defecto: true

encryption

La opción de formato encryption especifica las opciones de cifrado y descifrado para exportar e importar datos desde y hacia el almacén de objetos.

Utilice encryption para especificar los siguientes parámetros para cifrar y descifrar:

user_defined_function: especifica una función definida por el usuario totalmente cualificada para descifrar o cifrar el BLOB especificado (objeto grande binario). Devuelve un BLOB descifrado o cifrado. user_defined_function se excluye mutuamente con otros parámetros para encryption.
Por ejemplo, ADMIN.DECRYPTION_CALLBACK.
type: especifica el algoritmo de cifrado DBMS_CRYPTO para descifrar o cifrar.
type acepta valores en el formato Algoritmos de cifrado de bloque + Modificadores de encadenamiento de cifrado de bloque + Modificadores de relleno de cifrado de bloque.
Los algoritmos de cifrado de bloques soportados son:
- DBMS_CRYPTO.ENCRYPT_AES256
Los modificadores de encadenamiento de cifrado de bloques soportados son:
- DBMS_CRYPTO.CHAIN_CBC
- DBMS_CRYPTO.CHAIN_CFB
- DBMS_CRYPTO.CHAIN_ECB
- DBMS_CRYPTO.CHAIN_OFB
Los modificadores de relleno de cifrado de bloque soportados son:
- DBMS_CRYPTO.PAD_PKCS5
- DBMS_CRYPTO.PAD_NONE
- DBMS_CRYPTO.PAD_ZERO
- DBMS_CRYPTO.PAD_ORCL

credential_name: especifica la credencial utilizada para almacenar la clave de cifrado.

Los valores de Modificadores de Encadenamiento de Cifrado de Bloques y Modificadores de Relleno de Cifrado de Bloques se definen por defecto en DBMS_CRYPTO.CHAIN_CBC y DBMS_CRYPTO.PAD_PKCS5, si no especifica valores para estos parámetros.

La opción de formato encryption se utiliza con los siguientes procedimientos DBMS_CLOUD:

Se utiliza para transferir parámetros para descifrar para estos procedimientos:
- DBMS_CLOUD.COPY_DATA
- DBMS_CLOUD.CREATE_EXTERNAL_TABLE
- DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE
- DBMS_CLOUD.CREATE_HYBRID_PART_TABLE
  Para DBMS_CLOUD.CREATE_HYBRID_PART_TABLE, esta opción solo se aplica a los archivos de Object Storage.
- DBMS_CLOUD.COPY_COLLECTION
Se utiliza para transferir parámetros para cifrar para este procedimiento:
- DBMS_CLOUD.EXPORT_DATA

Por ejemplo:

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

Donde el valor es una cadena JSON que proporciona parámetros adicionales para el cifrado:

type: valor

Especifica el tipo de cifrado.

credential_name: value

Especifica la credencial utilizada para almacenar la clave de cifrado.

user_defined_function: value

Especifica una función definida por el usuario totalmente cualificada para descifrar o cifrar el BLOB especificado (objeto grande binario).

endquote

Los datos se pueden incluir entre dos delimitadores, especificados con quote y endquote. Los caracteres quote y endquote se eliminan durante la carga cuando se especifica.

Por ejemplo:

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

endquote:character

Valor predeterminado: nulo, lo que significa que no hay endquote.

escape

El carácter "\" se utiliza como carácter de escape cuando se especifica.

escape : true

Valor por defecto: false

ignoreblanklines

Opción válida con datos JSON

Las líneas en blanco se ignoran cuando están definidas en true.

ignoreblanklines : true

Valor por defecto: False

ignoremissingcolumns

Si hay más columnas en field_list que en los archivos de origen, las columnas adicionales se almacenan como nulas.

ignoremissingcolumns : true

Valor por defecto False

jsonpath

Utilizar solo con COPY_COLLECTION

Ruta de JSON para identificar el documento que se va a cargar.

Esta opción solo es válida para los datos de recopilación de JSON con DBMS_CLOUD.COPY_COLLECTION.

jsonpath: cadena

Valor por defecto: Valores nulos

`keyassignment`

Usar solo con `COPY_COLLECTION`

Especifica si una nueva recopilación se crea como una recopilación compatible con mongo o como una recopilación de SODA.

Cuando el valor se define en embedded_oid, se crea una nueva recopilación como una recopilación compatible con mongo.

Por defecto, este parámetro no está definido, lo que significa que se crea una nueva recopilación como una recopilación de SODA.

keyassignment: embedded_oid

Valor por defecto: keyassignment no está definido

keypath

Utilizar solo con COPY_COLLECTION

Especifica un atributo en los datos que se van a cargar como valor '_id'.

Si se especifica keypath, también debe especificar el valor keyassignment como embedded_oid.

Defina el valor en una ruta de acceso, por ejemplo, '$.mykey', para seleccionar el valor de la ruta como valor '_id'.

Este parámetro es opcional y solo es válido para cargar en recopilaciones compatibles con mongo.

Si no se especifica, Oracle genera un ID de sistema único de 12 bytes y lo rellena como atributo '_id', si un atributo '_id' aún no está presente en los datos que se están cargando.

keypath: string

Valor por defecto: keypath no está definido.

Cuando se define keypath, el valor de cadena por defecto es NULL.

language

Especifica un nombre de idioma (por ejemplo, FRENCH), a partir del cual se puede derivar información confidencial de la configuración regional.

language: cadena

Valor por defecto: Valores nulos

Consulte datos de configuración local en Oracle Database 19c Database Globalization Support Guide o Oracle Database 23ai Database Globalization Support Guide para obtener una lista de las lenguas soportadas por Oracle.

logdir

Especifica un valor de cadena que determina el nombre del objeto de directorio donde se guardan los archivos logfile_table o badfile_table.

Por defecto, logdir no distingue entre mayúsculas y minúsculas, pero las mayúsculas y minúsculas se reservan cuando el valor especificado está entre comillas dobles.

Por ejemplo:

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

La opción de formato logdir especificada en el ejemplo anterior guarda los archivos logfile_table o badfile_table en el objeto de directorio TEST_LOG.

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

La opción de formato logdir especificada en el ejemplo anterior guarda los archivos logfile_table o badfile_table en el objeto de directorio test_log.

logdir: cadena

Valor por defecto: DATA_PUMP_DIR

logprefix

Especifica un valor de cadena que determina el prefijo para los archivos logfile_table y badfile_table.

El formato del nombre de la tabla de logs es: logprefix$operation_id

Por defecto, el prefijo de log está en mayúsculas, pero el caso está reservado cuando el valor especificado está entre comillas dobles.

Por ejemplo:

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

A continuación, los archivos log utilizan el prefijo TEST, como TEST$2_LOG y TEST$2_BAD.

logprefix: cadena

Valor por defecto: COPY

logretention

Especifica una duración de entero positivo, en días, para la que se conservan los archivos logfile_table y badfile_table.

Valores válidos: de 0 a 99999

Por ejemplo:

format => JSON_OBJECT ('logretention' value 7)

logretention: número

Valor por defecto: 2

maxdocsize

Esta opción solo es válida con datos JSON

Tamaño máximo de documentos JSON.

maxdocsize: número

Valor por defecto: 1 megabyte

Valor máximo permitido: 2 GB

numericcharacters

Especifica los caracteres que se van a utilizar como separador de grupo y carácter decimal.

decimal_character: el decimal separa la parte entera de un número de la parte decimal.

group_separator: el Separador de grupo separa grupos enteros (es decir, miles, millones, miles de millones), etc.).

numericcharacters: 'decimal_character group_separator'

Valor por defecto: ".,"

Consulte NLS_NUMERIC_CHARACTERS Guía de soporte de globalización de bases de datos de Oracle Database 19c Guía de soporte de globalización de bases de datos de Oracle Database 23ai para obtener más información.

numberformat

Especifica el modelo de formato de número. Los modelos de formato de número hacen que el número se redondee al número especificado de dígitos significativos. Un modelo de formato de número está compuesto por uno o más elementos de formato de número.

Se utiliza en combinación con numericcharacters.

numberformat: number_format_model

Valor por defecto: se deriva de la configuración del parámetro NLS_TERRITORY

Consulte Modelos de formato numérico en Referencia de lenguaje SQL de Oracle Database 19c o Referencia de lenguaje SQL de Oracle Database 23ai para obtener más información.

partition_columns

La opción de formato partition_columns se utiliza con DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE para especificar los nombres de columna y los tipos de dato de las columnas de partición cuando las columnas de partición se derivan de la ruta de archivo, según el tipo de archivo de datos, estructurado o no estructurado:

Cuando DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE incluye el parámetro column_list y el archivo de datos no está estructurado, como los archivos de texto CSV, partition_columns no incluye el tipo de dato. Por ejemplo, utilice un formato como el siguiente para este tipo de especificación partition_columns:
```
'"partition_columns":["state","zipcode"]'
```
El tipo de dato no es necesario porque se especifica en el parámetro DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE column_list.
Cuando DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE no incluye el parámetro column_list y los archivos de datos están estructurados, como archivos Avro, ORC o Parquet, la opción partition_columns incluye el tipo de dato. Por ejemplo, a continuación se muestra una especificación partition_columns:
```
'"partition_columns":[{"name":"country", "type":"varchar2(10)"}, {"name":"year", "type":"number"}, {"name":"month", "type":"varchar2(10)"}]'
```

Si los archivos de datos no están estructurados y la subcláusula type se especifica con partition_columns, se ignora la subcláusula type.

Para los nombres de objeto que no se basan en el formato hive, el orden de las columnas especificadas partition_columns debe coincidir con el orden en el que aparecen en el nombre de objeto en file_uri_list.

quote

Especifica el carácter de comilla para los campos. Los caracteres de quote se eliminan durante el proceso de carga cuando se especifica.

quote: carácter

Valor predeterminado: Null significa que no hay comillas

recorddelimiter

Opción válida con datos JSON

Especifica el delimitador de registro.

Por defecto, DBMS_CLOUD intenta buscar automáticamente el carácter de nueva línea correcto como delimitador. Primero busca el carácter de línea nueva "\r\n" de Windows en el archivo. Si encuentra el carácter en línea nueva de Windows, este se utiliza como delimitador de registro para todos los archivos del procedimiento. If a Windows newline character is not found, it searches for the UNIX/Linux newline character "\n" and if it finds one it uses "\n" as the record delimiter for all files in the procedure.

Especifique este argumento explícitamente si desea sustituir el comportamiento por defecto, por ejemplo:

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

Para indicar que no hay ningún delimitador de registro, puede especificar un recorddelimiter que no se produzca en el archivo de entrada. Por ejemplo, para indicar que no hay delimitador, especifique el carácter de control 0x01 (SOH) como valor para recorddelimiter y defina el valor recorddelimiter en "0x''01''" (este carácter no se produce en el texto JSON). Por ejemplo:

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

recorddelimiter se define una vez por llamada de procedimiento. Si utiliza el valor predeterminado, detected newline, todos los archivos utilizan el mismo delimitador de registro, si se detecta uno.

recorddelimiter: carácter

Valor por defecto: nueva línea detectada

regexuri

La opción de formato regexuri se utiliza con los siguientes procedimientos DBMS_CLOUD:

COPY_COLLECTION
COPY_DATA
CREATE_EXTERNAL_TABLE
CREATE_EXTERNAL_PART_TABLE
CREATE_HYBRID_PART_TABLE

Cuando el valor de regexuri se define en TRUE, puede utilizar comodines y expresiones regulares en los nombres de archivo en los URI de archivo de origen de nube.

Los caracteres "*" y "?" se consideran caracteres comodín cuando el parámetro regexuri se define en FALSE. Cuando el parámetro regexuri se define en TRUE, los caracteres "*" y "?" forman parte del patrón de expresión regular especificado.

Los patrones de expresión regular solo están soportados para el nombre de archivo o la ruta de subcarpeta en los URI y la coincidencia de patrones es idéntica a la realizada por la función REGEXP_LIKE. Los patrones de expresión regular no están soportados para los nombres de directorio.

En el caso de las tablas externas, esta opción solo está soportada con las tablas que se crean en un archivo de Object Storage.

Por ejemplo:

format => JSON_OBJECT('regexuri' value TRUE)

Consulte Condición REGEXP_LIKE en Referencia de lenguaje SQL de Oracle Database 19c o Referencia de lenguaje SQL de Oracle Database 23ai para obtener más información sobre la condición REGEXP_LIKE.

regexuri: True

Valor por defecto: False

rejectlimit

Esta operación dará error después de que se haya rechazado un número especificado de filas.

rejectlimit: número

Valor por defecto: 0

removequotes

Elimina todas las comillas que se encuentren en cualquier campo del archivo de origen.

removequotes: true

Valor por defecto: False

skipheaders

Especifica cuántas filas se deberían omitir desde el principio del archivo.

skipheaders: número

Valor predeterminado: 0 si no se ha especificado, 1 si se ha especificado sin un valor

territory

Especifica un nombre de territorio para determinar aún más las características de los datos de entrada.

territory: cadena

Valor por defecto: Nulos

timestampformat

Especifica el formato de registro de hora en el archivo de origen. La opción de formato AUTO busca los siguientes formatos:

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: cadena

Valor por defecto: formato de registro de hora de base de datos

La cadena puede contener caracteres comodín como "$".

timestampltzformat

Especifica el registro de hora con formato de zona horaria local en el archivo de origen. La opción de formato AUTO busca los siguientes formatos:

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: cadena

Valor por defecto: Registro de hora de la base de Datos con formato de zona horaria local

timestamptzformat

Especifica el registro de hora con formato de zona horaria en el archivo de origen. La opción de formato AUTO busca los siguientes formatos:

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: cadena

Valor por defecto: Registro de hora de la base de Datos con formato de zona horaria

trimspaces

Especifica cómo se recortan los espacios iniciales y finales de los campos.

Consulte la descripción de trim_spec en Oracle Database 19c Utilities u Oracle Database 23ai Utilities.

trimspaces: rtrim| ltrim| notrim| lrtrim| ldrtrim

Valor por defecto: notrim

truncatecol

Si los datos del archivo son demasiado largos para un campo, esta opción truncará el valor del campo en lugar de rechazar la fila.

truncatecol:true

Valor por defecto: False

type

Especifica el tipo de archivo de origen.

Consulte la descripción de CSV en Oracle Database 19c Utilities u Oracle Database 23ai Utilities.

Si type es datapump, la única otra opción de formato válida es rejectlimit.

Si type es datapump, los únicos almacenes de objetos soportados son Oracle Cloud Infrastructure Object Storage y Oracle Cloud Infrastructure Object Storage Classic.

Consulte Opciones de formato del paquete DBMS_CLOUD para Avro, ORC o Parquet para los valores type avro, orc o parquet.

Para los datos JSON con DBMS_CLOUD.COPY_COLLECTION, type tiene dos valores válidos: json (valor por defecto) y ejson. Para DBMS_CLOUD.COPY_COLLECTION, estos valores especifican que la entrada es datos JSON. El valor ejson hace que los objetos ampliados de los datos de entrada JSON textuales se traduzcan a valores JSON escalares en la recopilación de JSON binaria nativa. El valor json no realiza esta transformación y todos los objetos de los datos de entrada se convierten al formato JSON binario.

Para los datos JSON con DBMS_CLOUD.COPY_DATA, type tiene un valor válido: json. Este valor especifica que la entrada es datos JSON.

Consulte Procedimiento COPY_COLLECTION para obtener información sobre la carga de objetos JSON.
Consulte Objetos JSON textuales que representan valores escalares ampliados para obtener información sobre los objetos JSON ampliados, que se interpretan cuando el parámetro type tiene el valor ejson.

Nota: No todos los procedimientos DBMS_CLOUD admiten todos estos tipos.

csv es lo mismo que csv without embedded.

Valor por defecto: Nulos

Para los datos JSON, hay dos valores type válidos para su uso con DBMS_CLOUD.COPY_COLLECTION: json|ejson. En este caso, el valor por defecto es json. Para los datos JSON con DBMS_CLOUD.COPY_DATA, solo json es válido.

unpackarrays

Utilizar solo con COPY_COLLECTION

Si se define en true, si un documento cargado es una matriz, el contenido de la matriz se carga como documentos en lugar de la propia matriz. Esto solo se aplica a la matriz de nivel superior.

Cuando se define en true, toda la matriz se inserta como un solo documento.

Esta opción solo es válida para los datos de recopilación de JSON con DBMS_CLOUD.COPY_COLLECTION.

unpackarrays: true

Valor por defecto: False

Opciones de formato del paquete DBMS_CLOUD

Contenido relacionado