将数据从自治 AI 事务处理复制到 Oracle 对象存储

此快速入门示例演示如何使用 OCI GoldenGate 将数据从 Autonomous AI Transaction Processing 复制到 Oracle Object Storage。

此快速入门也作为 LiveLab 研讨会提供。查看研讨会

开始之前

要成功完成此快速入门，您必须具有：

从 Oracle Cloud 控制台用户详细信息页创建和下载的 API 密钥
源 Autonomous AI Transaction Processing 实例
您的区间 OCID

环境设置：自治 AI 事务处理

如果您尚未为复制设置源数据库，则可以按照以下步骤加载要用于此快速入门的示例方案。此快速入门将自治 AI 事务处理用于源数据库。

要设置源 Autonomous AI Transaction Processing，请执行以下操作：

下载并解压缩示例数据库方案。
在 Oracle Cloud 控制台中，从“Autonomous AI Database（自治 AI 数据库）”页面中选择您的自治 AI 事务处理 (ATP) 实例，以查看其详细信息并访问 Database Actions。
解锁 GGADMIN 用户：
1. 选择数据库操作，然后选择数据库用户。
2. 找到 GGADMIN，然后选择其省略号菜单（三个点），然后选择编辑。
3. 在 "Edit User"（编辑用户）面板中，输入 GGADMIN 密码，确认密码，然后取消选择 Account is Locked 。
4. 选择 Apply Changes（应用更改）。
加载源示例方案和数据：
1. 从“数据库操作”菜单的“开发”下，选择 SQL 。
2. 将脚本从 OCIGGLL_OCIGGS_SETUP_USERS_ATP.sql 复制并粘贴到 SQL 工作表中。
3. 选择运行脚本。“Script Output（脚本输出）”选项卡显示确认消息。
4. 清除 SQL 工作表，然后从 OCIGGLL_OCIGGS_SRC_USER_SEED_DATA.sql. 复制并粘贴 SQL 脚本
  
  提示：您可能需要单独运行每个语句，SQL 工具才能成功执行脚本。
5. 要验证表是否已成功创建，请关闭 SQL 窗口，然后重新打开它。在“Navigator（导航器）”选项卡中，查找 SRC_OCIGGLL 方案，然后从其各自的下拉列表中选择表。
启用补充事件记录：
1. 清除 SQL 工作表。
2. 输入以下语句，然后选择运行语句：
```
ALTER PLUGGABLE DATABASE ADD SUPPLEMENTAL LOG DATA;
```

任务 1：创建 OCI GoldenGate 资源

此快速入门示例需要源和目标的部署和连接。

为源自治 AI 事务处理实例创建 Oracle 部署。
为目标 Oracle 对象存储桶创建大数据部署。
为源自治 AI 事务处理实例创建连接。
为目标 Oracle 对象存储创建连接。
创建与 GoldenGate 的连接，然后将此连接分配给源 Oracle 部署。
将自治 AI 事务处理连接分配给源 Oracle 部署。
将 Oracle 对象存储连接分配给目标大数据部署。

任务 2：添加提取

在“Deployments（部署）”页面上，选择源 Autonomous AI Transaction Processing 部署。
在部署详细信息页上，选择启动控制台。
使用源部署的管理员用户名和密码登录。
添加提取。

任务 3：添加并运行分发路径

如果使用 GoldenGate 身份证明存储，请在目标大数据部署中为分发路径创建用户，否则跳至步骤 3。
在 source GoldenGate 部署控制台中，为在步骤 1 中创建的用户添加路径连接。
1. 在源 GoldenGate 部署控制台中，在左侧导航中选择 Path Connections（路径连接）。
2. 选择添加路径连接（加号图标），然后完成以下操作：
  1. 对于身份证明别名，输入 GGSNetwork。
  2. 对于用户 ID ，输入在步骤 1 中创建的用户的名称。
  3. 输入用户的密码两次以进行验证。
3. 选择提交。
  
  路径连接将显示在“路径连接”列表中。
在 source 部署控制台中， add a Distribution Path with the following values：
1. 在源选项页上：
  - 对于源提取，选择在任务 2 中创建的提取。
  - 对于线索名称，输入两个字符的名称，例如 E1。
2. 在目标选项页上：
  - 对于目标主机，输入目标部署的主机域。
  - 在端口号中，输入 443。
  - 对于线索名称，输入两个字符的名称，例如 E1。
  - 对于别名，输入在步骤 2 中创建的身份证明别名。
在 target 大数据部署控制台中，查看作为分发路径结果创建的接收器路径。
1. 在目标大数据部署控制台中，选择接收方服务。
2. 查看路径详细信息。此路径是在上一步中创建的分发路径的结果创建的。

任务 4：添加并运行复制

