Subprogramas DBMS_CLOUD y API de REST

Utilice las credenciales del servicio de nube almacenadas para acceder a este servicio para cargar datos, para consultar datos externos que residen en la nube o para otros casos cuando utilice el procedimiento DBMS_CLOUD con un parámetro credential_name. Este procedimiento está sobrecargado:

• Utilice los parámetros relacionados con Oracle Cloud Infrastructure, que incluyen: user_ocid, tenancy_ocid, private_key y fingerprint, solo cuando utilice el autenticación de claves de firma de Oracle Cloud Infrastructure.

• Utilice el parámetro params para una de las siguientes opciones:

  • Credenciales de nombres de recursos (ARN) de Amazon

  • Credenciales de Google Analytics o Google BigQuery

  • Credenciales secretas de almacén para su uso con un almacén soportado:

    • Oracle Cloud Infrastructure Vault
    • Almacén de claves de Azure
    • AWS Secrets Manager
    • Gestor de secretos de GCP

Sintaxis

DBMS_CLOUD.CREATE_CREDENTIAL (
      credential_name   IN VARCHAR2,
      username          IN VARCHAR2,
      password          IN VARCHAR2 DEFAULT NULL,
      comments          IN VARCHAR2 DEFAULT NULL);


DBMS_CLOUD.CREATE_CREDENTIAL (
      credential_name   IN VARCHAR2,
      user_ocid         IN VARCHAR2,
      tenancy_ocid      IN VARCHAR2,
      private_key       IN VARCHAR2,
      fingerprint       IN VARCHAR2,
      comments          IN VARCHAR2 DEFAULT NULL);


DBMS_CLOUD.CREATE_CREDENTIAL (
      credential_name  IN VARCHAR2,
      params           IN CLOB DEFAULT);

Parámetros

Notas de uso

• Esta operación almacena las credenciales en la base de datos en un formato cifrado.

• Puede ver las credenciales en el esquema consultando la tabla user_credentials.

• Puede ver los comentarios de credenciales en su esquema consultando la tabla user_credentials. Por ejemplo:

  SELECT comments FROM user_credentials
          WHERE credential_name = 'MY_CRED';

• El usuario ADMIN puede ver todas las credenciales consultando la tabla dba_credentials.

• Solo tiene que crear credenciales una vez, a menos que cambien las credenciales del servicio en la nube. Una vez almacenadas las credenciales, puede utilizar el mismo nombre que las credenciales para procedimientos DBMS_CLOUD que requieren un parámetro credential_name.

• Este procedimiento está sobrecargado. Si proporciona uno de los atributos de autenticación basados en clave, user_ocid, tenancy_ocid, private_key o fingerprint, se asume que la llamada es una credencial basada en clave de firma de Oracle Cloud Infrastructure.

• Puede mostrar las credenciales de la vista ALL_CREDENTIALS. Por ejemplo, ejecute el siguiente comando para mostrar las credenciales:

  SELECT credential_name, username, comments FROM all_credentials;

Credenciales de Oracle Cloud Infrastructure (tokens de autenticación)

Para Oracle Cloud Infrastructure, username es el nombre de usuario de Oracle Cloud Infrastructure. password es el token de autenticación de Oracle Cloud Infrastructure. Consulte Trabajar con token de autenticación.

Por ejemplo:

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

Utilice credenciales basadas en token de autenticación al autenticar llamadas a OCI Object Storage. Para realizar llamadas a cualquier otro tipo de servicio en la nube de Oracle Cloud Infrastructure, utilice las credenciales basadas en claves de firma de Oracle Cloud Infrastructure.

Para OCI Object Storage, el valor del parámetro username debe incluir el dominio de identidad y el nombre de usuario del perfil. Puede encontrar el dominio de identidad asociado a un usuario en la consola de Oracle Cloud Infrastructure.

Por ejemplo:

oracleidentitycloudservice/adb_user@example.com

Con el dominio de identidad por defecto no es necesario incluir el nombre de dominio Default. Por ejemplo:

adb_user@example.com

Credenciales basadas en claves de firma de Oracle Cloud Infrastructure

Utilice los parámetros relacionados con la clave de firma de Oracle Cloud Infrastructure, que incluyen: user_ocid, tenancy_ocid, private_key y fingerprint, con la autenticación de claves de firma de Oracle Cloud Infrastructure.

Por ejemplo:

BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL (
       credential_name => ‘OCI_KEY_CRED’,
       user_ocid       => ‘ocid1.user.oc1..aaaaaaaauq54mi7zdyfhw33ozkwuontjceel7fok5nq3bf2vwetkpqsoa’,
       tenancy_ocid    => ‘ocid1.tenancy.oc1..aabbbbbbaafcue47pqmrf4vigneebgbcmmoy5r7xvoypicjqqge32ewnrcyx2a’,
       private_key     => ‘MIIEogIBAAKCAQEAtUnxbmrekwgVac6FdWeRzoXvIpA9+0r1.....wtnNpESQQQ0QLGPD8NM//JEBg=’,
       fingerprint     => ‘f2:db:f9:18:a4:aa:fc:94:f4:f6:6c:39:96:16:aa:27’);
END;
/

Las claves privadas generadas con una frase de contraseña no están soportadas. Debe generar la clave privada sin una frase de contraseña. Consulte Cómo generar una clave de firma de API para obtener más información.

Credenciales de Oracle Cloud Infrastructure Object Storage Classic

