Documentação do Oracle Cloud Infrastructure

Criar Links de Banco de Dados do Autonomous AI Database para um Autonomous AI Database em um Ponto Final Privado

Você pode criar links de banco de dados de um Autonomous AI Database para um Autonomous AI Database de destino que esteja em um ponto final privado.

Dependendo da configuração do Autonomous AI Database de destino, você tem estas opções:

Consulte Como Criar um Link de Banco de Dados do Autonomous AI Database para uma Instância do Database Cloud Service para obter mais informações.

Pré-requisitos para Links de Banco de Dados do Autonomous AI Database para um Autonomous AI Database de Destino em um Ponto Final Privado

Lista os pré-requisitos para criar links de banco de dados para um Autonomous AI Database de destino que esteja em um ponto final privado.

Para criar um link de banco de dados para um Autonomous AI Database de destino em um ponto final privado:

  • O banco de dados de destino deve estar acessível pela VCN do Oracle Cloud Infrastructure do banco de dados de origem. Por exemplo, você pode estabelecer conexão com o banco de dados de destino quando:

    • O banco de dados de destino está em um ponto final privado.

    • Tanto o banco de dados de origem quanto o de destino estão na mesma VCN do Oracle Cloud Infrastructure.

    • O banco de dados de origem e o banco de dados de destino estão em diferentes VCNs do Oracle Cloud Infrastructure pareadas.

    • O banco de dados de destino é conectado à VCN do Oracle Cloud Infrastructure do banco de dados de origem usando FastConnect ou VPN.

  • Para um destino em um ponto final privado, o DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK suporta a especificação de um único nome de host com o parâmetro hostname. Em um ponto final privado, não há suporte para o uso de um endereço IP, IP SCAN ou nome de host SCAN (quando o destino está em um ponto final público, o CREATE_DATABASE_LINK suporta o uso de um endereço IP, um IP SCAN ou um nome de host SCAN).

  • DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK não suporta um valor de localhost para o parâmetro hostname.

  • As seguintes regras de entrada e saída devem ser definidas para o ponto final privado:

    • Defina uma regra de saída na lista de segurança de sub-rede ou no grupo de segurança de rede do banco de dados de origem para que o tráfego em TCP seja permitido para o endereço IP e o número da porta do banco de dados de destino.

    • Defina uma regra de entrada na lista de segurança de sub-rede ou no grupo de segurança de rede do banco de dados de destino de forma que o tráfego por TCP seja permitido do endereço IP do banco de dados de origem para a porta de destino.

    Consulte Configurar o Acesso à Rede com Pontos Finais Privados para obter informações sobre como configurar pontos finais privados com regras de entrada e saída.

Observação

Observação: Quando sua instância do Autonomous AI Database for configurada com um ponto final privado, defina a propriedade do banco de dados ROUTE_OUTBOUND_CONNECTIONS para especificar que todos os links de banco de dados de saída estejam sujeitos às regras de saída da VCN do ponto final privado da instância do Autonomous AI Database. Consulte Segurança Aprimorada para Conexões de Saída com Pontos Finais Privados para obter mais informações.

Criar Links de Banco de Dados para um Autonomous AI Database de Destino em um Ponto Final Privado sem uma Wallet (TLS)

Você pode criar links de banco de dados de um Autonomous AI Database para um Autonomous AI Database de destino que esteja em um ponto final privado e se conecte sem uma wallet (TLS).

Execute as etapas de pré-requisito, conforme necessário. Consulte Pré-requisitos para Links de Banco de Dados do Autonomous AI Database para um Autonomous AI Database de Destino em um Ponto Final Privado para obter detalhes.

Para criar um link de banco de dados para um Autonomous AI Database de destino em um ponto final privado sem uma wallet:

  1. Se você ainda não tiver feito isso, ative as conexões TLS na sua instância do Autonomous AI Database.

    Consulte Atualizar sua Instância do Autonomous AI Database para Permitir a Autenticação TLS e mTLS para obter detalhes.

  2. Crie credenciais para acessar a instância de destino do Autonomous AI Database. As credenciais username e password que você especifica com DBMS_CLOUD.CREATE_CREDENTIAL são as credenciais do banco de dados de destino usado no link do banco de dados (em que o banco de dados de destino é acessado por meio da VCN).

    Por exemplo:

    BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
         credential_name => 'PRIVATE_ENDPOINT_CRED',
         username => 'NICK',
         password => 'password'
         );
