DBMS_CLOUD para objetos y archivos

Requisitos

Como desarrollador, puede utilizar procedimientos DBMS_CLOUD con instancias de Autonomous Database desplegadas en Oracle Public Cloud, Multicloud o Exadata Cloud@Customer.

En función de la opción de despliegue, se deben cumplir los siguientes requisitos para utilizar los procedimientos DBMS_CLOUD con los proveedores de servicios Amazon S3, Azure Blob Storage y Google Cloud Storage.

Oracle Public Cloud o multinube
Exadata Cloud at Customer

El administrador del conjunto debe haber configurado una conectividad saliente mediante un gateway de NAT, como se describe a continuación:

Cree un gateway de NAT en la red virtual en la nube (VCN) en la que residan los recursos de Autonomous Database siguiendo las instrucciones de Creación de un gateway de NAT de la Documentación de Oracle Cloud Infrastructure.
Después de crear el gateway de NAT, agregue una regla de ruta y una regla de seguridad de salida a cada subred (en la VCN) en la que residan los recursos de Autonomous Database para que estos recursos puedan utilizar el gateway para obtener una clave pública de la instancia de Azure AD:
1. Vaya a la página Detalles de subred de la subred.
2. En el separador Información de Subred, haga clic en el nombre de la Tabla de Direcciones de la subred para mostrar su página Detalles de Tabla de Direcciones.
3. En la tabla de Reglas de ruta existentes, compruebe si ya hay una regla con las siguientes características:
  - Destino: 0.0.0.0/0
  - Tipo de destino: gateway de NAT
  - Destino: nombre del gateway de NAT que acaba de crear en la VCN
  Si dicha regla no existe, haga clic en Agregar reglas de ruta y agregue una regla de ruta con estas características.
4. Vuelva a la página Detalles de subred de la subred.
5. En la tabla Listas de seguridad de la subred, haga clic en el nombre de la lista de seguridad de la subred para mostrar su página Detalles de lista de seguridad.
6. En el menú lateral, en Recursos, haga clic en Reglas de salida.
7. En la tabla de Reglas de salida existentes, compruebe si ya hay una regla con las siguientes características:
  - Tipo de destino: CIDR
  - Destino: 0.0.0.0/0
  - Protocolo IP: TCP
  - Rango de puertos de origen: 443
  - Rango de puertos de destino: todos
  Si dicha regla no existe, haga clic en Agregar Reglas de Salida y agregue una regla de salida con estas características.

La configuración del proxy HTTP en el entorno debe permitir que la base de datos acceda al proveedor de servicios en la nube.

El administrador del conjunto define esta configuración al crear la infraestructura de Exadata Cloud@Customer, como se describe en Uso de la consola para aprovisionar Exadata Database Service on Cloud@Customer.

Note:

La configuración de red, incluido el proxy HTTP, solo se puede editar hasta que la infraestructura de Exadata tenga el estado Necesita activación. Una vez activada, no puede editar esa configuración.

La configuración de un proxy HTTP para una infraestructura de Exadata ya aprovisionada necesita una solicitud de servicio (SR) en My Oracle Support. Consulte Creación de una solicitud de servicio en My Oracle Support para obtener más información.

DBMS_CLOUD Subprogramas para objetos y archivos

Los subprogramas para la gestión de objetos y archivos dentro del paquete DBMS_CLOUD.

Subprograma	Descripción
Procedimiento COPY_COLLECTION	Este procedimiento carga datos en una recopilación de SODA existente, ya sea desde Cloud Object Storage o desde archivos en un directorio.
Procedimiento COPY_DATA	Este procedimiento carga datos en tablas de Autonomous Database existentes desde Cloud Object Storage o desde archivos de un directorio.
COPY_DATA Procedimiento para archivos Avro, ORC o Parquet	Este procedimiento con el parámetro `format` `type` definido en el valor `orc`, `parquet` o `avro` carga datos en tablas de Autonomous Database existentes desde archivos ORC, Parquet o Avro en la nube o desde archivos ORC, Parquet o Avro en un directorio. De forma similar a los archivos de texto, los datos se copian del archivo ORC, Parquet o Avro de origen en la tabla interna preexistente.
Procedimiento COPY_OBJECT	Este procedimiento copia archivos de un cubo de Cloud Object Storage a otro.
Procedimiento CREATE_EXTERNAL_TABLE	Con este procedimiento se crea una tabla externa en los archivos de la nube o de un directorio. Permite ejecutar consultas en datos externos desde Autonomous Database.
CREATE_EXTERNAL_TABLE Procedimiento para archivos Avro, ORC o Parquet	Este procedimiento con el parámetro `format` `type` definido en el valor `parquet`, `orc` o `avro` crea una tabla externa con archivos de formato Parquet, ORC o Avro en la nube o en un directorio. Permite ejecutar consultas en datos externos desde Autonomous Database.
Procedimiento CREATE_EXTERNAL_TEXT_INDEX	Este procedimiento crea un índice de texto en los archivos del almacén de objetos.
Procedimiento CREATE_HYBRID_PART_TABLE	Con este procedimiento se crea una tabla particionada híbrida. Permite ejecutar consultas en datos particionados híbridos desde Autonomous Database.
Procedimiento DELETE_ALL_OPERATIONS	Este procedimiento borra todas las operaciones de carga de datos registradas en la tabla `user_load_operations` del esquema o todas las operaciones de carga de datos del tipo especificado, según se haya indicado con el parámetro `type`.
Procedimiento DELETE_FILE	Este procedimiento elimina el archivo especificado del directorio especificado en Autonomous Database
Procedimiento DELETE_OBJECT	Este procedimiento suprime el objeto especificado en el almacén de objetos.
Procedimiento DELETE_OPERATION	Este procedimiento acepta `operation_id` como entrada y suprime los logs asociados al `operation_id` especificado.
Procedimiento DROP_EXTERNAL_TEXT_INDEX	Este procedimiento borra el índice de texto en los archivos del almacén de objetos.
Procedimiento EXPORT_DATA	Con este procedimiento se exportan los datos de Autonomous Database a archivos en la nube según el resultado de una consulta. El formulario sobrecargado permite utilizar el parámetro `operation_id`. Según la opción `type` del parámetro `format` especificada, el procedimiento exporta filas al almacén de objetos en la nube como texto con opciones de CSV, JSON, Parquet o XML
Procedimiento y función GET_OBJECT	Este procedimiento está sobrecargado. El formulario de procedimiento lee un objeto de Cloud Object Storage y lo copia en Autonomous Database. El formulario de función lee un objeto de Cloud Object Storage y devuelve un valor `BLOB` a Autonomous Database.
Función LIST_FILES	Esta función muestra los archivos del directorio especificado. Los resultados incluyen los nombres de archivo y metadatos adicionales sobre los archivos, como el tamaño de archivo en bytes, el registro de hora de creación y el registro de hora de la última modificación.
Función LIST_OBJECTS	Esta función muestra los objetos de la ubicación especificada en el almacén de objetos. Los resultados incluyen los nombres de objetos y metadatos adicionales sobre los objetos, como el tamaño, el total de control, el registro de hora de creación y el registro de hora de la última modificación.
Procedimiento MOVE_OBJECT	Este procedimiento mueve un objeto de un cubo de Cloud Object Storage a otro.
Procedimiento PUT_OBJECT	Este procedimiento está sobrecargado. En un formulario el procedimiento copia un archivo de Autonomous Database en Cloud Object Storage. En otro formulario, el procedimiento copia un valor `BLOB` de Autonomous Database en Cloud Object Storage.
Procedimiento SYNC_EXTERNAL_PART_TABLE	Con este procedimiento se simplifica la actualización de una tabla particionada externa desde archivos de la nube. Ejecute este procedimiento siempre que se agreguen nuevas particiones o cuando se eliminen particiones del origen del almacén de objetos para la tabla particionada externa.
Procedimiento VALIDATE_EXTERNAL_TABLE	Este procedimiento valida los archivos de origen para una tabla externa, genera información de log y almacena las filas que no coinciden con las opciones de formato especificadas para la tabla externa en una tabla de archivos incorrectos en Autonomous Database.
Procedimiento VALIDATE_EXTERNAL_PART_TABLE	Con este procedimiento se validan los archivos de origen para una tabla particionada externa, se genera información de log y se almacenan las filas que no coinciden con las opciones de formato especificadas para la tabla externa en una tabla de archivos incorrectos en Autonomous Database.
Procedimiento VALIDATE_HYBRID_PART_TABLE	Con este procedimiento se validan los archivos de origen para una tabla particionada híbrida, se genera información de log y se almacenan las filas que no coinciden con las opciones de formato especificadas para la tabla híbrida en una tabla de archivos incorrectos en Autonomous Database.

Procedimiento COPY_COLLECTION

Este procedimiento carga datos en una recopilación de SODA desde Cloud Object Storage o desde un directorio. Si la recopilación de SODA especificada no existe, el procedimiento la crea. El formulario sobrecargado permite utilizar el parámetro operation_id.

Sintaxis

DBMS_CLOUD.COPY_COLLECTION (
    collection_name   IN VARCHAR2,
    credential_name   IN VARCHAR2 DEFAULT NULL,
    file_uri_list     IN CLOB,
    format            IN CLOB     DEFAULT NULL
);

DBMS_CLOUD.COPY_COLLECTION (
    collection_name   IN VARCHAR2,
    credential_name   IN VARCHAR2 DEFAULT NULL,
    file_uri_list     IN CLOB,
    format            IN CLOB     DEFAULT NULL,
    operation_id      OUT NOCOPY NUMBER
);

Parámetros

parámetro	Descripción
`collection_name`	Nombre de la recopilación de SODA en la que se cargarán los datos. Si ya existe una recopilación con este nombre, se cargarán los datos especificados; de lo contrario, se creará una nueva recopilación.
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage. Este parámetro no se utiliza al especificar un directorio con `file_uri_list`.
`file_uri_list`	Este parámetro especifica una lista delimitada por comas de los URI de archivo de origen o uno o más directorios y archivos de origen. URI de archivo de origen de nube Puede utilizar comodines y expresiones regulares en los nombres de archivo en los URI de archivo de origen de la nube. Las expresiones regulares solo se pueden utilizar cuando el parámetro `regexuri` `format` está definido en `TRUE`. 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 la subcarpeta en los URI y la coincidencia de patrones es idéntica a la realizada por la función `REGEXP_LIKE`. Por ejemplo: `file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)year=[0-9]+(/)month=[0-9]+(/)[a-z]+[1-3]??.csv'` El formato de los URI depende del servicio de Cloud Object Storage que utilice. Para obtener más información, consulte Formatos de URI de almacenamiento de objetos en la nube. Consulte Condición REGEXP_LIKE en Referencia de lenguaje SQL 19c de Oracle Database u Referencia de lenguaje SQL de Oracle Database 23ai para obtener más información sobre la condición `REGEXP_LIKE`. Directorio Puede especificar un directorio y uno o más nombres de archivos o utilizar una lista separada por comas de directorios y nombres de archivos. El formato para especificar un directorio es:`'MY_DIR:filename.ext'`. Por defecto, el nombre de directorio `MY_DIR` es un objeto de base de datos y no distingue entre mayúsculas y minúsculas. El nombre de archivo distingue mayúsculas. Puede utilizar comodines para especificar nombres de archivo en un directorio. Se puede utilizar el carácter "" como comodín para varios caracteres; el carácter "?" se puede utilizar como comodín para un solo carácter. Por ejemplo:`'MY_DIR:"` o `'MY_DIR:test?'` Para especificar varios directorios, utilice una lista separada por comas de directorios: por ejemplo:`'MY_DIR1:, MY_DIR2:test?'` Utilice comillas dobles para especificar un nombre de directorio sensible a mayúsculas/minúsculas. Por ejemplo:`'"my_dir1":*, "my_dir2":Test?'` Para incluir un carácter de comillas, utilice dos comillas. Por ejemplo:`'MY_DIR:''filename.ext'`. Especifica que `filename` empieza por una comilla (`'`).
`format`	Opciones que describen el formato de los archivos de origen. Estas opciones se especifican como una cadena JSON. Los formatos soportados son: `characterset, compression, ignoreblanklines, jsonpath, maxdocsize, recorddelimiter, rejectlimit, unpackarray`, `keyassignment` y `keypath`. Además de los formatos mencionados para datos JSON, Autonomous Database también soporta otros formatos. Para obtener la lista de argumentos de formato soportados por Autonomous Database, consulte Parámetro de formato.
`operation_id`	Utilice este parámetro para realizar un seguimiento del progreso y del estado final de la operación de carga como el identificador correspondiente en la vista `USER_LOAD_OPERATIONS`.

Ejemplo

BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL(
            credential_name => 'OBJ_STORE_CRED',
            username        => 'user_name@oracle.com',
            password        => 'password'
            );

    DBMS_CLOUD.COPY_COLLECTION(
            collection_name => 'myCollection',
            credential_name => 'OBJ_STORE_CRED',
            file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/adbexample/b/json/o/myCollection.json'  
            );
END;
/

Procedimiento COPY_DATA

Este procedimiento carga datos en tablas de Autonomous Database existentes desde archivos de la nube o desde archivos de un directorio. El formulario sobrecargado permite utilizar el parámetro operation_id.

Sintaxis

DBMS_CLOUD.COPY_DATA (
    table_name        IN VARCHAR2,
    credential_name   IN VARCHAR2 DEFAULT NULL,
    file_uri_list     IN CLOB,
    schema_name       IN VARCHAR2,
    field_list        IN CLOB,
    format            IN CLOB);

DBMS_CLOUD.COPY_DATA (
    table_name        IN VARCHAR2,
    credential_name   IN VARCHAR2 DEFAULT NULL,
    file_uri_list     IN CLOB DEFAULT NULL,
    schema_name       IN VARCHAR2 DEFAULT NULL,
    field_list        IN CLOB DEFAULT NULL,
    format            IN CLOB DEFAULT NULL
    operation_id      OUT NOCOPY NUMBER);

Parámetros

parámetro	Descripción
`table_name`	Nombre de la tabla de destino en la base de datos. Es necesario crear la tabla de destino para poder ejecutar `COPY_DATA`.
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage. Este parámetro no se utiliza al especificar un directorio con `file_uri_list`.
`file_uri_list`	Puede utilizar comodines y expresiones regulares en los nombres de archivo en los URI de archivo de origen de la nube. URI de archivo de origen de nube Este parámetro especifica una lista delimitada por comas de los URI de archivo de origen o uno o más directorios y archivos de origen. Las expresiones regulares solo se pueden utilizar cuando el parámetro `regexuri` `format` está definido en `TRUE`. 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 la subcarpeta en los URI y la coincidencia de patrones es idéntica a la realizada por la función `REGEXP_LIKE`. Por ejemplo: `file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)year=[0-9]+(/)month=[0-9]+(/)[a-z]+[1-3]??.csv'` El formato de los URI depende del servicio de Cloud Object Storage que utilice. Para obtener más información, consulte Formatos de URI de almacenamiento de objetos en la nube. Consulte Condición REGEXP_LIKE en Referencia de lenguaje SQL 19c de Oracle Database u Referencia de lenguaje SQL de Oracle Database 23ai para obtener más información sobre la condición `REGEXP_LIKE`. Directorio Puede especificar un directorio y uno o más nombres de archivos o utilizar una lista separada por comas de directorios y nombres de archivos. El formato para especificar un directorio es:`'MY_DIR:filename.ext'`. Por defecto, el nombre de directorio `MY_DIR` es un objeto de base de datos y no distingue entre mayúsculas y minúsculas. El nombre de archivo distingue mayúsculas. Puede utilizar comodines para especificar nombres de archivo en un directorio. Se puede utilizar el carácter "" como comodín para varios caracteres; el carácter "?" se puede utilizar como comodín para un solo carácter. Por ejemplo:`'MY_DIR:"` o `'MY_DIR:test?'` Para especificar varios directorios, utilice una lista separada por comas de directorios: por ejemplo:`'MY_DIR1:, MY_DIR2:test?'` Utilice comillas dobles para especificar un nombre de directorio sensible a mayúsculas/minúsculas. Por ejemplo:`'"my_dir1":*, "my_dir2":Test?'` Para incluir un carácter de comillas, utilice dos comillas. Por ejemplo:`'MY_DIR:''filename.ext'`. Especifica que `filename` empieza por una comilla (`'`).
`schema_name`	Nombre del esquema en el que reside la tabla de destino. El valor por defecto es NULL, lo que significa que la tabla de destino está en el mismo esquema que el usuario que ejecuta el procedimiento.
`field_list`	Identifica los campos en los archivos de origen y sus tipos de datos. El valor por defecto es NULL significa que los campos y sus tipos de datos están determinados por el parámetro column_list. La sintaxis de este argumento es la misma que la cláusula `field_list` de las tablas externas normales de Oracle. Para obtener más información, consulte field_list en Oracle Database 19c Utilities o Oracle Database 23ai Utilities. Cuando el valor de la opción `type` del parámetro `format` es `json`, este parámetro se ignora. Para ver un ejemplo de uso de `field_list`, consulte Procedimiento CREATE_EXTERNAL_TABLE.
`format`	Opciones que describen el formato del origen, el log y los archivos incorrectos. Para obtener una lista de las opciones y cómo especificar los valores, consulte Parámetro de formato. Para conocer las opciones de formato de archivo Avro, ORC o Parquet, consulte Opciones de formato del paquete DBMS_CLOUD para Avro, ORC o Parquet.
`operation_id`	Utilice este parámetro para realizar un seguimiento del progreso y del estado final de la operación de carga como el identificador correspondiente en la vista `USER_LOAD_OPERATIONS`.

Notas de uso

El delimitador de registro por defecto es detected newline. Con detected newline, DBMS_CLOUD intenta buscar automáticamente el carácter de nueva línea correcto que se va a utilizar como delimitador de registro. DBMS_CLOUD busca primero el carácter de línea nueva \r\n de Windows. Si encuentra el carácter de línea nueva de Windows, este se utiliza como delimitador de registro para todos los archivos del procedimiento. Si no se encuentra un carácter de línea nueva de Windows, DBMS_CLOUD busca el carácter de línea nueva de UNIX/Linux \n y si encuentra uno utiliza \n como delimitador de registro para todos los archivos del procedimiento. Si los archivos de origen utilizan una combinación de diferentes delimitadores de registro, puede que aparezca un error como, por ejemplo, "KUP-04020: found record longer than buffer size supported". En este caso, debe modificar los archivos de origen para utilizar el mismo delimitador de registro o solo especificar los archivos de origen que utilizan el mismo delimitador de registro.

Consulte Parámetro de formato para obtener información sobre la opción de formato recorddelmiter.

Ejemplos

BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL(
            credential_name => 'DEF_CRED_NAME',
            username        => 'user_name@oracle.com',
            password        => 'password'
            );
END;
/

BEGIN
 DBMS_CLOUD.COPY_DATA(
    table_name =>'CHANNELS',
    credential_name =>'DEF_CRED_NAME',
    file_uri_list =>'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/channels.txt',
    format => json_object('delimiter' value ',')
 );
END;
/

BEGIN
    DBMS_CLOUD.COPY_DATA(
            table_name      => 'ORDERS',
            schema_name     => 'TEST_SCHEMA',
            credential_name => 'DEF_CRED_NAME',
	     file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/adbexample/b/json/o/orde[r]s.tbl.1'
            format          =>  json_object('ignoreblanklines' value TRUE,
                                            'rejectlimit' value '0',
                                            'dateformat' value 'yyyy-mm-dd',
                                            'regexuri' value TRUE)
            );
END;
/

COPY_DATA Procedimiento para archivos Avro, ORC o Parquet

Este procedimiento con el parámetro format type definido en el valor avro, orc o parquet carga datos en tablas de Autonomous Database existentes desde archivos Avro, ORC o Parquet en la nube o desde archivos en un directorio.

De forma similar a los archivos de texto, los datos se copian del archivo de origen Avro, ORC o Parquet en la tabla interna preexistente.

Sintaxis

DBMS_CLOUD.COPY_DATA (
    table_name        IN VARCHAR2,
    credential_name   IN VARCHAR2 DEFAULT NULL,
    file_uri_list     IN CLOB,
    schema_name       IN VARCHAR2 DEFAULT,
    field_list        IN CLOB DEFAULT,
    format            IN CLOB DEFAULT);

Parámetros

parámetro	Descripción
`table_name`	Nombre de la tabla de destino en la base de datos. Es necesario crear la tabla de destino para poder ejecutar `COPY_DATA`.
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage. Este parámetro no se utiliza al especificar un directorio con `file_uri_list`.
`file_uri_list`	Este parámetro especifica una lista delimitada por comas de los URI de archivo de origen o uno o más directorios y archivos de origen. URI de archivo de origen de nube Puede utilizar comodines y expresiones regulares en los nombres de archivo en los URI de archivo de origen de la nube. Las expresiones regulares solo se pueden utilizar cuando el parámetro `regexuri` `format` está definido en `TRUE`. 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 la subcarpeta en los URI y la coincidencia de patrones es idéntica a la realizada por la función `REGEXP_LIKE`. Por ejemplo: `file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)year=[0-9]+(/)month=[0-9]+(/)[a-z]+[1-3]??.csv'` El formato de los URI depende del servicio de Cloud Object Storage que utilice. Para obtener más información, consulte Formatos de URI de almacenamiento de objetos en la nube. Consulte Condición REGEXP_LIKE en Referencia de lenguaje SQL 19c de Oracle Database u Referencia de lenguaje SQL de Oracle Database 23ai para obtener más información sobre la condición `REGEXP_LIKE`. Directorio Puede especificar un directorio y uno o más nombres de archivos o utilizar una lista separada por comas de directorios y nombres de archivos. El formato para especificar un directorio es:`'MY_DIR:filename.ext'`. Por defecto, el nombre de directorio `MY_DIR` es un objeto de base de datos y no distingue entre mayúsculas y minúsculas. El nombre de archivo distingue mayúsculas. Puede utilizar comodines para especificar nombres de archivo en un directorio. Se puede utilizar el carácter "" como comodín para varios caracteres; el carácter "?" se puede utilizar como comodín para un solo carácter. Por ejemplo:`'MY_DIR:"` o `'MY_DIR:test?'` Para especificar varios directorios, utilice una lista separada por comas de directorios: por ejemplo:`'MY_DIR1:, MY_DIR2:test?'` Utilice comillas dobles para especificar un nombre de directorio sensible a mayúsculas/minúsculas. Por ejemplo:`'"my_dir1":*, "my_dir2":Test?'` Para incluir un carácter de comillas, utilice dos comillas. Por ejemplo:`'MY_DIR:''filename.ext'`. Especifica que `filename` empieza por una comilla (`'`).
`schema_name`	Nombre del esquema en el que reside la tabla de destino. El valor por defecto es NULL, lo que significa que la tabla de destino está en el mismo esquema que el usuario que ejecuta el procedimiento.
`field_list`	Se ignora para los archivos Avro, ORC o Parquet. Los campos del origen coinciden con las columnas de la tabla externa por nombre. Los tipos de datos de origen se convierten en el tipo de datos de columna de tabla externa. Para los archivos ORC, consulte DBMS_CLOUD Asignación de tipo de datos de ORC a Oracle. Para los archivos Parquet, consulte Asignación de tipo de datos de Parquet a Oracle en el paquete DBMS_CLOUD para obtener más información sobre la asignación. Para los archivos Avro, consulte Asignación de tipo de datos de Avro a Oracle en el paquete DBMS_CLOUD para obtener más información sobre la asignación.
`format`	Opciones que describen el formato de los archivos de origen. Para los archivos Avro, ORC o Parquet, solo están soportadas dos opciones: consulte Opciones de formato del paquete DBMS_CLOUD para Avro, ORC o Parquet.

Notas de uso

Al igual que con otros archivos de datos, las cargas de datos de Avro, ORC y Parquet generan logs que se pueden ver en las tablas dba_load_operations y user_load_operations. Con cada operación de carga se agrega un registro a dba[usuario]_load_operations que indica la tabla que contiene los logs.

En la tabla de logs se proporciona información de resumen sobre la carga.
Para Avro, ORC o Parquet, cuando el parámetro format type se define en el valor avro, orc o parquet, la tabla BADFILE_TABLE siempre está vacía.
- Para los archivos Parquet, los errores de restricción PRIMARY KEY devuelven un error ORA.
- Si los datos de una columna encuentran un error de conversión, por ejemplo, la columna de destino no es lo suficientemente grande para contener el valor convertido, el valor de la columna se define en NULL. Esto no genera un registro rechazado.

Procedimiento COPY_OBJECT

Este procedimiento copia un objeto de un cubo o carpeta de Cloud Object Storage a otro.

La carpeta o el cubo de origen y de destino pueden estar en el mismo proveedor del almacén de objetos en la nube o en otro diferente.

Cuando el origen y el destino están en distintos almacenes de objetos o tienen cuentas diferentes con el mismo proveedor de nube, puede proporcionar nombres de credenciales independientes para las ubicaciones de origen y destino.

El nombre de la credencial de origen también lo utiliza por defecto la ubicación de destino cuando no se proporciona el nombre de la credencial de destino.

Sintaxis