Si los archivos de origen residen en Oracle Cloud Infrastructure Object Storage Classic, username es el nombre de usuario de Oracle Cloud Infrastructure Classic, y password es la contraseña de Oracle Cloud Infrastructure Classic.

Credenciales de Amazon Web Services (AWS)

Si los archivos de origen residen en Amazon S3 o llama a una API de AWS, username es el identificador de clave de acceso de AWS, y password es la clave de acceso secreta de AWS. Consulte AWS Identity and Access Management.

Credenciales de Microsoft Azure

Si sus archivos de origen residen en Azure Blob Storage o Azure Data Lake Storage o va a llamar a una API de Azure, username es el nombre de su cuenta de almacenamiento Azure, y password es la clave del acceso de cuenta de almacenamiento de Azure. Consulte la sección acerca de las cuentas de almacenamiento de Azure.

Credenciales compatibles con Amazon S3

Credenciales de AWS Amazon Resource Names (ARN)

Si sus archivos de origen residen en Amazon S3 o está llamando a una API de AWS, utilice params para especificar los parámetros para los nombres de recursos de Amazon (ARN).

Por ejemplo:

BEGIN DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name      => 'MY_CRED',
        params               => JSON_OBJECT(
               'aws_role_arn'      value 'arn:aws:iam::123456:role/AWS_ROLE_ARN',
               'external_id_type'  value 'database_ocid'));
END;
/

Token de acceso personal de GitHub

Si los archivos de origen residen en un repositorio GitHub o llama a una API GitHub, username es su correo electrónico GitHub y password es su token de acceso personal GitHub. Consulte Creación de un token de acceso personal para obtener más información.

Por ejemplo:

BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'MY_GITHUB_CRED',
    username => 'user@example.com',
    password => 'your_personal_access_token' );
END;
/

Credenciales de Google Analytics o Google BigQuery

Si accede a Google Analytics o a Google BigQuery, utilice el parámetro params para especificar los parámetros de credenciales de Google OAuth 2.0.

Por ejemplo:

BEGIN DBMS_CLOUD.CREATE_CREDENTIAL(
      credential_name => 'GOOGLE_BIGQUERY_CRED',
      params => JSON_OBJECT('gcp_oauth2' value 
                                  JSON_OBJECT(
                                       'client_id'     value 'client_id',
                                       'client_secret' value 'client_secret',
                                       'refresh_token' value 'refresh_token' )));
END;
/

Credenciales secretas de almacén con Oracle Cloud Infrastructure Vault

Para crear credenciales de secreto de almacén con Oracle Cloud Infrastructure Vault, utilice el parámetro params para especificar los parámetros necesarios:

• username: especifica el nombre de usuario de cualquier tipo de credencial de nombre de usuario/contraseña, como el nombre de usuario de la contraseña de OCI Swift. Por ejemplo, si tiene una credencial de Swift con el nombre de usuario "scott" y la contraseña "password", proporcione "scott" como parámetro username.

• secret_id: es el ID de secreto del almacén. Especifique el valor secret_id como el OCID secreto del almacén. Consulte Visión general del almacén de claves para más información

• region: parámetro opcional que especifica el identificador de región de oracle cloud. Cuando se especifica, la región indica la ubicación en la que se encuentra el secreto de Oracle Cloud Infrastructure Vault.

  Por defecto, CREATE_CREDENTIAL utiliza el valor region asignado desde la clave de región en secret_id. Un ejemplo de región es us-ashburn-1.

  Consulte Regiones y dominios de Disponibilidad para obtener una lista completa de las regiones.

Por ejemplo:

BEGIN DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'OCI_SECRET_CRED',
    params => JSON_OBJECT( 
                'username'   value 'scott',
                'region'     value 'us-ashburn-1',
                'secret_id'  value 'ocid1.vaultsecret.co1.ap-mumbai-1.example..aaaaaaaauq5ok5nq3bf2vwetkpqsoa'));
END;
/

Notas sobre el uso de un secreto de Oracle Cloud Infrastructure Vault para almacenar secretos de almacén:

• Al utilizar Oracle Cloud Infrastructure Vault, en la instancia de Autonomous Database, debe activar la autenticación de principal con DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

• En Oracle Cloud Infrastructure, debe especificar una política para que la entidad de recurso acceda al secreto.

Para crear una credencial de secreto de almacén, debe tener el privilegio EXECUTE en el paquete DBMS_CLOUD.

Credenciales secretas de almacén con Azure Key Vault

Para crear credenciales de Azure Key Vault, utilice el parámetro params para especificar los parámetros necesarios:

• username: especifica el nombre de usuario asociado a la clave.

• secret_id: especifica el nombre del secreto.

• azure_vault_name: especifica el nombre del almacén en el que se encuentra el secreto.

Consulte Creación de un almacén de claves para obtener más información.

Para crear una credencial de secreto de almacén, debe tener el privilegio EXECUTE en el paquete DBMS_CLOUD.

Credenciales secretas de almacén con AWS Secrets Manager

Para crear credenciales de secreto de almacén con AWS Secrets Manager, utilice el parámetro params para especificar los parámetros necesarios:

• username: especifica la clave de acceso de AWS Secrets Manager.

• secret_id: AWS Secrets Manager AWS ARN.

• region: (opcional) especifica la región de servicio de AWS donde se encuentran el almacén y el secreto. Un ejemplo de la región de AWS es "us-east-2". El valor por defecto region es la región especificada con ARN en el parámetro secret_id.

  Consulte Gestión de regiones de AWS para obtener más información.

  Para crear una credencial de secreto de almacén, debe tener el privilegio EXECUTE en el paquete DBMS_CLOUD.

