为 MySQL 添加提取

提取是对源数据源连接运行的进程，并提取或捕获数据。Learn to add an 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, and HeatWave on Azure technologies.

添加提取 (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 。