Data Catalog 区域

Data Catalog 资源托管在全球多个位置,这些位置被称为区域。区域是指您可以在其中访问资源的特定地理位置。如需了解详情,请参阅地理位置和区域

为减少网络延迟,我们建议您使用靠近您的使用位置的区域 API 端点。例如,如果您计划从亚洲访问 Data Catalog,则可以使用台湾的端点。

支持的区域

区域 区域端点 支持的资源
美洲
蒙特利尔 northamerica-northeast1-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
圣保罗 southamerica-east1-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
爱荷华 us-central1-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
塔尔萨 us-central2-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
南卡罗来纳州 us-east1-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
北弗吉尼亚 us-east4-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
俄勒冈 us-west1-datacatalog.googleapis.com TagTemplates、用户创建的条目
洛杉矶 us-west2-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
盐湖城 us-west3-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
拉斯维加斯 us-west4-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
欧洲
芬兰 europe-north1-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
比利时 europe-west1-datacatalog.googleapis.com TagTemplates、用户创建的条目
伦敦 europe-west2-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
法兰克福 europe-west3-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
荷兰 europe-west4-datacatalog.googleapis.com TagTemplates、用户创建的条目
苏黎世 europe-west6-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
亚太地区
台湾 asia-east1-datacatalog.googleapis.com TagTemplate、BigQuery 用户创建的条目
香港 asia-east2-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
东京 asia-northeast1-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
大阪 asia-northeast2-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
首尔 asia-northeast3-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
孟买 asia-south1-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
新加坡 asia-southeast1-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
雅加达 asia-southeast2-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
悉尼 australia-southeast1-datacatalog.googleapis.com TagTemplate、BigQuery、用户创建的条目
多区域 多区域端点 支持的资源
全球 global-datacatalog.googleapis.com Pub/Sub、TagTemplates
亚洲 asia-datacatalog.googleapis.com BigQuery、TagTemplates、用户创建的条目
欧盟 eu-datacatalog.googleapis.com BigQuery、TagTemplates、用户创建的条目
美国 us-datacatalog.googleapis.com BigQuery、TagTemplates、用户创建的条目

多区域(us、eu、global)

global 是一个特殊的多区域,主要用于传送没有关联单个区域的资源,例如为 Cloud Pub/Sub 主题同步的元数据。在内部,Data Catalog 可以随时随地复制和传送全球资源。

同样,euus 等多区域也是特殊区域,Data Catalog 可以在这些区域内的任意位置复制和传送资源。

使用区域 API 访问资源

您可以使用区域端点来访问资源(在上文列出)。通过客户端库,您可以配置端点。

为了向后兼容,datacatalog.googleapis.com 端点仍支持区域 API,但存在一些限制(请参阅 HTTP 批处理和 gRPC)。我们强烈建议您为区域 API 使用区域端点。

非区域性 API

虽然数据资源位于特定区域,但 Data Catalog 的搜索功能是全球范围的。SearchCatalogLookupEntry 等非区域性 API 可返回来自所有地区的资源,并可通过 datacatalog.googleapis.com 端点访问。

HTTP 批处理支持

Data Catalog 支持 HTTP 批处理,允许您在单个请求中批量发送 API 调用。

将 HTTP 批处理用于区域 API 时存在一些限制:

  • HTTP 批处理请求只能包含属于同一区域的资源的 API 请求。
  • 在批处理区域 API 时,您必须使用区域端点。 datacatalog.googleapis.com 支持批处理区域 API。 区域请求和非区域性请求不能一起批量处理。
  • 非区域相关 API(SearchCatalog 和 LookupEntry)可使用 datacatalog.googleapis.com 端点进行批处理。

如果您不确定自己是否在使用 HTTP 批处理,请执行以下操作:

  • 检查您是否直接发出了路径设置为 /batch 的 HTTP 请求,例如 http://datacatalog.googleapis.com/batch
  • 如果您在使用 Google API 客户端库,请执行以下操作:

    • Java:使用 BatchRequest 调用 API。
    • Python:使用 BatchHTTP 请求调用 API。
    • 其他库也存在类似的绑定关系(请参阅库专用文档)。

gRPC 支持

建议您在将 gRPC 用于区域 API 时使用区域端点。

请注意,某些现有 Google Cloud 客户端库 在内部使用 gRPC。为了向后兼容,当使用来自这些库的 gRPC 时,datacatalog.googleapis.com 端点支持区域 API。