END;
/

    Os caracteres no parâmetro username devem ter todas as letras maiúsculas.

    Observação

    Observação: Você pode usar uma credencial de segredo do vault para a credencial do banco de dados de destino em um link de banco de dados. Consulte Usar Credenciais do Segredo do Vault para obter mais informações.

    Esta operação armazena as credenciais no banco de dados em um formato criptografado. Você pode usar qualquer nome para o nome da credencial.

  3. Crie o link do banco de dados para o banco de dados de destino usando DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

    Por exemplo:

    BEGIN
     DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
         db_link_name => 'PRIVATE_ENDPOINT_LINK',
         hostname => 'exampleHostname',
         port => '1521',
         service_name => '*example_high.adb.oraclecloud.com*',
         credential_name => 'PRIVATE_ENDPOINT_CRED',
         directory_name => NULL,
         private_target => TRUE);
END;
/

    Para um destino em um ponto final privado, o DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK suporta a especificação de um único nome de host com o parâmetro hostname. Em um ponto final privado, não há suporte para o uso de um endereço IP, IP SCAN ou nome de host SCAN (quando o destino está em um ponto final público, o CREATE_DATABASE_LINK suporta o uso de um endereço IP, um IP SCAN ou um nome de host SCAN).

    Usuários diferentes de ADMIN precisam de privilégios para executar DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

    Conforme mostrado no exemplo, para criar um link de banco de dados com DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK para um banco de dados de destino em um ponto final privado sem uma wallet, todas as opções a seguir são necessárias:

    • O parâmetro directory_name deve ser NULL.

    • O parâmetro ssl_server_cert_dn pode ser omitido ou, se incluído, especifique um valor NULL.

    • O parâmetro private_target deve ser TRUE.

    Observação

    Observação: Se você definir a propriedade do banco de dados ROUTE_OUTBOUND_CONNECTIONS, a definição do parâmetro private_target como TRUE não será necessária nessa API. Consulte Segurança Aprimorada para Conexões de Saída com Pontos Finais Privados para obter mais informações.

  4. Use o link de banco de dados criado para acessar dados no banco de dados de destino.

    Por exemplo:

    SELECT * FROM employees@PRIVATE_ENDPOINT_LINK;
    Observação

    Observação:

    Para as credenciais criadas na Etapa 1, as credenciais do Oracle AI Database, se a senha do usuário de destino for alterada, você poderá atualizar a credencial que contém as credenciais do usuário de destino da seguinte forma:

    BEGIN
  DBMS_CLOUD.UPDATE_CREDENTIAL (
        credential_name => 'DB_LINK_CRED',
        attribute => 'PASSWORD',
        value => 'password');
END;
/

    Em que password é a senha nova.

    Após essa operação, os links de banco de dados existentes que usam essa credencial continuam funcionando sem precisar eliminar e recriar os links de banco de dados.

    Consulte Procedimento CREATE_DATABASE_LINK para obter informações adicionais.

Criar Links de Banco de Dados para um Autonomous AI Database de Destino em um Ponto Final Privado com uma Wallet (mTLS)

Você pode criar links de banco de dados de um Autonomous AI Database para um Autonomous AI Database de destino que esteja em um ponto final privado (mTLS).

Execute as etapas de pré-requisito, conforme necessário. Consulte Pré-requisitos para Links de Banco de Dados do Autonomous AI Database para um Autonomous AI Database de Destino em um Ponto Final Privado para obter detalhes.

