Data Catalog 区域

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

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

支持的区域

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

多区域(eu、us)

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

多区域 多区域端点 支持的资源
亚洲 asia-datacatalog.googleapis.com 代码模板、用户创建的条目、数据谱系
欧盟 eu-datacatalog.googleapis.com BigQuery、代码模板、用户创建的条目、数据谱系
美国 us-datacatalog.googleapis.com BigQuery、代码模板、用户创建的条目、数据谱系

BigQuery Omni 区域

BigQuery Omni 区域 区域端点 支持的资源
AWS
AWS - 亚太地区(首尔) aws-ap-northeast-2-datacatalog.googleapis.com BigQuery(连接除外)、数据传承
AWS - 亚太地区(悉尼) aws-ap-southeast-2-datacatalog.googleapis.com BigQuery(连接除外)、数据传承
AWS - 欧洲(法兰克福) aws-eu-central-1-datacatalog.googleapis.com BigQuery(连接除外)、数据传承
AWS - 欧洲(爱尔兰) aws-eu-west-1-datacatalog.googleapis.com BigQuery(连接除外)、数据传承
AWS - 美国东部(北弗吉尼亚) aws-us-east-1-datacatalog.googleapis.com BigQuery(连接除外)、数据传承
AWS - 美国西部(俄勒冈) aws-us-west-2-datacatalog.googleapis.com BigQuery(连接除外)、数据传承
Azure
Azure - 美国东部 2(弗吉尼亚) azure-eastus2-datacatalog.googleapis.com BigQuery(连接除外)、数据传承
Azure - 美国西部 2(华盛顿) azure-westus2-datacatalog.googleapis.com 数据沿袭

使用区域 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(SearchCatalogLookupEntry)可使用 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 标头。在内部使用 gRPC 的现有 Cloud 客户端库已经指定了此值。