DBMS_CLOUD.COPY_OBJECT (
    source_credential_name  IN  VARCHAR2 DEFAULT NULL,
    source_object_uri       IN  VARCHAR2,
    target_object_uri       IN  VARCHAR2,
    target_credential_name  IN  VARCHAR2 DEFAULT NULL
);

Parámetros

parámetro	Descripción
`source_credential_name`	Nombre de la credencial para acceder a Cloud Object Storage de origen. Si no proporciona un valor `source_credential_name`, `credential_name` se define en `NULL`.
`source_object_uri`	Especifica el URI, que apunta a la ubicación de carpeta o cubo de Object Storage de origen. Este parámetro es obligatorio. El formato de los URI depende del servicio Cloud Object Storage. Consulte Formatos de URI de almacenamiento de objetos en la nube para obtener más información.
`target_object_uri`	Especifica el URI del almacén de objetos de destino. Este parámetro es obligatorio. El formato de los URI depende del servicio Cloud Object Storage. Consulte Formatos de URI de almacenamiento de objetos en la nube para obtener más información.
`target_credential_name`	Nombre de la credencial para acceder a la ubicación de almacenamiento de objetos en la nube de destino. Si no proporciona un valor `target_credential_name`, `target_object_uri` se define en el valor `source_credential_name`.

Ejemplo

BEGIN 
DBMS_CLOUD.COPY_OBJECT (
    source_credential_name => 'OCI_CRED',
    source_object_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname1/bgfile.csv',
    target_object_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname2/myfile.csv'
);
END;
/

Procedimiento CREATE_EXTERNAL_PART_TABLE

Con este procedimiento se crea una tabla particionada externa en archivos de la nube o de archivos de un directorio. Permite ejecutar consultas en datos externos desde Autonomous Database.

Sintaxis

DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE (
    table_name           IN VARCHAR2,
    credential_name      IN VARCHAR2,
    partitioning_clause  IN CLOB,
    column_list          IN CLOB,
    field_list           IN CLOB DEFAULT,
    format               IN CLOB DEFAULT);


DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE (
    table_name           IN VARCHAR2,
    credential_name      IN VARCHAR2,
    file_uri_list        IN VARCHAR2,
    column_list          IN CLOB,
    field_list           IN CLOB DEFAULT,
    format               IN CLOB DEFAULT);

Parámetros

parámetro	Descripción
`table_name`	Nombre de la tabla externa.
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage.
`partitioning_clause`	Especifica la cláusula de partición completa, incluida la información de ubicación para particiones individuales. Si utiliza el parámetro `partitioning_clause`, el parámetro `file_uri_list` no está permitido.
`file_uri_list`	Este parámetro especifica una lista delimitada por comas de los URI de archivo de origen o uno o más directorios y archivos de origen. URI de archivo de origen de nube Puede utilizar comodines y expresiones regulares en los nombres de archivo en los URI de archivo de origen de la nube. Las expresiones regulares solo se pueden utilizar cuando el parámetro `regexuri` `format` está definido en `TRUE`. 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 la subcarpeta en los URI y la coincidencia de patrones es idéntica a la realizada por la función `REGEXP_LIKE`. Esta opción solo está soportada con tablas externas creadas en un archivo de Object Storage. Por ejemplo: `file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)year=[0-9]+(/)month=[0-9]+(/)*[a-z]+[1-3]??.csv'` Si utiliza el parámetro `file_uri_list`, el parámetro `partitioning_clause` no está permitido. El formato de los URI depende del servicio Cloud Object Storage. Consulte Formatos de URI de almacenamiento de objetos en la nube para obtener más información. Consulte Condición REGEXP_LIKE en Referencia de lenguaje SQL 19c de Oracle Database u Referencia de lenguaje SQL de Oracle Database 23ai para obtener más información sobre la condición `REGEXP_LIKE`.
`column_list`	Lista delimitada por comas de nombres de columna y tipos de datos para la tabla externa. Este parámetro tiene los siguientes requisitos, según el tipo de archivos de datos especificados con el parámetro `file_uri_list`: El parámetro `column_list` es necesario con archivos no estructurados. Mediante el uso de archivos no estructurados, por ejemplo, con archivos de texto CSV, el parámetro `column_list` debe especificar todos los nombres de columna y tipos de dato dentro del archivo de datos, así como las columnas de partición derivadas del nombre de objeto. El parámetro `column_list` es opcional con archivos estructurados. Por ejemplo, con archivos de datos Avro, ORC o Parquet, `column_list` no es necesario. Si no se incluye `column_list`, la opción `partition_columns` del parámetro `format` debe incluir especificaciones para los nombres de columna (`name`) y los tipos de datos (`type`).
`field_list`	Identifica los campos en los archivos de origen y sus tipos de datos. El valor por defecto es NULL significa que los campos y sus tipos de datos están determinados por el parámetro column_list. La sintaxis de este argumento es la misma que la cláusula `field_list` de las tablas externas normales de Oracle. Para obtener más información, consulte field_list en Oracle Database 19c Utilities o Oracle Database 23ai Utilities.
`format`	La opción de formato `partition_columns` especifica los nombres de columna `DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE` y los tipos de datos 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 los archivos de datos no están estructurados, como los archivos de texto CSV, `partition_columns` no incluye el tipo de datos. Por ejemplo, utilice un formato como el siguiente para este tipo de especificación `partition_columns`: `'"partition_columns":["state","zipcode"]'` El tipo de datos 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 en el caso de archivos Avro, ORC o Parquet, la opción `partition_columns` incluye el nombre de columna, la subcláusula `name` y el tipo de datos, la subcláusula `type`. 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 están basados en el formato de colmena, el orden de las columnas especificadas `partition_columns` debe coincidir con el orden en el que aparecen en el nombre de objeto en la ruta de archivo especificada en el parámetro `file_uri_list`. Para ver todas las opciones del parámetro `format` que describen el formato de los archivos de origen, consulte Formatos de URI de Cloud Object Storage.

Notas de uso

No puede llamar a este procedimiento con los parámetros partitioning_clause y file_uri_list.
La especificación del parámetro column_list es opcional con archivos de datos estructurados, incluidos archivos de datos Avro, Parquet u ORC. Si no se especifica column_list, la opción partition_columns del parámetro format debe incluir name y type.
El parámetro column_list es necesario con archivos de datos no estructurados, como archivos de texto CSV.
El procedimiento DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE soporta archivos externos en los servicios de almacenamiento de objetos en la nube soportados, incluidos:
- Oracle Cloud Infrastructure Object Storage
- Azure Blob Storage
Consulte Formatos de URI de almacenamiento de objetos en la nube para obtener más información.
El procedimiento DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE admite archivos particionados externos en directorios, ya sea en un sistema de archivos local o en un sistema de archivos de red.
Al llamar a DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE con el parámetro file_uri_list, los tipos de columnas especificados en el nombre de archivo del almacén de objetos en la nube deben ser uno de los siguientes:
```
VARCHAR2(n)
NUMBER(n)
NUMBER(p,s)
NUMBER
DATE
TIMESTAMP(9)
```
El delimitador de registro por defecto es detected newline. Con detected newline, DBMS_CLOUD intenta buscar automáticamente el carácter de nueva línea correcto que se va a utilizar como delimitador de registro. DBMS_CLOUD busca primero el carácter de línea nueva \r\n de Windows. Si encuentra el carácter de línea nueva de Windows, este se utiliza como delimitador de registro para todos los archivos del procedimiento. Si no se encuentra un carácter de línea nueva de Windows, DBMS_CLOUD busca el carácter de línea nueva de UNIX/Linux \n y si encuentra uno utiliza \n como delimitador de registro para todos los archivos del procedimiento. Si los archivos de origen utilizan una combinación de diferentes delimitadores de registro, puede que aparezca un error como, por ejemplo, "KUP-04020: found record longer than buffer size supported". En este caso, debe modificar los archivos de origen para utilizar el mismo delimitador de registro o solo especificar los archivos de origen que utilizan el mismo delimitador de registro.

Consulte Cloud Object Storage URI Formats para obtener información sobre la opción de formato recorddelmiter.
Las tablas particionadas externas que crea con DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE incluyen dos columnas invisibles: file$path y file$name. Estas columnas ayudan a identificar el archivo del que procede un registro.
- file$path: especifica el texto de la ruta del archivo hasta el principio del nombre del objeto.
- file$name: especifica el nombre del objeto, incluido todo el texto que sigue al nombre del cubo.

Ejemplos

Ejemplo con el parámetro partitioning_clause:

