使用 Datastream 近乎实时地流式传输数据更改

准备工作

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Enable the Datastream API.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the API

2. 确保您已将 Datastream Admin 角色分配给您的用户账号。

   转到 IAM 页面

如果您想为标准或共享 VPC 网络创建专用连接配置，则需要完成其他前提条件。如需了解详情，请参阅创建专用连接配置。

要求

Datastream 提供各种来源选项、目标选项和网络连接方法。

在本快速入门中，我们假设您使用的是独立的 Oracle 数据库和目标 Cloud Storage 服务。对于源数据库，您应该能够将网络配置为添加入站防火墙规则。源数据库可以位于本地，也可以位于云提供商。由于目标位置是 Cloud Storage，因此它应该位于 Google 的云提供商中。

由于我们无法获知您环境的具体细节，因此我们无法提供网络配置的详细步骤。

对于此快速入门，您将选择 IP 许可名单作为连接方法。IP 许可名单是一项安全功能，通常用于仅限受信任的用户访问您的源数据库中的数据并对这些访问进行控制。您可以使用 IP 许可名单创建受信任的 IP 地址或 IP 地址范围列表，您的用户和其他 Cloud 服务（如 Datastream）可通过这些地址访问此数据。要使用 IP 许可名单，您必须向来自 Datastream 的传入连接开放源数据库或防火墙。

创建连接配置文件

通过为源数据库和目标位置创建连接配置文件，您可以创建包含来源和目标位置相关信息的记录。

在本快速入门中，选择 Oracle 作为来源连接配置文件的类型，选择 Cloud Storage 作为目标连接配置文件的类型。Dataflow 使用连接配置文件中的信息将源 Oracle 数据库中的数据迁移到 Cloud Storage 中的目标存储桶。

为 Oracle 数据库创建来源连接配置文件

1. 前往 Google Cloud 控制台中 Datastream 的连接配置文件页面。

   转到“连接配置文件”页面

2. 点击创建配置文件。

3. 在创建连接配置文件页面中，点击 Oracle 配置文件类型（因为您希望为 Oracle 数据库创建来源连接配置文件）。

4. 在创建 Oracle 配置文件页面的定义连接设置部分中提供以下信息：

   • 输入 My Source Connection Profile 作为源数据库的连接配置文件名称。
   • 保留自动生成的连接配置文件 ID。

   • 选择用于存储连接配置文件的地区。

     与所有资源一样，连接配置文件也保存在地区中，并且数据流只能使用与该数据流存储在同一地区的连接配置文件。地区选择不会影响 Datastream 是否可连接到来源或目标位置，但如果该地区发生停机，则可能会影响可用性。

   • 输入连接详情：

     • 在主机名或 IP 字段中，输入 Datastream 可用于连接到源 Oracle 数据库的主机名或公共 IP 地址。您将提供公共 IP 地址，因为 IP 许可名单将用作本快速入门的网络连接方法。
     • 在端口字段中，输入为源数据库预留的端口号。对于 Oracle 数据库，默认端口通常为 1521。
     • 输入用户名和密码，对源数据库进行身份验证。
     • 在系统标识符 (SID) 字段中，输入标识数据库实例的 SID 或服务名称。对于 Oracle 数据库，这通常为 ORCL。

5. 在定义连接设置部分中，点击继续。创建 Oracle 配置文件页面的定义连接方法部分处于活动状态。

6. 选择您要在 Datastream 与源数据库之间建立连接时使用的网络方法。在本快速入门中，使用连接方法下拉菜单选择 IP 许可名单作为网络方法。

7. 配置源数据库以允许来自显示的 Datastream 公共 IP 地址的传入连接。

8. 在定义连接方法部分中，点击继续。创建 Oracle 配置文件页面的测试连接配置文件部分处于活动状态。

9. 点击运行测试，验证源 Oracle 数据库和 Datastream 是否可以相互通信。

10. 验证是否显示“已通过测试”状态。

11. 如果测试失败，您可以在流程的适当部分解决问题，然后返回重新测试。如需查看问题排查步骤，请参阅诊断问题页面。

