Documentação do Oracle Cloud Infrastructure

Fazer Download de Informações de Conexão ao Banco de Dados

Você pode fazer download de credenciais do cliente Oracle, arquivos da wallet, em uma instância do Autonomous Database.

Se você não for um administrador do Autonomous Database e seu aplicativo exigir que uma wallet se conecte, seu administrador deverá fornecer as credenciais do cliente. Você também pode exibir nomes TNS e strings de conexão para seu banco de dados.

Tópico principal: Estabelecer Conexão com o Autonomous Database

Fazer Download das Credenciais do Cliente (Wallets)

Para fazer download das credenciais de cliente, você pode usar a Oracle Cloud Infrastructure Console ou o Database Actions.

Observação

A senha que você fornece quando faz download da wallet protege a wallet de Credenciais do Cliente baixada.

Para regiões comerciais, a complexidade da senha da wallet para a senha fornecida requer o seguinte:

  • Mínimo de 8 caracteres
  • Mínimo de 1 letra
  • Mínimo de 1 caractere numérico ou 1 caractere especial
Para regiões do Governo dos EUA, a complexidade da senha da wallet exige o seguinte:
  • Mínimo de 15 caracteres
  • Mínimo de 1 letra minúscula
  • Mínimo de 1 letra maiúscula
  • Mínimo de 1 caractere numérico
  • Mínimo de 1 caractere especial

Para fazer download das credenciais do cliente na Console do Oracle Cloud Infrastructure:

  1. Navegue até a página de detalhes do Autonomous Database.
  2. Clique em Conexão do banco de dados.
  3. Na página Conexão do banco de dados, selecione o Tipo de wallet:
    • Wallet da instância: Wallet somente para um único banco de dados; isso fornece uma wallet específica do banco de dados.
    • Wallet regional: Wallet de todos os Autonomous Databases de um determinado tenant e região (isso inclui todas as instâncias do serviço que uma conta do Cloud possui).
    Observação

    A Oracle recomenda que você forneça uma wallet específica do banco de dados, usando a Wallet da instância, para usuários finais e para uso do aplicativo sempre que possível. Os wallets regionais devem ser usados somente para fins administrativos que exigem acesso potencial a todos os Bancos de Dados Autônomos em uma região.
  4. Clique em Fazer download da wallet.
  5. No diálogo Fazer download da wallet, informe uma senha da wallet no campoSenha e confirme a senha no campoConfirmar senha.
  6. Clique em Fazer download para salvar o arquivo zip das credenciais de segurança do cliente.

    Por padrão, o nome do arquivo é: Wallet_databasename.zip. Você pode salvar esse arquivo como qualquer nome de arquivo desejado.

    Proteja esse arquivo para impedir o acesso não autorizado ao banco de dados.

Para fazer download das credenciais do cliente no Database Actions:

Primeiro, acesse o Database Actions como o usuário ADMIN. Consulte Acessar o Database Actions como ADMIN para obter mais informações.

  1. Acesse o Database Actions como o usuário ADMIN. Consulte Acessar o Database Actions como ADMIN para obter mais informações.

  2. No Database Actions Launchpad, em Administration, selecione Download Client Credentials (Wallet).

  3. Na página Fazer Download de Credenciais do Cliente (Wallet), informe uma senha da wallet no campoSenha e confirme a senha no campoConfirmar Senha.

  4. Clique em Fazer download para salvar o arquivo zip das credenciais de segurança do cliente. Por padrão, o nome do arquivo é: Wallet_databasename.zip. Você pode salvar esse arquivo como qualquer nome de arquivo desejado. Proteja esse arquivo para impedir o acesso não autorizado ao banco de dados.

Observação

Quando você usa o Database Actions para fazer download de uma wallet, não há a opção Tipo de wallet na página Fazer Download das Credenciais do Cliente (Wallet) e você sempre faz download de uma wallet de instância. Se você precisar fazer download da wallet regional, clique em Conexão do banco de dados na Console do Oracle Cloud Infrastructure.

O arquivo zip inclui o seguinte:

Arquivo Descrição
cwallet.sso

Wallet de SSO aberta automaticamente
ewallet.p12

Arquivo PKCS12. O arquivo PKCS12 é protegido pela senha da wallet fornecida ao fazer download da wallet.
ewallet.pem

Arquivo de certificado codificado usado para autenticar-se com o certificado do servidor de autoridade certificadora (CA).
keystore.jks

