DBMS_CLOUD para la gestión masiva de archivos

Requisitos

Como desarrollador, puede utilizar procedimientos DBMS_CLOUD con bases de datos de IA autónomas desplegadas en Oracle Public Cloud, Multicloud o Exadata Cloud@Customer.

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

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

Para crear un Gateway de NAT en la red virtual en la nube (VCN) donde residen los recursos de la base de datos de IA autónoma, siga las instrucciones de Creación de un Gateway de NAT en 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 cual residan las bases de datos de IA autónoma de modo que estos recursos puedan utilizar el gateway para obtener una clave pública de su instancia deAzure AD:
1. Vaya a la página Detalles de la subred de la subred.
2. En el separador Información de subredes, haga clic en el nombre de la Tabla de ruta de la subredes para mostrar su página Detalles de tabla de ruta.
3. En la tabla de Reglas de Ruta existentes, compruebe si ya hay una regla con las siguientes características:
  - Destination: 0.0.0.0/0 (Destino):
  - Tipo de destino: gateway de NAT
  - Destino: nombre del puerta de enlace de NAT que ha creado 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 la subred de la subred.
5. En la tabla Listas de seguridad de La subred, haga clic en el nombre de su lista de seguridad 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 entrada y agregue una regla de salida con estas características.

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

El administrador de 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.

Nota: 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 que se activa, 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 Crear Solicitud de Servicio en My Oracle Support para obtener más información.

Resumen de subgrupos DBMS_CLOUD para la gestión masiva de archivos

Subprogramas para operaciones de archivos masivos en el paquete DBMS_CLOUD.

Subprograma	Descripción
Procedimiento BULK_COPY	Este procedimiento copia archivos de un cubo de Cloud Object Storage a otro.
Procedimiento BULK_DELETE	El procedimiento suprime archivos del cubo o la carpeta de Cloud Object Storage.
Procedimiento BULK_DOWNLOAD	Este procedimiento descarga archivos del cubo del almacén de objetos en la nube en un directorio de la base de datos de IA autónoma.
Procedimiento BULK_MOVE	Este procedimiento mueve archivos de un cubo de Cloud Object Storage a otro.
Procedimiento BULK_UPLOAD	Este procedimiento carga archivos de un directorio de la base de datos de IA autónoma en Cloud Object Storage.

Procedimiento BULK_COPY

Este procedimiento copia de forma masiva archivos de un cubo de Cloud Object Storage a otro. El formulario sobrecargado permite utilizar el parámetro operation_id.

Puede filtrar la lista de archivos que se suprimirán mediante un patrón de expresión regular compatible con el operador REGEXP_LIKE.

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

Cuando el origen y el destino están en almacenes de objetos distintos 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 credencial de origen también se utiliza por defecto en la ubicación de destino.

Sintaxis

