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” }'
Y:
format => json_object('format_option' value 'format_value'))
Ejemplos:
format => json_object('type' VALUE 'CSV')
Para especificar varias opciones de formato, separe los valores con una ",
".
Por ejemplo:
format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true', 'dateformat' value 'YYYY-MM-DD-HH24-MI-SS', 'blankasnull' value 'true', 'logretention' value 7)
Para las opciones de formato de Avro, ORC o Parquet, consulte DBMS_CLOUD Package Format Options for 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 |
---|---|---|
|
Especifica el tipo de tabla de Apache Iceberg, como AWS u OCI Object Storage, y qué información se utiliza para crear la tabla externa, por ejemplo, información de un catálogo de datos o de un URI de metadatos directos. |
Consulte el Procedimiento CREATE_EXTERNAL_TABLE para Apache Iceberg para obtener detalles sobre la sintaxis |
|
Si se define en |
Valor por defecto: |
Válido con JSON |
Especifica el juego de caracteres de los archivos de origen |
Valor por defecto: juego de caracteres de base de datos |
Utilizar solo con JSON |
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 Expresiones de ruta de acceso SQL/JSON. Utilice solo con formato JSON y |
Matriz de JSON de expresiones de ruta de json expresadas en formato de cadena. Por ejemplo: 'columnpath' value |
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 |
Valor predeterminado: valor nulo que no significa compresión. |
|
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á. |
Valor por defecto: |
|
Especifica el formato de fecha en el archivo de origen. La opción de formato J MM-DD-YYYYBC MM-DD-YYYY YYYYMMDD HHMISS YYMMDD HHMISS YYYY.DDD YYYY-MM-DD |
Valor por defecto: formato de fecha de base de datos |
|
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, lo siguiente especifica el carácter de tabulador como delimitador:
|
Valor por defecto |
|
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:
Restricciones para
Consulte FIELD NAMES y la descripción de |
Valor por defecto: |
|
La opción de formato
Por ejemplo: format => JSON_OBJECT('enablelogs' value FALSE) |
Valor por defecto: |
|
La opción de formato Utilice
Los valores de Modificadores de Encadenamiento de Cifrado de Bloques y Modificadores de Relleno de Cifrado de Bloques se definen por defecto en La opción de formato
encryption se utiliza con los siguientes procedimientos DBMS_CLOUD :
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 valor es una cadena JSON que proporciona parámetros adicionales para el cifrado:
Especifica el tipo de cifrado.
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). |
|
Los datos se pueden incluir entre dos delimitadores, especificados con Por ejemplo: format => JSON_OBJECT(‘quote’ value ‘(’, ‘endquote’ value ‘)’) |
Valor predeterminado: nulo, lo que significa que no hay |
|
El carácter "\" se utiliza como carácter de escape cuando se especifica. |
Valor por defecto: |
Opción válida con datos JSON |
Las líneas en blanco se ignoran cuando están definidas en true. |
Valor por defecto: |
|
Si hay más columnas en |
Valor por defecto |
|
Active la partición implícita y especifique los nombres de columna de partición mediante la opción de formato La partición implícita se activa de las siguientes formas:
Consulte |
Valor predeterminado: si se especifica |
|
Active la partición implícita y especifique los tipos de dato de las columnas de partición mediante la opción de formato Consulte |
Valor por defecto: si se especifica |
Utilizar solo con |
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 |
Valor por defecto: Nulos |
keyassignment Utilizar solo con |
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 Por defecto, este parámetro no está definido, lo que significa que se crea una nueva recopilación como una recopilación de SODA. |
Valor por defecto: |
Utilizar solo con |
Especifica un atributo en los datos que se van a cargar como valor Si se especifica Defina el valor en una ruta, por ejemplo, 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 |
Valor por defecto: Cuando se establece |
|
Especifica un nombre de idioma (por ejemplo, FRENCH), a partir del cual se puede derivar información confidencial de la configuración regional. |
Valor por defecto: Nulos Consulte la sección sobre datos de configuración regional en Oracle Database Globalization Support Guide para obtener una lista de los idiomas soportados por Oracle. |
|
Especifica un valor de cadena que determina el nombre del objeto de directorio donde se guardan los archivos Por defecto, Por ejemplo:
La opción de formato
La opción de formato |
Valor por defecto: |
|
Especifica un valor de cadena que determina el prefijo para los archivos El formato del nombre de la tabla de logs es: logprefix 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 |
Valor por defecto: |
|
Especifica una duración de entero positivo, en días, para la que se conservan los archivos Valores válidos: de Por ejemplo: format => JSON_OBJECT ('logretention' value 7) |
Valor por defecto: |
Esta opción solo es válida con datos JSON |
Tamaño máximo de documentos JSON. |
Valor por defecto: 1 megabyte Valor máximo permitido: 2 GB |
|
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 de enteros (es decir, miles, millones, miles de millones, etc.). |
Valor por defecto: Consulte NLS_NUMERIC_CHARACTERS en Oracle Database Globalization Support Guide para obtener más información. |
|
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 |
Valor por defecto: se deriva de la configuración del parámetro Consulte la sección sobre modelos de formato de número en Referencia de lenguaje SQL para obtener más información. |
|
La opción de formato
Si los archivos de datos no están estructurados y la subcláusula Para los nombres de objeto que no se basan en el formato hive, el orden de las columnas especificadas |
|
|
Especifica el carácter de comilla para los campos. Los caracteres de |
Valor predeterminado: Null significa que no hay comillas |
Opción válida con datos JSON |
Especifica el delimitador de registro. Por defecto, Especifique este argumento explícitamente si desea sustituir el comportamiento por defecto, por ejemplo:
Para indicar que no hay ningún delimitador de registro, puede especificar un
|
Valor por defecto: nueva línea detectada |
|
La opción de formato
Cuando el valor de Los caracteres "*" y "?" se consideran caracteres comodín cuando el parámetro 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 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:
Consulte Condición REGEXP_LIKE para obtener más información sobre la condición |
Valor por defecto: |
|
Esta operación dará error después de que se haya rechazado un número especificado de filas. |
Valor por defecto: |
|
Elimina todas las comillas que se encuentren en cualquier campo del archivo de origen. |
Valor por defecto: |
|
Especifica cuántas filas se deberían omitir desde el principio del archivo. |
Valor predeterminado: 0 si no se ha especificado, 1 si se ha especificado sin un valor |
|
Especifica un nombre de territorio para determinar aún más las características de los datos de entrada. |
Valor por defecto: Nulos Consulte la sección sobre datos de configuración regional en Oracle Database Globalization Support Guide para obtener una lista de los territorios soportados por Oracle. |
|
Especifica el formato de registro de hora en el archivo de origen. La opción de formato 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 |
Valor por defecto: formato de registro de hora de base de datos La cadena puede contener caracteres comodín como "$". |
|
Especifica el registro de hora con formato de zona horaria local en el archivo de origen. La opción de formato 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 |
Valor por defecto: Registro de hora de la base de Datos con formato de zona horaria local |
|
Especifica el registro de hora con formato de zona horaria en el archivo de origen. La opción de formato 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 |
Valor por defecto: Registro de hora de la base de Datos con formato de zona horaria |
|
Especifica cómo se recortan los espacios iniciales y finales de los campos. Consulte la descripción de trim_spec. |
Valor por defecto: |
|
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. |
Valor por defecto: |
|
Especifica el tipo de archivo de origen. Consulte la descripción de Si Si Consulte DBMS_CLOUD Package Format Options for Avro, ORC, or Parquet para obtener los valores Para los datos JSON con Para los datos JSON con
|
Nota
No todos los procedimientos DBMS_CLOUD admiten todos estos tipos.
Valor por defecto: Nulos Para los datos JSON, hay dos valores |
Utilizar solo con |
Si se define en Cuando se define en Esta opción solo es válida para los datos de recopilación de JSON con |
Valor por defecto: |
Tema principal: Paquete DBMS_CLOUD