为 MySQL 添加提取

Extract 是一个再次运行源数据源连接并提取或捕获数据的进程。Learn to add an Extract for MySQL Database Server, HeatWave, 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.

添加提取 (23ai)

在添加和运行提取之前,请确保为 Oracle GoldenGate 23ai 准备数据库
要在 Oracle GoldenGate 23ai 中为 MySQL 源添加提取:
  1. Administration Service 导航菜单中,单击 Extracts
  2. Extracts 页面上,单击添加 Extract (加号图标)。
  3. “添加 Extract”表单由四页组成。根据需要填写“添加 Extract”表单:
    1. 在“Extract 信息”页上:
      1. 选择 Extract 类型
        • Change Data Capture Extract
        • Initial Load Extract
      2. 输入进程名
      3. (可选)输入说明
      4. 单击下一步
    2. 在“Extract 选项”页上:
      1. 选择开始的时间:
        • Now
        • 定制时间
        • 日志中的位置
        • 日志结尾
      2. 输入 Extract Trail 详细信息:
        • 名称(只能是两个字符。)
        • 子目录
        • 线索大小
        • 线索序号
        • 线索偏移量
      3. 从下拉列表中选择 "Source Credentials"(源身份证明) "Domain"(域)和 " Alias"(别名)
      4. 单击下一步
    3. 在“托管选项”页面上,根据需要填写可选字段:
      1. 选择配置文件名
      2. 启用 Critical to deployment health
      3. 启用自动启动
      4. 启用自动重新启动
      5. 单击下一步
    4. 在“参数文件”页上,可以编辑文本区域中的参数文件,以列出要捕获的表详细信息。例如:
      table source.table1;

      注意:

      GoldenGate 默认使用格林威治标准时间 (GMT)。使用 SETENV 覆盖 Extract 的默认设置。此更改仅适用于 Extract 进程,不适用于部署。
      setenv (TZ="US/Eastern")
      setenv (TZ="GMT+5")
  4. 单击创建并运行可启动 Extract。如果单击“创建”,以后可以从 Extracts 页面手动启动 Extract
您可以返回到 Extracts 页面,在其中可以选择 Extract 进程以查看其详细信息。

添加提取 (21 c )

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

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

    注意:

    通过添加配置文件并配置“自动启动”和“自动重新启动”选项,部署可以在网络中断后自动重新启动。有关更多信息,请参见配置托管进程
  6. 单击下一步
  7. 在“提取参数”页上,可以编辑文本区域中的参数文件,以列出要捕获的表详细信息。例如:
    table source.table1;

    注意:

    GoldenGate 默认使用格林威治标准时间 (GMT)。使用 SETENV 覆盖提取的默认设置。此更改仅适用于提取流程,不适用于部署。
    setenv (TZ="US/Eastern")
    setenv (TZ="GMT+5")

    了解有关 SETENV 的详细信息。

  8. 选择在后台注册提取可在后台异步注册提取。
  9. 单击创建并运行以创建并启动提取。如果单击创建,则以后可以从“管理服务概览”页手动启动提取。
您将返回到“管理服务概览”页面,您可以在其中查看提取处理的状态。从“提取操作”菜单中选择详细信息以查看流程信息、检查点、统计信息、参数和报表。

了解更多信息

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

已知问题

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

在为使用全局事务处理标识符 (GTID) 的 MySQL 数据库启用了“远程”选项的情况下创建“更改数据捕获提取”处理时,提取处理将失败,并报告以下错误:
ERROR   OGG-25192  Trail file '<trail name>' is remote. Only local trail allowed for this extract.

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

有关更多信息,请参见 Using Oracle GoldenGate for MySQL