前提条件和设置

如需完成谱系使用情形教程，请执行以下设置步骤：

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 role (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

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 role (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

1. Enable the BigQuery, Data lineage , Dataform, BigQuery Data Transfer, and Secret Manager APIs.

   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 APIs

   For new projects, the BigQuery API is automatically enabled.

所需的角色

如需获得执行谱系使用情形教程所需的权限，请让您的管理员为您授予项目的以下 IAM 角色：

• Data Lineage Viewer (roles/datalineage.viewer)：在记录和查看沿袭的项目中。
• BigQuery Data Viewer (roles/bigquery.dataViewer)：针对表的存储项目。
• BigQuery Resource Viewer (roles/bigquery.resourceViewer)：在作业的计算项目上。
• Dataplex Catalog Viewer (roles/dataplex.catalogViewer)：针对存储目录条目的项目。
• Dataform Editor (roles/dataform.editor)：在工作区和代码库所在的项目中。

下表介绍了与所需角色关联的项目类型和服务：

• 存储项目用于存储 BigQuery 数据集和表。
• 计算项目处理您的数据并存储沿袭元数据。它用于运行 BigQuery 作业和数据转换。
• 目录条目包含描述表的元数据，可让您在不访问底层数据的情况下查找和整理表。
• 沿袭项目会记录并直观呈现数据及其转换的历史记录。
• Dataform 是一种用于构建、版本控制和运行基于 SQL 的数据流水线的服务。它将原始数据转换为整洁有序且有文档记录的数据集。

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。您也可以通过自定义角色或其他预定义角色来获取所需的权限。

开始使用

如需完成教程，请使用数据沿袭使用场景代码库。此代码库包含用于设置数据集和运行数据转换的预定义代码。

数据集概览

每个教程都使用不同的真实世界数据集（例如医疗服务提供方、就业或商家数据）来演示真实场景中的数据沿袭。

设置数据集

如需通过数据沿袭跟踪数据更改，请执行以下一次性设置：

1. 创建个人访问令牌并将其存储在 Secret Manager 中。
2. 将代码库关联到 Dataform。

设置完成后，运行数据转换以处理数据并生成谱系。