Criar Links de Banco de Dados para Bancos de Dados Não Oracle com Conectividade Heterogênea Gerenciada pela Oracle

O suporte do Autonomous Database para conectividade heterogênea gerenciada pela Oracle facilita a criação de links de banco de dados para bancos de dados não Oracle.

1. No Autonomous Database, crie credenciais para acessar o banco de dados de destino. As credenciais username e password especificadas com DBMS_CLOUD.CREATE_CREDENTIAL são as credenciais do banco de dados de destino usado no link do banco de dados.

   Por exemplo:

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

   Esta operação armazena as credenciais no banco de dados em um formato criptografado. Você pode usar qualquer nome para o nome da credencial. É necessário fornecer o parâmetro credential_name.

   Para acessar o Google Analytics, o Google BigQuery, o Google Drive, o Youtube, ServiceNow ou o Microsoft SharePoint com OAuth2, a credencial deve incluir o parâmetro params com o valor gcp_oauth2.

   Por exemplo:

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'SERVICENOW_OAUTH',
       params => JSON_OBJECT(
                    'gcp_oauth2' value JSON_OBJECT(
                           'client_id' value 'CLIENT_ID', 
                           'client_secret' value 'CLIENT_SECRET', 
                           'refresh_token' value 'Refresh_Token')));
   END;
   /

   Consulte CREATE_CREDENTIAL Procedures para obter mais informações.

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

   Por exemplo, para criar um link de banco de dados para o AWS Redshift:

   BEGIN
        DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
             db_link_name => 'AWSREDSHIFT_LINK', 
             hostname => 'example.com', 
             port => '5439',
             service_name => 'example_service_name',
             credential_name => 'AWS_REDSHIFT_LINK_CRED',
             gateway_params => JSON_OBJECT('db_type'  value 'awsredshift'),
             ssl_server_cert_dn => NULL);
   END;
   /

   O service_name é o nome do banco de dados não Oracle.

   O valor gateway_params db_type que você fornece deve ser um dos valores suportados:

   Valor db_type	Tipo de Banco de Dados
   awsredshift	Amazon Redshift
   azure	Microsoft SQL Server SQL do Azure Azure Synapse Analytics
   db2	IBM Db2
   google_analytics	Google Analytics
   google_bigquery	Google BigQuery
   google_drive	Google Drive
   hive	Apache Hive
   mongodb	MongoDB
   mysql	MySQL
   mysql_community	MySQL Community Edition
   postgres	PostgreSQL
   salesforce	Salesforce
   servicenow	ServiceNow
   sharepoint	Microsoft SharePoint
   snowflake	Snowflake
   youtube	YouTube

   O Autonomous Database configura e trata automaticamente a conexão segura com um banco de dados de destino e suas conexões são criptografadas de ponta a ponta. A conectividade heterogênea gerenciada pela Oracle é pré-configurada com uma wallet que contém a maioria dos certificados SSL raiz e intermediários confiáveis comuns. Portanto, NULL deve ser fornecido como o valor do parâmetro ssl_server_cert_dn.

   Para garantir a segurança ao usar links de banco de dados com conectividade heterogênea gerenciada pela Oracle, a porta de conexão é restrita e deve ter SSL/TLS ativado. Você especifica a porta do banco de dados de destino com o parâmetro port.

   Consulte Tipos e Portas de Banco de Dados de Conectividade Heterogênea Gerenciada pela Oracle para obter a lista de tipos de banco de dados não Oracle suportados.

   A view HETEROGENEOUS_CONNECTIVITY_INFO fornece informações sobre os tipos de Conectividade Heterogênea do Oracle suportados e mostra uma amostra de código PL/SQL para cada tipo suportado. Consulte Acessar Informações e Amostras de Conectividade Heterogênea para obter mais informações.

   Quando você especifica o parâmetro gateway_params, para alguns valores db_type, são suportados parâmetros gateway_params adicionais:

   Valor db_type	Parâmetros de Gateway Suportados com db_type Especificado
   azure	Quando o valor db_type é azure, há dois parâmetros opcionais, auth_method e domain para suportar a autenticação NTLM/AD. Quando NTLMv2 estiver configurado, defina auth_method=10 e domain como o valor de domínio do Windows. Para usar uma senha do Azure Active Directory, defina auth_method=13. Não use auth_method=13 para acessar um Banco de Dados Oracle on-premises. Consulte Método de Autenticação do Microsoft SQL Server para obter mais informações.
   google_analytics	Quando o valor db_type é google_analytics, o hostname não é usado e você pode fornecer um valor como example.com. Para db_type google_analytics, a credencial deve ser uma credencial do tipo OAuth usando o parâmetro params com valores gcp_oauth2 especificados (client_id, client_secret e refresh_token). Consulte CREATE_CREDENTIAL Procedures para obter mais informações.
   google_bigquery	Quando db_type é google_bigquery, o parâmetro project é válido. Este parâmetro especifica o nome do projeto no google_bigquery e é obrigatório. Quando o valor db_type é google_bigquery, o hostname não é usado e você pode fornecer um valor como example.com. Para db_type google_bigquery, a credencial deve ser uma credencial do tipo OAuth usando o parâmetro params com valores gcp_oauth2 especificados (client_id, client_secret e refresh_token). Consulte CREATE_CREDENTIAL Procedures para obter mais informações.
   google_drive	Para db_type google_drive, a credencial fornecida com DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK deve ser um tipo de credencial OAuth usando o parâmetro params com valores de gcp_oauth2 especificados (client_id, client_secret e refresh_token). Para se conectar ao Google Drive e obter dados, você deve fornecer os parâmetros de gateway directory_name e file_name. Esses parâmetros especificam um arquivo de modelo (arquivo REST automático) que mapeia a resposta JSON para o modelo relacional. O arquivo de modelo especifica os pontos finais, o mapeamento de tabela e o código de resposta HTTP para processar a resposta JSON. Consulte Sintaxe de arquivo de modelo e Arquivo de modelo de exemplo para obter mais informações. Ao usar o parâmetro gateway_params com db_type google_drive, você deve fornecer o parâmetro gateway_params db_type com o valor 'google_drive' e os parâmetros directory_name e file_name, juntamente com as credenciais do tipo OAuth: O parâmetro directory_name especifica o diretório com o arquivo de configuração REST. Você poderia criar esse diretório da seguinte forma: create or replace directory google_drive_dir as 'GOOGLE_DRIVE_DIR'; Obtenha e faça download do arquivo REST automático para o diretório especificado. Por exemplo: exec DBMS_CLOUD.get_object('google_drive_dir_cred', 'https://objectstorage.<...>/google_drive.rest','GOOGLE_DRIVE_DIR'); Defina o valor file_name como o nome do arquivo REST automático que você baixou, "google_drive.rest". Em seguida, você pode usar o arquivo de configuração REST com o OAuth 2.0.
   hive	Quando db_type é hive, o parâmetro http_path é válido. Esse parâmetro especifica o valor HttpPath, se necessário, para estabelecer conexão com a instância do Hive.
   salesforce	Ao usar o parâmetro gateway_params com db_type salesforce, você deve fornecer a opção security_token. O token de segurança é um código alfanumérico que distingue maiúsculas de minúsculas. Consulte Redefinir Seu Token de Segurança para obter mais informações. Ao usar o parâmetro gateway_params com db_type salesforce, você deve fornecer o parâmetro hostname correto. O Salesforce fornece duas formas de URLs para a conta de serviço do Salesforce: Formulário xxxx.develop.lightning.force.com do URL Formulário xxxxmy.salesforce.com de URL, conforme mostrado na guia Exibir perfil. A Conectividade Heterogênea Gerenciada pela Oracle só suporta o formato xxxxmy.salesforce.com do URL para o valor do parâmetro hostname.
   servicenow	Para se conectar a ServiceNow e obter dados, você deve fornecer os parâmetros de gateway directory_name e file_name. Esses parâmetros especificam um arquivo de modelo (arquivo de configuração REST) que mapeia a resposta JSON para o modelo relacional. O arquivo de modelo especifica os pontos finais, o mapeamento de tabela e o código de resposta HTTP para processar a resposta JSON. Consulte Sintaxe de arquivo de modelo e Arquivo de modelo de exemplo para obter mais informações. Quando você usa o parâmetro gateway_params com db_type servicenow, há duas opções suportadas: Autenticação Básica: você deve fornecer o parâmetro gateway_params db_type com o valor 'servicenow' e fornecer os parâmetros directory_name e file_name juntamente com as credenciais do tipo de nome de usuário/senha. Autenticação OAuth 2.0: você deve fornecer o parâmetro gateway_params db_type com o valor 'servicenow' e os parâmetros directory_name, file_name e token_uri, juntamente com as credenciais do tipo OAuth. Para a autenticação OAuth 2.0 com db_type servicenow, a credencial deve ser uma credencial do tipo OAuth usando o parâmetro params com valores gcp_oauth2 especificados (client_id, client_secret e refresh_token). Consulte CREATE_CREDENTIAL Procedures para obter mais informações. O parâmetro directory_name especifica o diretório com o arquivo de configuração REST ServiceNow. Você poderia criar esse diretório da seguinte forma: create or replace directory servicenow_dir as 'SERVICENOW_DIR'; Obtenha e faça download do arquivo de configuração REST ServiceNow para o diretório especificado. Por exemplo: exec DBMS_CLOUD.get_object('servicenow_dir_cred', 'https://objectstorage.<...>/servicenow.rest','SERVICENOW_DIR'); Defina o valor file_name como o nome do arquivo de configuração REST que você baixou, "servicenow.rest". Em seguida, você pode usar o arquivo de configuração REST ServiceNow com autenticação básica ou OAuth2.0. Consulte HETEROGENEOUS_CONNECTIVITY_INFO View para obter amostras.
   sharepoint	Ao usar o parâmetro gateway_params com db_type sharepoint, também especifique valores para auth_uri, scope, service_url e token_uri. Para db_type sharepoint, a credencial fornecida com DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK deve ser um tipo de credencial OAuth usando o parâmetro params com valores de gcp_oauth2 especificados (client_id, client_secret e refresh_token). Consulte CREATE_CREDENTIAL Procedures para obter mais informações. Gere o refresh_token para tenant_id.sharepoint.com/.default offline_access. Consulte o seguinte para obter mais informações: Determinar o escopo e Autenticação OAuth 2.0. Defina valores para gateway_params para db_type sharepoint: auth_uri: Defina o auth_uri do Azure. Consulte Obter informações e pontos finais do cliente do aplicativo para obter mais informações. scope: Defina o escopo. Consulte Descrições da opção de conexão para obter mais informações. service_url: Defina o service_url. Consulte URL do Serviço para obter mais informações. token_uri: Obtenha a token_uri do Azure. Consulte Obter informações e pontos finais do cliente do aplicativo para obter mais informações.
   snowflake	Quando você usar o parâmetro gateway_params com db_type snowflake, use o identificador de conta Snowflake como o parâmetro hostname. Nesse caso, o driver adiciona snowflakecomupting.com, para que você não passe essa parte do nome do host explicitamente. Para localizar o identificador da sua conta do Snowflake, consulte Formatos de Identificador de Conta por Plataforma e Região da Nuvem. Por exemplo: para a conta Snowflake: https://example-marketing_test_account.snowflakecomputing.com Defina o valor hostname como "example-marketing_test_account". Quando a db_type é SNOWFLAKE, os parâmetros opcionais: role, schema e warehouse são válidos. Esses valores especificam um esquema, atribuição ou valor de depósito diferente do padrão. Por exemplo: gateway_params => JSON_OBJECT( 'db_type' value 'snowflake', 'role' value 'ADMIN', 'schema' value 'PUBLIC', 'warehouse' value 'TEST' )
   youtube	Para se conectar a YouTube e obter dados, forneça os parâmetros directory_name e file_name. Esses parâmetros especificam um arquivo de modelo (arquivo de configuração REST) que mapeia a resposta JSON para o modelo relacional. O arquivo de modelo especifica os pontos finais, o mapeamento de tabela e o código de resposta HTTP para processar a resposta JSON. Consulte Sintaxe de arquivo de modelo e Arquivo de modelo de exemplo para obter mais informações. Para db_type youtube, a credencial deve ser uma credencial do tipo OAuth usando o parâmetro params com valores gcp_oauth2 especificados (client_id, client_secret e refresh_token). Consulte CREATE_CREDENTIAL Procedures para obter mais informações. O parâmetro directory_name especifica o diretório com o arquivo de configuração REST do youtube. Por exemplo, para criar este diretório e adicionar o conteúdo necessário: Crie um diretório na instância do Autonomous Database: create or replace directory youtube_dir as 'YOUTUBE_DIR'; Obtenha e faça download do arquivo de configuração REST de descanso automático para o diretório especificado. Por exemplo: exec DBMS_CLOUD.get_object('youtube_dir_cred', 'https://objectstorage.<...>/youtube.rest','YOUTUBE_DIR'); Defina o valor file_name como o nome do arquivo de configuração REST que você baixou, 'youtube.rest'. Em seguida, você pode usar o arquivo de configuração REST com o OAuth2.0. Consulte HETEROGENEOUS_CONNECTIVITY_INFO View para obter amostras.

   Consulte CREATE_DATABASE_LINK Procedures para obter mais informações.

