Data Catalog 区域

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

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

支持的区域

区域 区域端点 支持的资源
美洲
蒙特利尔 northamerica-northeast1-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
多伦多 northamerica-northeast2-datacatalog.googleapis.com 代码模板、用户创建的条目、数据谱系
圣保罗 southamerica-east1-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
圣地亚哥 southamerica-west1-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
爱荷华 us-central1-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
南卡罗来纳 us-east1-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
北弗吉尼亚 us-east4-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
哥伦布 us-east5-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
达拉斯 us-south1-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
俄勒冈 us-west1-datacatalog.googleapis.com 代码模板、用户创建的条目、数据谱系
洛杉矶 us-west2-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
盐湖城 us-west3-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
拉斯维加斯 us-west4-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
欧洲
华沙 europe-central2-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
芬兰 europe-north1-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
比利时 europe-west1-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
伦敦 europe-west2-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
法兰克福 europe-west3-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
荷兰 europe-west4-datacatalog.googleapis.com 代码模板、用户创建的条目、数据谱系
苏黎世 europe-west6-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
米兰 europe-west8-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
巴黎 europe-west9-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
柏林 europe-west10-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
都灵 europe-west12-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
马德里 europe-southwest1-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
亚太地区
台湾 asia-east1-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
香港 asia-east2-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
东京 asia-northeast1-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
大阪 asia-northeast2-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
首尔 asia-northeast3-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
孟买 asia-south1-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
德里 asia-south2-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
新加坡 asia-southeast1-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
雅加达 asia-southeast2-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
悉尼 australia-southeast1-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
墨尔本 australia-southeast2-datacatalog.googleapis.com 代码模板、用户创建的条目、数据谱系
中东
多哈 me-central1-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
达曼 me-central2-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
特拉维夫 me-west1-datacatalog.googleapis.com 标记模板、BigQuery、用户创建的条目、数据沿袭
非洲
约翰内斯堡 africa-south1-datacatalog.googleapis.com 代码模板、BigQuery、用户创建的条目、数据传承
多区域 多区域端点 支持的资源
亚洲 asia-datacatalog.googleapis.com 代码模板、用户创建的条目、数据谱系
欧盟 eu-datacatalog.googleapis.com BigQuery、代码模板、用户创建的条目、数据谱系
美国 us-datacatalog.googleapis.com BigQuery、代码模板、用户创建的条目、数据谱系
BigQuery Omni 区域 区域端点 支持的资源
AWS
AWS - 美国东部(北弗吉尼亚) aws-us-east-1-datacatalog.googleapis.com BigQuery(连接除外)、数据沿袭
AWS - 美国西部(俄勒冈) aws-us-west-2-datacatalog.googleapis.com BigQuery(连接除外)、数据沿袭
AWS - 亚太地区(首尔) aws-ap-northeast-2-datacatalog.googleapis.com BigQuery(连接除外)、数据沿袭
AWS - 亚太地区(悉尼) aws-ap-southeast-2-datacatalog.googleapis.com BigQuery(连接除外)、数据传承
AWS - 欧洲西部(爱尔兰) aws-eu-west-1-datacatalog.googleapis.com BigQuery(连接除外)、数据传承
AWS - 欧洲(法兰克福) aws-eu-central-1-datacatalog.googleapis.com BigQuery(连接除外)、数据沿袭
Azure
Azure - 美国东部 2(弗吉尼亚) azure-eastus2-datacatalog.googleapis.com BigQuery(连接除外)、数据沿袭
Azure - 美国西部 2(华盛顿) azure-westus2-datacatalog.googleapis.com 数据沿袭

多区域(美国、欧盟)

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 时使用区域端点。

如果您使用手动创建的 gRPC 库调用 datacatalog.googleapis.com 端点,则必须在请求中指定带有 locations=<region> 标记的 x-google-request-params 标头。现有的 Cloud 客户端库 内部使用 gRPC 的软件包已实现此功能。