Para criar um link de banco de dados para um Autonomous AI Database de destino em um ponto final privado, com uma wallet:

  1. Copie sua wallet do banco de dados de destino, cwallet.sso, contendo os certificados do banco de dados de destino para o Object Store.

    Observação

    Observação: O arquivo da wallet, juntamente com o ID de usuário e a senha do Banco de Dados, fornecem acesso aos dados no banco de dados Oracle de destino. Armazene os arquivos da wallet em um local seguro. Só compartilhe os arquivos da wallet com usuários autorizados.

  2. Crie credenciais para acessar o Object Store no qual você armazena o cwallet.sso. Consulte Procedimento CREATE_CREDENTIAL para obter informações sobre os parâmetros de nome de usuário e senha para diferentes serviços de armazenamento de objetos.

  3. Crie um diretório no Autonomous AI Database para o arquivo de wallet cwallet.sso.

    Por exemplo:

    CREATE DIRECTORY WALLET_DIR AS '*directory_path_of_your_choice*';

    Consulte Criar Diretório no Autonomous AI Database para obter informações sobre como criar diretórios.

  4. Use DBMS_CLOUD.GET_OBJECT para fazer upload da wallet do banco de dados de destino para o diretório criado na etapa anterior, WALLET_DIR.

    Por exemplo:

    BEGIN
   DBMS_CLOUD.GET_OBJECT(
       credential_name => 'DEF_CRED_NAME',
       object_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/cwallet.sso',
       directory_name => 'WALLET_DIR');
END;
/

    Neste exemplo, namespace-string é o namespace do Oracle Cloud Infrastructure Object Storage e bucketname é o nome do bucket. Consulte Noções Básicas de Namespaces do serviço Object Storage para obter mais informações.

    Observação

    Observação: O credential_name usado nesta etapa são as credenciais do Object Store. Na próxima etapa, você cria as credenciais para acessar o banco de dados de destino.

  5. No Autonomous AI Database, crie credenciais para acessar o banco de dados de destino. As credenciais username e password que você especifica com DBMS_CLOUD.CREATE_CREDENTIAL são as credenciais do banco de dados de destino usado no link do banco de dados (em que o banco de dados de destino é acessado por meio da VCN).

    Observação

    Observação: é necessário fornecer o parâmetro credential_name.

    Por exemplo:

    BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DB_LINK_CRED',
       username => 'NICK',
       password => 'password');
END;
/

    Os caracteres no parâmetro username devem ter todas as letras maiúsculas.

    Observação

    Observação: Você pode usar uma credencial de segredo do vault para a credencial do banco de dados de destino em um link de banco de dados. Consulte Usar Credenciais do Segredo do Vault para obter mais informações.

    Esta operação armazena as credenciais no banco de dados em um formato criptografado. Você pode usar qualquer nome para o nome da credencial.

  6. Crie o link do banco de dados para o banco de dados de destino usando DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

    Por exemplo:

    BEGIN
    DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
        db_link_name => 'PEDBLINK1',
        hostname => 'example1.adb.ap-osaka-1.oraclecloud.com',
        port => '1522',
        service_name => '*example_high.adb.oraclecloud.com*',
        credential_name => 'DB_LINK_CRED',
        directory_name => 'WALLET_DIR',
        private_target => TRUE);
END;
/

    Observação

    Observação: Se você definir a propriedade do banco de dados ROUTE_OUTBOUND_CONNECTIONS, a definição do parâmetro private_target como TRUE não será necessária nessa API. Consulte Segurança Aprimorada para Conexões de Saída com Pontos Finais Privados para obter mais informações.

    Para um destino em um ponto final privado, o DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK suporta a especificação de um único nome de host com o parâmetro hostname. Em um ponto final privado, não há suporte para o uso de um endereço IP, IP SCAN ou nome de host SCAN (quando o destino está em um ponto final público, o CREATE_DATABASE_LINK suporta o uso de um endereço IP, um IP SCAN ou um nome de host SCAN).

    DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK não suporta um valor de localhost para o parâmetro hostname.

    Usuários diferentes de ADMIN precisam de privilégios para executar DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

  7. Use o link de banco de dados criado para acessar dados no banco de dados de destino.

    Por exemplo:

    SELECT * FROM employees@PEDBLINK1;
    Observação

    Observação:

    Para as credenciais criadas na Etapa 5, as credenciais do Oracle AI Database, se a senha do usuário de destino for alterada, você poderá atualizar a credencial que contém as credenciais do usuário de destino da seguinte forma:

    BEGIN
  DBMS_CLOUD.UPDATE_CREDENTIAL (
    credential_name => 'DB_LINK_CRED',
    attribute => 'PASSWORD',
    value => 'password');
END;
/

    Em que password é a senha nova.

    Após essa operação, os links de banco de dados existentes que usam essa credencial continuam funcionando sem precisar eliminar e recriar os links de banco de dados.

Consulte Procedimento CREATE_DATABASE_LINK para obter informações adicionais.