Arquivo de armazenamento de chaves Java. Este arquivo é protegido pela senha da wallet fornecida durante o download da wallet.
ojdbc.properties

Contém a propriedade da conexão relacionada à wallet necessária para a conexão JDBC. Isso deve estar no mesmo caminho que tnsnames.ora.

README

Contém informações de expiração da wallet e links para ferramentas e recursos do Autonomous Database.

Consulte Arquivo Wallet README para obter informações sobre o conteúdo do arquivo README.

sqlnet.ora

Configuração do cliente SQL*Net.
tnsnames.ora

Arquivo de configuração de rede que armazena descritores de conexão.
truststore.jks

Arquivo de armazenamento confiável Java. Este arquivo é protegido pela senha da wallet fornecida ao fazer download da wallet.

Observações para arquivos da wallet e a senha da wallet:

  • Para invalidar as chaves de certificação do cliente de banco de dados associadas a uma wallet, consulte Alternar Wallets com Rotação Imediata.

  • Os arquivos da wallet, juntamente com o ID de usuário e senha do Banco de dados, fornecem acesso aos dados em seu banco de dados. Armazene os arquivos da wallet em um local seguro. Só compartilhe os arquivos da wallet com usuários autorizados. Se os arquivos da wallet forem transmitidos de uma forma que possam ser acessados por usuários não autorizados (por exemplo, por e-mail público), transmita a senha da wallet separadamente e de modo seguro.

  • Para maior segurança, a Oracle recomenda o uso de permissões restritas em arquivos de wallet. Isso significa definir as permissões de arquivo como 600 no Linux/Unix. Restrições semelhantes podem ser obtidas no Windows, permitindo que o proprietário do arquivo tenha permissões de Leitura e Gravação, enquanto todos os outros usuários não têm permissões.

  • O Autonomous Database usa regras de complexidade de senha forte para todos os usuários com base nos padrões de segurança do Oracle Cloud. Para obter mais informações sobre as regras de complexidade de senhas, consulte Create Users on Autonomous Database - Connecting with a Client Tool.

  • O arquivo README que contém informações de expiração da wallet não está disponível nos arquivos zip da wallet que foram baixados antes de abril de 2020.

  • A partir de seis semanas antes da data de expiração da wallet, o Autonomous Database envia e-mails de notificação a cada semana, indicando a data de expiração da wallet. Esses e-mails fornecem um aviso antes de sua carteira expirar de que você precisa fazer download de uma nova carteira. Você receberá esses e-mails de notificação somente se houver uma conexão que use uma wallet prestes a expirar.

    Você também pode usar o evento WalletExpirationWarning para ser notificado quando uma wallet expirar. Você só receberá esses eventos de notificação se estiver inscrito em eventos Críticos e houver uma conexão que use uma wallet que esteja prestes a expirar. Consulte Sobre Notificação e Automação com Base em Eventos no Autonomous Database para obter mais informações.

Arquivo README da Wallet

O arquivo README da wallet contém as informações de expiração da wallet e detalhes sobre ferramentas e recursos do Autonomous Database.

As informações de expiração da wallet na parte superior do arquivo README mostram as seguintes informações:

  • A data em que o download da wallet foi feito.

  • A data em que o certificado SSL da wallet fornecido na wallet expira. Se sua wallet estiver se aproximando da expiração ou expirando, faça download de uma nova wallet ou obtenha uma nova wallet do administrador do Autonomous Database. Se você não fizer download de uma nova wallet antes da data de expiração, não poderá mais se conectar ao seu banco de dados.

A área de ferramentas e recursos do Autonomous Database fornece as seguintes informações:

Ferramenta ou Recurso Descrição

Ações do Banco de Dados

Carregue, explore, transforme, modele e catalogue seus dados. Use uma planilha SQL, crie interfaces REST e aplicativos de baixo código, gerencie usuários e conexões, crie e aplique modelos de aprendizado de máquina.

Link de Acesso: fornece o link para usar o Database Actions. Consulte Estabelecer Conexão com o Oracle Database Actions Integrado para obter mais informações.

Graph Studio

O Oracle Graph Studio permite criar bancos de dados de gráficos de propriedades escaláveis. O Graph Studio automatiza a criação de modelos de gráfico e gráficos na memória a partir de tabelas de banco de dados. Ele inclui notebooks e APIs de desenvolvedor que permitem executar consultas de gráfico usando PGQL (uma linguagem de consulta de gráfico semelhante a SQL) e mais de 50 algoritmos de gráfico integrados. O Graph Studio também oferece dezenas de visualizações, incluindo visualização gráfica nativa.

O Link de Acesso fornece o link para usar o Graph Studio. Consulte Sobre o Oracle Graph Studio no Autonomous Database para obter mais informações.

Oracle APEX

O Oracle APEX é uma plataforma para desenvolvimento de baixo código que permite criar aplicativos empresariais escaláveis e seguros, que podem ser implementados em qualquer lugar.

Link de Acesso: fornece o link para usar o Oracle APEX. Consulte Acessar o Oracle APEX Administration Services para obter mais informações.

Oracle Machine Learning User Management

Crie novas contas de usuários do Oracle Machine Learning e gerencie as credenciais dos usuários existentes do Oracle Machine Learning.

Link de Acesso: fornece o link para usar o Gerenciamento de Usuários do Oracle Machine Learning. Consulte Criar e Atualizar Contas de Usuário para Componentes Oracle Machine Learning no Autonomous Database para obter mais informações.

Notebooks de Usuários do Oracle Machine Learning

Oracle Machine Learning notebooks provide easy access to Oracle's parallelized, scalable in-database implementations of a library of Oracle Advanced Analytics' machine learning algorithms (classification, regression, anomaly detection, clustering, associations, attribute importance, feature extraction, times series, and so on), SQL, PL/SQL and Oracle's statistical and analytical SQL functions.

Link de Acesso: fornece o link para usar Notebooks do Usuário do Oracle Machine Learning. Consulte Trabalhar com a Interface do Usuário do Oracle Machine Learning para Acesso a Dados, Análise e Descoberta para obter mais informações.

Drivers SODA

O SODA (Simple Oracle Document Access) é um conjunto de APIs que permite trabalhar com documentos JSON gerenciados pelo Oracle Database sem a necessidade de usar SQL. Os drivers SODA estão disponíveis para REST, Java, Node.js, Python, PL/SQL e C.

Link de acesso: fornece o link para baixar os drivers SODA. Consulte Trabalhar com o SODA (Simple Oracle Document Access) no Autonomous Database para obter mais informações.

Observações para o arquivo README da wallet:

  • Se você renomear sua instância do Autonomous Database, os links de ferramentas serão alterados e os links antigos não funcionarão mais. Para obter links de ferramentas válidos, faça download de um novo arquivo zip do Wallet com um arquivo README atualizado. O link de drivers SODA é um link de recurso e esse link não é alterado quando você renomeia uma instância.

  • O README em uma wallet regional não contém os links de ferramentas e recursos do Autonomous Database.

  • Se sua instância do Autonomous Database estiver em um ponto final privado e você ativar a opção Permitir acesso público, o arquivo README incluirá dois links para cada ferramenta: um link a ser usado no ponto final privado quando você está se conectando da mesma VCN em que o banco de dados reside e outro link para usar de endereços IP públicos específicos ou de VCNs específicas se essas VCNs estiverem configuradas para estabelecer conexão privada com o Autonomous Database usando um Gateway de Serviço. Consulte Usar um Ponto Final Privado com Acesso Público Permitido para obter mais informações.

Exibir Nomes de TNS e Strings de Conexão de uma Instância do Autonomous Database

Na página Conexão do Banco de Dados na Console do Oracle Cloud Infrastructure, você pode exibir nomes de TNS e strings de conexão do Autonomous Database.

Observação

Consulte Atualizar sua Instância do Autonomous Database para Permitir Autenticação TLS e mTLS para obter informações sobre como permitir conexões TLS.

Execute as seguintes etapas conforme necessário:

  • Abra a Console do Oracle Cloud Infrastructure clicando no ícone de navegação ao lado da Nuvem.

  • No menu de navegação esquerdo do Oracle Cloud Infrastructure, clique em Oracle Database e depois clique em Autonomous Database.

  • Na página Autonomous Databases, selecione seu Autonomous Database nos links na coluna Nome para exibição.

Para exibir os nomes TNS e as strings de conexão, faça o seguinte:

  1. Na página de detalhes do Autonomous Database, clique em Conexão do banco de dados.

    Por padrão, isso mostra as informações de conexão TLS Mútuo em uma tabela com os nomes TNS e as strings de conexão da instância do Autonomous Database.

  2. Quando conexões TLS Mútuas (mTLS) e TLS forem permitidas, em autenticação TLS, selecione TLS para exibir os nomes TNS e as strings de conexão para conexões com autenticação TLS.

    Os nomes TNS são os mesmos para autenticação mTLS e TLS. As strings de conexão diferem para conexões mTLS e TLS, com definições de porta diferentes. As conexões TLS mútuas (mTLS) usam a porta 1522. As conexões TLS usam a porta 1521 ou 1522. As atribuições de porta de 1522 para TLS Mútuo (mTLS) e 1521 ou 1522 para TLS não podem ser alteradas.

    Na coluna String de Conexão, clique em Mostrar para exibir o valor completo de uma string de conexão ou clique em Copiar para copiar uma string de conexão.

    Por exemplo, quando você clica em Mostrar, vê a string de conexão completa.

  3. Quando sua instância do Autonomous Database estiver em um ponto final privado e você ativar a opção Permitir acesso público, também selecione um tipo de acesso para mostrar ou copiar as informações do ponto final privado ou público.

    As strings de conexão privada são as strings de conexão que você usa dentro da VCN em que o banco de dados de ponto final privado reside. Use as strings de conexão pública para estabelecer conexão de IPs públicos ou de outras VCNs permitidas. Consulte Usar um Ponto Final Privado com Acesso Público Permitido para obter mais informações.

    Em Acesso, selecione Ponto final privado ou URL do ponto final público.

Exemplos de Código para Estabelecer Conexão com uma Instância do Autonomous Database

Na página Conexão do Banco de Dados na Console do Oracle Cloud Infrastructure, você pode exibir exemplos de código de conexão do Autonomous Database.

Execute as seguintes etapas conforme necessário:

  • Abra a Console do Oracle Cloud Infrastructure clicando no ícone de navegação ao lado da Nuvem.

  • No menu de navegação esquerdo do Oracle Cloud Infrastructure, clique em Oracle Database e depois clique em Autonomous Database.

  • Na página Autonomous Databases, selecione seu Autonomous Database nos links na coluna Nome para exibição.

Para exibir e copiar exemplos de código de conexão:

  1. Na página Autonomous Database, clique em Conexão do banco de dados.
  2. Na página Conexão do banco de dados, em Exemplos de código, selecione o Tipo de serviço de conexão entre as seguintes opções:
  3. Quando conexões TLS Mútuas (mTLS) e TLS forem permitidas, em autenticação TLS, selecione TLS para exibir os nomes TNS e as strings de conexão para conexões com autenticação TLS.

    Os nomes TNS são os mesmos para autenticação mTLS e TLS. As strings de conexão diferem para conexões mTLS e TLS, com definições de porta diferentes. As conexões TLS mútuas (mTLS) usam a porta 1522. As conexões TLS usam a porta 1521 ou 1522. As atribuições de porta de 1522 para TLS Mútuo (mTLS) e 1521 ou 1522 para TLS não podem ser alteradas.

    Quando conexões TLS não são permitidas, a lista drop-down autenticação TLS fica esmaecida.

    Consulte Atualizar sua Instância do Autonomous Database para Permitir Autenticação TLS e mTLS para obter informações sobre como permitir conexões TLS.

  4. Selecione um Idioma/Ferramenta entre as seguintes opções:
    • MongoDB API (Java)
    • MongoDB API (Python)
    • MongoDB API (JavaScript)
    • Java
    • Python
    • JavaScript
      Observação

      Os exemplos de conexão para a API MongoDB só estarão disponíveis se você configurar o acesso para MongoDB no seu Autonomous Database. Consulte Configurar Acesso para MongoDB e Ativar MongoDB para obter mais informações.

      Dependendo da plataforma selecionada, uma string de conexão de amostra é exibida para estabelecer conexão com uma instância do Autonomous Database, com comentários adicionados que indicam áreas em que a personalização é possível.

  5. Clique em Copiar para copiar a amostra da string de conexão.
    O exemplo de string de conexão contém texto comentado com instruções. Por exemplo, você precisa fornecer uma USER_NAME e uma PASSWORD para estabelecer conexão com sua instância do Autonomous Database.

    Consulte Conexão com o Autonomous Database Usando um Aplicativo Cliente para obter mais informações.