USERIDALIAS
有效对象
提取、复制、DEFGEN、管理客户机。
受以下项支持
该发行版支持的所有数据库。
说明
使用 USERIDALIAS 参数为登录数据库时使用的 Oracle GoldenGate 进程指定验证。使用 USERIDALIAS 需要使用 Oracle GoldenGate 身份证明存储。在参数文件中的任何 TABLE 或 MAP 项之前指定 USERIDALIAS。USERIDALIAS 用户所需的权限因数据库而异。
以下规则适用于 <alias> 的值:
-
长度最多可为 30 个字符
-
必须以字母开头
-
可以包括字母、数字和以下特殊字符的任意组合:
-
美元(美元)符号
-
_ (下划线)
-
(散列)符号
-
USERIDALIAS 与 USERID 比较
通过 USERIDALIAS,可以在参数文件中指定别名,而不是用户 ID 和口令。用户 ID 和加密密码存储在身份证明存储中。USERIDALIAS 支持在 Linux、UNIX 和 Windows 平台上运行的数据库。
USERID 要求在参数文件中指定明文口令或者使用 ENCRYPT PASSWORD 命令对其进行加密,并且(可选)将加密密钥存储在 ENCKEYS 文件中。USERID 支持 Oracle GoldenGate 支持的广泛数据库。此外,它还支持为 Oracle AI Database 使用操作系统登录。
每个数据库类型的 USERIDALIAS 要求
USERIDALIAS 的使用情况因数据库类型而异。注:需要数据库用户和口令的登录必须存储在 Oracle GoldenGate 身份证明存储中。
Oracle GoldenGate 中 USERIDALIAS 中 MySQL MA 支持的指定 USERID 为:
-
user/db -
user@host/db -
user@host:port/db
如果允许 Oracle GoldenGate 用户更改或添加不遵循上述任何模式的 USERIDALIAS,则用户将在客户机(例如 MA Web 界面客户机或管理客户机)上看到模式匹配中的错误。
适用于 LUW 的 DB2
对使用数据库验证连接到 Db2 LUW 数据库的所有 Oracle GoldenGate 进程使用 USERIDALIAS 参数。
MySQL
将 USERIDALIAS 用于连接到 MySQL 数据库的所有 Oracle GoldenGate 进程。
Oracle
将 USERIDALIAS 用于连接到 Oracle AI Database 的 Oracle GoldenGate 进程。
-
指定存储在 Oracle GoldenGate 身份证明存储中的数据库身份证明的别名。
-
将 Extract 配置为使用
LOGRETENTION时,USERIDALIAS用户需要特殊数据库权限。安装 Oracle GoldenGate 时可能已授予这些权限。有关LOGRETENTION的更多信息,请参见 Configure Logging Properties 。 -
要将
USERIDALIAS用于为集成捕获配置的提取组,用户必须具有特权。如果使用 Oracle AI Database 26ai 及更高版本,则可以使用OGG_CAPTURE和OGG_APPLY用户角色授予用户权限。如果使用 Oracle 数据库 21c 或更低版本,则用户必须具有dbms_goldengate_auth.grant_admin_privilege过程中的特权。用户必须为与此USERIDALIAS关联的提取组发出DBLOGIN和REGISTER EXTRACT或UNREGISTER EXTRACT的用户。有关授予 Oracle AI Database 26ai 用户权限的详细信息,请参阅为 Oracle AI Database 26ai 及更高版本授予用户权限。
有关为 Oracle Database 21c 及更低版本授予权限的详细信息,请参见 Grant User Privileges for Oracle Database 21c and lower 。
使用 Kerberos 验证的 USERIDALIAS
仅支持 Oracle AI Database。
您需要将 ALTER CREDENTIALSTORE 设置为使用 NOPASSWORD 关键字,因为验证是外部验证。有关更多信息,请参见 ALTER CREDENTIALSTORE 。
SQL Server
如果 Oracle GoldenGate 进程将使用的 ODBC 数据源连接配置为使用 SQL Server 验证进行连接,则使用 USERIDALIAS。
Teradata
将 USERIDALIAS 用于连接到 Teradata 数据库的 Oracle GoldenGate 进程。
默认值
无
语法
USERIDALIAS <alias> [DOMAIN <domain>] [SYSDBA]
[, THREADS (<threadID>[, <threadID>][, ...][, <thread_range>[, <thread_range>][, ...])]
<alias>
指定存储在 Oracle GoldenGate 身份证明存储中的数据库用户身份证明的别名。
DOMAIN <domain>
指定所指定别名的身份证明存储域。所指定别名的身份证明存储中必须存在有效的域条目。
SYSDBA
(Oracle) 指定用户以 sysdba 身份登录。
THREADS (<threadID>[, <threadID>][, ...][, <thread_range>[, <thread_range>][, ...])
对复制有效。将指定的身份证明链接到协调 Replicat 的一个或多个线程。使您能够为不同的线程指定不同的登录。
<threadID>[, <threadID>][, ...]
指定一个线程 ID,或以 threadID, threadID, threadID 格式指定逗号分隔的线程列表。
[, <thread_range>[, <thread_range>][, ...]
以 threadIDlow-threadIDhigh 形式指定线程范围,或以 threadIDlow-threadIDhigh,threadIDlow-threadIDhigh 格式指定的逗号分隔的范围列表。
允许组合使用这些格式,例如 threadID、threadID、threadIDlow-threadIDhigh。
TimesTen
将 USERIDALIAS 用于连接到 TimesTen 数据库的 Oracle GoldenGate 进程。
默认值
无
语法
USERIDALIAS <alias> [DOMAIN <domain>] [SYSDBA]
[, THREADS (<threadID>[, <threadID>][, ...][, <thread_range>[, <thread_range>][, ...])]
<alias>
指定存储在 Oracle GoldenGate 身份证明存储中的数据库用户身份证明的别名。
DOMAIN <domain>
指定所指定别名的身份证明存储域。所指定别名的身份证明存储中必须存在有效的域条目。
SYSDBA
(Oracle) 指定用户以 sysdba 身份登录。
THREADS (<threadID>[, <threadID>][, ...][, <thread_range>[, <thread_range>][, ...])
对复制有效。将指定的身份证明链接到协调 Replicat 的一个或多个线程。使您能够为不同的线程指定不同的登录。
<threadID>[, <threadID>][, ...]
指定一个线程 ID,或以 threadID, threadID, threadID 格式指定逗号分隔的线程列表。
[, <thread_range>[, <thread_range>][, ...]
以 threadIDlow-threadIDhigh 形式指定线程范围,或以 threadIDlow-threadIDhigh,threadIDlow-threadIDhigh 格式指定的逗号分隔的范围列表。
允许组合使用这些格式,例如 threadID、threadID、threadIDlow-threadIDhigh。
示例
示例 1
以下项为身份证明存储中的用户提供身份证明,该身份证明存储的别名为 east 域中的 tiger1。
USERIDALIAS tiger1 DOMAIN east
示例 2
以下为协调复制的线程 3 提供身份证明。
USERIDALIAS tiger1 DOMAIN east THREADS (3)
示例 3
以下示例显示了 PostgreSQL 中参数的使用:
USERIDALIAS pgdsn
以下示例显示了如何将 Kerberos 验证与 Oracle GoldenGate 管理客户机结合使用:
OGG (http://localhost:9005 demo)4> dblogin useridalias ggma
Successfully logged into database CDB1_PDB1
在此示例中,以前使用 ALTER CREDENTIALSTORE 命令设置了凭证存储。