创建数据网域

本文档介绍了如何使用Google Cloud 控制台和 REST API 创建数据网域和子网域,以及如何向与网域及其资源互动的用户授予 Identity and Access Management 角色和权限。

准备工作

在创建数据网域和分配网域所有者之前,请确保您拥有所需的角色并已启用所需的 API。

  • 网域和子网域的嵌套深度上限为 5 级。
  • 您可以在单个数据网域下创建最多 50 个直接子网域。
  • 在每个区域中,一个项目最多可以包含 1,000 个网域。

启用 API

启用 Dataplex API。

启用 API 所需的角色

如需启用 API,您需要拥有 serviceusage.services.enable 权限。如果您创建了项目,则可能已经通过 Owner 角色 (roles/owner) 获得了此权限。否则,您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色

启用 API

所需的角色

如需获得创建数据网域和分配网域所有者所需的权限,请让管理员向您授予项目的以下 IAM 角色:

如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

创建数据网域

创建数据域,以作为项目和位置内数据资产和产品的逻辑分组。

控制台

  1. 在 Google Cloud 控制台中,前往数据网域页面。

    前往“数据网域”

  2. 点击创建数据域,然后提供以下信息:

    • 显示名称字段中,为网域提供一个易记的名称。例如 Finance
    • 数据网域 ID 字段中,提供网域的唯一 ID。系统创建网域后,您无法更改此值。
    • 位置字段中,选择要在其中创建数据网域的区域。
    • 项目 ID 字段中,选择您要在其中创建数据网域的项目。
    • 可选:在说明字段中,提供网域的简短说明。
    • 所有者字段中,添加网域的所有者。您可以同时输入多个电子邮件地址。
  3. 可选:在标签字段中,输入标签以将相关对象组合在一起或者与其他 Google Cloud 资源组合在一起。

  4. 点击创建。您可能需要等待几分钟才能访问或搜索数据域。

REST

如需创建数据网域,请使用 projects.locations.dataDomains.create 方法。

在使用任何请求数据之前,请先进行以下替换:

  • PROJECT_ID:您的 Google Cloud 项目的 ID。
  • LOCATION_ID:要在其中创建数据网域的区域。例如 us-central1
  • DATA_DOMAIN_ID:数据网域的唯一标识符。

HTTP 方法和网址:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?data_domain_id=DATA_DOMAIN_ID

请求 JSON 正文:

{
  "display_name": "Finance Domain",
  "description": "Domain for finance datasets and reports.",
  "contacts": {
    "identities": [
      {
        "contact_name": "Alice Wonderland",
        "contact_role": "owner",
        "contact_id": "alice@example.com"
      }
    ]
  }
}

如需发送您的请求,请展开以下选项之一:

您应该会收到一个成功的状态代码 (2xx) 和一个空响应。

创建数据子网域

创建子网域以扩展数据网域层次结构。

控制台

  1. 在 Google Cloud 控制台中,前往数据网域页面。

    前往“数据网域”

  2. 选择要为其创建子网域的网域。

  3. 点击 Create Data Subdomain,然后提供以下信息:

    • 显示名称字段中,为网域提供一个易记的名称。例如 Finance
    • 数据网域 ID 字段中,提供网域的唯一 ID。系统创建网域后,您无法更改此值。
    • 可选:在说明字段中,提供网域的简短说明。
    • 所有者字段中,添加网域所有者的电子邮件地址。您可以同时输入多个电子邮件地址。
  4. 可选:在标签字段中,输入标签以将相关对象组合在一起或者与其他 Google Cloud 资源组合在一起。

  5. 点击创建。您可能需要等待几分钟才能访问或搜索数据子网域。

REST

如需创建数据子网域,请使用 projects.locations.dataDomains.create 方法并在请求正文中指定 parent_data_domain

在使用任何请求数据之前,请先进行以下替换:

  • PROJECT_ID:您的 Google Cloud 项目的 ID。
  • LOCATION_ID:父数据网域所在的区域。例如 us-central1
  • SUBDOMAIN_ID:数据子网域的唯一标识符。
  • PARENT_DATA_DOMAIN_ID:创建相应子网域时所依据的父数据网域的唯一 ID。

HTTP 方法和网址:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?data_domain_id=SUBDOMAIN_ID

请求 JSON 正文:

{
  "display_name": "Finance Subdomain",
  "description": "A subdomain within the Finance domain.",
  "contacts": {
    "identities": [
      {
        "contact_name": "Alice Wonderland",
        "contact_role": "owner",
        "contact_id": "alice@example.com"
      }
    ]
  },
  "parent_data_domain": "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DATA_DOMAIN_ID"
}

如需发送您的请求,请展开以下选项之一: