Documentação do Oracle Cloud Infrastructure

Fazer download de informações de conexão do 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 administrador do Autonomous Database e seu aplicativo exigir uma wallet para conexão, o administrador deverá fornecer as credenciais de cliente. Você também pode ver nomes de TNS e strings de conexão para o seu banco de dados.

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

Fazer Download das Credenciais do Cliente (Wallets)

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

Observação

A senha que você fornece ao fazer download da wallet protege a wallet das Credenciais de Cliente baixada.

Para regiões comerciais, a complexidade da senha da wallet que você fornece exige o seguinte:

  • Mínimo de 8 caracteres
  • 1 letra no mínimo
  • 1 caractere numérico ou 1 caractere especial no mínimo
Para regiões do Governo dos EUA, a complexidade da senha da wallet exige o seguinte:
  • 15 caracteres no mínimo
  • 1 letra menor no mínimo
  • No mínimo 1 letra alta
  • 1 caractere numérico no mínimo
  • Mínimo de 1 caractere especial

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

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

    A Oracle recomenda fornecer uma wallet específica de banco de dados, usando wallet de instância, para usuários finais e uso de aplicativo sempre que possível. Os wallets regionais só devem ser usados para fins administrativos que exigem acesso potencial a todos os Autonomous Databases em uma região.
  4. Clique em Download da wallet.
  5. Na caixa de diálogo Download da wallet, digite uma senha da wallet no campo Senha e confirme a senha no campo Confirmar 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 de credenciais de cliente no Database Actions:

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

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

  2. No Launchpad do Database Actions, em Administração, selecione Fazer Download de Credenciais de Cliente (Wallet).

  3. Na página Download de Credenciais de Cliente (Wallet), digite uma senha de wallet no campo Senha e confirme a senha no campo Confirmar 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á opção Tipo de wallet na página Download de Credenciais de 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 de banco de dados na Console do Oracle Cloud Infrastructure.

O arquivo zip inclui o seguinte:

Arquivo Descrição
cwallet.sso

Abrir wallet de SSO automaticamente
ewallet.p12

Arquivo PKCS12. O arquivo PKCS12 é protegido pela senha da wallet fornecida durante o download da wallet.
ewallet.pem

Arquivo de certificado codificado usado para autenticação com o certificado do servidor da autoridade de certificação (CA).
keystore.jks

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

Contém a propriedade de conexão relacionada da wallet que é exigida para 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 recursos e ferramentas do Autonomous Database.

Consulte Arquivo README de Wallet 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. Esse arquivo é protegido pela senha da wallet fornecida durante o download da wallet.

Observações sobre arquivos de wallet e a senha da wallet:

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

  • Os arquivos de wallet com o ID e a senha do usuário do Banco de Dados fornecem acesso aos dados no 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 tenham 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 senha, consulte Criar Usuários no Autonomous Database - Conectando-se com uma Ferramenta Cliente.

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

  • Faltando seis semanas para a data de expiração da wallet, o Autonomous Database envia e-mails de notificação toda semana, indicando a data de expiração da wallet. Esses e-mails avisam antes que sua wallet expire que você precisa fazer download de uma nova wallet. Você só receberá esses e-mails de notificação se houver uma conexão que use uma wallet que esteja 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 Baseadas em Evento no Autonomous Database para obter mais informações.

Arquivo README da Wallet

O arquivo README da wallet contém informações e detalhes de expiração da wallet para 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 a wallet foi baixada.

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

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

Ferramenta ou Recurso Descrição

Database Actions

Carregar, explorar, transformar, modelar e catalogar 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 Conexão com o Oracle Database Actions Incorporado para obter mais informações.

Graph Studio

O Oracle Graph Studio permite criar bancos de dados gráficos de propriedade 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 do 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. Para obter mais informações, consulte Sobre o Oracle Graph Studio no Autonomous Database.

Oracle APEX

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

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 Oracle Machine Learning User Management. Para obter mais informações, consulte Criar e Atualizar Contas de Usuário para Componentes do Oracle Machine Learning no Autonomous Database.

Notebooks do Usuário do Oracle Machine Learning

Os notebooks do Oracle Machine Learning fornecem acesso fácil a implementações paralelas e escaláveis no banco de dados da Oracle de uma biblioteca de algoritmos de aprendizado de máquina do Oracle Advanced Analytics (classificação, regressão, detecção de anomalia, clusterização, associações, importância de atributos, extração de recursos, séries temporais etc.), SQL, PL/SQL e funções SQL de estatísticas e análises da Oracle.

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

Drivers SODA

SODA (Oracle Document Access) simples é um conjunto de APIs que permite que você trabalhe com documentos JSON gerenciados pelo Oracle Database sem precisar 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 fazer download dos drivers SODA. Consulte Trabalhar com SODA (Simple Oracle Document Access) no Autonomous Database para obter mais informações.

Observações do arquivo README da wallet:

  • Se você renomear a 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 de Wallet com um arquivo README atualizado. O link de drivers SODA é um link de recurso que não é alterado quando você renomea uma instância.

  • O README em uma wallet regional não contém os links de ferramentas e de 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 a ser usado 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 para 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 de TNS e as strings de conexão, faça o seguinte:

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

    Por padrão, essa opção mostra as informações de conexão TLS mútuo em uma tabela com nomes de TNS e strings de conexão para a instância do Autonomous Database.

  2. Quando conexões TLS Mútua (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.

    Por exemplo, ao clicar em Mostrar, você verá 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, selecione também 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 de dentro da VCN na qual 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 de 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 Plataforma entre as seguintes opções:
    • MongoDB API (Java)
    • MongoDB API (Python)
    • MongoDB API (JavaScript)
    • Java
    • Python
    • Nó
      Observação

      Os exemplos de conexão para a API MongoDB só estarão disponíveis se você tiver configurado 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.