12. 点击创建。

为 Cloud Storage 创建目标连接配置文件

1. 前往 Google Cloud 控制台中 Datastream 的连接配置文件页面。

   转到“连接配置文件”页面

2. 点击创建配置文件。

3. 在创建连接配置文件页面中，点击 Cloud Storage 配置文件类型（因为您希望为 Cloud Storage 创建目标连接配置文件）。

4. 在创建 Cloud Storage 配置文件页面中提供以下信息：

   • 输入 My Destination Connection Profile 作为目标 Cloud Storage 服务的连接配置文件名称。
   • 保留自动生成的连接配置文件 ID。
   • 选择用于存储连接配置文件的地区。
   • 在连接详情窗格中，点击浏览。

   • 在选择存储桶窗格中，选择 Datastream 要将源数据库中的数据转移到的目标 Cloud Storage 存储桶，然后点击选择。

     您的存储桶会显示在创建 Cloud Storage 配置文件页面的存储桶名称字段中。

     注意：如果您没有看到想要选择的存储桶，可以创建一个。

   • （可选）在连接配置文件路径前缀字段中，您可以提供一个在 Datastream 将数据转移到目标位置时要追加到存储桶名称中的路径的前缀。

     注意：您在此字段中输入的任何路径都必须以斜杠 (/) 开头。

5. 点击创建。

为 Oracle 数据库创建来源连接配置文件，并为 Cloud Storage 创建目标连接配置文件后，您可以使用它们来创建数据流。

创建数据流

在本部分中，您将创建一个数据流。Datastream 使用此数据流将数据从源 Oracle 数据库转移到 Cloud Storage 中的目标存储桶。

创建数据流涉及到：

• 定义数据流的设置。
• 选择您为源数据库创建的连接配置文件（来源连接配置文件）。在本快速入门中，我们使用的是我的来源连接配置文件。
• 通过在源数据库中指定 Datastream 对其执行以下操作的表和架构，配置数据流的源数据库的相关信息：
  • 可以转移到目标位置。
  • 无法转移到目标位置。
• 确定 Datastream 是回填历史数据并将进行中的更改流式传输到目标位置，还是仅流式传输对数据的更改。
• 选择您为 Cloud Storage 创建的连接配置文件（目标连接配置文件）。在本快速入门中，我们使用的是我的目标连接配置文件。
• 配置有关数据流的目标存储桶的信息。此类信息包括：
  • DataStream 将架构、表和数据从源 Oracle 数据库转移到的目标存储桶的文件夹。
  • 写入 Cloud Storage 的文件的输出格式。Datastream 支持两种输出格式：Avro 和 JSON。在本快速入门中，使用 Avro 文件格式。

Dataflow 配备了向导，可帮助您创建数据流。此向导包含六个面板：使用入门、定义和测试来源、配置来源、定义目标位置、配置目标位置以及审核并创建。本页面的各个部分介绍了如何填充每个面板。

定义数据流的设置

1. 前往 Google Cloud 控制台中的 Datastream 数据流页面。

   转到“数据流”页面

2. 点击创建信息流。

3. 在创建数据流页面的定义数据流详情面板中提供以下信息：

   • 输入 My Stream 作为数据流名称。
   • 保留自动生成的数据流 ID。
   • 从地区菜单中，选择您创建来源连接配置文件的地区。
   • 从来源类型菜单中，选择 Oracle 配置文件类型。
   • 从目标类型菜单中，选择 Cloud Storage 配置文件类型。

4. 查看自动生成的必要前提条件，以反映如何为数据流准备您的环境。这些前提条件可能包括如何配置源数据库，以及如何将 Datastream 连接到 Cloud Storage 中的目标存储桶。

   如需详细了解这些前提条件，请参阅配置源 Oracle 数据库。

5. 点击继续。系统会显示创建数据流页面的定义 Oracle 连接配置文件面板。

指定有关来源连接配置文件的信息