3. Use o link de banco de dados para acessar dados no banco de dados de destino.

   Por exemplo:

   SELECT count(*) FROM sales@AWSREDSHIFT_LINK

   O nome da tabela especificado quando você usa SELECT com o Google BigQuery deve estar entre aspas. Por exemplo:

   SELECT count(*) FROM "sales"@GOOGLE_BIGQUERY_LINK

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

• Criar Links de Banco de Dados para o Oracle MySQL em um Ponto Final Privado com Conectividade Heterogênea Gerenciada pela Oracle
  O suporte do Autonomous Database para conectividade heterogênea gerenciada pela Oracle facilita a criação de links de banco de dados para o Oracle MySQL Database Service em um ponto final privado. Quando você usa links de banco de dados com conectividade heterogênea gerenciada pela Oracle, o Autonomous Database configura e configura a conexão com o Oracle MySQL Database Service.
• Tipos e Portas de Banco de Dados de Conectividade Heterogênea Gerenciada pela Oracle
  Mostra os bancos de dados não Oracle com os quais você pode se conectar do Autonomous Database com conectividade heterogênea gerenciada pela Oracle e lista o valor de porta suportado para cada tipo de banco de dados. Também fornece um link no qual você pode ver as versões de banco de dados suportadas para cada tipo de banco de dados.
• Acessar Informações e Amostras de Conectividade Heterogênea
  O Oracle Autonomous Database fornece informações de conectividade heterogêneas para links de banco de dados a bancos de dados não Oracle.