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:
-
Selecione Oracle AI Database no menu à esquerda da exibição.
-
Selecione Autonomous AI Database.
-
Em Filtros Aplicados, selecione o Compartimento para criar o banco de dados.
-
Selecione Criar Autonomous AI Database.
-
Especifique as Informações Básicas do Autonomous AI Database; por exemplo,
-
Compartimento: informe o nome do compartimento selecionado acima.
-
Nome de exibição: o nome a ser exibido na console; por exemplo,
NoSqlToAdwDb. -
Nome do banco de dados: o nome a ser usado ao estabelecer conexão com o banco de dados; por exemplo,
NoSqlToAdwDb(não pode ter mais de 30 caracteres).
-
-
Selecione o tipo de carga de trabalho Lakehouse.
-
Use a configuração padrão para o banco de dados.
-
Defina uma senha em Criação de credenciais de administrador.
-
Selecione Acesso seguro de qualquer lugar para Tipo de Acesso.
-
Selecione o tipo de licença apropriado. Se você tiver sua própria licença, ative o BYOL (Bring Your Own License).
-
Selecione Criar.
Instale as credenciais necessárias para uma conexão de banco de dados segura
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:
-
Selecione Oracle AI Database no menu à esquerda da exibição.
-
Selecione Autonomous AI Database.
-
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.
-
Selecione Conexão de Banco de Dados.
-
Selecione Fazer download da wallet e informe a senha administrativa definida durante a criação do banco de dados.
-
Salve o arquivo (zip) em um local seguro.
O arquivo zip produzido inclui os seguintes itens:
-
Os arquivos de configuração de rede (
tnsnames.oraesqlnet.ora) necessários para estabelecer conexão com o banco de dados. -
O arquivo da wallet SSO de abertura automática,
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.jksetruststore.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
READMEcontendo 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 de 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 Oracle Autonomous AI Lakehouse Database
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 DBMS_CLOUD do Oracle PL/SQL para recuperar os arquivos Parquet do Object Storage. Em seguida, ele carrega os dados contidos nesses arquivos em 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.
-
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.
-
Em Database actions, selecione SQL.
-
Na janela rotulada [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();
Descrição da ilustração dbactions-resource-principal.png
Alternativamente, se você deseja 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;
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 Object Storage, o nome da credencial é 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.