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 |
数据沿袭 |
多区域(美国、欧盟)
eu
和 us
等多区域是特殊区域,Data Catalog 可以在其中任意位置复制和传送资源。
使用区域 API 访问资源
您可以使用区域端点(如前文所述, 支持的区域)。通过客户端库,您可以配置端点。
为了向后兼容,datacatalog.googleapis.com
端点仍支持区域级 API,但存在一些限制(请参阅
HTTP 批量支持和 gRPC 支持)。我们强烈建议您为区域 API 使用区域端点。
非区域性 API
虽然数据资源位于特定区域,但 Data Catalog 的搜索功能是全球范围的。SearchCatalog
和 LookupEntry
等非区域性 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 的软件包已实现此功能。