Credenciales secretas de almacén con GCP Secret Manager

Para crear credenciales de GCP Secret Manager, utilice el parámetro params para especificar los parámetros necesarios:

• username: especifica el nombre de usuario asociado al secreto.

• secret_id: es el nombre del secreto.

• gcp_project_id: especifica el ID del proyecto en el que se encuentra el secreto.

Consulte Gestor de secretos para obtener más información.

Para crear una credencial de secreto de almacén, debe tener el privilegio EXECUTE en el paquete DBMS_CLOUD.

Sintaxis

DBMS_CLOUD.DROP_CREDENTIAL (
   credential_name     IN VARCHAR2);

Parámetros

Este procedimiento le permite refrescar inmediatamente el secreto de almacén de una credencial de secreto de almacén para obtener la última versión del secreto de almacén para el credential_name especificado.

Sintaxis

DBMS_CLOUD.REFRESH_VAULT_CREDENTIAL (
    credential_name   IN VARCHAR2);

Parámetros

Notas de uso

• El usuario ADMIN puede ver todas las credenciales consultando la tabla dba_credentials.

• Puede mostrar las credenciales de la vista ALL_CREDENTIALS. Por ejemplo, ejecute el siguiente comando para mostrar las credenciales:

  SELECT credential_name, username, comments FROM all_credentials;

Ejemplo

BEGIN
  DBMS_CLOUD.REFRESH_VAULT_CREDENTIAL(
     credential_name => 'AZURE_SECRET_CRED'); 
END;
/

Utilice las credenciales almacenadas para cargas de datos, para consultar datos externos en la nube o dondequiera que utilice procedimientos DBMS_CLOUD con un parámetro credential_name.

Sintaxis

DBMS_CLOUD.UPDATE_CREDENTIAL (
    credential_name   IN VARCHAR2,
    attribute         IN VARCHAR2,
    value             IN VARCHAR2);

Parámetros

Notas de uso

• El valor del nombre de usuario distingue entre mayúsculas y minúsculas. No puede contener comillas dobles ni espacios.

• El usuario ADMIN puede ver todas las credenciales consultando dba_credentials.

• Solo tiene que crear credenciales una vez, a menos que cambien las credenciales del servicio en la nube. Una vez almacenadas las credenciales, puede utilizar el mismo nombre que las credenciales para procedimientos DBMS_CLOUD que requieren un parámetro credential_name.

• Puede mostrar las credenciales de la vista ALL_CREDENTIALS. Por ejemplo, ejecute el siguiente comando para mostrar las credenciales:

  SELECT credential_name, username, comments FROM all_credentials;

Ejemplos

BEGIN
  DBMS_CLOUD.UPDATE_CREDENTIAL(
     credential_name => 'OBJ_STORE_CRED',
     attribute => 'PASSWORD',
     value => 'password'); 
END;
/

BEGIN
  DBMS_CLOUD.UPDATE_CREDENTIAL(
     credential_name => 'ARN_CRED',
     attribute => 'aws_role_arn',
     value => 'NEW_AWS_ARN'); 
END;
/

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

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'

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;
/

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

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'

Nota de uso

El delimitador de registro predeterminado es detected newline. Con detected newline, DBMS_CLOUD intenta encontrar 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 nueva línea de Windows \r\n. Si encuentra el carácter en línea nueva de Windows, este se utiliza como delimitador de registro para todos los archivos del procedimiento. If a Windows newline character is not found, DBMS_CLOUD searches for the UNIX/Linux newline character \n, and if it finds one it uses \n as the record delimiter for all files in the procedure. Si los archivos de origen utilizan una combinación de diferentes delimitadores de registros, puede encontrar un error como "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 DBMS_CLOUD Package Format Options 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;
/

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

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'

Notas de uso

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

  La tabla de logs 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 como para contener el valor convertido, el valor de la columna se define en NULL. Esto no produce un registro rechazado.

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 lo utiliza por defecto la ubicación de destino cuando no se proporciona el nombre de 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

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;
/

Sintaxis

DBMS_CLOUD.CREATE_CLOUD_TABLE (
    table_name       IN VARCHAR2,
    column_list      IN CLOB,
    params           IN CLOB);

Parámetros

Notas de uso

• Atributos DEFAULT: column_list puede incluir la cláusula DEFAULT, que funciona como la cláusula DEFAULT en un CREATE TABLE ordinario. Consulte CREATE TABLE para obtener información sobre el comportamiento de la cláusula DEFAULT.

• Utilice DROP TABLE para borrar una tabla en la nube. Las tablas en la nube no soportan la papelera de reciclaje.

  Por ejemplo:

  DROP TABLE CLOUD_TAB1; 

• Puede otorgar privilegios SELECT, INSERT y UPDATE para una tabla en la nube. No se pueden otorgar otros privilegios a una tabla en la nube.

  Consulte Configuración de Privilegios y Autorización de Roles para obtener más información.

Ejemplos

EXEC DBMS_CLOUD.CREATE_CLOUD_TABLE( 'CLOUD_TAB1', 'I INTEGER, J INTEGER' );