在目标“大数据”部署控制台导航菜单中，选择复制。
在 "Replicats"（复制）页面上，选择 Add Replicat（添加复制）（加号图标），然后按如下方式填写表单：
1. 在“复制信息”页上：
  1. 对于 Replicat Type（复制类型），选择 Classic Replicat 。
  2. 对于进程名称，输入名称，例如 REP
2. 在“复制选项”页面上：
  1. 对于 Replicat Trail Name（复制线索名称），输入两个字符的名称，例如 E1。
  2. 对于“目标”，选择 Oracle 对象存储
3. 在“参数文件”页上，将 MAP *.*, TARGET *.*; 替换为：
```
MAP SRC_OCIGGLL.*, TARGET *.*;
```
4. 在“Properties File（属性文件）”页上，根据需要配置 OCI Event Handler 属性。
  
  必需的属性：
  - gg.eventhandler.oci.compartmentID：Oracle 对象存储存储桶所在的区间 OCID。
  - gg.handler.oci.fileNameMappingTemplate：使用模板关键字动态生成文件名。
  您可以考虑修改的属性包括：
  - gg.handler.oci.format：选择如何设置输出的格式。json_row 是默认设置。可用的选项包括：
    - 分隔文本
    - json
    - json_ 行
    - xml
    - avro_row_ocf
    - avro_op_ocf
      
      提示：要将 formatting 属性用于 Oracle 对象存储，请将 name 替换为 oci。例如，gg.handler.name.format 变为 gg.handler.oci.format。
  - gg.handler.oci.inactivityRollInterval：GoldenGate 创建文件并使其保持打开状态以进行写入。此属性在指定的不活动期间（无传入事务处理）后关闭文件，然后将其加载到 Oracle 对象存储中。缺省情况下，设置为 5 秒。可以指定以毫秒 (ms)、秒 (s)、分钟 (m) 或小时 (h) 为单位的时间。例如，gg.handler.oci.inactivityRollInterval=10m。
  - gg.handler.oci.maxFileSize：文件写入器处理程序将打开文件并使其保持打开状态，直到达到最大文件大小（假定没有元数据更改）。默认情况下，最大文件大小为 1 GB，但您可以使用此属性进行更改。当达到大小时，将关闭文件，并生成新文件。例如，gg.handler.oci.maxFileSize=500m。
  - gg.handler.oci.rollOnShutdown：默认值为“真”。设置为 true 时，GoldenGate 将在停止复制进程时关闭打开的文件。缺省情况下，即使复制停止，文件写入器处理程序也会保持文件的打开状态，并在复制重新启动时继续写入同一文件。例如，gg.handler.oci.rollOnShutdown=false
  - gg.handler.oci.fileRollInterval：指定在文件关闭并滚动到新文件之前保持文件打开的时间量。默认情况下，它设置为 7 分钟。可以指定以毫秒 (ms)、秒 (s)、分钟 (m) 或小时 (h) 为单位的时间。例如，gg.handler.oci.fileRollInterval=10m。
  - gg.eventhandler.oci.bucketMappingTemplate：输入 Oracle 对象存储存储桶名称。
5. 选择创建并运行。

任务 5：验证复制

对源自治 AI 事务处理实例执行一些更新以验证复制到 Oracle 对象存储。

在 Oracle Cloud 控制台中，打开导航菜单，选择 Oracle AI Database ，然后选择 Autonomous AI Transaction Processing 。
在自治 AI 事务处理实例列表中，选择源实例以查看其详细信息。
在“数据库详细信息”页上，选择数据库操作。

注：您应该自动登录。如果没有，则使用数据库身份证明登录。
在“数据库操作”主页上，选择 SQL 。

在工作表中输入以下内容，然后选择运行脚本。

Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1000,'Houston',20,743113);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1001,'Dallas',20,822416);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1002,'San Francisco',21,157574);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1003,'Los Angeles',21,743878);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1004,'San Diego',21,840689);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1005,'Chicago',23,616472);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1006,'Memphis',23,580075);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1007,'New York City',22,124434);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1008,'Boston',22,275581);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1009,'Washington D.C.',22,688002);

在源 ATP 部署控制台中，选择提取名称，然后选择统计信息。验证 SRC_OCIGGLL.SRC_CITY 是否具有 10 个插入。
在目标 Big Data OCI GoldenGate 部署控制台中，选择复制名称，然后选择统计信息。验证 SRC_OCIGGLL.SRC_CITY 是否具有 10 个插入。
在 Oracle Cloud 控制台中，导航到 Oracle 对象存储桶并检查其内容。

任务 6：监控和维护流程

了解更多信息

单击此处的链接，可以了解有关配置详细信息和支持的文件格式的更多信息。