BEGIN  
   DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE(
      table_name =>'PET1',  
      credential_name =>'OBJ_STORE_CRED',
      format => json_object('delimiter' value ',', 'recorddelimiter' value 'newline', 'characterset' value 'us7ascii'),
      column_list => 'col1 number, col2 number, col3 number',
      partitioning_clause => 'partition by range (col1)
                                (partition p1 values less than (1000) location
                                    ( ''&base_URL//file_11.txt'')
                                 ,
                                 partition p2 values less than (2000) location
                                    ( ''&base_URL/file_21.txt'')
                                 ,
                                 partition p3 values less than (3000) location 
                                    ( ''&base_URL/file_31.txt'')
                                 )'
     );
   END;
/  


BEGIN
    DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE(
       table_name          => 'PET',
       format              => json_object('delimiter'value ','),
       column_list         => 'name varchar2(20), gender varchar2(10), salary number',
       partitioning_clause => 'partition by range (salary)
              (   -- Use test1.csv in the DEFAULT DIRECTORY DATA_PUMP_DIR 
                  partition p1 values less than (100) LOCATION (''test1.csv''),
                   -- Use test2.csv in a specified directory MY_DIR
                  partition p2 values less than (300) DEFAULT DIRECTORY MY_DIR LOCATION (''test2.csv'')        )'   );                       
END;                     
/

Ejemplo con los parámetros file_uri_list y column_list con archivos de datos no estructurados:

BEGIN
  DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE(
   table_name => 'MYSALES',
   credential_name => 'DEF_CRED_NAME',
   file_uri_list     => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/*.csv', 
   column_list       => 'product varchar2(100), units number, country varchar2(100), year number, month varchar2(2)', 
   field_list        => 'product, units', --[Because country, year and month are not in the file, they are not listed in the field list]
   format            => '{"type":"csv", "partition_columns":["country","year","month"]}');
END;
/

Ejemplo con file_uri_list sin el parámetro column_list con archivos de datos estructurados:

BEGIN
  DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE(
  table_name => 'MYSALES',
  credential_name => 'DEF_CRED_NAME',
  DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE(
    table_name      => 'MYSALES',
    credential_name => 'DEF_CRED_NAME',
    file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/*.parquet',
    format          => 
        json_object('type' value 'parquet', 'schema' value 'first',
                    'partition_columns' value 
                          json_array(
                                json_object('name' value 'country', 'type' value 'varchar2(100)'),
                                json_object('name' value 'year', 'type' value 'number'),
                                json_object('name' value 'month', 'type' value 'varchar2(2)')
                          )
         )
    );
END;
/

CREATE_EXTERNAL_PART_TABLE Procedimiento para C3 Object Storage

Puede utilizar el paquete DBMS_CLOUD para crear tablas particionadas externas mediante los objetos almacenados en el cubo de almacenamiento de objetos C3.

Por ejemplo:

BEGIN
  DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE(
     table_name => 'USAGE_EXTP',
     credential_name => 'OBJECT_STORAGE_CREDENTIAL',
     file_uri_list => 'https://objectstorage.mydomain.com/n/mytenancy/b/mybucket/o/usage-data/*usage-data*.parquet',
     format => json_object(
          'type' value 'parquet', 'schema' value 'first',
          'partition_columns' value json_array(
                json_object('name' value 'year', 'type' value 'number'),         
                json_object('name' value 'month', 'type' value 'number'),
                json_object('name' value 'day', 'type' value 'number')
          )
     )
   );
END;
/

Procedimiento CREATE_EXTERNAL_TABLE

Este procedimiento crea una tabla externa en archivos de la nube o de archivos de un directorio. Permite ejecutar consultas en datos externos desde Autonomous Database.

Sintaxis

DBMS_CLOUD.CREATE_EXTERNAL_TABLE (
    table_name       IN VARCHAR2,
    credential_name  IN VARCHAR2,
    file_uri_list    IN CLOB,
    column_list      IN CLOB,
    field_list       IN CLOB DEFAULT,
    format           IN CLOB DEFAULT);

Parámetros

parámetro	Descripción
`table_name`	Nombre de la tabla externa.
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage. Este parámetro no se utiliza al especificar un directorio o una URL de hiperenlace de tabla con `file_uri_list`.
`file_uri_list`	Este parámetro especifica una lista delimitada por comas de los URI de archivo de origen o uno o más directorios y archivos de origen. URI de archivo de origen de nube Puede utilizar comodines y expresiones regulares en los nombres de archivo en los URI de archivo de origen de la nube. Las expresiones regulares solo se pueden utilizar cuando el parámetro `regexuri` `format` está definido en `TRUE`. 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 la subcarpeta en los URI y la coincidencia de patrones es idéntica a la realizada por la función `REGEXP_LIKE`. Esta opción solo está soportada con tablas externas creadas en un archivo de Object Storage. Por ejemplo: `file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)year=[0-9]+(/)month=[0-9]+(/)[a-z]+[1-3]??.csv'` El formato de los URI depende del servicio de Cloud Object Storage que utilice. Para obtener más información, consulte Formatos de URI de almacenamiento de objetos en la nube. Consulte Condición REGEXP_LIKE en Referencia de lenguaje SQL 19c de Oracle Database u Referencia de lenguaje SQL de Oracle Database 23ai para obtener más información sobre la condición `REGEXP_LIKE`. Directorio Puede especificar un directorio y uno o más nombres de archivos o utilizar una lista separada por comas de directorios y nombres de archivos. El formato para especificar un directorio es:`'MY_DIR:filename.ext'`. Por defecto, el nombre de directorio `MY_DIR` es un objeto de base de datos y no distingue entre mayúsculas y minúsculas. El nombre de archivo distingue mayúsculas. Puede utilizar comodines para especificar nombres de archivo en un directorio. Se puede utilizar el carácter "" como comodín para varios caracteres; el carácter "?" se puede utilizar como comodín para un solo carácter. Por ejemplo:`'MY_DIR:"` o `'MY_DIR:test?'` Para especificar varios directorios, utilice una lista separada por comas de directorios: por ejemplo:`'MY_DIR1:, MY_DIR2:test?'` Utilice comillas dobles para especificar un nombre de directorio sensible a mayúsculas/minúsculas. Por ejemplo:`'"my_dir1":*, "my_dir2":Test?'` Para incluir un carácter de comillas, utilice dos comillas. Por ejemplo:`'MY_DIR:''filename.ext'`. Especifica que `filename` empieza por una comilla (`'`).
`column_list`	Lista delimitada por comas de nombres de columna y tipos de datos para la tabla externa.
`field_list`	Identifica los campos en los archivos de origen y sus tipos de datos. El valor por defecto es nulo, lo que significa que los campos y sus tipos de datos están determinados por el parámetro `column_list`. La sintaxis de este argumento es la misma que la cláusula `field_list` de las tablas externas normales de Oracle Database. Para obtener más información sobre `field_list`, consulte ORACLE_LOADER Access Driver field_list en la cláusula field_definitions en Oracle Database 19c Utilities u Oracle Database 23ai Utilities.
`format`	Opciones que describen el formato de los archivos de origen. Para obtener una lista de las opciones y cómo especificar los valores, consulte Parámetro de formato. Para los archivos de formato Avro, ORC o Parquet, consulte Procedimiento CREATE_EXTERNAL_TABLE para archivos de Avro, ORC o Parquet.

Notas de uso

El procedimiento DBMS_CLOUD.CREATE_EXTERNAL_TABLE soporta archivos externos en los servicios de almacenamiento de objetos en la nube soportados, incluido Azure Blob Storage.

La credencial es una propiedad de nivel de tabla; los archivos externos deben estar en el mismo almacén de objetos.

Consulte Formatos de URI de almacenamiento de objetos en la nube para obtener más información.
El delimitador de registro por defecto es detected newline. Con detected newline, DBMS_CLOUD intenta buscar automáticamente el carácter de nueva línea correcto que se va a utilizar como delimitador de registro. DBMS_CLOUD busca primero el carácter de línea nueva \r\n de Windows. Si encuentra el carácter de línea nueva de Windows, este se utiliza como delimitador de registro para todos los archivos del procedimiento. Si no se encuentra un carácter de línea nueva de Windows, DBMS_CLOUD busca el carácter de línea nueva de UNIX/Linux \n y si encuentra uno utiliza \n como delimitador de registro para todos los archivos del procedimiento. Si los archivos de origen utilizan una combinación de diferentes delimitadores de registro, puede que aparezca un error como, por ejemplo, "KUP-04020: found record longer than buffer size supported". En este caso, debe modificar los archivos de origen para utilizar el mismo delimitador de registro o solo especificar los archivos de origen que utilizan el mismo delimitador de registro.

Consulte Parámetro de formato para obtener información sobre la opción de formato recorddelimiter.

Ejemplo

BEGIN  
   DBMS_CLOUD.CREATE_EXTERNAL_TABLE(   
      table_name =>'WEATHER_REPORT_DOUBLE_DATE',   
      credential_name =>'OBJ_STORE_CRED',   
      file_uri_list =>'&base_URL/Charlotte_NC_Weather_History_Double_Dates.csv',
      format => json_object('type' value 'csv', 'skipheaders' value '1'),   
      field_list => 'REPORT_DATE DATE''mm/dd/yy'',                   
                     REPORT_DATE_COPY DATE ''yyyy-mm-dd'',
                     ACTUAL_MEAN_TEMP,                 
                     ACTUAL_MIN_TEMP,                 
                     ACTUAL_MAX_TEMP,                 
                     AVERAGE_MIN_TEMP,                    
                     AVERAGE_MAX_TEMP,     
                     AVERAGE_PRECIPITATION',   
      column_list => 'REPORT_DATE DATE,   
                     REPORT_DATE_COPY DATE,
                     ACTUAL_MEAN_TEMP NUMBER,  
                     ACTUAL_MIN_TEMP NUMBER,  
                     ACTUAL_MAX_TEMP NUMBER,  
                     AVERAGE_MIN_TEMP NUMBER,   
                     AVERAGE_MAX_TEMP NUMBER,                  
                     AVERAGE_PRECIPITATION NUMBER');
   END;
/ 

SELECT * FROM WEATHER_REPORT_DOUBLE_DATE where         
   actual_mean_temp > 69 and actual_mean_temp < 74

CREATE_EXTERNAL_TABLE Procedimiento para C3 Object Storage

Puede utilizar el paquete DBMS_CLOUD para crear tablas externas mediante los objetos almacenados en el cubo de almacenamiento de objetos C3.

Por ejemplo:

BEGIN
  DBMS_CLOUD.CREATE_EXTERNAL_TABLE(
     table_name =>'CHANNELS_EXT',
     credential_name =>'OBJECT_STORAGE_CREDENTIAL',
     file_uri_list => '<https://objectstorage.mydomain.com/n/mytenancy/b/mybucket/o/channels.txt>',
     format => json_object('delimiter' value ','),
     column_list => 'CHANNEL_ID NUMBER, CHANNEL_DESC VARCHAR2(20), CHANNEL_CLASS VARCHAR2(20)'
  );
END;
/

CREATE_EXTERNAL_TABLE Procedimiento para Apache Iceberg

Este procedimiento crea tablas externas para tablas de Apache Iceberg en las configuraciones soportadas.

Se admiten estas configuraciones específicas:

Tablas de Iceberg en AWS:
- Tablas de iceberg registradas en AWS Glue Data Catalog, creadas con Spark o Athena.
  Para obtener más información, consulte Uso del conector AWS Glue para leer y escribir tablas de Apache Iceberg con transacciones ACID y realizar viajes en el tiempo y Uso de tablas Iceberg.
- Las tablas Iceberg se almacenan en AWS S3 proporcionando directamente la URL para el archivo de metadatos raíz.
Iceberg tables en OCI:
- Tablas de iceberg generadas con OCI Data Flow mediante un catálogo de Hadoop.
  Para obtener más información, consulte Ejemplos de Oracle Data Flow y Uso de un catálogo de Hadoop.
- Las tablas de Iceberg se almacenan en OCI Object Storage proporcionando directamente la URL para el archivo de metadatos raíz.

Sintaxis

DBMS_CLOUD.CREATE_EXTERNAL_TABLE (
    table_name       IN VARCHAR2,
    credential_name  IN VARCHAR2 DEFAULT NULL,
    file_uri_list    IN CLOB,
    column_list      IN CLOB DEFAULT NULL,
    field_list       IN CLOB DEFAULT NULL,
    format           IN CLOB DEFAULT NULL
);

Parámetros

parámetro	Descripción
`table_name`	Nombre de la tabla externa.
`credential_name`	Nombre de la credencial utilizada para acceder a los archivos de datos, los archivos de metadatos y el catálogo de Iceberg (si se utiliza). Para las configuraciones de AWS y OCI, la credencial se debe crear como se describe en el procedimiento CREATE_CREDENTIAL. Actualmente no se admiten las credenciales de AWS Amazon Resource Names (ARN).
`file_uri_list`	Debe ser NULL si se especifica un catálogo de Iceberg (consulte el parámetro `format` a continuación). Si no se utiliza un catálogo de iceberg, `file_uri_list` debe contener el URI del archivo de metadatos de iceberg.
`column_list`	Debe ser NULL, ya que los nombres y tipos de columna se derivan automáticamente de los metadatos de Iceberg. Los nombres de columna coinciden con los nombres encontrados en los archivos de datos subyacentes (Parquet, Avro, ORC). Los tipos de dato de Oracle se derivan mediante las asignaciones Parquet/Avro/ORC entre los tipos de dato Iceberg y Parquet, Avro y ORC. Por lo tanto, los usuarios no pueden especificar `column_list`.
`field_list`	Debe ser NULL, ya que los nombres de columna y los tipos de dato se derivan automáticamente de los metadatos de Iceberg.
`format`	El parámetro `format` tiene una estructura diferente según el tipo de tabla Iceberg y qué información se utiliza para crear la tabla externa, por ejemplo, información de un catálogo de datos o un URI de metadatos directos. Consulte Soporte de Iceberg en muestras de OCI Data Flow y Formatos de URI DBMS_CLOUD para obtener más información.

Ejemplo de parámetro de formato para tablas de AWS Iceberg utilizando un catálogo de AWS Glue

A continuación se muestra un parámetro format de ejemplo al crear tablas en una tabla AWS Iceberg mediante un catálogo de AWS Glue:

format => json_object('access_protocol' value
       json_object('protocol_type' value 'iceberg',
                   'protocol_config' value
                    json_object('iceberg_catalog_type' value 'aws_glue',
                                'iceberg_glue_region'  value 'glue region',
                                'iceberg_table_path'   value 'database_name.table_name')));

Donde, el parámetro access_protocol contiene un objeto JSON con dos elementos de la siguiente manera:

protocol_type: debe ser 'iceberg'
protocol_config: objeto JSON anidado que especifica los detalles del catálogo de iceberg.
- iceberg_catalog_type: debe ser 'aws_glue'
- iceberg_glue_region: región del catálogo, por ejemplo, 'us-west-1'
- iceberg_table_path: ruta de acceso glue database.glue table name.

Parámetro de formato de ejemplo para la tabla Iceberg de AWS mediante un URI de archivo de metadatos

A continuación se muestra un parámetro format de ejemplo al crear tablas en una tabla de AWS Iceberg mediante un URI de archivo de metadatos:

format => json_object('access_protocol' value
       json_object('protocol_type' value 'iceberg')

Parámetro de formato de ejemplo para la tabla OCI Iceberg mediante el catálogo HadoopCatalog

A continuación se muestra un parámetro format de ejemplo al crear tablas en una tabla de OCI Iceberg creada por OCI Data Flow mediante el catálogo HadoopCatalog:

format => json_object('access_protocol' value
       json_object('protocol_type'   value 'iceberg',
                   'protocol_config' value
                   json_object('iceberg_catalog_type'  value 'hadoop',
                               'iceberg_warehouse'     value '<OCI folder URI>',
                               'iceberg_table_path'    value 'database_name.table_name')));

Donde, el parámetro access_protocol contiene un objeto JSON con dos elementos de la siguiente manera:

protocol_type: debe ser 'iceberg'
protocol_config: objeto JSON anidado que especifica los detalles del catálogo de iceberg.
- iceberg_catalog_type: debe ser 'hadoop'
- iceberg_warehouse: ruta de acceso del directorio de almacén que se utiliza al generar la tabla, en formato URI nativo.
- iceberg_table_path: ruta de acceso database_name.table name utilizada al crear la tabla.

Parámetro de formato de ejemplo para la tabla OCI Iceberg mediante el URI del archivo de metadatos

A continuación se muestra un parámetro format de ejemplo al crear tablas en una tabla de OCI Iceberg mediante el URI del archivo de metadatos:

format => json_object('access_protocol' value
       json_object('protocol_type' value 'iceberg')

Donde el parámetro access_protocol contiene un objeto JSON con un elemento como se indica a continuación:

protocol_type: debe ser 'iceberg'

CREATE_EXTERNAL_TABLE Procedimiento para archivos Avro, ORC o Parquet

Este procedimiento con el parámetro format type definido en el valor avro, orc o parquet crea una tabla externa con archivos de formato Avro, ORC o Parquet en la nube o en un directorio.

Permite ejecutar consultas en datos externos desde Autonomous Database.

Sintaxis

DBMS_CLOUD.CREATE_EXTERNAL_TABLE (
    table_name       IN VARCHAR2,
    credential_name  IN VARCHAR2 DEFAULT NULL,
    file_uri_list    IN CLOB,
    column_list      IN CLOB,
    field_list       IN CLOB DEFAULT,
    format           IN CLOB DEFAULT);

Parámetros

parámetro	Descripción
`table_name`	Nombre de la tabla externa.
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage. Este parámetro no se utiliza al especificar un directorio con `file_uri_list`.
`file_uri_list`	Este parámetro especifica una lista delimitada por comas de los URI de archivo de origen o uno o más directorios y archivos de origen. URI de archivo de origen de nube Puede utilizar comodines y expresiones regulares en los nombres de archivo en los URI de archivo de origen de la nube. Las expresiones regulares solo se pueden utilizar cuando el parámetro `regexuri` `format` está definido en `TRUE`. 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 la subcarpeta en los URI y la coincidencia de patrones es idéntica a la realizada por la función `REGEXP_LIKE`. Esta opción solo está soportada con tablas externas creadas en un archivo de Object Storage. Por ejemplo: `file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)year=[0-9]+(/)month=[0-9]+(/)[a-z]+[1-3]??.parquet'` El formato de los URI depende del servicio de Cloud Object Storage que utilice. Para obtener más información, consulte Formatos de URI de almacenamiento de objetos en la nube. Consulte Condición REGEXP_LIKE en Referencia de lenguaje SQL 19c de Oracle Database u Referencia de lenguaje SQL de Oracle Database 23ai para obtener más información sobre la condición `REGEXP_LIKE`. Directorio Puede especificar un directorio y uno o más nombres de archivos o utilizar una lista separada por comas de directorios y nombres de archivos. El formato para especificar un directorio es:`'MY_DIR:filename.ext'`. Por defecto, el nombre de directorio `MY_DIR` es un objeto de base de datos y no distingue entre mayúsculas y minúsculas. El nombre de archivo distingue mayúsculas. Puede utilizar comodines para especificar nombres de archivo en un directorio. Se puede utilizar el carácter "" como comodín para varios caracteres; el carácter "?" se puede utilizar como comodín para un solo carácter. Por ejemplo:`'MY_DIR:"` o `'MY_DIR:test?'` Para especificar varios directorios, utilice una lista separada por comas de directorios: por ejemplo:`'MY_DIR1:, MY_DIR2:test?'` Utilice comillas dobles para especificar un nombre de directorio sensible a mayúsculas/minúsculas. Por ejemplo:`'"my_dir1":*, "my_dir2":Test?'` Para incluir un carácter de comillas, utilice dos comillas. Por ejemplo:`'MY_DIR:''filename.ext'`. Especifica que `filename` empieza por una comilla (`'`).
`column_list`	(Opcional) Este campo, cuando se especifica, sustituye el parámetro `format->schema` que especifica que el esquema, las columnas y los tipos de datos se derivan automáticamente. Consulte el parámetro format para obtener más información. Si se especifica `column_list` para el origen Avro, ORC o Parquet, los nombres de columna deben coincidir con las columnas encontradas en el archivo. Los tipos de datos de Oracle se deben asignar correctamente a los tipos de datos Avro, ORC o Parquet. Para los archivos de Parquet, consulte Asignación de tipo de datos de Parquet a Oracle en el paquete DBMS_CLOUD. Para los archivos ORC, consulte Asignación de tipo de datos de ORC a Oracle en el paquete DBMS_CLOUD para obtener información. Para los archivos de Avro, consulte Asignación de tipo de datos de Avro a Oracle en el paquete DBMS_CLOUD para obtener más información.
`field_list`	Se ignora para los archivos Avro, ORC o Parquet. Los campos del origen coinciden con las columnas de la tabla externa por nombre. Los tipos de datos de origen se convierten en el tipo de datos de columna de tabla externa. Para los archivos ORC, consulte Asignación de tipo de datos de ORC a Oracle en el paquete DBMS_CLOUD Para los archivos de Parquet, consulte Asignación de tipo de datos de Parquet a Oracle en el paquete DBMS_CLOUD. Para los archivos de Avro, consulte Asignación de tipo de datos de Avro a Oracle en el paquete DBMS_CLOUD para obtener más información.
`format`	Para los archivos de origen Avro, ORC o Parquet `type`, consulte DBMS_CLOUD Opciones de formato del paquete para Avro, ORC o Parquet para obtener más información.

Ejemplos de ORC

format => '{"type":"orc", "schema": "all"}'

format => json_object('type' value 'orc', 'schema' value 'first')

Ejemplos de Avro

format => '{"type":"avro", "schema": "all"}'

format => json_object('type' value 'avro', 'schema' value 'first')

Ejemplos de Parquet

format => '{"type":"parquet", "schema": "all"}'

format => json_object('type' value 'parquet', 'schema' value 'first')

Asignación de nombres de columna de Avro, ORC o Parquet a nombres de columna de Oracle

Consulte Asignación de nombres de Avro, ORC y Parquet a la columna de Oracle en el paquete DBMS_CLOUD para obtener información sobre la asignación de nombres de columna y el uso de conversión de nombres de columna en Oracle SQL.

Procedimiento CREATE_EXTERNAL_TEXT_INDEX

Con este procedimiento se crea un índice de texto en los archivos de Object Storage.

El procedimiento CREATE_EXTERNAL_TEXT_INDEX crea un índice de texto en los archivos de Object Storage especificados en la ubicación location_uri. El índice se refresca a intervalos regulares para las nuevas adiciones o supresiones realizadas con archivos en el URI de ubicación.

Sintaxis

DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX (
      credential_name  IN  VARCHAR2 DEFAULT NULL,
      location_uri     IN  VARCHAR2,
      index_name       IN  VARCHAR2,
      format           IN  CLOB     DEFAULT NULL
);

Parámetros

parámetro	Descripción
`credential_name`	Nombre de la credencial para acceder a la ubicación de Cloud Object Storage. Para los URI de cubo públicos, autenticados previamente o firmados previamente, se puede especificar un valor NULL. Si no proporciona un valor `credential_name`, `credential_name` se define en un valor `NULL`.
`location_uri`	Este parámetro especifica la lista delimitada por comas de los URI de archivo de origen. Puede utilizar comodines y expresiones regulares en los nombres de archivo de los URI de archivo de origen de nube. Este parámetro es obligatorio. URI de archivo de origen en la nube Este parámetro especifica una lista delimitada por comas de URI de archivo de origen o uno o más directorios y archivos de origen. Las expresiones regulares solo se pueden utilizar cuando el parámetro `regexuri` `format` está definido en `TRUE`. 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`. Ejemplo de uso de expresiones regulares: `location_uri => 'https://objectstorage.my$region.oraclecloud.com/n/namespace-string/b/bucketname/o(/)year=[0-9]+(/)month=[0-9]+(/)[a-z]+[1-3]??.csv'` Ejemplo de uso de comodines: `location_uri => 'https://objectstorage.my$region.oraclecloud.com/n/namespace-string/b/bucketname/o/year=????/month=??/.csv` El formato de los URI depende del servicio Cloud Object Storage que utilice; para obtener información, consulte Formatos de URI en la nube de almacenamiento de objetos. Consulte Condición REGEXP_LIKE para obtener más información sobre la condición `REGEXP_LIKE`.
`index_name`	Especifica el nombre del índice que está creando en los archivos ubicados en la ubicación `location_uri`. Este parámetro es obligatorio.
`format`	Especifica opciones de configuración adicionales. Las opciones se especifican como una cadena JSON. Las opciones de formato soportadas son: `refresh_rate`: especifica la frecuencia en minutos en la que se refresca el índice local. Las nuevas cargas y supresiones de archivos dan como resultado un refrescamiento de índice. El valor por defecto es de 5 minutos. `binary_files`: especifica si el contenido de los archivos que se van a indexar es binario. Por ejemplo, PDF, MS-Word, el valor por defecto es `FALSE`. `stop_words`: especifica que se puede proporcionar una lista de palabras de parada al crear índices. El valor `stop_words` indica si se trata de una lista de palabras irrelevantes o de una tabla de palabras irrelevantes. Cuando se proporciona una matriz JSON, el parámetro de palabras de parada se trata como una lista; de lo contrario, el parámetro de palabras de parada se trata como un nombre de tabla cuya columna "`STOP_WORDS`" se utiliza para leer en la lista de palabras de parada. Puede especificar palabras de parada mediante los siguientes métodos: Matriz JSON: por ejemplo: `format := '{"stop_words":["king","queen"]}'` Nombre de tabla de palabras de parada: por ejemplo: `format := '{"stop_words":"STOP_WORDS_TABLE"}'` Si no proporciona un parámetro `format`, `format` se define en un valor `NULL`.

Ejemplo

BEGIN 
DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX (
        credential_name => 'DEFAULT_CREDENTIAL',
        location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/ts_data/'
        index_name      => 'EMP',
        format          => JSON_OBJECT ('refresh_rate' value 10)
);
END;
/

Procedimiento CREATE_HYBRID_PART_TABLE

Con este procedimiento se crea una tabla particionada híbrida. Esto permite ejecutar consultas en datos particionados híbridos desde Autonomous Database mediante objetos y archivos de base de datos en la nube, u objetos y archivos de base de datos en un directorio.

Sintaxis

DBMS_CLOUD.CREATE_HYBRID_PART_TABLE (
    table_name           IN VARCHAR2,
    credential_name      IN VARCHAR2,
    partitioning_clause  IN CLOB,
    column_list          IN CLOB,
    field_list           IN CLOB DEFAULT,
    format               IN CLOB DEFAULT);

Parámetros

parámetro	Descripción
`table_name`	Nombre de la tabla externa.
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage.
`partitioning_clause`	Especifica la cláusula de partición completa, incluida la información de ubicación para particiones individuales. Para utilizar directorios, la cláusula de partición soporta los valores `LOCATION` y `DEFAULT DIRECTORY`. Puede utilizar comodines y expresiones regulares en los nombres de archivo en los URI de archivo de origen de la nube. Las expresiones regulares solo se pueden utilizar cuando el parámetro `regexuri` `format` está definido en `TRUE`. 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 la 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. Por ejemplo: `partitioning_clause => 'partition by range (col1) (partition p1 values less than (1000) external location ( ''https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)year=[0-9]+(/)month=[0-9]+(/)*[a-z]+[1-3]??.txt''),….` Consulte Condición REGEXP_LIKE en Referencia de lenguaje SQL 19c de Oracle Database u Referencia de lenguaje SQL de Oracle Database 23ai para obtener más información sobre la condición `REGEXP_LIKE`.
`column_list`	Lista delimitada por comas de nombres de columna y tipos de datos para la tabla externa.
`field_list`	Identifica los campos en los archivos de origen y sus tipos de datos. El valor por defecto es NULL significa que los campos y sus tipos de datos están determinados por el parámetro column_list. La sintaxis de este argumento es la misma que la cláusula `field_list` de las tablas externas normales de Oracle. Para obtener más información, consulte field_list en Oracle Database 19c Utilities o Oracle Database 23ai Utilities.
`format`	Opciones que describen el formato de los archivos de origen. Para obtener una lista de las opciones y cómo especificar los valores, consulte Parámetro de formato.

Notas de uso

El procedimiento DBMS_CLOUD.CREATE_HYBRID_PART_TABLE soporta archivos externos en los servicios de almacenamiento de objetos en la nube soportados, incluido Azure Blob Storage.

La credencial es una propiedad de nivel de tabla; los archivos externos deben estar en el mismo almacén de objetos.

Consulte Formatos de URI de almacenamiento de objetos en la nube para obtener más información.
El procedimiento DBMS_CLOUD.CREATE_HYBRID_PART_TABLE admite archivos particionados híbridos en directorios, ya sea en un sistema de archivos local o en un sistema de archivos de red.
Las tablas particionadas externas que crea con DBMS_CLOUD.CREATE_HYBRID_PART_TABLE incluyen dos columnas invisibles file$path y file$name. Estas columnas ayudan a identificar el archivo del que procede un registro.
- file$path: especifica el texto de la ruta del archivo hasta el principio del nombre del objeto.
- file$name: especifica el nombre del objeto, incluido todo el texto que sigue al nombre del cubo.

Ejemplos

BEGIN  
   DBMS_CLOUD.CREATE_HYBRID_PART_TABLE(
      table_name =>'HPT1',  
      credential_name =>'OBJ_STORE_CRED',  
      format => json_object('delimiter' value ',', 'recorddelimiter' value 'newline', 'characterset' value 'us7ascii'),  
      column_list => 'col1 number, col2 number, col3 number',
      partitioning_clause => 'partition by range (col1)
                                (partition p1 values less than (1000) external location
                                    ( ''&base_URL/file_11.txt'')
                                 ,
                                 partition p2 values less than (2000) external location
                                    ( ''&base_URL/file_21.txt'')
                                 ,
                                 partition p3 values less than (3000)
                                 )'
     );
   END;
/ 


BEGIN
   DBMS_CLOUD.CREATE_HYBRID_PART_TABLE(
    table_name  => 'HPT1',
    format      => json_object('delimiter'value ',', 'recorddelimiter'value 'newline'),
    column_list => 'NAME VARCHAR2(30), GENDER VARCHAR2(10), BALANCE number',
    partitioning_clause => 'partition by range (B  2  ALANCE)
               (partition p1 values less than (1000) external DEFAULT DIRECTORY DATA_PUMP_DIR LOCATION (''Scott_male_1000.csv''),
                partition p2 values less than (2000) external DEFAULT DIRECTORY DATA_PUMP_DIR LOCATION (''Mary_female_3000.csv''),
                partition p3 values less than (3000))' );
END;
/

Procedimiento DELETE_ALL_OPERATIONS

Este procedimiento borra todas las operaciones de carga de datos registradas en la tabla user_load_operations del esquema o todas las operaciones de carga de datos del tipo especificado, según se haya indicado con el parámetro type.

Sintaxis

DBMS_CLOUD.DELETE_ALL_OPERATIONS (
	type      IN VARCHAR DEFAULT NULL);

Parámetros

parámetro Descripción

parámetro	Descripción
`type`	Especifica el tipo de operación que se va a suprimir. Los valores de tipo se pueden encontrar en la columna `TYPE` de la tabla `user_load_operations`. Si no se especifica `type`, se suprimen todas las filas.

type

Especifica el tipo de operación que se va a suprimir. Los valores de tipo se pueden encontrar en la columna TYPE de la tabla user_load_operations.

Si no se especifica type, se suprimen todas las filas.

Notas de uso

DBMS_CLOUD.DELETE_ALL_OPERATIONS no suprime las operaciones que se están ejecutando actualmente (las operaciones con el estado "En ejecución").

Procedimiento DELETE_FILE

Este procedimiento elimina el archivo especificado del directorio especificado en Autonomous Database.

Sintaxis

 DBMS_CLOUD.DELETE_FILE ( 
       directory_name     IN VARCHAR2,
       file_name          IN VARCHAR2,
       force              IN BOOLEAN DEFAULT FALSE);

Parámetros

parámetro	Descripción
`directory_name`	Nombre del directorio en la instancia de Autonomous Database.
`file_name`	Nombre del archivo que se va a eliminar.
`force`	Ignore y no informe errores si el archivo no existe. Los valores válidos son: `TRUE` y `FALSE`. El valor por defecto es `FALSE`.

Note:

Para ejecutar DBMS_CLOUD.DELETE_FILE con un usuario que no sea ADMIN, debe otorgar privilegios de escritura en el directorio que contiene el archivo a ese usuario.Por ejemplo, ejecute el siguiente comando como ADMIN para otorgar privilegios de escritura a atpc_user:

GRANT WRITE ON DIRECTORY data_pump_dir TO atpc_user;

Ejemplo

BEGIN
   DBMS_CLOUD.DELETE_FILE(
      directory_name =>  'DATA_PUMP_DIR',
      file_name => 'exp1.dmp' );
   END;
/

Procedimiento DELETE_OBJECT

Este procedimiento suprime el objeto especificado en el almacén de objetos.

Sintaxis

DBMS_CLOUD.DELETE_OBJECT (
       credential_name      IN VARCHAR2,
       object_uri           IN VARCHAR2,
       force                IN BOOLEAN DEFAULT FALSE);

Parámetros

parámetro	Descripción
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage.
`object_uri`	URI de objeto o de archivo para el objeto que se va a suprimir. El formato del URI depende del servicio de Cloud Object Storage que utilice. Para obtener más información, consulte Formatos de URI de almacenamiento de objetos en la nube.
`force`	Ignore y no informe errores si el objeto no existe. Los valores válidos son: `TRUE` y `FALSE`. El valor por defecto es `FALSE`.

Ejemplo

BEGIN
   DBMS_CLOUD.DELETE_OBJECT(
       credential_name => 'DEF_CRED_NAME',
       object_uri => 'https://objectstorage.us-ashburn-1.oraclecloud.com/n/namespace-string/b/bucketname/o/exp1.dmp' );
   END;
/

Procedimiento DELETE_OPERATION

Este procedimiento borra las entradas de carga de datos para el ID de operación especificado registrado en las tablas user_load_operations o dba_load_operations del esquema.

Sintaxis

DBMS_CLOUD.DELETE_OPERATION (
	id      IN NUMBER);

Parámetros

parámetro	Descripción
`id`	Especifica el ID de operación asociado a las entradas del archivo log que desea suprimir.

Ejemplo

SELECT id FROM user_load_operations WHERE type LIKE '%BAD%';
EXEC DBMS_CLOUD.DELETE_OPERATION(id);

Procedimiento DROP_EXTERNAL_TEXT_INDEX

Este procedimiento borra el índice de texto en los archivos de Object Storage.

El procedimiento DROP_EXTERNAL_TEXT_INDEX borra el índice especificado creado con el procedimiento CREATE_EXTERNAL_TEXT_INDEX.

Sintaxis

DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEX (
      index_name       IN  VARCHAR2,
);

Parámetros

parámetro Descripción

parámetro	Descripción
`index_name`	Especifica el nombre del índice que va a borrar. El nombre del índice debe coincidir con el nombre proporcionado en el momento de la creación del índice. Este parámetro es obligatorio.

index_name

Especifica el nombre del índice que va a borrar.

El nombre del índice debe coincidir con el nombre proporcionado en el momento de la creación del índice.

Este parámetro es obligatorio.

Ejemplo

BEGIN 
DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEX (
        index_name => 'EMP',
);
END;
/

Procedimiento EXPORT_DATA

Con este procedimiento se exportan los datos de Autonomous Database según el resultado de una consulta. Este procedimiento está sobrecargado y admite la escritura de archivos en la nube o en un directorio.

Según el parámetro format type, el procedimiento exporta archivos a la nube o a una ubicación de directorio como archivos de texto en formato CSV, JSON, Parquet o XML.

Sintaxis

DBMS_CLOUD.EXPORT_DATA (
      credential_name   IN VARCHAR2 DEFAULT NULL,
      file_uri_list     IN CLOB,
      format            IN CLOB,
      query             IN CLOB);

DBMS_CLOUD.EXPORT_DATA (
      credential_name   IN VARCHAR2 DEFAULT NULL,
      file_uri_list     IN CLOB DEFAULT NULL,
      format            IN CLOB DEFAULT NULL,
      query             IN CLOB DEFAULT NULL,
      operation_id      OUT NOCOPY NUMBER);

Parámetros

parámetro	Descripción
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage. Cuando no se incluye el parámetro de credencial, especifica la salida a un directorio.
`file_uri_list`	Hay diferentes formas, según el valor del parámetro format y según si incluye un parámetro credential: When the `format` parameter `type` value is `json`: The JSON on Object Store or to the specified directory location is saved with a generated file name based on the value of the `file_uri_list` parameter. See File Naming for Text Output (CSV,JSON, Parquet, or XML) for more information. Cuando el valor `type` del parámetro `format` es `datapump`, `file_uri_list` es una lista delimitada por comas de los archivos de volcado. Especifica los archivos que se van a crear en el almacén de objetos. El uso de caracteres comodín y de sustitución no está soportado en `file_uri_list`. Cuando no se especifica el parámetro `credential_name`, se proporciona un nombre de directorio en `file_uri_list`. El formato de los URI depende del servicio de Cloud Object Storage que utilice. Para obtener más información, consulte Formatos de URI de almacenamiento de objetos en la nube.
`format`	Cadena JSON que proporciona opciones de formato de exportación. La opción admitida es: `type`: la opción `type` `format` es necesaria y debe tener uno de los valores: `csv` \| `datapump` \| `json` \| `parquet` \| `xml`. Consulte DBMS_CLOUD Package Format Options for EXPORT_DATA.
`query`	Utilice este parámetro para especificar una sentencia `SELECT` de modo que solo se exporten los datos necesarios. La consulta determina el contenido de los archivos que exporta como archivos de texto CSV, JSON, Parquet o XML, o como archivos de volcado. Por ejemplo: `SELECT warehouse_id, quantity FROM inventories` Cuando el valor `format` `type` es `json`, se comprueba cada resultado de consulta y, si no es JSON, según se determina con la función: `JSON_OBJECT_T.parse()`, `DBMS_CLOUD.EXPORT_DATA` transforma la consulta para incluir la función JSON_OBJECT para convertir la fila en JSON. Consulte JSON_OBJECT en Oracle Database 19c SQL Language Reference o Oracle Database 23ai SQL Language Reference y JSON_OBJECT_T Object Type en Oracle Database 19c PL/SQL Packages and Types Reference o Oracle Database 23ai PL/SQL Packages and Types Reference para obtener más información. Por ejemplo: `SELECT JSON_OBJECT(* RETURNING CLOB) from(SELECT warehouse_id, quantity FROM inventories)`
`operation_id`	Utilice este parámetro para realizar un seguimiento del progreso y del estado final de la operación de exportación como el ID correspondiente en la vista `USER_LOAD_OPERATIONS`.

Notas de uso:

El valor del parámetro query que proporcione puede ser una consulta avanzada, si es necesario, como una consulta que incluya uniones o subconsultas.
Según el parámetro de formato especificado, DBMS_CLOUD.EXPORT_DATA muestra los resultados de la consulta especificada en el almacén de objetos en la nube o en una ubicación de directorio en formatos de archivo CSV, JSON, Parquet o XML.

Consulte Exportación de datos al almacén de objetos como texto mediante DBMS_CLOUD.EXPORT_DATA y Exportación de datos a un directorio mediante DBMS_CLOUD.EXPORT_DATA para obtener más información sobre el uso de DBMS_CLOUD.EXPORT_DATA con archivos de salida CSV, JSON, Parquet o XML.
Para una salida CSV, JSON o XML, por defecto cuando un archivo generado contiene 10 MB de datos, se crea un nuevo archivo de salida. Sin embargo, si tiene menos de 10 MB de datos de resultados, puede tener varios archivos de salida, según el servicio de base de datos y el número de ECPU (OCPU si la base de datos utiliza OCPU) para la instancia de Autonomous Database.

Consulte Nomenclatura de archivos para la salida de texto (CSV, JSON, Parquet o XML) para obtener más información.

El tamaño de fragmento del archivo de salida por defecto es 10 MB para CSV, JSON o XML. Puede cambiar este valor con la opción maxfilesize del parámetro format. Consulte DBMS_CLOUD Opciones de formato del paquete para EXPORT_DATA para obtener más información.
Para la salida de Parquet, cada archivo generado tiene menos de 128 MB y se pueden generar varios archivos de salida. Sin embargo, si tiene menos de 128 MB de datos de resultados, puede tener varios archivos de salida según el servicio de base de datos y el número de ECPU (OCPU si la base de datos utiliza OCPU) para la instancia de Autonomous Database.

Consulte Nomenclatura de archivos para la salida de texto (CSV, JSON, Parquet o XML) para obtener más información.
El formato de salida de parquet solo se puede utilizar con servicios de base de datos altos y medios para instancias de Autonomous Database en una infraestructura de Exadata dedicada.

Notas de uso de DBMS_CLOUD.EXPORT_DATA con salida a un directorio

El directorio proporcionado debe existir y debe estar conectado como usuario ADMIN o tener acceso WRITE al directorio.
DBMS_CLOUD.EXPORT_DATA no crea directorios.
El procedimiento no sobrescribe los archivos. Por ejemplo, si existe un archivo de volcado en file_uri_list, DBMS_CLOUD.EXPORT_DATA notifica un error como:
```
ORA-31641: unable to create dump file  "/u02/exports/123.dmp"
ORA-27038: created file already exists
```

Ejemplos

En el siguiente ejemplo, se muestra DBMS_CLOUD.EXPORT_DATA con el parámetro de formato type con el valor json:

BEGIN  
   DBMS_CLOUD.EXPORT_DATA(
      credential_name => 'OBJ_STORE_CRED',
      file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/exp1.json', 
      query           => 'SELECT * FROM DEPT',
      format          => JSON_OBJECT('type' value 'json', 'compression' value 'gzip'));
     );
   END;
/

En el siguiente ejemplo, se muestra DBMS_CLOUD.EXPORT_DATA con el parámetro de formato type con el valor xml:

BEGIN  
   DBMS_CLOUD.EXPORT_DATA(
      credential_name => 'OBJ_STORE_CRED',
      file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/exp1.xml', 
      query           => 'SELECT * FROM DEPT',
      format          => JSON_OBJECT('type' value 'xml', 'compression' value 'gzip'));
     );
   END;
/

En el siguiente ejemplo, se muestra DBMS_CLOUD.EXPORT_DATA con el parámetro de formato type con el valor csv:

BEGIN  
   DBMS_CLOUD.EXPORT_DATA(
      credential_name => 'OBJ_STORE_CRED',
      file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/exp.csv', 
      query           => 'SELECT * FROM DEPT',
      format          => JSON_OBJECT('type' value 'csv', 'delimiter' value '|', 'compression' value 'gzip', 'header' value true ));
     );
   END;
/

Procedimiento y función GET_OBJECT

Este procedimiento está sobrecargado. El formulario de procedimiento lee un objeto de Cloud Object Storage y lo copia en Autonomous Database. El formulario de función lee un objeto de Cloud Object Storage y devuelve un valor BLOB a Autonomous Database.

Sintaxis

DBMS_CLOUD.GET_OBJECT (
       credential_name      IN VARCHAR2,
       object_uri           IN VARCHAR2,
       directory_name       IN VARCHAR2,
       file_name            IN VARCHAR2 DEFAULT  NULL,
       startoffset          IN NUMBER DEFAULT  0,
       endoffset            IN NUMBER DEFAULT  0,
       compression          IN VARCHAR2 DEFAULT  NULL);


DBMS_CLOUD.GET_OBJECT(
       credential_name      IN VARCHAR2 DEFAULT NULL,
       object_uri           IN VARCHAR2,
       startoffset          IN NUMBER DEFAULT  0,
       endoffset            IN NUMBER DEFAULT  0,
       compression          IN VARCHAR2 DEFAULT  NULL)
RETURN BLOB;

Parámetros

parámetro	Descripción
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage.
`object_uri`	URI de archivo o de objeto. El formato del URI depende del servicio de Cloud Object Storage que utilice. Para obtener más información, consulte Formatos de URI de almacenamiento de objetos en la nube.
`directory_name`	Nombre del directorio en la base de datos. ^{Pie 1}
`file_name`	Especifica el nombre del archivo que se va a crear. Si no se ha especificado el nombre de archivo, este se toma desde después de la última barra inclinada del parámetro `object_uri`. Para casos especiales, por ejemplo, cuando el nombre de archivo contenga barras inclinadas, utilice el parámetro `file_name`.
`startoffset`	Desplazamiento, en bytes, desde donde comienza a leer el procedimiento.
`endoffset`	Desplazamiento, en bytes, hasta donde el procedimiento detiene la lectura.
`compression`	Especifica la compresión utilizada para almacenar el objeto. Cuando `compression` se define en `‘AUTO’`, se descomprime el archivo (el valor `‘AUTO’` implica que el objeto especificado con `object_uri` se comprime con Gzip).

^{Nota a Pie de Página 1}

Note:

Para ejecutar DBMS_CLOUD.GET_OBJECT con un usuario que no sea ADMIN, debe otorgar privilegios WRITE en el directorio a ese usuario. Por ejemplo, ejecute el siguiente comando como ADMIN para otorgar privilegios de escritura a atpc_user:

GRANT WRITE ON DIRECTORY data_pump_dir TO atpc_user;

Valores devueltos

El formulario de función lee del almacén de objetos y DBMS_CLOUD.GET_OBJECT devuelve BLOB.

Ejemplos

BEGIN 
   DBMS_CLOUD.GET_OBJECT(
     credential_name => 'OBJ_STORE_CRED',
     object_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/file.txt',
     directory_name => 'DATA_PUMP_DIR'); 
END;
/

Para leer datos de caracteres de un archivo del almacén de objetos:

SELECT to_clob(
     DBMS_CLOUD.GET_OBJECT(
       credential_name => 'OBJ_STORE_CRED',
       object_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/file.txt'))
FROM DUAL;

Para agregar una imagen almacenada en el almacén de objetos en un BLOB en la base de datos:


DECLARE
   l_blob BLOB := NULL;
BEGIN
   l_blob := DBMS_CLOUD.GET_OBJECT(
     credential_name => 'OBJ_STORE_CRED',
     object_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/MyImage.gif' );
END;
/

En este ejemplo, namespace-string es el espacio de nombres de almacenamiento de objetos de Oracle Cloud Infrastructure, y bucketname es el nombre del cubo. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

Función LIST_FILES

Esta función muestra los archivos del directorio especificado. Los resultados incluyen los nombres de archivo y metadatos adicionales sobre los archivos, como el tamaño de archivo en bytes, el registro de hora de creación y el registro de hora de la última modificación.

Sintaxis

DBMS_CLOUD.LIST_FILES (
	directory_name      IN VARCHAR2)
       RETURN TABLE;

Parámetros

parámetro	Descripción
`directory_name`	Nombre del directorio en la base de datos. Este parámetro admite comodines.

Notas de uso

Para ejecutar DBMS_CLOUD.LIST_FILES con un usuario que no sea ADMIN, debe otorgar privilegios de lectura en el directorio a ese usuario.Por ejemplo, ejecute el siguiente comando como ADMIN para otorgar privilegios de lectura a atpc_user:
```
GRANT READ ON DIRECTORY data_pump_dir TO atpc_user;
```
Esta es una función de tabla con pipeline con el tipo de retorno DBMS_CLOUD_TYPES.list_object_ret_t.
DBMS_CLOUD.LIST_FILES no obtiene el valor de total de control y devuelve NULL para este campo.
DBMS_CLOUD.LIST_FILES admite el filtrado de archivos de forma selectiva mediante la sintaxis directory:filename. Los comodines están soportados en el nombre de archivo.

Por ejemplo:

Esta es una función con pipeline que devuelve una fila para cada archivo. Por ejemplo, utilice la siguiente consulta para utilizar esta función:

SELECT * FROM DBMS_CLOUD.LIST_FILES('DATA_PUMP_DIR');

OBJECT_NAME       BYTES   CHECKSUM      CREATED              LAST_MODIFIED
------------ ---------- ----------    ---------------------  ---------------------
cwallet.sso        2965               2018-12-12T18:10:47Z   2019-11-23T06:36:54Z

Ejemplos de consultas con comodines:

Puede utilizar DBMS_CLOUD.LIST_FILES con la sintaxis DIRECTORY:FILE, ya sea especificando un archivo o utilizando comodines. * y ? son los comodines admitidos.

Ejemplo 1: muestre todos los archivos CSV que empiecen por "f" en el directorio DATA_PUMP_DIR con un comodín.

SELECT * FROM DBMS_CLOUD.LIST_FILES('DATA_PUMP_DIR:f*.csv');

Ejemplo 2: enumere el archivo f1.csv en el directorio DATA_PUMP_DIR especificando el nombre del archivo.

SELECT * FROM DBMS_CLOUD.LIST_FILES('DATA_PUMP_DIR:f1.csv');

Función LIST_OBJECTS

Esta función muestra los objetos de la ubicación especificada en el almacén de objetos. Los resultados incluyen los nombres de objetos y metadatos adicionales sobre los objetos, como el tamaño, el total de control, el registro de hora de creación y el registro de hora de la última modificación.

Sintaxis

DBMS_CLOUD.LIST_OBJECTS (
       credential_name      IN VARCHAR2,
       location_uri         IN VARCHAR2)
   RETURN TABLE;

Parámetros

parámetro Descripción

credential_name

Nombre de la credencial para acceder a Cloud Object Storage.

location_uri

URI de carpeta o cubo de almacenamiento de objetos. El formato de los URI depende del servicio Cloud Object Storage que utilice; para obtener información, consulte Formatos de URI en la nube de almacenamiento de objetos.

Los comodines se admiten para mostrar de forma selectiva archivos o subcarpetas en un URI. Los caracteres "*" y "?" se consideran caracteres comodín.

Ejemplo de uso de comodines:

location_uri => 'https://objectstorage.my$region.oraclecloud.com/n/namespace-string/b/bucketname/o/year=????/month=??/*.csv'

Notas de uso

Según las capacidades del almacén de objetos, DBMS_CLOUD.LIST_OBJECTS no devuelve valores para determinados atributos y el valor de retorno para el campo es NULL en este caso.

Todos los almacenes de objetos soportados devuelven valores para los campos OBJECT_NAME, BYTES y CHECKSUM.

En la siguiente tabla se muestra el soporte para los campos CREATED y LAST_MODIFIED por almacén de objetos:

Almacenamiento de Objetos	`CREATED`	`LAST_MODIFIED`
Nativo de Oracle Cloud Infrastructure	Devuelve el registro de hora	Devuelve el registro de hora
Swift de Oracle Cloud Infrastructure	Devuelve `NULL`	Devuelve el registro de hora
Amazon S3	Devuelve `NULL`	Devuelve el registro de hora
Compatible con Amazon S3	Devuelve `NULL`	Devuelve el registro de hora
Azure	Devuelve el registro de hora	Devuelve el registro de hora

El valor del total de control es el total de control MD5. Es un número hexadecimal de 32 caracteres que se calcula en el contenido del objeto.
Esta es una función de tabla con pipeline con el tipo de retorno DBMS_CLOUD_TYPES.list_object_ret_t.

Ejemplo

Esta es una función con pipeline que devuelve una fila para cada objeto. Por ejemplo, utilice la siguiente consulta para utilizar esta función:

SELECT * FROM DBMS_CLOUD.LIST_OBJECTS('OBJ_STORE_CRED', 
    'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/');


OBJECT_NAME   BYTES              CHECKSUM                       CREATED         LAST_MODIFIED
------------ ---------- -------------------------------- --------------------- --------------------
cwallet.sso   2965      2339a2731ba24a837b26d344d643dc07 2019-11-23T06:36:54Z

En este ejemplo, namespace-string es el espacio de nombres de almacenamiento de objetos de Oracle Cloud Infrastructure, y bucketname es el nombre del cubo. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

Procedimiento MOVE_OBJECT

Este procedimiento mueve un objeto de un cubo o carpeta de Cloud Object Storage a otro.

La carpeta o el cubo de origen y de destino pueden estar en el mismo proveedor del almacén de objetos en la nube o en otro diferente.

Cuando el origen y el destino están en distintos almacenes de objetos o tienen cuentas diferentes con el mismo proveedor de nube, puede proporcionar nombres de credenciales independientes para las ubicaciones de origen y destino.

El nombre de la credencial de origen también lo utiliza por defecto la ubicación de destino cuando no se proporciona el nombre de la credencial de destino.

Sintaxis

DBMS_CLOUD.MOVE_OBJECT (
    source_credential_name  IN  VARCHAR2 DEFAULT NULL,
    source_object_uri       IN  VARCHAR2,
    target_object_uri       IN  VARCHAR2,
    target_credential_name  IN  VARCHAR2 DEFAULT NULL
);

Parámetros

parámetro	Descripción
`source_credential_name`	Nombre de la credencial para acceder a Cloud Object Storage de origen. Si no proporciona un valor `source_credential_name`, `credential_name` se define en `NULL`.
`source_object_uri`	Especifica el URI, que apunta a la ubicación de carpeta o cubo de Object Storage de origen. Este parámetro es obligatorio. El formato de los URI depende del servicio Cloud Object Storage. Consulte Formatos de URI de almacenamiento de objetos en la nube para obtener más información.
`target_object_uri`	Especifica el URI del cubo o carpeta de Object Storage de destino, donde se deben mover los archivos. Este parámetro es obligatorio. El formato de los URI depende del servicio Cloud Object Storage. Consulte Formatos de URI de almacenamiento de objetos en la nube para obtener más información.
`target_credential_name`	Nombre de la credencial para acceder a la ubicación de almacenamiento de objetos en la nube de destino. Si no proporciona un valor `target_credential_name`, `target_object_uri` se define en el valor `source_credential_name`.

Ejemplo

BEGIN 
DBMS_CLOUD.MOVE_OBJECT (
    source_credential_name => 'OCI_CRED',
    source_object_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname1/bgfile.csv',
    target_object_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname2/myfile.csv'
);
END;
/

Procedimiento PUT_OBJECT

Este procedimiento está sobrecargado. En un formulario el procedimiento copia un archivo de Autonomous Database en Cloud Object Storage. En otro formulario, el procedimiento copia un valor BLOB de Autonomous Database en Cloud Object Storage.

Sintaxis

DBMS_CLOUD.PUT_OBJECT (
       credential_name      IN VARCHAR2,
       object_uri           IN VARCHAR2,
       directory_name       IN VARCHAR2,
       file_name            IN VARCHAR2
       compression          IN VARCHAR2 DEFAULT  NULL);


DBMS_CLOUD.PUT_OBJECT (
       credential_name      IN VARCHAR2,
       object_uri           IN VARCHAR2,
       contents             IN BLOB
       compression          IN VARCHAR2 DEFAULT  NULL);

Parámetros

parámetro	Descripción
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage.
`object_uri`	URI de archivo o de objeto. El formato del URI depende del servicio de Cloud Object Storage que utilice. Para obtener más información, consulte Formatos de URI de almacenamiento de objetos en la nube.
`directory_name`	Nombre del directorio en Autonomous Database. ^{Pie 1}
`contents`	Especifica el `BLOB` que se va a copiar de Autonomous Database en Cloud Object Storage.
`file_name`	Nombre del archivo en el directorio especificado.
`compression`	Especifica la compresión utilizada para almacenar el objeto. Valor por defecto: `NULL`

^{Nota a Pie de Página 1}

Note:

Para ejecutar DBMS_CLOUD.PUT_OBJECT con un usuario que no sea ADMIN, debe otorgar privilegios de lectura en el directorio a ese usuario. Por ejemplo, ejecute el siguiente comando como ADMIN para otorgar privilegios de lectura a atpc_user:

GRANT READ ON DIRECTORY data_pump_dir TO atpc_user;

Ejemplo

Para manejar los datos de BLOB después del procesamiento en la base de datos y, a continuación, almacenar los datos directamente en un archivo del almacén de objetos:

DECLARE
      my_blob_data BLOB;
BEGIN 
 /* Some processing producing BLOB data and populating my_blob_data */
DBMS_CLOUD.PUT_OBJECT(
     credential_name => 'OBJ_STORE_CRED',
     object_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/my_new_file',
     contents => my_blob_data)); 
END;
/

Notas de uso

Según su instancia de Cloud Object Storage, el tamaño del objeto que transfiera está limitado de la siguiente forma:

Servicio de almacenamiento de objetos en la nube	Límite de tamaño de transferencia de objeto
Oracle Cloud Infrastructure Object Storage	50 GB
Amazon S3	5 GB
Azure Blob Storage	256 MB
Compatible con Amazon S3	Lo define el proveedor del almacén de objetos. Para obtener más información, consulte la documentación del proveedor.

El almacén de objetos de Oracle Cloud Infrastructure no permite escribir archivos en un cubo público sin proporcionar credenciales (Oracle Cloud Infrastructure permite a los usuarios descargar objetos de cubos públicos). Por lo tanto, debe proporcionar un nombre de credencial con credenciales válidas para almacenar un objeto en un cubo público de Oracle Cloud Infrastructure mediante PUT_OBJECT.

Consulte Formatos de URI de almacenamiento de objetos en la nube para obtener más información.

Procedimiento SYNC_EXTERNAL_PART_TABLE

Con este procedimiento se simplifica la actualización de una tabla particionada externa desde archivos de la nube. Ejecute este procedimiento siempre que se agreguen nuevas particiones o cuando se eliminen particiones del origen del almacén de objetos para la tabla particionada externa.

Sintaxis

DBMS_CLOUD.SYNC_EXTERNAL_PART_TABLE (
	table_name        IN VARCHAR2,
	schema_name       IN VARCHAR2 DEFAULT,
	update_columns    IN BOOLEAN DEFAULT);

Parámetros

parámetro Descripción

parámetro	Descripción
`table_name`	Nombre de la tabla de destino. Es necesario crear la tabla de destino para ejecutar `DBMS_CLOUD.SYNC_EXTERNAL_PART_TABLE`.
`schema_name`	Nombre del esquema en el que reside la tabla de destino. El valor por defecto es NULL, lo que significa que la tabla de destino está en el mismo esquema que el usuario que ejecuta el procedimiento.
`update_columns`	Los nuevos archivos pueden introducir un cambio en el esquema. Las actualizaciones soportadas incluyen: nuevas columnas y columnas suprimidas. Actualizaciones a columnas existentes, por ejemplo, un cambio en el tipo de datos devuelve errores. Valor por defecto: False

table_name

Nombre de la tabla de destino. Es necesario crear la tabla de destino para ejecutar DBMS_CLOUD.SYNC_EXTERNAL_PART_TABLE.

schema_name

Nombre del esquema en el que reside la tabla de destino. El valor por defecto es NULL, lo que significa que la tabla de destino está en el mismo esquema que el usuario que ejecuta el procedimiento.

update_columns

Los nuevos archivos pueden introducir un cambio en el esquema. Las actualizaciones soportadas incluyen: nuevas columnas y columnas suprimidas. Actualizaciones a columnas existentes, por ejemplo, un cambio en el tipo de datos devuelve errores.

Valor por defecto: False

Procedimiento VALIDATE_EXTERNAL_PART_TABLE

Con este procedimiento se validan los archivos de origen para una tabla particionada externa, se genera información de log y se almacenan las filas que no coinciden con las opciones de formato especificadas para la tabla externa en una tabla de archivos incorrectos en Autonomous Database. El formulario sobrecargado permite utilizar el parámetro operation_id.

Sintaxis

DBMS_CLOUD.VALIDATE_EXTERNAL_PART_TABLE (
       table_name                 IN VARCHAR2,
       partition_name             IN CLOB DEFAULT,
       subpartition_name          IN CLOB DEFAULT,
       schema_name                IN VARCHAR2 DEFAULT,
       rowcount                   IN NUMBER DEFAULT,
       partition_key_validation   IN BOOLEAN DEFAULT,
       stop_on_error              IN BOOLEAN DEFAULT);


DBMS_CLOUD.VALIDATE_EXTERNAL_PART_TABLE (
       table_name                 IN VARCHAR2,
       operation_id               OUT NUMBER,
       partition_name             IN CLOB DEFAULT,
       subpartition_name          IN CLOB DEFAULT,
       schema_name                IN VARCHAR2 DEFAULT,
       rowcount                   IN NUMBER DEFAULT,
       partition_key_validation   IN BOOLEAN DEFAULT,
       stop_on_error              IN BOOLEAN DEFAULT);

Parámetros

parámetro	Descripción
`table_name`	Nombre de la tabla externa.
`operation_id`	Utilice este parámetro para realizar un seguimiento del progreso y del estado final de la operación de carga como el identificador correspondiente en la vista `USER_LOAD_OPERATIONS`.
`partition_name`	Si se define, solo se validan las particiones específicas. Si no se especifica, lea todas las particiones de forma secuencial hasta que se alcance `rowcount`.
`subpartition_name`	Si se define, solo se validan una subpartición específica. Si no se especifica, lea de todas las particiones o subparticiones externas de forma secuencial hasta que se alcance `rowcount`.
`schema_name`	Nombre del esquema en el que reside la tabla externa. El valor por defecto es NULL, lo que significa que la tabla externa está en el mismo esquema que el usuario que ejecuta el procedimiento.
`rowcount`	Número de filas que se van a examinar. El valor por defecto es NULL, lo que significa que se examinan todas las filas de los archivos de origen.
`partition_key_validation`	Sólo para uso interno. No utilice este parámetro.
`stop_on_error`	Determina si la validación se debe parar cuando se rechaza una fila. El valor por defecto es `TRUE`, lo que significa que la validación se para en la primera fila rechazada. Al definir el valor en `FALSE`, se especifica que la validación no se para en la primera fila rechazada y se validan todas las filas hasta el valor especificado para el parámetro `rowcount`.

Procedimiento VALIDATE_EXTERNAL_TABLE

Este procedimiento valida los archivos de origen para una tabla externa, genera información de log y almacena las filas que no coinciden con las opciones de formato especificadas para la tabla externa en una tabla de archivos incorrectos en Autonomous Database. El formulario sobrecargado permite utilizar el parámetro operation_id.

Sintaxis

DBMS_CLOUD.VALIDATE_EXTERNAL_TABLE (
	table_name      IN VARCHAR2,
	schema_name     IN VARCHAR2 DEFAULT,		
	rowcount        IN NUMBER DEFAULT,
	stop_on_error   IN BOOLEAN DEFAULT);


DBMS_CLOUD.VALIDATE_EXTERNAL_TABLE(
	table_name      IN VARCHAR2,
	operation_id    OUT NOCOPY NUMBER,
	schema_name     IN VARCHAR2 DEFAULT NULL,		
	rowcount        IN NUMBER DEFAULT 0,
	stop_on_error   IN BOOLEAN DEFAULT TRUE);

Parámetros

parámetro	Descripción
`table_name`	Nombre de la tabla externa.
`operation_id`	Utilice este parámetro para realizar un seguimiento del progreso y del estado final de la operación de carga como el identificador correspondiente en la vista `USER_LOAD_OPERATIONS`.
`schema_name`	Nombre del esquema en el que reside la tabla externa. El valor por defecto es NULL, lo que significa que la tabla externa está en el mismo esquema que el usuario que ejecuta el procedimiento.
`rowcount`	Número de filas que se van a examinar. El valor por defecto es NULL, lo que significa que se examinan todas las filas de los archivos de origen.
`stop_on_error`	Determina si la validación se debe parar cuando se rechaza una fila. El valor por defecto es `TRUE`, lo que significa que la validación se para en la primera fila rechazada. Al definir el valor en `FALSE`, se especifica que la validación no se para en la primera fila rechazada y se validan todas las filas hasta el valor especificado para el parámetro `rowcount`. Si la tabla externa hace referencia a archivos Avro, ORC o Parquet, la validación se para en la primera fila rechazada. Cuando la tabla externa especifica el parámetro `format` `type` definido en el valor `avro`, `orc` o `parquet`, el parámetro `stop_on_error` tiene siempre el valor `TRUE`. Por lo tanto, el archivo badfile de la tabla siempre estará vacío para una tabla externa que haga referencia a archivos de Avro, ORC o Parquet.

Notas de uso

DBMS_CLOUD.VALIDATE_EXTERNAL_TABLE funciona tanto con tablas particionadas externas como con tablas particionadas híbridas. Esto lee potencialmente los datos de todas las particiones externas hasta que se alcance rowcount o se aplique stop_on_error. No tiene control sobre qué partición, o partes de una partición, se lee en qué orden.

Procedimiento VALIDATE_HYBRID_PART_TABLE

Con este procedimiento se validan los archivos de origen para una tabla particionada híbrida, se genera información de log y se almacenan las filas que no coinciden con las opciones de formato especificadas para la tabla híbrida en una tabla de archivos incorrectos en Autonomous Database. El formulario sobrecargado permite utilizar el parámetro operation_id.

Sintaxis

DBMS_CLOUD.VALIDATE_HYBRID_PART_TABLE (
       table_name                 IN VARCHAR2,
       partition_name             IN CLOB DEFAULT,
       subpartition_name          IN CLOB DEFAULT,
       schema_name                IN VARCHAR2 DEFAULT,
       rowcount                   IN NUMBER DEFAULT,
       partition_key_validation   IN BOOLEAN DEFAULT,
       stop_on_error              IN BOOLEAN DEFAULT);


DBMS_CLOUD.VALIDATE_HYBRID_PART_TABLE (
       table_name                 IN VARCHAR2,
       operation_id               OUT NUMBER,
       partition_name             IN CLOB DEFAULT,
       subpartition_name          IN CLOB DEFAULT,
       schema_name                IN VARCHAR2 DEFAULT,
       rowcount                   IN NUMBER DEFAULT,
       partition_key_validation   IN BOOLEAN DEFAULT,
       stop_on_error              IN BOOLEAN DEFAULT);

Parámetros

parámetro	Descripción
`table_name`	Nombre de la tabla externa.
`operation_id`	Utilice este parámetro para realizar un seguimiento del progreso y del estado final de la operación de carga como el identificador correspondiente en la vista `USER_LOAD_OPERATIONS`.
`partition_name`	Si se define, solo se validan las particiones específicas. Si no se especifica, lea de todas las particiones externas de forma secuencial hasta que se alcance `rowcount`.
`subpartition_name`	Si se define, solo se validan una subpartición específica. Si no se especifica, lea de todas las particiones o subparticiones externas de forma secuencial hasta que se alcance `rowcount`.
`schema_name`	Nombre del esquema en el que reside la tabla externa. El valor por defecto es NULL, lo que significa que la tabla externa está en el mismo esquema que el usuario que ejecuta el procedimiento.
`rowcount`	Número de filas que se van a examinar. El valor por defecto es NULL, lo que significa que se examinan todas las filas de los archivos de origen.
`partition_key_validation`	Sólo para uso interno. No utilice este parámetro.
`stop_on_error`	Determina si la validación se debe parar cuando se rechaza una fila. El valor por defecto es `TRUE`, lo que significa que la validación se para en la primera fila rechazada. Al definir el valor en `FALSE`, se especifica que la validación no se para en la primera fila rechazada y se validan todas las filas hasta el valor especificado para el parámetro `rowcount`.