Acessando o Oracle Cloud Autonomous Data Warehouse

Criar um banco de dados no Autonomous Data Warehouse

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

Selecione Oracle Database no menu à esquerda da exibição.
Selecione Autonomous Data Warehouse.

Descrição da ilustração oci-orcldb.png
Selecione o Compartimento no qual criar o banco de dados.
Clique em Criar Autonomous Database.
Informe as Informações Básicas do Autonomous Database; por exemplo,
- Compartimento: informe o nome do compartimento selecionado acima.
- Nome para exibição: o nome a ser exibido no console; por exemplo, NoSqlToAdwDb.
- Nome do banco de dados: o nome a ser usado ao estabelecer conexão com o banco de dados; ex. NoSqlToAdwDb (não pode ter mais de 14 caracteres).
Descrição da ilustração crtadb-dbname.png
Selecione o tipo de carga de trabalho Data Warehouse.
Escolha o tipo de implantação da Infraestrutura Compartilhada.

Descrição da ilustração crtadb-wltype.png
Escolha a configuração padrão para o banco de dados.

Descrição da ilustração crtadb-param.png
Defina uma Senha em Criar Credenciais de Administrador.

Descrição da ilustração crtadb-admin.png
Escolha Permitir acesso seguro em qualquer lugar para Tipo de Acesso.
Escolha o tipo de licença apropriado. Se você tiver sua própria licença, escolha BYOL (Bring Your Own License).
Clique em Criar Autonomous Database.

Descrição da ilustração crtadb-network.png

Tópicos Relacionados

Gerar um token de autorização para o Object Storage

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 Autonomous Data Warehouse devem ser seguras. Para que o Oracle NoSQL Database Analytics Integrator se conecte com segurança ao banco de dados ADW, o utilitário usa as credenciais contidas em um Oracle Wallet.

Para obter o Oracle Wallet, vá para a Console do Oracle Cloud e faça o seguinte:

Selecione Oracle Database no menu à esquerda da exibição.
Selecione Autonomous Data Warehouse.

Descrição da ilustração oci-orcldb.png
Selecione o Compartimento no qual o banco de dados está localizado.
Clique no link com o nome para exibição informado ao criar o banco de dados.

Descrição da ilustração adb-listdb.png
Clique em Console de Serviço.

Descrição da ilustração adb-srvconsole.png
Clique no link Administração à esquerda da exibição.
Selecione Fazer Download das Credenciais do Cliente (Wallet) e informe a senha administrativa definida durante a criação do banco de dados.

Descrição da ilustração adb-adminstration.png
Salve o arquivo (zip) em um local seguro.

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.
Os arquivos de armazenamento de chaves Java e de trustore, keystore.js 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.

Depois de obter o arquivo zip da wallet, anote a senha e armazene a wallet em qualquer ambiente no qual você estabelecerá conexão com o 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.

Ative a Credencial Principal do Recurso ou Armazene/Ative o Armazenamento de Objetos do Usuário AUTH_TOKEN no Banco de Dados do ADW

Depois de recuperar dados da tabela NoSQL Cloud Service desejada 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 Cloud Autonomous Data Warehouse.

Para que o Oracle NoSQL Database Analytics Integrator possa fazer isso, você deve fornecer uma maneira de o banco de dados ADW se autenticar no Object Storage para acessar esses arquivos Parquet. O banco de dados do ADW 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 Database no menu à esquerda da exibição.
Selecione Autonomous Data Warehouse.

Descrição da ilustração oci-orcldb.png
Selecione o Compartimento no qual o banco de dados está localizado.
Clique no link com o nome para exibição informado ao criar o banco de dados.

Descrição da ilustração adb-listdb.png
Clique em Console de Serviço.

Descrição da ilustração adb-srvconsole.png
Selecione Desenvolvimento no menu à esquerda da exibição.

Descrição da ilustração adb-development.png
Selecione Database Actions e faça log-in no banco de dados; por exemplo,
- Nome do Usuário: ADMIN
- Senha: <password-set-during-database-creation>
Descrição da ilustração dbactions-login.png
Selecione o item SQL.

Descrição da ilustração dbactions-sqlsheet.png
Na janela identificada como [Planilha]*, se você quiser autenticar o banco de dados do ADW 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
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;
```
Descrição da ilustração dbactions-worksheet.png

O procedimento DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL permite que o Controlador de Recursos do OCI (denominado OCI$RESOURCE_PRINCIPAL) seja usado pelo banco de dados ADW 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ê empregue, esse procedimento precisa ser executado apenas uma vez; após o qual o mesmo nome de credencial pode ser especificado para todas as transferências do Object Storage para o banco de dados ADW.

Observação:

Quando o banco de dados do ADW usa o Controlador de Recursos do OCI para autenticação no Object Storage, o nome da credencial é OCI$RESOURCE_PRINCIPAL. Como alternativa, ao usar AUTH_TOKEN para autenticação no serviç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. Portanto, 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 ADW com o Object Storage.