Gerenciar as Conexões do Banco de Dados Externo

Este tópico fornece informações sobre como gerenciar conexões de banco de dados externo usando a Console e a API. O recurso de conexão de banco de dados externo permite que você conecte um handle de banco de dados externo a uma instância doOracle Database localizada fora do OCI.

Observação

Atualmente, o serviço External Database suporta apenas agentes do Management Agent Cloud Service (MACS) para criar uma conexão com bancos de dados externos. No momento, os Agentes Enterprise Manager Cloud Control não são suportados. Para obter mais informações sobre MACS, consulte Management Agent.

Política Obrigatória do Serviço IAM

Para usar o Oracle Cloud Infrastructure, um administrador deve conceder a você acesso de segurança em uma política. Esse acesso será necessário se você estiver usando a Console ou a API REST com um SDK, uma CLI ou outra ferramenta. Caso receba uma mensagem de que você não tem permissão ou de que não está autorizado, verifique com o administrador o tipo de acesso que você tem e em qual compartimento deve trabalhar.

Quando você registra um handle de banco de dados externo, ele é criado com a tag Oracle-Tags. Portanto, para gerenciar ainda mais a conexão, conceda a seguinte permissão.
Allow group <Group Name> to manage tag-namespaces IN tenancy 
    where target.tag-namespace.name='Oracle-Tags'

Para administradores: A política em Let database admins manage Oracle Cloud external database resources permite que o grupo especificado faça tudo com bancos de dados e recursos de banco de dados relacionados.

Se você não conhece as políticas, consulte Conceitos Básicos de Políticas e Políticas Comuns. Para obter mais informações sobre como gravar políticas para bancos de dados, consulte Detalhes da Política para Banco de Dados Externo.

Verifique o Status de uma conexão de Banco de Dados Externo

Execute as etapas a seguir para verificar o status de uma conexão de banco de dados externo.

  1. Abra o menu de navegação, selecione Oracle Database e, em seguida, selecione External Database.
  2. Em Banco de Dados Externo, selecione Bancos de Dados Plugáveis, Bancos de Dados de Contêineres ou Bancos de Dados Não Contêineres, dependendo do tipo de banco de dados externo que você está usando.
  3. Todos os bancos de dados externos no compartimento selecionado são exibidos em uma tabela. Para exibir os bancos de dados externos em outro compartimento, use o filtro Compartimento para alternar compartimentos.
  4. Na página da lista Bancos de dados externos, selecione o banco de dados externo cujo status de conexão você deseja verificar. Os detalhes do banco de dados externo que você selecionou são exibidos.
  5. Na página de detalhes do banco de dados externo, selecione a guia Conectores. Uma lista de conexões de banco de dados externo é exibida.
  6. Na lista de conexões de banco de dados externo, selecione o nome da conexão para a qual deseja verificar o status. Os detalhes da conexão selecionada são exibidos.
  7. Na página de detalhes do conector externo, na guia Informações da conexão externa, na seção Informações da conexão, selecione Verificar status da conexão e confirme quando solicitado. Uma solicitação de serviço Verificar status da conexão é criada.
  8. Selecione o nome da Solicitação de Serviço para ver detalhes do status de conexão.

Para obter mais informações sobre solicitações de serviço, consulte Solicitações de Serviço.

Atualizar as Credenciais de Conexão de uma Conexão de Banco de Dados Externo

Execute as etapas a seguir para atualizar as credenciais de conexão de uma conexão de banco de dados externo.

  1. Abra o menu de navegação, selecione Oracle Database e, em seguida, selecione External Database.
  2. Em Banco de Dados Externo, selecione Bancos de Dados Plugáveis, Bancos de Dados de Contêineres ou Bancos de Dados Não Contêineres, dependendo do tipo de banco de dados externo que você está usando.
  3. Todos os bancos de dados externos no compartimento selecionado são exibidos em uma tabela. Para exibir os bancos de dados externos em outro compartimento, use o filtro Compartimento para alternar compartimentos.
  4. Na página de lista Bancos de dados externos, selecione a conexão de banco de dados externo que você deseja atualizar. Os detalhes do banco de dados externo que você selecionou são exibidos.
  5. Na página de detalhes do banco de dados externo, selecione a guia Conectores. Uma lista de conexões de banco de dados externo é exibida.
  6. Na lista de conexões de bancos de dados externos, selecione o nome da conexão que você deseja atualizar. Os detalhes da conexão selecionada são exibidos.
  7. Na página de detalhes do conector externo, selecione Atualizar credenciais de conexão.
  8. No painel Atualizar credenciais de conexão, informe os seguintes detalhes:
  9. Nome da credencial: (Somente Leitura) Nome da credencial da conexão.
  10. Nome do Usuário: Forneça o nome do usuário para as credenciais do banco de dados a serem usadas por essa conexão.
  11. Senha: Forneça a senha para que as credenciais do banco de dados sejam usadas por esta conexão.
  12. Atribuição: Forneça a atribuição para as credenciais do banco de dados a serem usadas por essa conexão. Você pode selecionar entre NORMAL e SYSDBA.
  13. Segredo: Informe um segredo para as credenciais do banco de dados a serem usadas por essa conexão (se o conector tiver sido criado usando TCPS).
    • Selecione Selecionar um novo segredo ou Modificar segredo atual.
    • Se você selecionar Selecionar um novo segredo, use o menu para exibir os segredos existentes e selecione o nome do segredo necessário.
    • Se você selecionar Modificar segredo atual, a caixa do diálogo Modificar segredo atual será exibida.
    • Digite as seguintes informações de SSL:
      • Tipo de Armazenamento Confiável SSL: Tipo de armazenamento confiável SSL. As opções disponíveis são PKCS12 e JKS. O BCFKS é a única opção disponível nas regiões do governo dos EUA.
      • Local de Armazenamento Confiável SSL: Caminho totalmente qualificado do armazenamento confiável SSL no host do agente.
      • Senha do Armazenamento Confiável SSL: Senha do armazenamento confiável SSL.
      • Tipo de Armazenamento de Chaves SSL: [Somente leitura] Tipo de armazenamento de chaves. Ele é escolhido automaticamente para ser o mesmo que o tipo de armazenamento confiável SSL.
      • Local do Armazenamento de Chaves SSL: Caminho totalmente qualificado do armazenamento de chaves no host do agente.
      • Senha do Armazenamento de Chaves SSL: A senha do armazenamento de chaves.
      • Nome Distinto do Certificado do Servidor SSL: Nome exclusivo do certificado do servidor SSL.
    • Selecione Modificar segredo atual.
  14. Selecione Salvar.

