Documentação do Oracle Cloud Infrastructure

Carregar Dados no Autonomous Database do Armazenamento Blob do Azure ou do Azure Data Lake Storage

Este exemplo mostra como carregar dados do Azure Blob Storage ou do Azure Data Lake Storage para o 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 do Azure para autenticação de conta de usuário e um URL de objeto para acessar o objeto no contêiner de conta do Azure Storage.

Para carregar dados do Armazenamento do Blob do Azure ou do Armazenamento do Data Lake do Azure:

  1. Crie credenciais para a conta de usuário do Azure no Autonomous Database.

  2. Copie dados do Azure Blob Storage ou do Azure Data Lake Storage para o banco de dados.

Tópicos

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

Prepare-se para Carregar Dados do Armazenamento Blob do Azure ou do Armazenamento do Data Lake do Azure

Verifique os pré-requisitos e prepare-se para carregar dados do Armazenamento Blob do Azure ou do Armazenamento do Azure Data Lake.

Pré-requisitos

Um arquivo de dados, por exemplo, azure-data.txt existe no contêiner de contas do Azure Storage que você pode importar. O arquivo de exemplo neste exemplo tem o seguinte conteúdo:
1,Azure Direct Sales
2,Azure Tele Sales
3,Azure Catalog
4,Azure Internet
5,Azure Partners

No Azure, faça login na sua conta de Armazenamento do Azure e faça o seguinte:

  1. Conceda a atribuição necessária, por exemplo, Storage Blob Data Contributor, à sua conta do Azure Storage.
    Para obter mais informações, consulte Designar atribuições do Azure usando o portal do Azure.
  2. Obtenha uma chave de acesso para a conta do Azure Storage.
    Para obter mais informações, consulte Exibir chaves de acesso da conta.
  3. Obtenha o URL do objeto para o arquivo de dados armazenado no contêiner da conta do Azure Storage.

Etapas para Carregar Dados do Armazenamento do Blob do Azure ou do Armazenamento do Data Lake do Azure

Execute estas etapas para carregar dados do Azure Blob Storage ou do Azure Data Lake Storage para o Autonomous Database.

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

    Aqui, o nome do usuário é o nome da sua conta do Azure Storage e a senha é a sua chave de acesso do usuário.

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

    Não é necessário criar uma credencial para acessar o Azure Blob Storage ou o Azure Data Lake Storage se você ativar o controlador de serviços do Azure. Consulte Usar o Principal do Azure Service para Acessar Recursos do Azure para obter mais informações.

    Opcionalmente, você pode testar o acesso ao Armazenamento Blob do Azure ou ao Armazenamento do Data Lake do Azure, conforme mostrado neste exemplo. 

    SELECT * FROM DBMS_CLOUD.LIST_OBJECTS('AZURE_CRED_NAME', 'https://dbazure.blob.core.windows.net/my-azure-container/');
  2. Crie uma tabela no banco de dados na qual você deseja carregar os dados.
    CREATE TABLE myazuretable (id NUMBER, name VARCHAR2(64));
  3. Importe dados do contêiner Azure Blob Storage ou Azure Data Lake Storage para o seu Autonomous Database.
    Especifique o nome da tabela e o nome da credencial do Azure seguido pelo URL do objeto Armazenamento Blob do Azure ou do Armazenamento do Data Lake do Azure. 
    BEGIN
      DBMS_CLOUD.COPY_DATA(
          table_name => 'myazuretable',
          credential_name => 'AZURE_CRED_NAME',
          file_uri_list => 'https://dbazure.blob.core.windows.net/my-azure-container/azure-data.txt',
          format => json_object('delimiter' value ',')
      );
END;
/

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

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

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