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 de usuário da ferramenta de Carregamento do Data Studio para criar credenciais para o local do armazenamento na nuvem, selecionar arquivos que contenham dados e executar jobs de carregamento de dados.

    Consulte Carregando Dados do Armazenamento em Nuvem

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

    Consulte Usando APIs do Data Studio Data Load no PL/SQL

  • Usar 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 oferece 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 de credenciais de acesso do Oracle Cloud Infrastructure para autenticação de conta de usuário e um URL de objeto para acessar o objeto no 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 para Carregar Dados no Autonomous Database

Prepare-se para Carregar Dados 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 neste exemplo tem o seguinte conteúdo:
1,OCI Direct Sales
2,OCI Tele Sales
3,OCI Catalog
4,OCI Internet
5,OCI Partners

No 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 Autorizaçã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 do Serviço Object Storage.

Etapas para Carregar Dados 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 do usuário é o seu nome de usuário do Oracle Cloud Infrastructure e a senha é o token de Autenticação do usuário.

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

    Não será necessário criar uma credencial para acessar o Oracle Cloud Infrastructure Object Store se você ativar as credenciais do controlador de recursos. Consulte Usar o Controlador de Recursos para Acessar Recursos da Oracle Cloud Infrastructure para obter mais informações.

    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 seguidos 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 é o namespace do Oracle Cloud Infrastructure Object Storage e bucketname é o 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 ProcedimentoCOPY_DATA.

Você importou com sucesso dados do Oracle Cloud Infrastructure Object Storage para o seu Autonomous Database. Você pode executar essa instrução e verificar os dados na 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 Load Data from Files in the Cloud.