使用 Wallet (mTLS) 创建从自治 AI 数据库到公共可访问的 Oracle Database 的数据库链接
您可以创建从自治 AI 数据库到公共端点上的目标 Oracle 数据库的数据库链接。
要将数据库链接与自治 AI 数据库结合使用,必须将目标数据库配置为将 TCP/IP 与 SSL (TCPS) 验证结合使用。自治 AI 数据库默认使用 TCP/IP 和 SSL (TCPS) 验证,因此您无需在目标数据库中执行任何其他配置即可链接到另一个自治 AI 数据库。必须将其他 Oracle 数据库配置为将 TCP/IP 与 SSL (TCPS) 验证结合使用。有关更多信息,请参见 Configuring Secure Sockets Layer Authentication in Oracle Database 19c Security Guide 或 Oracle Database 26ai Security Guide 。
要创建指向公共目标的数据库链接,必须可以访问目标 Oracle Database。某些数据库可能会限制访问(例如,使用访问控制列表)。确保启用目标数据库以允许从源数据库访问数据库链接。如果通过访问控制列表 (Access Control Lists,ACL) 限制访问,则可以找到源自治 AI 数据库的出站 IP 地址并允许该 IP 地址连接到目标数据库。
有关详细信息,请参阅如何创建从自治 AI 数据库到 Database Cloud Service 实例的数据库链接。
要使用 wallet (mTLS) 创建指向目标 Oracle 数据库的数据库链接,请执行以下操作:
-
将目标数据库 wallet
cwallet.sso(包含目标数据库的证书)复制到对象存储。请注意 wallet 文件的以下内容:
-
通过 wallet 文件以及数据库用户 ID 和密码,可以访问目标 Oracle Database 中的数据。将 Wallet 文件存储在安全位置。仅与授权用户共享 wallet 文件。
-
请勿重命名 wallet 文件。对象存储中的 wallet 文件必须命名为
cwallet.sso。
-
-
创建身份证明以访问存储 wallet 文件
cwallet.sso的对象存储。有关不同对象存储服务的用户名和口令参数的信息,请参见 CREATE_CREDENTIAL Procedure 。 -
在自治 AI 数据库上为 wallet 文件
cwallet.sso创建目录。例如:
CREATE DIRECTORY *dblink_wallet_dir* AS '*directory_path_of_your_choice*';有关创建目录的信息,请参见 Create Directory in Autonomous AI Database 。
-
使用
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是存储桶名称。有关详细信息,请参阅了解对象存储名称空间。注:在此步骤中使用的
credential_name是对象存储的身份证明。在下一步中,创建用于访问目标数据库的身份证明。 -
在自治 AI 数据库实例上,创建身份证明以访问目标数据库。使用
DBMS_CLOUD.CREATE_CREDENTIAL指定的username和password是用于创建数据库链接的目标数据库的身份证明。注:需要提供
credential_name参数。例如:
BEGIN DBMS_CLOUD.CREATE_CREDENTIAL( credential_name => 'DB_LINK_CRED', username => 'NICK', password => '*password*'); END; /username参数中的字符必须全部为大写字母。此操作以加密格式将身份证明存储在数据库中。可以将任何名称用于身份证明名称。
-
使用
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK创建指向目标数据库的数据库链接。例如:
BEGIN DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK( db_link_name => 'SALESLINK', hostname => 'adb.eu-frankfurt-1.oraclecloud.com', port => '1522', service_name => '*example*_medium.atpc.example.oraclecloud.com', ssl_server_cert_dn => 'CN=atpc.example.oraclecloud.com,OU=Oracle BMCS FRANKFURT,O=Oracle Corporation,L=Redwood City,ST=California,C=US', credential_name => 'DB_LINK_CRED', directory_name => '*DBLINK_WALLET_DIR*'); END; /ADMIN 以外的用户需要运行
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK的权限。如果使用
directory_name指定的目录中的 wallet 文件不是cwallet.sso,则该过程将报告错误,例如:ORA-28759: failure to open file。 -
使用创建的数据库链接访问目标数据库中的数据。
例如:
SELECT * FROM employees@SALESLINK;
对于您在步骤 5 中创建的身份证明,即目标数据库身份证明,如果目标用户的口令发生更改,则可以更新包含目标用户身份证明的身份证明,如下所示:
BEGIN
DBMS_CLOUD.UPDATE_CREDENTIAL (
credential_name => 'DB_LINK_CRED',
attribute => 'PASSWORD',
value => '*password*' );
END;
/
其中 password 是新密码。
执行此操作后,使用此身份证明的现有数据库链接将继续工作,而无需删除和重新创建数据库链接。
有关其它信息,请参阅:
数据库链接附注与目标 Oracle Database
提供有关创建指向目标 Oracle 数据库的数据库链接的备注(当目标不是自治 AI 数据库时)
有关指向其他 Oracle 数据库的数据库链接的说明:
-
每个目录只有一个 wallet 文件有效,可用于数据库链接。一次只能将一个
cwallet.sso上载到为 wallet 文件选择的目录(例如 DBLINK_WALLET_DIR )。这意味着在 DBLINK_WALLET_DIR 中使用cwallet.sso时,只能创建指向该目录中 wallet 有效的数据库的数据库链接。要将多个cwallet.sso文件与数据库链接一起使用,需要创建其他目录并将每个cwallet.sso放入不同的目录。使用DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK创建数据库链接时,使用directory_name参数指定包含 wallet 的目录。有关创建目录的信息,请参见 Create Directory in Autonomous AI Database 。
-
指向其他 Oracle Database 的数据库链接支持的 Oracle 目标数据库版本包括:19c、12.2.0 和 12.1.0。
注:有关受支持版本的完整信息,请参见 Client Server Interoperability Support Matrix for Different Oracle Versions (Doc ID 207303.1)
-
自治 AI 数据库将
SEC_CASE_SENSITIVE_LOGON参数设置为true,并且此值无法更改。如果目标数据库不是自治 AI 数据库,则必须在目标数据库上将SEC_CASE_SENSITIVE_LOGON参数设置为true。如果目标数据库上的SEC_CASE_SENSITIVE_LOGON设置为false,则会引发错误ORA-28040: No matching authentication protocol。 -
要列出数据库链接,请使用
ALL_DB_LINKS视图。有关详细信息,请参阅 Oracle Database 19c Database Reference 中的 ALL_DB_LINKS 或 Oracle Database 26ai Database Reference 。 -
通过 wallet 文件以及数据库用户 ID 和密码,可以访问目标 Oracle 数据库中的数据。将 Wallet 文件存储在安全位置。仅与授权用户共享 wallet 文件。
-
当自治 AI 数据库实例位于专用端点上时,有两种选项可以指定目标数据库:使用
hostname参数或rac_hostnames参数:-
对于专用端点上的目标,
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK支持使用hostname参数指定单个主机名。在专用端点上,不支持使用 IP 地址、SCAN IP 或 SCAN 主机名(当目标位于公共端点上时,CREATE_DATABASE_LINK支持使用 IP 地址、SCAN IP 或 SCAN 主机名)。 -
当目标为 Oracle RAC 数据库时,使用
rac_hostnames参数指定具有DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK的一个或多个主机名。这使您可以利用 Oracle RAC 的高可用性功能。不支持使用 IP 地址、SCAN IP 或rac_hostnames值中的 SCAN 主机名。在
rac_hostnames参数中指定主机名列表时,CREATE_DATABASE_LINK将所有指定的主机名用作连接字符串中的地址。如果指定的主机之一在目标 Oracle RAC 数据库上不可用,则 Autonomous Database 会自动尝试使用列表中的其他主机名进行连接。 -
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK不支持hostname或rac_hostnames参数的值为localhost。
-