通过客户管理的异构连接创建数据库链接，以连接到专用端点上的非 Oracle 数据库

您可以创建数据库链接，从基于专用 Exadata 基础设施的 Autonomous Database 到 Oracle Database Gateway，以访问专用端点上的非 Oracle 数据库。

Oracle Database Gateway 是专为访问特定非 Oracle 系统而设计的网关。使用 Oracle Database Gateway，您可以访问分布式数据库系统中的任意位置的数据，而无需知道数据的位置或存储方式。将 Autonomous Database 上的数据库链接与 Oracle Database Gateway 结合使用，可支持异构环境，无需定制应用即可访问非 Oracle 系统中的数据。

注意：

只有版本 19.25 及更高版本（适用于 19c）和 23.6 及更高版本（适用于 23ai）支持在专用端点上创建与客户管理的异构连接的非 Oracle 数据库的数据库链路。

相关主题

Prerequisites

要在公共端点上使用来自 Autonomous Database 实例的数据库链接，请执行以下操作：

  1. 配置 Oracle Database Gateway 以访问非 Oracle 数据库。有关详细信息，请参阅 Oracle Database 19c Database Heterogeneous Connectivity User's Guide 或 Oracle Database 23ai Database Heterogeneous Connectivity User's Guide 中的 Oracle Database Gateways 。

    根据要连接到的数据库，您可以参考相应的《安装和配置指南》和《网关用户指南》。

    例如，对于 Oracle Database Gateway for SQL Server，请参阅：

  2. 配置 Oracle Net Listener 以处理 Oracle Database Gateway 上的传入请求。

  3. 在 Oracle Database Gateway 上创建自签名的 wallet。

此外：

  • 目标数据库必须可从源数据库的 Oracle Cloud Infrastructure VCN 访问。例如，可以在以下情况下连接到目标数据库：

    • 目标数据库位于专用端点上。

    • 源数据库和目标数据库都位于同一 Oracle Cloud Infrastructure VCN 中。

    • 源数据库和目标数据库位于不同的配对 Oracle Cloud Infrastructure VCN 中。

    • 对于专用端点上的目标，DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK 支持使用 hostname 参数指定单个主机名。在专用端点上，不支持使用 IP 地址、SCAN IP 或 SCAN 主机名（当目标位于公共端点上时，CREATE_DATABASE_LINK 支持使用 IP 地址、SCAN IP 或 SCAN 主机名）。

  • 必须为专用端点定义以下入站和出站规则：

    • 在源数据库的子网安全列表或网络安全组中定义出站规则，以便允许通过 TCP 传输到目标数据库的 IP 地址和端口号的流量。

    • 在目标数据库的子网安全列表或网络安全组中定义入站规则，以便允许通过 TCP 的流量从源数据库 IP 地址传输到目标端口。

客户管理的与专用端点上的非 Oracle 数据库的异构连接（无 wallet）

您可以创建从 an Autonomous Database 到 Oracle Database Gateway 的数据库链接，以访问专用端点上具有 wallet (TCPS) 或无 wallet (TLS) 的非 Oracle 数据库。本节介绍如何在不使用 wallet 的情况下创建数据库链接。

要使用数据库链接和 TLS 连接从专用端点上的 Autonomous Database 实例创建到目标网关的数据库链接，请执行以下操作：
  1. 在 Autonomous Database 上，创建身份证明以访问目标数据库。使用 DBMS_CLOUD.CREATE_CREDENTIAL 指定的用户名和密码是数据库链接（通过 Oracle Database Gateway 访问目标数据库）内使用的目标数据库的身份证明。
    例如：
    BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name => 'DB_LINK_CRED',
        username => 'NICK',
        password => 'password'
    );
END;/

    必须提供 credential_name 参数。

    username 参数中的字符必须全部为大写字母。

    此操作以加密格式将身份证明存储在数据库中。您可以使用身份证明名称的任何名称。

  2. 使用 DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK 创建指向目标网关的数据库链接。
    例如：
    BEGIN
    DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
        db_link_name =>       'SALESLINK',
        hostname =>           'example.com',
        port =>               '1522',
        service_name =>       'example_service_name',
        ssl_server_cert_dn => 'ssl_server_cert_dn',
        credential_name =>    'DB_LINK_CRED',
        directory_name =>      NULL,
        gateway_link =>        TRUE,
        private_target =>      TRUE,
        gateway_params =>      NULL
    );
END;/

    如果将连接创建为基于 TCP 的数据库链接（没有 wallet），则 ssl_server_cert_dn 参数是可选的。

    当 directory_name 为 NULL 时，连接将创建为基于 TCP 的数据库链接（没有 wallet）。

    当目标非 Oracle Database 位于专用端点上（即，数据库链接访问需要在 VCN DNS 服务器中解析的主机名）时，必须将 private_target 参数设置为 TRUE。如果 private_target 为 TRUE，则 hostname 参数必须是单个主机名（在专用端点上，不支持使用 IP 地址、SCAN IP 或 SCAN 主机名）。

    如果 gateway_link 为 TRUE 且 gateway_params 为 NULL，则指定数据库链接指向客户管理的 Oracle 网关。

    非 ADMIN 用户需要运行 DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK 的特权。

    有关详细信息，请参阅：CREATE_DATABASE_LINK 过程

  3. 使用您创建的数据库链接访问目标网关上的数据。
    例如：
    SELECT * FROM employees@SALESLINK;