BEGIN
  DBMS_CLOUD.CREATE_CLOUD_TABLE(
   table_name  => 'CLOUD_TABLE_WITH_DEFAULT',
   column_list => 'I INTEGER,
                   A VARCHAR2(32) DEFAULT ''ABC''' );
END;
/

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

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'

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 los 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 admite archivos particionados externos en los servicios de almacenamiento de objetos en la nube soportados, incluidos:

  • Almacenamiento de objeto de infraestructura de nube de Oracle

  • Almacenamiento de bloques de Azure o almacenamiento de lago de datos de Azure

  • Amazon S3

  • Compatible con Amazon S3, que incluye: Oracle Cloud Infrastructure Object Storage, Google Cloud Storage y Wasabi Hot Cloud Storage.

  • Repositorio de GitHub

  Consulte DBMS_CLOUD URI Formats 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 de uno de los siguientes tipos:

  VARCHAR2(n)
  NUMBER(n)
  NUMBER(p,s)
  NUMBER
  DATE
  TIMESTAMP(9)

• El delimitador de registro predeterminado es detected newline. Con detected newline, DBMS_CLOUD intenta encontrar 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 nueva línea de Windows \r\n. Si encuentra el carácter en línea nueva de Windows, este se utiliza como delimitador de registro para todos los archivos del procedimiento. If a Windows newline character is not found, DBMS_CLOUD searches for the UNIX/Linux newline character \n, and if it finds one it uses \n as the record delimiter for all files in the procedure. Si los archivos de origen utilizan una combinación de diferentes delimitadores de registros, puede encontrar un error como "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 DBMS_CLOUD Package Format Options para obtener información sobre la opción de formato recorddelmiter.

• Las tablas particionadas externas que cree con DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE incluyen dos columnas invisibles file$path y file$name. Estas columnas ayudan a identificar de qué archivo procede un registro.

  • file$path: especifica el texto de la ruta de acceso 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;
/

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

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'

Notas de uso

• El procedimiento DBMS_CLOUD.CREATE_EXTERNAL_TABLE soporta archivos particionados externos en los orígenes de almacenamiento de objeto en la nube soportados, que incluyen:

  • Almacenamiento de objeto de infraestructura de nube de Oracle

  • Almacenamiento de bloques de Azure o almacenamiento de lago de datos de Azure

  • Amazon S3

  • Compatible con Amazon S3, que incluye: Oracle Cloud Infrastructure Object Storage, Google Cloud Storage y Wasabi Hot Cloud Storage.

  • Repositorio de GitHub

  • Oracle Cloud Infrastructure Object Storage con URL de hiperenlace de tabla

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

  Consulte DBMS_CLOUD URI Formats para obtener más información.

• El delimitador de registro predeterminado es detected newline. Con detected newline, DBMS_CLOUD intenta encontrar 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 nueva línea de Windows \r\n. Si encuentra el carácter en línea nueva de Windows, este se utiliza como delimitador de registro para todos los archivos del procedimiento. If a Windows newline character is not found, DBMS_CLOUD searches for the UNIX/Linux newline character \n, and if it finds one it uses \n as the record delimiter for all files in the procedure. Si los archivos de origen utilizan una combinación de diferentes delimitadores de registros, puede encontrar un error como "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 DBMS_CLOUD Package Format Options 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

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

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'))); 

Parámetro de formato de ejemplo para la tabla Iceberg de AWS 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

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')));

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

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

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

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'

Ejemplos ORC

Ejemplos Avro

Ejemplos Parquet

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

Consulte DBMS_CLOUD Package Avro, ORC y Parquet to Oracle Column Name Mapping 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.

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 cualquier adición o supresión nueva realizada 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

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'

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

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;
/

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

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''),….

Notas de uso

• El procedimiento DBMS_CLOUD.CREATE_HYBRID_PART_TABLE admite archivos particionados externos en los servicios de almacenamiento de objetos en la nube soportados, incluidos:

  • Almacenamiento de objeto de infraestructura de nube de Oracle

  • Almacenamiento de bloques de Azure o almacenamiento de lago de datos de Azure

  • Amazon S3

  • Compatible con Amazon S3, que incluye: Oracle Cloud Infrastructure Object Storage, Google Cloud Storage y Wasabi Hot Cloud Storage.

  • Repositorio de GitHub

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

  Consulte DBMS_CLOUD URI Formats 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 cree con DBMS_CLOUD.CREATE_HYBRID_PART_TABLE incluyen dos columnas invisibles file$path y file$name. Estas columnas ayudan a identificar de qué archivo procede un registro.

  • file$path: especifica el texto de la ruta de acceso 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;
/

Sintaxis

DBMS_CLOUD.DELETE_ALL_OPERATIONS (
	type      IN VARCHAR DEFAULT NULL);

Parámetros

Notas de uso

• Este procedimiento no suprime las operaciones en ejecución actualmente (operaciones con el estado "En ejecución").

• Este procedimiento suprime las tablas de registro y los archivos log asociados con las operaciones.

Sintaxis

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

Parámetros

GRANT WRITE ON DIRECTORY data_pump_dir TO adb_user;

Ejemplo

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

Sintaxis

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

Parámetros

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;
/ 

Sintaxis

DBMS_CLOUD.DELETE_OPERATION (
	id      IN NUMBER);

Parámetros

Nota de uso

• Este procedimiento suprime las tablas de registro y los archivos log asociados con el ID de operación especificado en la entrada.

Ejemplo

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

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

Ejemplo

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

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

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 uno de estos formatos:

  • Archivos CSV, JSON, Parquet o XML.

    Consulte Exportación de datos al almacén de objetos como texto y Exportación de datos a un directorio para obtener más información sobre el uso de DBMS_CLOUD.EXPORT_DATA con archivos de salida CSV, JSON, Parquet o XML.

  • Uso del controlador de acceso ORACLE_DATAPUMP para escribir datos en un archivo de volcado.

• Para la 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 Nombre de archivo para salida de texto (CSV, JSON, Parquet o XML) para obtener más información.

  El tamaño de fragmento del archivo de salida predeterminado es de 10 MB para CSV, JSON o XML. Puede cambiar este valor con la opción maxfilesize del parámetro format. Consulte DBMS_CLOUD Package Format Options for 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 Nombre de archivo para salida de texto (CSV, JSON, Parquet o XML) para obtener más información.

Notas de uso para la salida ORACLE_DATAPUMP (DBMS_CLOUD.EXPORT_DATA con el parámetro format, opción type, datapump):

• EXPORT_DATA utiliza DATA_PUMP_DIR como directorio de registro por defecto. Por lo tanto, se necesita el privilegio de escritura en DATA_PUMP_DIR al utilizar la salida ORACLE_DATAPUMP.

• La exportación de Autonomous Database mediante DBMS_CLOUD.EXPORT_DATA con la opción type del parámetro format datapump solo soporta Oracle Cloud Infrastructure Object Storage, los almacenes de objetos de Oracle Cloud Infrastructure Object Storage Classic o la salida del directorio.

• Al especificar DBMS_CLOUD.EXPORT_DATA con la opción datapump del parámetro format type, el valor del parámetro credential_name no puede ser una entidad de recurso de OCI.

• Oracle Data Pump divide cada parte del archivo de volcado en fragmentos más pequeños para cargas más rápidas. La consola de Oracle Cloud Infrastructure Object Storage muestra varios archivos para cada parte del archivo de volcado que exporte. El tamaño de los archivos de volcado reales se mostrará como cero (0) y sus fragmentos de archivo relacionados como 10 MB o menos. Por ejemplo:

  exp01.dmp
  exp01.dmp_aaaaaa
  exp02.dmp
  exp02.dmp_aaaaaa

  Al descargar el archivo de volcado de cero bytes desde la consola de Oracle Cloud Infrastructure o mediante la CLI de Oracle Cloud Infrastructure, no obtendrá todos los archivos de volcado. Para descargar todos los archivos de volcado del almacén de objetos, utilice una herramienta que soporte Swift, como curl, y proporcione su conexión de usuario y token de autenticación Swift.

  curl -O -v -X GET -u 'user1@example.com:auth_token' \
     https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/namespace-string/bucketname/exp01.dmp

  Si importa un archivo con los procedimientos DBMS_CLOUD que soportan el parámetro format type con el valor 'datapump', solo tiene que proporcionar el nombre de archivo principal. Los procedimientos que soportan el tipo del formato 'datapump' detectan y descargan automáticamente los fragmentos.

  Cuando se utiliza DBMS_CLOUD.DELETE_OBJECT, el procedimiento detecta y suprime automáticamente los fragmentos cuando el procedimiento suprime el archivo principal.

• El procedimiento DBMS_CLOUD.EXPORT_DATA crea los archivos de volcado a partir de los valores file_uri_list que especifique, de la siguiente manera:

  • A medida que se necesitan más archivos, el procedimiento crea archivos adicionales desde file_uri_list.

  • El procedimiento no sobrescribe los archivos. Si existe un archivo de volcado en file_uri_list, DBMS_CLOUD.EXPORT_DATA informa de un error.

  • DBMS_CLOUD.EXPORT_DATA no crea cubos.

• El número de archivos de volcado que genera DBMS_CLOUD.EXPORT_DATA se determina cuando se ejecuta el procedimiento. El número de archivos de volcado que se generan depende del número de nombres de archivo que proporcione en el parámetro file_uri_list, así como del número de OCPU de Autonomous Database disponibles para la instancia, el nivel de servicio y el tamaño de los datos.

  Por ejemplo, si utiliza una instancia de Autonomous Database de 1 OCPU o el servicio low, se exporta un único archivo de volcado sin paralelismo, incluso si proporciona varios nombres de archivo. Si utiliza una instancia de Autonomous Database con 4 OCPU con el servicio medium o high, los trabajos se pueden ejecutar en paralelo y se exportan varios archivos de volcado si proporciona varios nombres de archivo.

• Los archivos de volcado que cree con DBMS_CLOUD.EXPORT_DATA no se pueden importar mediante Oracle Data Pump impdp. Según la base de datos, puede utilizar estos archivos de la siguiente forma:

  • En una instancia de Autonomous Database, puede utilizar los archivos de volcado con los procedimientos DBMS_CLOUD que soportan el parámetro format type con el valor 'datapump'. Puede importar los archivos de volcado mediante DBMS_CLOUD.COPY_DATA o puede llamar a DBMS_CLOUD.CREATE_EXTERNAL_TABLE para crear una tabla externa.

  • En cualquier otra instancia de Oracle Database, como Oracle Database 19c local, puede importar los archivos de volcado creados con el procedimiento DBMS_CLOUD.EXPORT_DATA mediante el controlador de acceso ORACLE_DATAPUMP. Consulte Descarga y carga de datos con el controlador de acceso ORACLE_DATAPUMP para obtener más información.

• El valor del parámetro query que proporcione puede ser una consulta avanzada, si es necesario, como una consulta que incluya uniones o subconsultas.

Notas de Uso para 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 informa 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 datapump:

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.dmp',
      format => json_object('type' value 'datapump', 'compression' value 'basic', 'version' value 'latest'),
      query => 'SELECT warehouse_id, quantity FROM inventories'
     );
   END;
/  

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

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, 'encryption' value ('user_defined_function' value 'ADMIN.decryption_callback')));
     );
   END;
/  

En el siguiente ejemplo se muestra DBMS_CLOUD.EXPORT_DATA exportando datos a una ubicación de directorio con el parámetro type con el valor datapump:

BEGIN
 DBMS_CLOUD.EXPORT_DATA(
    file_uri_list => 'export_dir:sales.dmp',
    format        => json_object('type' value 'datapump'),
    query         => 'SELECT * FROM sales'
 );
END;
/

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

^{Nota a pie 1}

GRANT WRITE ON DIRECTORY data_pump_dir TO adb_user;

Valores de Retorno

La pantalla 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 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 Oracle Cloud Infrastructure Object Storage Namepace, y bucketname es el nombre del cubo. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

Sintaxis

DBMS_CLOUD.LIST_FILES (
	directory_name      IN VARCHAR2)
       RETURN TABLE;

Parámetros

Notas de uso

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

  GRANT READ ON DIRECTORY data_pump_dir TO adb_user;

• Se trata de una función de tabla con líneas discontinuas 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 soporta el filtrado de archivos de forma selectiva mediante la sintaxis directory:filename. Los comodines están soportados en el nombre de archivo.

Ejemplo:

Se trata de una función de línea discontinua 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 soportados.

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: muestre 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');

Sintaxis

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

Parámetros

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 devuelto 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 soporte para los campos CREATED y LAST_MODIFIED por almacén de objetos:

  Almacén de Objetos	CREATED	LAST_MODIFIED
  Nativo de Oracle Cloud Infrastructure	Registro de hora de devoluciones	Registro de hora de devoluciones
  Swift de Oracle Cloud Infrastructure	Devuelve NULL	Registro de hora de devoluciones
  Oracle Cloud Infrastructure Classic	Devuelve NULL	Registro de hora de devoluciones
  Amazon S3	Devuelve NULL	Registro de hora de devoluciones
  Compatibles con Amazon S3	Devuelve NULL	Registro de hora de devoluciones
  Azure	Registro de hora de devoluciones	Registro de hora de devoluciones
  Repositorio de GitHub

• El valor de total de control es el total de control MD5. Se trata de un número hexadecimal de 32 caracteres que se calcula en el contenido del objeto. Se espera que tenga un valor de total de control diferente si se utiliza la credencial OCI$RESOURCE_PRINCIPAL.

• Se trata de una función de tabla con líneas discontinuas con el tipo de retorno DBMS_CLOUD_TYPES.list_object_ret_t.

Ejemplo

Se trata de una función con canalización 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 Oracle Cloud Infrastructure Object Storage Namepace, y bucketname es el nombre del cubo. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

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 lo utiliza por defecto la ubicación de destino cuando no se proporciona el nombre de 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

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;
/

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

^{Nota a pie 2}

GRANT READ ON DIRECTORY data_pump_dir TO adb_user;

Ejemplo

Para manejar datos 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

En función del almacenamiento de objetos en la nube, el tamaño del objeto que transfiere está limitado de la siguiente manera:

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 DBMS_CLOUD URI Formats para obtener más información.

Sintaxis

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

Parámetros

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

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

Notas de uso

• DBMS_CLOUD.VALIDATE_EXTERNAL_TABLE funciona tanto con tablas externas particionadas como con tablas particionadas híbridas. Esto podría leer 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 leen en qué orden.

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

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

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'

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

Notas de uso

• 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;
/

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

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'

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;
/

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

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'

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;
/

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

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'

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

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;
/

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

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;
/

DBMS_CLOUD soporta los métodos HTTP GET, PUT, POST, HEAD y DELETE. El método de la API de REST que se utilizará para una solicitud HTTP se suele documentar en la documentación de la API de REST en la nube.

Por defecto, las llamadas a la API de REST DBMS_CLOUD no guardan los resultados de la sesión. En este caso, utilizará la función DBMS_CLOUD.SEND_REQUEST para devolver resultados.

Al utilizar DBMS_CLOUD.SEND_REQUEST y definir el parámetro cache en TRUE, los resultados se guardan y puede ver los resultados anteriores en la vista SESSION_CLOUD_API_RESULTS. Guardar y consultar resultados históricos de solicitudes de API de REST DBMS_CLOUD puede ayudarle cuando necesite trabajar con los resultados anteriores en sus aplicaciones.

Por ejemplo, para consultar los resultados recientes de la API de REST DBMS_CLOUD, utilice la vista SESSION_CLOUD_API_RESULTS:

SELECT timestamp FROM SESSION_CLOUD_API_RESULTS;

Al guardar los resultados de la API de REST DBMS_CLOUD con DBMS_CLOUD.SEND_REQUEST, los datos guardados solo están disponibles en la misma sesión (conexión). Después de que la sesión se cierre, los datos guardados ya no estarán disponibles.

Utilice DBMS_CLOUD.GET_API_RESULT_CACHE_SIZE y DBMS_CLOUD.SET_API_RESULT_CACHE_SIZE para ver y definir el tamaño de caché de la API de REST DBMS_CLOUD y para desactivar el almacenamiento en caché.

Sintaxis

DBMS_CLOUD.GET_RESPONSE_HEADERS(
       resp          IN DBMS_CLOUD_TYPES.resp)
   RETURN JSON_OBJECT_T;

Parámetros

Excepciones

Sintaxis

DBMS_CLOUD.GET_RESPONSE_RAW(
       resp          IN DBMS_CLOUD_TYPES.resp)
   RETURN BLOB;

Parámetros

Excepciones

Sintaxis

DBMS_CLOUD.GET_RESPONSE_STATUS_CODE(
       resp          IN DBMS_CLOUD_TYPES.resp)
   RETURN PLS_INTEGER;

Parámetros

Excepciones

Sintaxis

DBMS_CLOUD.GET_RESPONSE_TEXT(
       resp          IN DBMS_CLOUD_TYPES.resp)
   RETURN CLOB;

Parámetros

Excepciones

Sintaxis

DBMS_CLOUD.GET_API_RESULT_CACHE_SIZE()
   RETURN NUMBER;

Sintaxis

DBMS_CLOUD.SEND_REQUEST(
       credential_name    IN VARCHAR2,
       uri                IN VARCHAR2,
       method             IN VARCHAR2,
       headers            IN CLOB DEFAULT NULL,
       async_request_url  IN VARCHAR2 DEFAULT NULL,
       wait_for_states    IN DBMS_CLOUD_TYPES.wait_for_states_t DEFAULT NULL,
       timeout            IN NUMBER DEFAULT 0,
       cache              IN PL/SQL BOOLEAN DEFAULT FALSE,
       cache_scope        IN VARCHAR2 DEFAULT 'PRIVATE',
       body               IN BLOB DEFAULT NULL)
   RETURN DBMS_CLOUD_TYPES.resp;

DBMS_CLOUD.SEND_REQUEST(
       credential_name    IN VARCHAR2,
       uri                IN VARCHAR2,
       method             IN VARCHAR2,
       headers            IN CLOB DEFAULT NULL,
       async_request_url  IN VARCHAR2 DEFAULT NULL,
       wait_for_states    IN DBMS_CLOUD_TYPES.wait_for_states_t DEFAULT NULL,
       timeout            IN NUMBER DEFAULT 0,
       cache              IN PL/SQL BOOLEAN DEFAULT FALSE,
       cache_scope        IN VARCHAR2 DEFAULT 'PRIVATE',
       body               IN BLOB DEFAULT NULL);

Parámetros

Excepciones

Notas de uso

• Si utiliza Oracle Cloud Infrastructure, debe utilizar un valor de credencial basado en clave de firma para credential_name. Consulte CREATE_CREDENTIAL Procedure para obtener más información.

• Los parámetros opcionales async_request_url, wait_for_states y timeout le permiten manejar solicitudes de larga ejecución. Con este formato asíncrono de send_request, la función espera el estado de finalización especificado en wait_for_states antes de volver. Con estos parámetros en la solicitud de envío, transfiere los estados de devolución esperados en el parámetro wait_for_states y utiliza el parámetro async_request_url para especificar una solicitud de trabajo asociada, la solicitud no se devuelve inmediatamente. En su lugar, la solicitud sondea async_request_url hasta que el estado de devolución es uno de los estados esperados o se supera timeout (timeout es opcional). Si no se especifica timeout, la solicitud espera hasta que se produzca un estado encontrado en wait_for_states.

Sintaxis

DBMS_CLOUD.SET_API_RESULT_CACHE_SIZE(
       cache_size          IN NUMBER);

Parámetros

Excepciones

Ejemplo

EXEC DBMS_CLOUD.SET_API_RESULT_CACHE_SIZE(101);

Ejemplo de creación de cubo

Muestra un ejemplo con el método DBMS_CLOUD.SEND_REQUEST con HTTP POST para crear un cubo de almacén de objetos denominado bucketname.

Consulte CreateBucket para obtener más información sobre la API de servicio de Oracle Cloud Infrastructure Object Storage para este ejemplo.

SET SERVEROUTPUT ON
DECLARE
  resp DBMS_CLOUD_TYPES.resp;
BEGIN
  -- Send request
  resp := DBMS_CLOUD.send_request(
            credential_name => 'OCI_KEY_CRED',
            uri => 'https://objectstorage.region.oraclecloud.com/n/namespace-string/b/',
            method => DBMS_CLOUD.METHOD_POST,
            body => UTL_RAW.cast_to_raw(
                        JSON_OBJECT('name' value 'bucketname',
                                    'compartmentId' value 'compartment_OCID'))
          );
 
  -- Response Body in TEXT format
  dbms_output.put_line('Body: ' || '------------' || CHR(10) ||
  DBMS_CLOUD.get_response_text(resp) || CHR(10));
  
  -- Response Headers in JSON format
  dbms_output.put_line('Headers: ' || CHR(10) || '------------' || CHR(10) ||
  DBMS_CLOUD.get_response_headers(resp).to_clob || CHR(10));
 
  -- Response Status Code
  dbms_output.put_line('Status Code: ' || CHR(10) || '------------' || CHR(10) ||
  DBMS_CLOUD.get_response_status_code(resp));
 
END;
/

Notas:

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

• Donde: region es una región de punto final. Consulte la referencia de la API de Object Storage en Puntos finales y referencia de API para obtener más información. Por ejemplo, donde region es: us-phoenix-1.

Ejemplo de supresión de cubo

Muestra un ejemplo con el método DBMS_CLOUD.SEND_REQUEST con HTTP DELETE para suprimir un cubo de almacén de objetos denominado bucketname.

Consulte DeleteBucket para obtener más información sobre la API de servicio de Oracle Cloud Infrastructure Object Storage para este ejemplo.

SET SERVEROUTPUT ON
DECLARE
  resp DBMS_CLOUD_TYPES.resp;
BEGIN
  -- Send request
  resp := DBMS_CLOUD.send_request(
            credential_name => 'OCI_KEY_CRED',
            uri => 'https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucketname',
            method => DBMS_CLOUD.METHOD_DELETE
          );
 
  -- Response Body in TEXT format
  dbms_output.put_line('Body: ' || '------------' || CHR(10) ||
  DBMS_CLOUD.get_response_text(resp) || CHR(10));
  
  -- Response Headers in JSON format
  dbms_output.put_line('Headers: ' || CHR(10) || '------------' || CHR(10) ||
  DBMS_CLOUD.get_response_headers(resp).to_clob || CHR(10));
 
  -- Response Status Code
  dbms_output.put_line('Status Code: ' || CHR(10) || '------------' || CHR(10) ||
  DBMS_CLOUD.get_response_status_code(resp));
 
END;
/

Notas:

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

• Donde: region es una región de punto final. Consulte la referencia de la API de Object Storage en Puntos finales y referencia de API para obtener más información. Por ejemplo, donde region es: us-phoenix-1.

Ejemplo de lista de compartimentos

Muestra un ejemplo con el método DBMS_CLOUD.SEND_REQUEST con HTTP GET para mostrar todos los compartimentos del arrendamiento (compartimento raíz). En este ejemplo se muestra cómo transferir cabeceras de solicitud en DBMS_CLOUD.SEND_REQUEST.

Consulte ListCompartments para obtener más información sobre la API de servicio de Oracle Cloud Infrastructure Identity and Access Management para este ejemplo.

--
-- List compartments
--
DECLARE
  resp DBMS_CLOUD_TYPES.resp;
  root_compartment_ocid VARCHAR2(512) := '&1';
BEGIN
  -- Send request
  dbms_output.put_line('Send Request');
  resp := DBMS_CLOUD.send_request(
            credential_name => 'OCI_KEY_CRED',
            uri => 'https://identity.region.oraclecloud.com/20160918/compartments?compartmentId=' || root_compartment_ocid,
            method => DBMS_CLOUD.METHOD_GET,
            headers => JSON_OBJECT('opc-request-id' value 'list-compartments')
          );
  dbms_output.put_line('Body: ' || '------------' || CHR(10) || DBMS_CLOUD.get_response_text(resp) || CHR(10));
  dbms_output.put_line('Headers: ' || CHR(10) || '------------' || CHR(10) || DBMS_CLOUD.get_response_headers(resp).to_clob || CHR(10));
  dbms_output.put_line('Status Code: ' || CHR(10) || '------------' || CHR(10) || DBMS_CLOUD.get_response_status_code(resp));
  dbms_output.put_line(CHR(10));
END;
/

Donde: region es una región de punto final. Consulte la referencia de API de Identity and Access Management (IAM) en Referencia de API y puntos finales para obtener más información. Por ejemplo, donde region es: uk-london-1.

Ejemplo de solicitud asíncrona

Muestra un ejemplo con el método DBMS_CLOUD.SEND_REQUEST con HTTP POST para realizar la operación de parada de Autonomous Database y esperar el estado. En este ejemplo se muestra cómo utilizar DBMS_CLOUD.SEND_REQUEST con los parámetros async_request_url, wait_for_states y timeout.

--
-- Sent Work Request Autonomous Database Stop Request with Wait for Status
DECLARE
    l_resp DBMS_CLOUD_TYPES.resp;
    l_resp_json JSON_OBJECT_T;
    l_key_shape JSON_OBJECT_T;
    l_body JSON_OBJECT_T;
    status_array DBMS_CLOUD_TYPES.wait_for_states_t;
BEGIN
  status_array := DBMS_CLOUD_TYPES.wait_for_states_t('SUCCEEDED');
  l_body := JSON_OBJECT_T('{}');
  l_body.put('autonomousDatabaseId', 'ocid');
-- Send request
  dbms_output.put_line(l_body.to_clob);
  dbms_output.put_line('Send Request');
  l_resp := DBMS_CLOUD.send_request(
                       credential_name    => 'NATIVE_CRED_OCI',
                       uri                => 'https://database.region.oraclecloud.com/20160918/autonomousDatabases/ocid/actions/stop',
                       method             => DBMS_CLOUD.METHOD_POST,
                       body               => UTL_RAW.cast_to_raw(l_body.to_clob),
                       async_request_url  => 'https://iaas.region.oraclecloud.com/20160918/workRequests',
                       wait_for_states    => status_array,
                       timeout            => 600
                  );
   dbms_output.put_line('resp body: '||DBMS_CLOUD.get_response_text(l_resp));
   dbms_output.put_line('resp headers: '||DBMS_CLOUD.get_response_headers(l_resp).to_clob);
END;
/

Donde: region es una región de punto final. Consulte la referencia de API de Identity and Access Management (IAM) en Referencia de API y puntos finales para obtener más información. Por ejemplo, donde region es: uk-london-1.

ocid es el identificador de recurso de Oracle Cloud Infrastructure. Consulte Identificadores de recursos para obtener más información.