Acesso ao Oracle Autonomous AI Lakehouse

Etapas para acessar o Oracle Autonomous AI Lakehouse no Oracle NoSQL Database Analytics Integrator.

Crie um banco de dados no Oracle Autonomous AI Lakehouse

Você deve criar um banco de dados para acessar o Oracle Autonomous AI Lakehouse no Oracle NoSQL Database Analytics Integrator. Para criar um banco de dados no Oracle Autonomous AI Lakehouse, vá para a Console do Oracle Cloud e faça o seguinte:

Tópicos Relacionados

Instale as credenciais necessárias para uma conexão segura com o banco de dados

As conexões com o banco de dados criado no Oracle Autonomous AI Lakehouse devem ser seguras. Para que o Oracle NoSQL Database Analytics Integrator se conecte com segurança ao banco de dados do Oracle Autonomous AI Lakehouse, o utilitário usa as credenciais contidas em uma Oracle Wallet.

Para obter o Oracle Wallet, vá para a Console do Oracle Cloud e faça o seguinte:
O arquivo zip produzido inclui os seguintes itens:
  • Os arquivos de configuração de rede (tnsnames.ora e sqlnet.ora) necessários para estabelecer conexão com o banco de dados.
  • O arquivo de wallet de SSO aberto automaticamente, cwallet.sso.
  • O arquivo PKCS12, ewallet.p12, que é protegido pela senha da wallet fornecida quando você fez download do arquivo zip por meio da Console do Oracle Cloud.
  • A área de armazenamento de chaves Java e os arquivos trustore, keystore.jks e truststore.jks;, protegidos pela senha da wallet.
  • O arquivo ojdbc.properties, que especifica a propriedade do sistema Java relacionada à wallet necessária para estabelecer conexão com o banco de dados via JDBC.
  • Um arquivo README contendo informações de expiração da wallet.

Após obter o arquivo zip da wallet, anote a senha e armazene a wallet em qualquer ambiente no qual você se conectará ao banco de dados. Além disso, para usar o Oracle NoSQL Database Analytics Integrator, o conteúdo extraído do arquivo zip da wallet deve ser instalado no ambiente em que você executará o utilitário. Por exemplo, se você estiver executando o utilitário de uma Instância do Oracle Cloud Compute, deverá extrair o conteúdo do arquivo zip em qualquer diretório dessa instância. Em seguida, use o caminho para esse diretório como o valor do parâmetro databaseWallet na seção do banco de dados do arquivo de configuração do utilitário.

Ativar a Credencial do Controlador de Recursos ou Armazenar/Ativar o Armazenamento de Objetos do Usuário AUTH_TOKEN no Banco de Dados do Oracle Autonomous AI Lakehouse

Depois de recuperar dados da tabela desejada do NoSQL Cloud Service e gravar esses dados em arquivos Parquet no Object Storage, o Oracle NoSQL Database Analytics Integrator usa subprogramas do pacote Oracle PL/SQL DBMS_CLOUD para recuperar os arquivos Parquet do Object Storage. Em seguida, ele carrega os dados contidos nesses arquivos para uma tabela no banco de dados criado no Oracle Autonomous AI Lakehouse.

Para que o Oracle NoSQL Database Analytics Integrator possa fazer isso, você deve fornecer uma maneira de o banco de dados do Oracle Autonomous AI Lakehouse se autenticar com o Object Storage para acessar esses arquivos Parquet. O banco de dados Oracle Autonomous AI Lakehouse pode ser autenticado com o serviço Object Storage de duas maneiras: usando o Controlador de Recursos do OCI ou um AUTH_TOKEN específico do usuário que você ou o administrador do sistema gera. O mecanismo de autenticação que você decide usar é ativado executando as etapas a seguir na Console do Oracle Cloud.
  • Selecione Oracle AI Database no menu à esquerda da exibição.
  • Selecione Autonomous AI Database.
    A Descrição de oci-orcldb.png é a seguir
    Descrição da ilustração Oci-orcldb.png

  • Em Filtros Aplicados, selecione o Compartimento no qual o banco de dados está localizado.
  • Selecione o vínculo com o nome de exibição inserido ao criar o banco de dados.
    A Descrição de adb-listdb.png é a seguir
    Descrição da ilustração adb-listdb.png

  • Em Database actions, selecione SQL.
  • Na janela chamada [Worksheet]*, se você quiser autenticar o banco de dados Oracle Autonomous AI Lakehouse com o Object Storage usando o Controlador de Recursos, execute o procedimento a seguir.
    EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();

    Veja a seguir a descrição de dbactions-resource-principal.png
    Descrição da ilustração dbactions-resource-principal.png

    Como alternativa, se você quiser executar a autenticação usando o AUTH_TOKEN que o administrador do sistema forneceu a você ou você mesmo gerou, execute o procedimento,

    BEGIN
DBMS_CLOUD.CREATE_CREDENTIAL (
credential_name => 'NOSQLADWDB_OBJ_STORE_CREDENTIAL',
username => '<your-Oracle-Cloud-username>',
password => '<cut-and-paste-the-AUTH_TOKEN>'
);
END;

    Veja a seguir a descrição de dbactions-worksheet.png
    Descrição da ilustração dbactions-worksheet.png

O procedimento DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL permite que o Controlador de Recursos do OCI (nomeado OCI$RESOURCE_PRINCIPAL) seja usado pelo banco de dados Oracle Autonomous AI Lakehouse ao autenticar com um recurso do OCI, como o Object Storage. O procedimento DBMS_CLOUD.CREATE_CREDENTIAL criptografa a credencial AUTH_TOKEN especificada e a armazena em uma tabela no banco de dados chamado adwc_user. Qualquer procedimento que você empregar, esse procedimento precisará ser executado apenas uma vez; após o qual o mesmo nome de credencial poderá ser especificado para todas as transferências do serviço Object Storage para o banco de dados Oracle Autonomous AI Lakehouse.

Observação:

Quando o banco de dados Oracle Autonomous AI Lakehouse usa o Controlador de Recursos do OCI para autenticação com o Object Storage, o nome da credencial é OCI$RESOURCE_PRINCIPAL. Como alternativa, ao usar o AUTH_TOKEN para autenticação com o serviço Object Storage, o nome da credencial será o valor especificado para o parâmetro credential_name no procedimento DBMS_CLOUD.CREATE_CREDENTIAL. Mas observe que o valor mostrado acima (NOSQLADWDB_OBJ_STORE_CREDENTIAL) é apenas um exemplo. Você pode usar qualquer nome que desejar. Assim, o parâmetro dbmsCredentialName no arquivo de configuração deve conter o valor OCI$RESOURCE_PRINCIPAL ou o nome especificado aqui para o parâmetro credential_name; dependendo do mecanismo de autenticação que você optar por empregar para autenticar o banco de dados Oracle Autonomous AI Lakehouse com o Object Storage.