1. 从来源连接配置文件菜单中，选择 Oracle 数据库的来源连接配置文件。

2. 点击运行测试，验证源数据库和 DataStream 是否可以相互通信。

   如果测试失败，会显示与连接配置文件关联的问题。如需查看问题排查步骤，请参阅诊断问题页面。进行必要的更改以纠正问题，然后重新测试。

3. 点击继续。系统会显示创建数据流页面的配置数据流来源面板。

配置有关数据流的源数据库的信息

1. 使用要包含的对象菜单指定源数据库中 Datastream 可转移到 Cloud Storage 目标存储桶中的文件夹的表和架构。仅当数据库中的对象不超过 5,000 个时，系统才会加载菜单。

   在本快速入门中，您希望 Datastream 转移所有表和架构。因此，请从菜单中选择所有架构中的所有表。

   在本快速入门中，请确保将选择要排除的对象面板设置为“无”。您不希望限制 Dataflow 将源数据库中的任何表和架构转移到 Cloud Storage 的操作。

   此外，请确保为历史数据选择回填模式面板设置为“自动”。除了数据更改外，DataStream 还会将所有现有数据从来源流式传输到目标位置。

2. 指定 CDC 方法。在本教程中，请选择 Logminer。

3. 点击继续。系统显示创建数据流页面的定义 Cloud Storage 连接配置文件面板。

选择目标连接配置文件

1. 从目标连接配置文件菜单中，选择 Cloud Storage 的目标连接配置文件。

2. 点击继续。系统会显示创建数据流页面的配置数据流目标位置面板。

配置有关数据流的目标位置的信息

1. 在数据流路径前缀字段中，输入 Datastream 将架构、表和数据从源 Oracle 数据库转移到的目标存储桶的文件夹。

   在本快速入门中，您希望 Datastream 将数据从源数据库转移到 Cloud Storage 目标存储桶中的 /root/tutorial 文件夹。因此，请在数据流路径前缀字段中输入 /root/tutorial。

2. 在输出格式字段中，选择写入 Cloud Storage 的文件的格式。在本快速入门中，使用 Avro 文件格式。

3. 点击继续。系统会显示创建数据流页面的审核数据流详情并创建面板。

创建数据流

1. 验证数据流的详细信息，以及数据流用于将数据从源 Cloud 数据库转移到 Cloud Storage 中目标存储桶的来源和目标连接配置文件。

2. 点击运行验证来验证数据流。通过验证数据流，Datastream 会检查来源是否配置正确，验证数据流是否可以连接到来源和目标位置，并验证数据流的端到端配置。

   如果验证检查通过，则验证检查的左侧会显示一个对勾标记图标。

   如果验证检查未通过，则检查的左侧会显示一个英文感叹号图标，并且检查下方会显示查看错误详情按钮。点击该按钮后，系统会显示一条消息，其中说明了检查未通过的原因以及如何纠正问题。进行适当的更正后，请点击重新验证。

   如需详细了解如何排查未通过的验证检查，请参阅诊断问题。

3. 所有验证检查都通过后，点击创建。

4. 在创建数据流？对话框中，点击创建。

创建数据流后，您可以启动它。

启动数据流

在本快速入门的上一部分中，您创建了一个数据流，但并未启动它。您现在可以进行启动。

在本快速入门中，您将分别创建和启动数据流，以防数据流创建过程造成源数据库负载增加。如需消除该负载，您需要创建数据流但不启动它，然后在可产生负载时启动数据流。

通过启动数据流，Datastream 可以将数据、架构和表从源数据库转移到目标位置。

1. 前往 Google Cloud 控制台中的 Datastream 数据流页面。

   转到“数据流”页面

2. 选择要启动的数据流左侧的复选框。在本快速入门中，这是我的数据流。

3. 点击开始 (START)。

4. 在对话框中，点击开始。数据流的状态从 Not started 更改为 Starting，再更改为 Running。

   数据流大约需要 30 秒才能开始运行。需要启动后台资源，然后才能启动数据流。

