为 Azure 数据湖存储添加复制

了解如何为 Azure 数据湖存储目标添加复制。

相关主题

Azure Blob 存储目标详细信息

添加副本 (23ai)

开始之前

确保查看特定于此目标类型的先决条件。

要在 GoldenGate 23ai 中添加复制，请执行以下操作：

在 OCI GoldenGate 部署控制台的管理服务主页上，单击添加复制（加号图标）。
在“添加复制”面板的复制信息页上，根据需要填写字段，然后单击下一步：
- 选择复制类型：
  - 经典复制
  - 协调的复制
- 输入进程名称，长度不超过 5 个字符。
- 输入说明，以帮助区分此流程与其他流程。
在复制选项页上，根据需要填写字段，然后单击下一步：
- 复制线索：
  - 输入名称。
  - 如果希望跟踪文件位于非默认位置，请输入子目录。
  - 选择加密配置文件。如果未创建加密概要信息，则默认情况下会选择本地 Wallet。
  - 对于开始，选择数据处理的起点：
    - 日志中的位置（默认）
    - Now
    - 定制时间
- 线索位置：
  - 输入序号。
  - 输入 RBA 偏移。
  - 从下拉列表中选择目标。
    
    注意：
    根据您的目标选择，您可能有其他选项，例如流处理、暂存和合并以及暂存位置。
- 目标身份证明：
  - 选择域。
  - 选择指定域中的别名。
  - 选择检查点表。保留默认选择，或选择为目标部署创建的检查点表。
  - 选择最大线程数（仅限协调的复制）。
在托管选项页上，根据需要填写可选字段，然后单击下一步：
- 选择概要文件名称（如果有）。
- 启用对部署健康状况至关重要。
- 启用和配置自动启动设置。
在参数文件页上，可以添加参数以进一步配置复制。例如：
```
table source.table1;
```
如果使用协调的 Replicat ，请将 TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/your_replicat_name.properties 添加到参数文件中。
注意：

GoldenGate 默认使用格林威治标准时间 (GMT)。使用 SETENV 覆盖此复制进程的默认设置。此更改不适用于部署。例如：
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
在“属性文件”页上，配置以下 Azure 数据湖存储属性：
必需属性：
- 对于 gg.eventhandler.abs.bucketMappingTemplate：提供 Azure Data Lake Storage 容器名称。如果容器已预先配置，则可以提供静态容器名称。如果提供了 Azure 验证方法权限，则 OCI GoldenGate 可以使用模板关键字自动创建容器。
（可选）您可以考虑添加的其他属性：
- （可选）gg.handler.abs.format：选择如何设置输出的格式。JSON 是默认设置。可用的选项包括：
  - 分隔文本
  - json
  - json_row
  - xml
  - avro_row_ocf
  - avro_op_ocf
  对于 parquet，必须应用其他属性。有关详细信息，请参见 Parquet for Azure Data Lake Storage。
有关此目标属性的信息，请参阅 Oracle GoldenGate for Distributed Applications and Analytics 指南中的 Azure Blob Storage 。
单击创建并运行。如果单击创建，则可以稍后从管理服务主页手动启动复制。

添加复制 (21 c )

要在 Oracle GoldenGate 21 c 中为 Azure Data Lake Storage 目标添加复制：

在 OCI GoldenGate 部署控制台的“管理服务概览”页上，单击添加复制（加号图标）。
在“添加复制”页上，选择复制类型，然后单击下一步。
副本的类型包括：
- 经典复制
- 协调的复制
在“复制选项”页上，填写以下字段，然后单击下一步：
1. 对于进程名称，输入复制进程的名称。
2. （可选）对于说明，输入简要说明以将此副本与其他副本区分开来。
3. 对于线索名称，输入两个字符的线索名称。
4. 对于目标，从下拉列表中选择 Azure 数据湖存储。
5. 对于别名，选择 Azure 数据湖存储连接。
在“参数文件”页上，根据需要添加和配置复制参数，然后单击下一步。
注意：
- 如果使用协调复制，请在参数文件的第二行添加以下参数：
```
TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/<replicat
      name>.properties
```
  使用协调复制将创建多个文件。
  
  如果省略，您将遇到以下错误：
```
OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file
      "/u02/Deployment/etc/conf/ogg/<replicat name>001.properties" (error 2, No such file or
      directory).
```
- GoldenGate 默认使用格林威治标准时间 (GMT)。使用 SETENV 覆盖默认设置。例如：
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
  了解有关 SETENV 的详细信息。
在“属性文件”页上，配置以下 Azure 数据湖存储属性：
必需属性：
- 对于 gg.eventhandler.abs.bucketMappingTemplate：提供 Azure Data Lake Storage 容器名称。如果容器已预先配置，则可以提供静态容器名称。如果提供了 Azure 验证方法权限，则 OCI GoldenGate 可以使用模板关键字自动创建容器。
（可选）您可以考虑添加的其他属性：
- gg.handler.abs.format：选择如何设置输出的格式。JSON 是默认设置。可用的选项包括：
  - 分隔文本
  - json
  - json_row
  - xml
  - avro_row_ocf
  - avro_op_ocf
  对于 parquet，必须应用其他属性。有关详细信息，请参见 Parquet for Azure Data Lake Storage。
单击创建并运行。如果单击创建，则以后可以从“管理服务概览”页手动启动复制。

您可以返回到“管理服务概览”页，在该页中可以查看复制进程的创建并访问复制操作。

标题和版权信息

Oracle 和/或其关联公司。