Atualizar as Strings de Conexão de uma Conexão de Banco de Dados Externo

Execute as etapas a seguir para atualizar as strings de conexão de uma conexão de banco de dados externo.

  1. Abra o menu de navegação, selecione Oracle Database e, em seguida, selecione External Database.
  2. Em Banco de Dados Externo, selecione Bancos de Dados Plugáveis, Bancos de Dados de Contêineres ou Bancos de Dados Não Contêineres, dependendo do tipo de banco de dados externo que você está usando.
  3. Todos os bancos de dados externos no compartimento selecionado são exibidos em uma tabela. Para exibir os bancos de dados externos em outro compartimento, use o filtro Compartimento para alternar compartimentos.
  4. Na página de lista Bancos de dados externos, selecione a conexão de banco de dados externo que você deseja atualizar. Os detalhes do banco de dados externo que você selecionou são exibidos.
  5. Na página de detalhes do banco de dados externo, selecione a guia Conectores. Uma lista de conexões de banco de dados externo é exibida.
  6. Na lista de conexões de bancos de dados externos, selecione o nome da conexão que você deseja atualizar. Os detalhes da conexão selecionada são exibidos.
  7. No painel Detalhes do conector externo, selecione Atualizar strings de conexão.
  8. No painel Atualizar strings de conexão, informe os seguintes detalhes:
  9. Nome do host ou nome SCAN do DNS: Forneça o endereço IP virtual (VIP) ou o SCAN (Single Client Access Name) do banco de dados no local que você está conectando ao OCI.
  10. Porta: Forneça a porta que está sendo usada pelo banco de dados fora do OCI para conexões de banco de dados.
  11. Serviço: Forneça o nome do serviço que está sendo usado pelo banco de dados fora do OCI para conexões de banco de dados.
  12. Protocolo: (Somente leitura) O protocolo que foi definido quando você criou a conexão. Isso não pode ser alterado.
  13. Selecione Salvar.

Excluir uma Conexão do Banco de Dados Externo

Execute as etapas a seguir para excluir uma conexão de banco de dados externo.

  1. Abra o menu de navegação, selecione Oracle Database e, em seguida, selecione External Database.
  2. Em Banco de Dados Externo, selecione Bancos de Dados Plugáveis, Bancos de Dados de Contêineres ou Bancos de Dados Não Contêineres, dependendo do tipo de banco de dados externo que você está usando.
  3. Todos os bancos de dados externos no compartimento selecionado são exibidos em uma tabela. Para exibir os bancos de dados externos em outro compartimento, use o filtro Compartimento para alternar compartimentos.
  4. Na página da lista Bancos de dados externos, selecione a conexão de banco de dados externo que você deseja excluir. Os detalhes do banco de dados externo que você selecionou são exibidos.
  5. Na página de detalhes do banco de dados externo, selecione a guia Conectores. Uma lista de conexões de banco de dados externo é exibida.
  6. Na lista de conexões de bancos de dados externos, selecione o nome da conexão que você deseja excluir. Os detalhes da conexão selecionada são exibidos.
  7. No painel Detalhes do conector externo, selecione Excluir e confirme.

Usar a API

Para obter informações sobre como usar a API e assinar solicitações, consulte APIs REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte Kits de Desenvolvimento de Software e Interface de Linha de Comando.

Use estas operações de API para gerenciar conexões de banco de dados externo:

  • ListExternalDatabaseConnectors
  • GetExternalDatabaseConnector
  • CheckExternalDatabaseConnectorConnectionStatus
  • UpdateExternalDatabaseConnector
  • DeleteExternalDatabaseConnector

Para obter a lista completa de APIs do serviço Database, consulte Database Service API.