Documentação do Oracle Cloud Infrastructure

Carregar Dados no Autonomous Database do AWS S3

Este exemplo mostra como carregar dados do armazenamento de objetos do Amazon S3 no Autonomous Database.

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 da AWS para autenticação de conta de usuário e um URL de objeto para acessar o objeto no bucket do Amazon S3.

Para carregar dados de um bucket do Amazon S3:

  1. Crie credenciais para a conta de usuário da AWS no Autonomous Database.

  2. Copie dados do bucket do Amazon S3 para o banco de dados.

Tópicos

Tópico principal: Exemplos para Carregar Dados no Autonomous Database

Prepare-se para carregar dados do AWS S3

Verifique os pré-requisitos e prepare-se para carregar dados do Amazon S3.

Pré-requisitos

Um arquivo de dados, por exemplo, data.txt existe no bucket do Amazon S3 que você pode importar. O arquivo de exemplo neste exemplo tem o seguinte conteúdo:
1,Direct Sales
2,Tele Sales
3,Catalog
4,Internet
5,Partners

No lado da AWS, faça login na sua conta da AWS e faça o seguinte:

  1. Conceder privilégios de acesso ao usuário do AWS IAM para o bucket do Amazon S3.
    Para obter mais informações, consulte Controlando o acesso a um bucket com políticas do usuário.
  2. Crie uma chave de acesso para o usuário.
    Para obter mais informações, consulte Gerenciando chaves de acesso para usuários do IAM.
  3. Obtenha um URL de objeto para o arquivo de dados armazenado no bucket do Amazon S3.
    Para obter mais informações, consulte Como acessar e listar um bucket do Amazon S3.

Etapas para Carregar Dados do AWS S3

Execute estas etapas para carregar dados do Amazon S3 para o Autonomous Database.

  1. Armazene as credenciais de acesso da AWS no seu Autonomous Database e especifique um nome de credencial. Isso permite que o banco de dados se autentique com sua conta de usuário da AWS e acesse os itens no bucket S3.
    SET DEFINE OFF
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'AWS_CRED_NAME',
    username => 'username',
    password => 'password'
  );
END;
/
    Observação

    Aqui, o nome do usuário é seu ID de chave do AWS Access e a senha é sua chave de acesso do usuário.

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

    A criação de uma credencial para acessar os recursos da AWS não será necessária se você ativar os ADNs (Amazon Resource Names). Consulte Usar ADNs (Amazon Resource Names) para Acessar Recursos do AWS para obter mais informações.

    Opcionalmente, você pode testar o acesso ao bucket S3 conforme mostrado neste exemplo.

    SELECT * FROM DBMS_CLOUD.LIST_OBJECTS('AWS_CRED_NAME', ' https://aws-bucket-01.s3.amazonaws.com/');
  2. Crie uma tabela no banco de dados na qual você deseja carregar os dados.
    CREATE TABLE mytable (id NUMBER, name VARCHAR2(64));
  3. Importe dados do bucket do Amazon S3 para o seu Autonomous Database.
    Especifique o nome da tabela e o nome da credencial da AWS seguido pelo URL do objeto S3.
    BEGIN
      DBMS_CLOUD.COPY_DATA(
          table_name => 'mytable',
          credential_name => 'AWS_CRED_NAME',
          file_uri_list => https://aws-bucket-01.s3.amazonaws.com/data.txt',
          format => json_object('delimiter' value ',')
      );
END;
/

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

Você importou dados do Amazon S3 para o seu Autonomous Database com sucesso. Você pode executar essa instrução e verificar os dados na tabela.
SELECT * FROM mytable;
ID  NAME
--  –-------------
 1  Direct Sales
 2  Tele Sales
 3  Catalog
 4  Internet
 5  Partners

Para obter mais informações sobre como carregar dados, consulte Load Data from Files in the Cloud.