为 MySQL 添加提取

提取是对源数据源连接运行的进程，并提取或捕获数据。了解如何添加 Extract for MySQL Database Server、HeatWave on OCI、Azure Database for MySQL、HeatWave on AWS、Amazon Aurora MySQL、Amazon RDS for MySQL、Amazon RDS for MariaDB、Google Cloud SQL for MySQL、SingleStoreDB、SingleStoreDB Cloud、HeatWave on AWS 和 Azure 技术。

添加提取 (26ai)

在添加和运行提取之前，请确保为 Oracle GoldenGate 26ai 准备数据库。

要在 Oracle GoldenGate 26ai 中为 MySQL 源添加提取：

在 OCI GoldenGate 部署控制台导航菜单中，选择提取。
在“提取”页上，选择添加提取（加号图标）。
“添加提取”表单由四个页面组成。根据需要填写“添加提取”表单：
1. 在“提取信息”页面上：
  1. 选择提取类型：
    - 更改数据捕获提取
    - 初始加载提取
  2. 输入流程名称。
  3. （可选）输入说明。
  4. 选择 Next 。
2. 在“提取选项”页面上：
  1. 选择开始的时间：
    - Now
    - 定制时间
    - 日志中的位置
    - 日志结尾
  2. 输入提取线索详细信息：
    - 名称（只能为两个字符。）
    - 子目录
    - 线索大小
    - 线索序号
    - 线索偏移
  3. 从下拉列表中选择源身份证明域和别名。
  4. 选择 Next 。
3. 在“托管选项”页面上，根据需要填写可选字段，然后选择下一步：
- 概要文件名
- 对于部署的健康状况至关重要
- 自动启动
- 自动重新启动
  
  注：通过添加配置文件和配置“自动启动”和“自动重新启动”选项，您的部署可以在网络中断后自动重新启动。要了解详细信息，请参阅配置托管流程。
1. 在“参数文件”页上，可以编辑文本区域中的参数文件，以列出要捕获的表详细信息。例如：
```
table source.table1;
```
  注:
  
  默认情况下，GoldenGate 使用格林威治标准时间 (GMT)。使用 SETENV 覆盖提取的默认设置。此更改仅适用于“提取”处理，不适用于部署。
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
选择创建并运行以启动提取。如果选择“创建”，可以稍后从“提取”页面手动启动“提取”。

返回到“提取”页面，在此页面可以选择“提取”处理以查看其详细信息。

添加提取 (21c)

在添加和运行提取之前，请确保为 Oracle GoldenGate 准备和配置系统。

要在 Oracle GoldenGate 21 c 中为 MySQL 数据库添加提取：

在 OCI GoldenGate 部署控制台中，确保您位于“管理服务概览”页上，然后选择添加提取（加号图标）。
在“添加提取”页面上，为提取类型选择以下项之一，然后选择下一步。
- 更改数据捕获
- 初始加载
在“提取选项”页面的“基本信息”下，根据需要填写以下字段：
1. 对于流程名称，为“提取”流程输入名称，最多 8 个字符。
2. （可选）在说明中，输入简要说明以帮助您区分此流程与其他流程。
3. 对于意图，选择最能描述此提取用途的选项：
  - 单向（默认值）
  - 灾难恢复
  - N 向
4. 仅当从不使用全局事务处理标识符 (Global Transaction Identifier，GTID) 的 MySQL 数据库中捕获数据时，才启用 Remote 。
5. 对于 Credential Domain（身份证明域），选择 Oracle GoldenGate 。
6. 对于身份证明别名，选择源 MySQL 连接。
7. 对于线索名称，输入线索文件的两个字符名称。
8. （可选）对于线索子目录，为生成的线索文件设置定制位置。
9. （可选）对于线索大小，设置生成的线索文件的最大大小。
（可选）在 "Encryption Profile"（加密配置文件）下，输入加密配置文件说明。如果未创建加密配置文件，则默认情况下会选择本地 Wallet 配置文件。
1. 从下拉列表中选择概要信息名称。您可以选择本地 Wallet 或自定义配置文件。
2. 从下拉列表中选择加密配置文件。
3. 指定加密配置文件的主密钥。
（可选）在“Managed Options（托管选项）”下，可以配置以下各项：
- 概要文件名
- 自动启动
- 自动重新启动
  
  注：通过添加配置文件和配置“自动启动”和“自动重新启动”选项，您的部署可以在网络中断后自动重新启动。有关详细信息，请参阅配置托管进程。
选择 Next 。
在“提取参数”页上，可以编辑文本区域中的参数文件，以列出要捕获的表详细信息。例如：
```
table source.table1;
```
注:

默认情况下，GoldenGate 使用格林威治标准时间 (GMT)。使用 SETENV 覆盖提取的默认设置。此更改仅适用于“提取”处理，不适用于部署。
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
了解有关 SETENV 的更多信息。
选择在后台注册提取以在后台异步注册提取。
选择创建并运行以创建并启动提取。如果选择创建，则稍后可以从“管理服务概览”页手动启动提取。

您将返回到“管理服务概览”页面，您可以在该页面中查看提取处理的状态。从“提取操作”菜单中选择详细信息以查看流程信息、检查点、统计信息、参数和报表。

了解更多信息

有兴趣了解有关提取流程和获取数据的更多信息？请参见：

将数据从 MySQL 复制到 Autonomous AI Lakehouse

已知问题

启用 GTID 的数据库的远程更改数据捕获提取失败

在为使用全局事务处理标识符 (Global Transaction Identifier，GTID) 的 MySQL 数据库创建启用了“远程”选项的“更改数据捕获提取”处理时，提取处理将失败，并报告以下错误：

ERROR   OGG-25192  Trail file '<trail name>' is remote. Only local trail allowed for this extract.

解决方法：在“更改数据捕获提取”的“参数文件”屏幕上，删除行 TRANLOGOPTIONS ALTLOGDEST REMOTE。

有关详细信息，请参阅使用 Oracle GoldenGate for MySQL 。