Documentação do Oracle Cloud Infrastructure

Carregar Dados no Autonomous Database do Oracle Cloud Infrastructure Object Storage

Este exemplo mostra como carregar dados do Oracle Cloud Infrastructure Object Storage para o Autonomous Database usando comandos SQL.

Você tem várias opções para executar o carregamento de dados no Autonomous Database, como:

  • Usando opções de IU: Você pode usar a interface do usuário da ferramenta Carga do Data Studio para criar credenciais para o local do armazenamento na nuvem, selecionar arquivos que contêm dados e executar jobs de carga de dados.

    Consulte Loading Data from Cloud Storage

  • Usando APIs Rest Data Services: Você pode usar as APIs da ferramenta de Carga do Data Studio para criar links para o local do armazenamento na nuvem e executar jobs de carga de dados.

    Consulte Usando APIs de Carga de Dados do Data Studio em PL/SQL

  • Uso de comandos SQL conforme explicado neste exemplo.

Todos esses métodos usam o mesmo pacote PL/SQL DBMS_CLOUD para carregar dados. No entanto, o Data Studio fornece benefícios adicionais em relação aos comandos SQL. Ele não só ajuda a analisar a origem e criar definições de tabela, mas também executa verificações de validação.

Você precisa das credenciais de acesso do Oracle Cloud Infrastructure para autenticação de conta de usuário e de um URL de objeto para acessar o objeto em seu bucket do Oracle Cloud Infrastructure Object Storage.

Para carregar dados do Oracle Cloud Infrastructure Object Storage:

  1. Crie credenciais para a conta de usuário do Oracle Cloud Infrastructure no Autonomous Database.

  2. Copie dados do Oracle Cloud Infrastructure Object Storage para o banco de dados.

Tópicos

Tópico principal: Exemplos de Carregamento de Dados no Autonomous Database

Prepare-se para Carregar Dados a partir do Oracle Cloud Infrastructure

Verifique os pré-requisitos e prepare-se para carregar dados do Oracle Cloud Infrastructure Object Storage.

Pré-requisitos

Um arquivo de dados, por exemplo, oci-data.txt existe no bucket do Oracle Cloud Infrastructure que você pode importar. O arquivo de exemplo deste exemplo possui o conteúdo:
1,OCI Direct Sales
2,OCI Tele Sales
3,OCI Catalog
4,OCI Internet
5,OCI Partners

No lado do Oracle Cloud Infrastructure, faça log-in na sua conta do Oracle Cloud Infrastructure e faça o seguinte:

  1. Obtenha um token de Autenticação para a conta do Oracle Cloud Infrastructure.
    Para obter mais informações, consulte Obtendo um Token de Autenticação.
  2. Na página Detalhes do Objeto, obtenha o URL do objeto para o arquivo de dados armazenado no bucket do Oracle Cloud Infrastructure Object Storage.
    Para obter mais informações, consulte Obtendo Detalhes de um Objeto de Armazenamento de Objetos.

Etapas para Carregar Dados a partir do Oracle Cloud Infrastructure

Execute estas etapas para carregar dados do Oracle Cloud Infrastructure Object Storage para o Autonomous Database.

  1. Armazene as credenciais da conta do Oracle Cloud Infrastructure no seu Autonomous Database e especifique um nome de credencial. Isso permite que o banco de dados se autentique com sua conta do Oracle Cloud Infrastructure e acesse os itens no bucket do Oracle Cloud Infrastructure Object Storage.
    SET DEFINE OFF
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'OCI_CRED_NAME',
    username => 'username',
    password => 'password'
  );
END;
/
    Observação

    Aqui, o nome de usuário é seu nome de usuário do Oracle Cloud Infrastructure e a senha é seu token de Autenticação do usuário.

    Para obter informações detalhadas sobre os parâmetros, consulte CREATE_CREDENTIAL Procedure.

    A criação de uma credencial para acessar o Oracle Cloud Infrastructure Object Store não será necessária se você ativar as credenciais do controlador de recursos. Para obter mais informações, consulte Usar o Controlador de Recursos para Acessar Recursos do Oracle Cloud Infrastructure.

    Opcionalmente, você pode testar o acesso ao Oracle Cloud Infrastructure conforme mostrado neste exemplo. 

    SELECT * FROM DBMS_CLOUD.LIST_OBJECTS('OCI_CRED_NAME', 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/');
  2. Crie uma tabela no banco de dados na qual você deseja carregar os dados.
    CREATE TABLE myocitable (id NUMBER, name VARCHAR2(64));
  3. Importe dados do bucket do Oracle Cloud Infrastructure para o seu Autonomous Database.
    Especifique o nome da tabela e o nome da credencial do Oracle Cloud Infrastructure seguido pelo URL do objeto do 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;
/

    Neste exemplo, namespace-string corresponde ao namespace do armazenamento de objetos do Oracle Cloud Infrastructure e bucketname corresponde ao nome do bucket. Consulte Noções Básicas de Namespaces do serviço Object Storage para obter mais informações.

    Para obter informações detalhadas sobre os parâmetros, consulte Procedimento COPY_DATA.

Você importou com sucesso dados do Oracle Cloud Infrastructure Object Storage para o seu Autonomous Database. Você pode executar esta instrução e verificar os dados na sua tabela.
SELECT * FROM myocitable;
ID  NAME
--  –-------------
 1  OCI Direct Sales
 2  OCI Tele Sales
 3  OCI Catalog
 4  OCI Internet
 5  OCI Partners

Para obter mais informações sobre como carregar dados, consulte Carregar Dados de Arquivos na Nuvem.