DBMS_CLOUD.BULK_COPY (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_COPY (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL,
      operation_id            OUT NUMBER
);

Parámetros

parámetro	Descripción
`source_credential_name`	Nombre de la credencial para acceder a Cloud Object Storage. Si no proporciona un valor `source_credential_name`, `credential_name` se define en `NULL`.
`source_location_uri`	Especifica el URI que apunta al cubo o la ubicación de la carpeta de Object Storage de origen. Este parámetro es obligatorio. URI de archivo de origen en la nube Puede utilizar comodines y expresiones regulares en los nombres de archivo de los URI de archivo de origen de 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 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: `source_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: `source_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 en Referencia de lenguaje SQL de Oracle Database 19c o Referencia de lenguaje SQL de Oracle Database 26ai para obtener más información sobre la condición `REGEXP_LIKE`.
`target_location_uri`	Especifica el URI del cubo o la carpeta de Object Storage de destino, donde se deben copiar los archivos. Este parámetro es obligatorio. Especifica el URI que apunta al cubo o la ubicación de la carpeta 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 de archivos de paquete DBMS_CLOUD para obtener más información.
`target_credential_name`	Nombre de la credencial para acceder a la ubicación de Cloud Object Storage de destino. Si no proporciona un valor `target_credential_name`, `target_location_uri` se define en el valor `source_credential_name`.
`regex_filter`	Especifica la expresión REGEX para filtrar archivos. El patrón de expresión REGEX debe ser compatible con el operador `REGEXP_LIKE`. Si no proporciona un valor `regex_filter`, `regex_filter` se define en `NULL`. Consulte Condición REGEXP_LIKE para obtener más información.
`format`	Especifica las opciones de configuración adicionales para la operación de archivo. Estas opciones se especifican como una cadena JSON. Las opciones de formato admitidas son: `logretention`: acepta un valor entero que determina la duración en días para la que se retiene la tabla de estado para una operación masiva. El valor por defecto es de 2 días. `logprefix`: acepta un valor de cadena que determina la cadena de prefijo de nombre de tabla de estado de operación masiva. El tipo de operación es el valor por defecto. Para `BULK_COPY`, el valor `logprefix` por defecto es `COPYOBJ`. `priority`: acepta un valor de cadena que determina el número de operaciones de archivo realizadas simultáneamente. Una operación con una prioridad más alta consume más recursos de base de datos y se debe ejecutar más rápido. Acepta los siguientes valores: `HIGH`: determina el número de archivos paralelos manejados mediante el recuento de ECPU de la base de datos (recuento de OCPU si la base de datos utiliza OCPU) `MEDIUM`: determina el número de procesos simultáneos que utilizan el límite de simultaneidad para el servicio Medium. El valor por defecto es 4. `LOW`: procese los archivos en orden serie. El valor por defecto es `MEDIUM`. El número máximo de operaciones de archivo simultáneas está limitado a 64. Si no proporciona un valor `format`, `format` se define en `NULL`.
`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`.

Nota: Se devuelve un error cuando el URI de origen y de destino apuntan al mismo cubo o carpeta de Object Storage.

Ejemplo

BEGIN
DBMS_CLOUD.BULK_COPY (
     source_credential_name => 'OCI_CRED',
     source_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname1/o',
     target_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname2/o',
     format       => JSON_OBJECT ('logretention' value 7, 'logprefix' value 'BULKOP')
);
END;
/

Procedimiento BULK_DELETE

Este procedimiento suprime de forma masiva archivos de Cloud Object Storage. El formulario sobrecargado permite utilizar el parámetro operation_id. Puede filtrar la lista de archivos que se suprimirán mediante un patrón de expresión regular compatible con el operador REGEXP_LIKE.

Sintaxis

DBMS_CLOUD.BULK_DELETE(
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_DELETE (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL,
     operation_id     OUT NUMBER
);

Parámetros

parámetro	Descripción
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage. Si no proporciona un valor `credential_name`, `credential_name` se define en `NULL`.
`location_uri`	Especifica el URI, que apunta a una ubicación de Object Storage en la base de datos de IA autónoma. Este parámetro es obligatorio. URI de archivo de origen en la nube Puede utilizar comodines y expresiones regulares en los nombres de archivo de los URI de archivo de origen de 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 subcarpeta en los URI y la coincidencia de patrones es idéntica a la realizada por la función `REGEXP_LIKE`. Por ejemplo: `location_uri => '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 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 en Referencia de lenguaje SQL de Oracle Database 19c o Referencia de lenguaje SQL de Oracle Database 26ai para obtener más información sobre la condición `REGEXP_LIKE`. El formato de los URI depende del servicio Cloud Object Storage. Consulte Formatos de URI de almacenamiento de objetos en la nube de archivos de paquete DBMS_CLOUD para obtener más información.
`regex_filter`	Especifica la expresión REGEX para filtrar archivos. El patrón de expresión REGEX debe ser compatible con el operador `REGEXP_LIKE`. Si no proporciona un valor `regex_filter`, `regex_filter` se define en `NULL`. Consulte Condición REGEXP_LIKE para obtener más información.
`format`	Especifica las opciones de configuración adicionales para la operación de archivo. Estas opciones se especifican como una cadena JSON. Las opciones de formato admitidas son: `logretention`: acepta un valor entero que determina la duración en días para la que se retiene la tabla de estado para una operación masiva. El valor por defecto es de 2 días. `logprefix`: acepta un valor de cadena que determina la cadena de prefijo de nombre de tabla de estado de operación masiva. El tipo de operación es el valor por defecto. Para `BULK_DELETE`, el valor `logprefix` por defecto es `DELETE`. `priority`: acepta un valor de cadena que determina el número de operaciones de archivo realizadas simultáneamente. Una operación con una prioridad más alta consume más recursos de base de datos y se completa antes. Acepta los siguientes valores: `HIGH`: determina el número de archivos paralelos manejados mediante el recuento de ECPU de la base de datos (recuento de OCPU si la base de datos utiliza OCPU). `MEDIUM`: determina el número de procesos simultáneos que utilizan el límite de simultaneidad para el servicio Medium. El valor por defecto es 4. `LOW`: procese los archivos en orden serie. El valor por defecto es `MEDIUM`. El número máximo de operaciones de archivo simultáneas está limitado a 64. Si no proporciona un valor `format`, `format` se define en `NULL`.
`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.BULK_DELETE (
     credential_name => 'OCI_CRED',
     location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
     format          => JSON_OBJECT ('logretention' value 5, 'logprefix' value 'BULKDEL')
);
END;
/

Procedimiento BULK_DOWNLOAD

Este procedimiento descarga archivos en un directorio de base de datos de IA autónoma desde Cloud Object Storage. El formulario sobrecargado permite utilizar el parámetro operation_id. Puede filtrar la lista de archivos que se van a descargar mediante un patrón de expresión regular compatible con el operador REGEXP_LIKE.

Sintaxis

DBMS_CLOUD.BULK_DOWNLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_DOWNLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL,
     operation_id     OUT NUMBER
);

Parámetros

parámetro	Descripción
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage. Si no proporciona un valor `credential_name`, `credential_name` se define en `NULL`.
`location_uri`	Especifica el URI, que apunta a una ubicación de Object Storage en la base de datos de IA autónoma. Este parámetro es obligatorio. URI de archivo de origen en la nube Puede utilizar comodines y expresiones regulares en los nombres de archivo de los URI de archivo de origen de 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 subcarpeta en los URI y la coincidencia de patrones es idéntica a la realizada por la función `REGEXP_LIKE`. Por ejemplo: `location_uri => '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 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 en Referencia de lenguaje SQL de Oracle Database 19c o Referencia de lenguaje SQL de Oracle Database 26ai para obtener más información sobre la condición `REGEXP_LIKE`.
`directory_name`	Nombre del directorio de la base de datos de IA autónoma desde la que desea descargar los archivos. Este parámetro es obligatorio.
`regex_filter`	Especifica la expresión REGEX para filtrar archivos. El patrón de expresión REGEX debe ser compatible con el operador `REGEXP_LIKE`. Si no proporciona un valor `regex_filter`, `regex_filter` se define en `NULL`. Consulte Condición REGEXP_LIKE para obtener más información.
`format`	Especifica las opciones de configuración adicionales para la operación de archivo. Estas opciones se especifican como una cadena JSON. Las opciones de formato admitidas son: `logretention`: acepta un valor entero que determina la duración en días para la que se retiene la tabla de estado para una operación masiva. El valor por defecto es de 2 días. `logprefix`: acepta un valor de cadena que determina la cadena de prefijo de nombre de tabla de estado de operación masiva. Para `BULK_DOWNLOAD`, el valor por defecto de `logprefix` es `DOWNLOAD`. El tipo de operación es el valor por defecto. `priority`: acepta un valor de cadena que determina el número de operaciones de archivo realizadas simultáneamente. Una operación con una prioridad más alta consume más recursos de base de datos y se completa antes. Acepta los siguientes valores: `HIGH`: determina el número de archivos paralelos manejados mediante el recuento de ECPU de la base de datos (recuento de OCPU si la base de datos utiliza OCPU). `MEDIUM`: determina el número de procesos simultáneos que utilizan el límite de simultaneidad para el servicio Medium. El valor por defecto es 4. `LOW`: procese los archivos en orden serie. El valor por defecto es `MEDIUM`. El número máximo de operaciones de archivos simultáneas está limitado a 64. Si no proporciona un valor `format`, `format` se define en `NULL`.
`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.BULK_DOWNLOAD (
     credential_name => 'OCI_CRED',
     location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
     directory_name  => 'BULK_TEST',
     format          => JSON_OBJECT ('logretention' value 7, 'logprefix' value 'BULKOP')
 );
END;
/

Procedimiento BULK_MOVE

Este procedimiento mueve de forma masiva archivos de un cubo o carpeta de Cloud Object Storage a otra. El formulario sobrecargado permite utilizar el parámetro operation_id.

Puede filtrar la lista de archivos que se suprimirán mediante un patrón de expresión regular compatible con el operador REGEXP_LIKE.

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

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

El primer paso para mover archivos es copiarlos en la ubicación de destino y, a continuación, suprimir los archivos de origen, una vez que se hayan copiado correctamente.

El nombre del objeto se cambia en lugar de moverlo si el almacén de objetos permite cambiar el nombre de las operaciones entre las ubicaciones de origen y destino.

Sintaxis

DBMS_CLOUD.BULK_MOVE (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_MOVE (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL,
      operation_id            OUT NUMBER
);

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_location_uri`	Especifica el URI que apunta al cubo o la ubicación de la carpeta de Object Storage de origen. Este parámetro es obligatorio. URI de archivo de origen en la nube Puede utilizar comodines y expresiones regulares en los nombres de archivo de los URI de archivo de origen de 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 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: `source_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: `source_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 en Referencia de lenguaje SQL de Oracle Database 19c o Referencia de lenguaje SQL de Oracle Database 26ai para obtener más información sobre la condición `REGEXP_LIKE`.
`target_location_uri`	Especifica el URI del cubo o la 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 que utilice; para obtener información, consulte Formatos de URI en la nube de almacenamiento de objetos.
`target_credential_name`	Nombre de la credencial para acceder a la ubicación de Cloud Object Storage de destino. Si no proporciona un valor `target_credential_name`, `target_location_uri` se define en el valor `source_credential_name`.
`regex_filter`	Especifica la expresión REGEX para filtrar archivos. El patrón de expresión REGEX debe ser compatible con el operador `REGEXP_LIKE`. Si no proporciona un valor `regex_filter`, `regex_filter` se define en `NULL`. Consulte Condición REGEXP_LIKE para obtener más información.
`format`	Especifica las opciones de configuración adicionales para la operación de archivo. Estas opciones se especifican como una cadena JSON. Las opciones de formato admitidas son: `logretention`: acepta un valor entero que determina la duración en días para la que se retiene la tabla de estado para una operación masiva. El valor por defecto es de 2 días. `logprefix`: acepta un valor de cadena que determina la cadena de prefijo de nombre de tabla de estado de operación masiva. El tipo de operación es el valor por defecto. Para `BULK_MOVE`, el valor por defecto de `logprefix` es `MOVE`. `priority`: acepta un valor de cadena que determina el número de operaciones de archivo realizadas simultáneamente. Una operación con una prioridad más alta consume más recursos de base de datos y se completa antes. Acepta los siguientes valores: `HIGH`: determina el número de archivos paralelos manejados mediante el recuento de ECPU de la base de datos (recuento de OCPU si la base de datos utiliza OCPU). `MEDIUM`: determina el número de procesos simultáneos que utilizan el límite de simultaneidad para el servicio Medium. El valor por defecto es 4. `LOW`: procese los archivos en orden serie. El valor por defecto es `MEDIUM`. El número máximo de operaciones de archivo simultáneas está limitado a 64. Si no proporciona un valor `format`, `format` se define en `NULL`.
`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.BULK_MOVE (
     source_credential_name => 'OCI_CRED',
     source_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname1/o',
     target_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname2/o',
     format                 => JSON_OBJECT ('logretention' value 7, 'logprefix' value 'BULKMOVE')
);
END;
/

Nota: Se devuelve un error cuando el URI de origen y de destino apuntan al mismo cubo o carpeta de Object Storage.

Procedimiento BULK_UPLOAD

Este procedimiento copia archivos en Cloud Object Storage desde un directorio de base de datos de IA autónoma. El formulario sobrecargado permite utilizar el parámetro operation_id.

Sintaxis

DBMS_CLOUD.BULK_UPLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_UPLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL,
     operation_id     OUT NUMBER
);

Parámetros

parámetro	Descripción
`credential_name`	Nombre de la credencial para acceder a Cloud Object Storage. Si no proporciona un valor `credential_name`, `credential_name` se define en `NULL`.
`location_uri`	Especifica el URI, que apunta a una ubicación de Object Storage para cargar 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 de archivos de paquete DBMS_CLOUD para obtener más información.
`directory_name`	Nombre del directorio de la base de datos de IA autónoma desde la que se cargan archivos. Este parámetro es obligatorio. Directorio Puede especificar un directorio y uno o más nombres de archivo o utilizar una lista separada por comas de directorios y nombres de archivo. 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 del Archivo es sensible a mayúsculas/minúsculas. Las expresiones regulares no están soportadas al especificar los nombres de archivo en un directorio. Solo puede utilizar comodines para especificar nombres de archivo en un directorio. Se puede emplear 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 (`'`).
`regex_filter`	Especifica la expresión REGEX para filtrar archivos. El patrón de expresión REGEX debe ser compatible con el operador `REGEXP_LIKE`. Si no proporciona un valor `regex_filter`, `regex_filter` se define en `NULL`. Consulte Condición REGEXP_LIKE para obtener más información.
`format`	Especifica las opciones de configuración adicionales para la operación de archivo. Estas opciones se especifican como una cadena JSON. Las opciones de formato admitidas son: `logretention`: acepta un valor entero que determina la duración en días para la que se retiene la tabla de estado para una operación masiva. El valor por defecto es de 2 días. `logprefix`: acepta un valor de cadena que determina la cadena de prefijo de nombre de tabla de estado de operación masiva. El tipo de operación es el valor por defecto. Para `BULK_UPLOAD`, el valor `logprefix` por defecto es `UPLOAD`. `priority`: acepta un valor de cadena que determina el número de operaciones de archivo realizadas simultáneamente. Una operación con una prioridad más alta consume más recursos de base de datos y se completa antes. Acepta los siguientes valores: `HIGH`: determina el número de archivos paralelos manejados mediante el recuento de ECPU de la base de datos (recuento de OCPU si la base de datos utiliza OCPU). `MEDIUM`: determina el número de procesos simultáneos que utilizan el límite de simultaneidad para el servicio Medium. El valor por defecto es 4. `LOW`: procese los archivos en orden serie. El valor por defecto es `MEDIUM`. El número máximo de operaciones de archivos simultáneas está limitado a 64. Si no proporciona un valor `format`, `format` se define en `NULL`.
`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.BULK_UPLOAD (
     credential_name => 'OCI_CRED',
     location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
     directory_name  => 'BULK_TEST',
     format          => JSON_OBJECT ('logretention' value 5, 'logprefix' value 'BULKUPLOAD')
 );
END;
/

Contenido relacionado

Operaciones masivas para archivos en la nube