对于您在步骤 1 中创建的身份证明，Oracle Database Gateway 身份证明，如果目标用户的密码发生更改，您可以更新包含目标用户身份证明的身份证明，如下所示：
BEGIN
    DBMS_CLOUD.UPDATE_CREDENTIAL (
        credential_name =>'DB_LINK_CRED',
        attribute =>'PASSWORD',
        value=>'password'
    );
END;
/

其中，口令是新口令。

执行此操作后，使用此身份证明的现有数据库链接将继续工作，而不必删除并重新创建数据库链接。

有关详细信息，请参阅：UPDATE_CREDENTIAL 过程

客户管理的与专用端点上的非 Oracle 数据库的异构连接（带 wallet）

您可以创建从 an Autonomous Database 到 Oracle Database Gateway 的数据库链接，以访问专用端点上具有 wallet (TCPS) 或无 wallet (TLS) 的非 Oracle 数据库。本节介绍如何使用 wallet 创建数据库链接。

要创建数据库链接，从专用端点上的 Autonomous Database 实例到目标网关（使用 wallet 进行连接），请执行以下操作：
  1. 将包含 Oracle Database Gateway 证书的目标网关自签名 wallet（例如 cwallet.sso）复制到对象存储。
    通过 Wallet 文件以及数据库用户 ID 和密码，可以访问通过目标网关可用的数据。将 wallet 文件存储在安全位置。仅与授权用户共享 wallet 文件。
  2. 在 Autonomous Database 上，创建身份证明以访问存储 cwallet.sso 的对象存储。
    有关不同对象存储服务的用户名和口令参数的信息，请参见CREATE_CREDENTIAL Procedure 。
  3. 在 Autonomous Database 上为 wallet 文件 cwallet.sso 创建目录。
    例如：
    CREATE DIRECTORY dblink_wallet_dir AS 'directory_path_of_your_choice';
    有关创建目录的信息，请参阅在 Autonomous Database 中创建目录。
  4. 使用 DBMS_CLOUD.GET_OBJECT 将目标网关自签名 wallet 上载到您在上一步中创建的目录 DBLINK_WALLET_DIR。
    例如：
    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 =>'DBLINK_WALLET_DIR'
    ); 
END;
/

    在此示例中，namespace-string 是 Oracle Cloud Infrastructure 对象存储名称空间，bucketname 是存储桶名称。有关更多信息，请参见 Understanding Object Storage Namespaces 。

    注意：

    在此步骤中使用的 credential_name 是对象存储的身份证明。在下一步中，您将创建用于访问目标网关的身份证明。
  5. 在 Autonomous Database 上，创建身份证明以访问目标数据库。使用 DBMS_CLOUD.CREATE_CREDENTIAL 指定的用户名和密码是数据库链接（通过 Oracle Database Gateway 访问目标数据库）内使用的目标数据库的身份证明。
    例如：
    BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name =>'DB_LINK_CRED',
        username =>'NICK',
        password =>'password'
    );
END;
/

    必须提供 credential_name 参数。

    username 参数中的字符必须全部为大写字母。

    此操作以加密格式将身份证明存储在数据库中。您可以使用身份证明名称的任何名称。

  6. 使用 DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK 创建指向目标网关的数据库链接。
    例如：
    BEGIN
    DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
        db_link_name =>'SALESLINK', 
        hostname =>'example.com', 
        port =>'1522',
        service_name =>'example_service_name',
        ssl_server_cert_dn =>'ssl_server_cert_dn',
        credential_name =>'DB_LINK_CRED',
        directory_name =>'DBLINK_WALLET_DIR',
        gateway_link =>TRUE,
        private_target =>TRUE,
        gateway_params =>NULL
    );
END;
/

    如果 directory_name 不是 NULL，则会创建基于 TCPS 的数据库链接。

    当目标非 Oracle Database 位于专用端点上（即，数据库链接访问需要在 VCN DNS 服务器中解析的主机名）时，必须将 private_target 参数设置为 TRUE。如果 private_target 为 TRUE，则 hostname 参数必须是单个主机名（在专用端点上，不支持使用 IP 地址、SCAN IP 或 SCAN 主机名）。

    如果 gateway_link 为 TRUE 且 gateway_params 为 NULL，则指定数据库链接指向客户管理的 Oracle 网关。

    非 ADMIN 用户需要运行 DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK 的特权。

    有关详细信息，请参阅：CREATE_DATABASE_LINK 过程

  7. 使用您创建的数据库链接访问目标网关上的数据。
    例如：
    SELECT * FROM employees@SALESLINK;
对于您在步骤 5 中创建的身份证明，Oracle Database Gateway 身份证明，如果目标用户的密码发生更改，您可以更新包含目标用户身份证明的身份证明，如下所示：
BEGIN
    DBMS_CLOUD.UPDATE_CREDENTIAL (
        credential_name =>'DB_LINK_CRED',
        attribute =>'PASSWORD',
        value=>'password'
    );
END;
/

其中，口令是新口令。

执行此操作后，使用此身份证明的现有数据库链接将继续工作，而不必删除并重新创建数据库链接。

有关详细信息，请参阅：UPDATE_CREDENTIAL 过程