Documentación de Oracle Cloud Infrastructure

Carga de datos en Autonomous Database desde Oracle Cloud Infrastructure Object Storage

En este ejemplo se muestra cómo cargar datos de Oracle Cloud Infrastructure Object Storage en Autonomous Database mediante comandos SQL.

Tiene varias opciones para realizar la carga de datos en Autonomous Database, como:

  • Uso de opciones de interfaz de usuario: puede utilizar la interfaz de usuario de la herramienta de carga de Data Studio para crear credenciales para la ubicación del almacén en la nube, seleccionar archivos que contengan datos y ejecutar trabajos de carga de datos.

    Consulte Carga de datos del almacenamiento en la nube

  • Uso de las API de Rest Data Services: puede utilizar las API de la herramienta de carga de Data Studio para crear enlaces a la ubicación del almacén en la nube y ejecutar trabajos de carga de datos.

    Consulte Uso de las API de carga de datos de Data Studio en PL/SQL

  • El uso de comandos SQL como se explica en este ejemplo.

Todos estos métodos utilizan el mismo paquete PL/SQL DBMS_CLOUD para cargar datos. Sin embargo, Data Studio proporciona ventajas adicionales sobre los comandos SQL. No solo ayuda a analizar el origen y crear definiciones de tabla, sino que también realiza comprobaciones de validación.

Necesita las credenciales de acceso de Oracle Cloud Infrastructure para la autenticación de cuenta de usuario y una URL de objeto para acceder al objeto en el cubo de Oracle Cloud Infrastructure Object Storage.

Para cargar datos de Oracle Cloud Infrastructure Object Storage:

  1. Cree credenciales para la cuenta de usuario de Oracle Cloud Infrastructure en Autonomous Database.

  2. Copie datos de Oracle Cloud Infrastructure Object Storage en la base de datos.

Temas

Tema principal: Ejemplos de carga de datos en Autonomous Database

Preparación para la carga de datos desde Oracle Cloud Infrastructure

Verifique los requisitos y prepárese para cargar datos desde Oracle Cloud Infrastructure Object Storage.

Requisitos

Existe un archivo de datos, por ejemplo, oci-data.txt, en el cubo de Oracle Cloud Infrastructure que puede importar. El archivo de ejemplo de este ejemplo tiene el siguiente contenido:
1,OCI Direct Sales
2,OCI Tele Sales
3,OCI Catalog
4,OCI Internet
5,OCI Partners

En Oracle Cloud Infrastructure, conéctese a su cuenta de Oracle Cloud Infrastructure y haga lo siguiente:

  1. Obtenga un token de autenticación para la cuenta de Oracle Cloud Infrastructure.
    Para obtener más información, consulte Obtención de un token de autenticación.
  2. En la página Detalles de objeto, obtenga la URL del objeto del archivo de datos almacenado en el cubo de Oracle Cloud Infrastructure Object Storage.
    Para obtener más información, consulte Obtención de detalles de un objeto de almacenamiento de objetos.

Pasos para cargar datos desde Oracle Cloud Infrastructure

Ejecute estos pasos para cargar datos de Oracle Cloud Infrastructure Object Storage en Autonomous Database.

  1. Almacene las credenciales de la cuenta de Oracle Cloud Infrastructure en Autonomous Database y especifique un nombre de credencial. Esto permite a la base de datos autenticarse en la cuenta de Oracle Cloud Infrastructure y acceder a los elementos del bloque de Oracle Cloud Infrastructure Object Storage.
    SET DEFINE OFF
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'OCI_CRED_NAME',
    username => 'username',
    password => 'password'
  );
END;
/
    Nota

    Aquí, nombre de usuario es el nombre de usuario de Oracle Cloud Infrastructure y contraseña es el token de autenticación de usuario.

    Para obtener información detallada sobre los parámetros, consulte Procedimiento CREATE_CREDENTIAL.

    No es necesario crear una credencial para acceder al almacén de objetos de Oracle Cloud Infrastructure si activa las credenciales de la entidad de recurso. Consulte Uso de la entidad de recurso para acceder a los recursos de Oracle Cloud Infrastructure para obtener más información.

    También puede probar el acceso a Oracle Cloud Infrastructure, como se muestra en este ejemplo. 

    SELECT * FROM DBMS_CLOUD.LIST_OBJECTS('OCI_CRED_NAME', 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/');
  2. Cree una tabla en la base de datos donde desee cargar los datos.
    CREATE TABLE myocitable (id NUMBER, name VARCHAR2(64));
  3. Importe datos del cubo de Oracle Cloud Infrastructure a Autonomous Database.
    Especifique el nombre de la tabla y el nombre de la credencial de Oracle Cloud Infrastructure seguido de la URL del objeto de Oracle Cloud Infrastructure. 
    BEGIN
      DBMS_CLOUD.COPY_DATA(
          table_name => 'myocitable',
          credential_name => 'OCI_CRED_NAME',
          file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/oci-data.txt',
          format => json_object('delimiter' value ',')
      );
END;
/

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

    Para obtener información detallada sobre los parámetros, consulte Procedimiento COPY_DATA.

Ha importado correctamente datos de Oracle Cloud Infrastructure Object Storage a su instancia de Autonomous Database. Puede ejecutar esta sentencia y verificar los datos de la tabla.
SELECT * FROM myocitable;
ID  NAME
--  –-------------
 1  OCI Direct Sales
 2  OCI Tele Sales
 3  OCI Catalog
 4  OCI Internet
 5  OCI Partners

Para obtener más información sobre la carga de datos, consulte Carga de datos de archivos en la nube.