启动数据流后，您可以验证 Dataflow 是否将数据从源数据库转移到目标位置。

验证数据流

在本部分中，您将确认 Dataflow 将数据从源 Oracle 数据库的所有表转移到 Cloud Storage 目标存储桶的 /root/tutorial 文件夹中。

1. 前往 Google Cloud 控制台中的 Datastream 数据流页面。

   转到“数据流”页面

2. 点击您创建的数据流。在本快速入门中，这是我的数据流。

3. 在数据流详情页面中，点击目标写入路径字段下方显示的链接。Cloud Storage 的存储桶详情页面会在单独的标签页中打开。

   注意：点击的链接由存储桶的名称以及 Datastream 将架构、表和数据从源 Oracle 数据库转移到的存储桶的文件夹组成。在配置数据流的目标连接配置文件的相关信息时，您将此文件夹指定为 /root/tutorial。因此，链接应显示为 [bucket-name]/root/tutorial。

4. 验证您是否看到表示源 Oracle 数据库的表的文件夹。

5. 点击其中一个表文件夹并展开细目，直到您看到与该表关联的数据。

   第一个文件夹是 [schema]_[table]，后跟文件夹表示 Datastream 将数据从源 Oracle 数据库转移到 Cloud Storage 中的目标存储桶的具体时间（年、月、日、小时和分钟）。

   每分钟创建一个文件夹（当要写入新数据时）。

   当文件大小达到 250 MB 或架构发生更改时，系统将创建一个新文件。如果表已分区，则系统会为每个分区创建文件。

清理

为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用，请按照以下步骤操作。

1. 使用 Google Cloud 控制台 删除您的项目、Datastream 数据流和连接配置文件以及 Cloud Storage 目标存储桶。

清理您在 Datastream 上创建的资源后，这些资源不会占用配额，日后也不会产生费用。以下部分介绍如何删除或关闭这些资源。

删除项目

若要避免产生费用，最简单的方法是删除您为本快速入门创建的项目。

删除项目会产生以下影响：

• 项目中的所有内容都会被删除。如果您将现有项目用于本快速入门，则在删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。 创建此项目时，您可能创建了要在将来使用的自定义项目 ID。如需保留使用该项目 ID 的网址（例如 appspot.com），请删除项目内的所选资源，而不是删除整个项目。

如果您打算浏览多个教程和快速入门，重复使用项目可以帮助您避免超出项目配额上限。

1. 在 Google Cloud 控制台中，前往管理资源页面。

   转到“管理资源”页面

2. 在项目列表中，选择要删除的项目，然后点击删除。

3. 在对话框中输入项目 ID，然后点击关停以删除项目。

删除数据流

1. 前往 Google Cloud 控制台中的 Datastream 数据流页面。

   转到“数据流”页面

2. 点击要删除的数据流。在本快速入门中，这是我的数据流。

3. 点击暂停。

4. 在对话框中，点击暂停。

5. 在数据流详情页面的数据流状态窗格中，验证数据流的状态是否为 Paused。

   注意：在删除数据流之前，请先暂停该数据流，以确保所有“运行中”数据从源数据库正常转移到目标位置。

6. 点击删除。

7. 在对话框中，在文本字段中输入 Delete，然后点击删除。

删除连接配置文件

1. 前往 Google Cloud 控制台中 Datastream 的连接配置文件页面。

   转到“连接配置文件”页面

2. 选中您要删除的每个连接配置文件对应的复选框。在本快速入门中，选中我的来源连接配置文件和我的目标连接配置文件对应的复选框。

3. 点击删除。

4. 在该对话框中，点击 DELETE。

删除您的 Cloud Storage 目标存储桶

1. 前往 Google Cloud 控制台中 Cloud Storage 的浏览器页面。

   转到“浏览器”页面

2. 选中存储桶左侧的复选框，然后点击删除。

3. 在对话框中，在文本字段中输入 DELETE，然后点击删除。

后续步骤

• 详细了解 Datastream。
• 自行试用其他 Google Cloud 功能。查阅我们的快速入门。