Los recursos de Data Catalog se alojan en varias ubicaciones en todo el mundo, llamadas regiones. Una región es una ubicación geográfica específica donde puedes acceder a tus recursos. Para obtener más información, consulta Geografía y regiones.
A fin de disminuir la latencia de la red, recomendamos usar el extremo de API para una región que esté cerca de donde planea usarlo. Por ejemplo, si planea acceder a Data Catalog desde Asia, podría usar el extremo para Taiwán.
Regiones admitidas
| Region | Extremo regional | Recursos admitidos | |
|---|---|---|---|
| América | |||
| Montreal | northamerica-northeast1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Toronto | northamerica-northeast2-datacatalog.googleapis.com |
Plantillas de etiquetas, entradas creadas por el usuario, linaje de datos | |
| São Paulo | southamerica-east1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Santiago | southamerica-west1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Iowa | us-central1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Carolina del Sur | us-east1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Virginia del Norte | us-east4-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, Linaje de datos | |
| Columbus | us-east5-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Dallas | us-south1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Oregón | us-west1-datacatalog.googleapis.com |
Plantillas de etiquetas, entradas creadas por el usuario, linaje de datos | |
| Los Ángeles | us-west2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, Linaje de datos | |
| Salt Lake City | us-west3-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Las Vegas | us-west4-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, Linaje de datos | |
| Europa | |||
| Varsovia | europe-central2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Finlandia | europe-north1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Bélgica | europe-west1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Londres | europe-west2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Fráncfort | europe-west3-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Países Bajos | europe-west4-datacatalog.googleapis.com |
Plantillas de etiquetas, entradas creadas por el usuario, linaje de datos | |
| Zúrich | europe-west6-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Milán | europe-west8-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| París | europe-west9-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Berlín | europe-west10-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, Linaje de datos | |
| Turín | europe-west12-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Madrid | europe-southwest1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Asia-Pacífico | |||
| Taiwán | asia-east1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Hong Kong | asia-east2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Tokio | asia-northeast1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Osaka | asia-northeast2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Seúl | asia-northeast3-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Bombay | asia-south1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Delhi | asia-south2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Singapur | asia-southeast1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Yakarta | asia-southeast2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Sídney | australia-southeast1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Melbourne | australia-southeast2-datacatalog.googleapis.com |
Plantillas de etiquetas, entradas creadas por el usuario, linaje de datos | |
| Oriente Medio | |||
| Doha | me-central1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Dammam | me-central2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos | |
| Tel Aviv | me-west1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, Linaje de datos | |
| África | |||
| Johannesburgo | africa-south1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por el usuario, linaje de datos |
| Multirregión | Extremo multirregional | Recursos admitidos |
|---|---|---|
| Asia | asia-datacatalog.googleapis.com |
Plantillas de etiquetas, entradas creadas por el usuario, linaje de datos |
| Unión Europea | eu-datacatalog.googleapis.com |
BigQuery, plantillas de etiquetas, entradas creadas por el usuario, linaje de datos |
| Estados Unidos | us-datacatalog.googleapis.com |
BigQuery, plantillas de etiquetas, entradas creadas por el usuario, linaje de datos |
| Regiones de BigQuery Omni | Extremo regional | Recursos admitidos | |
|---|---|---|---|
| AWS | |||
| AWS - US East (N. Virginia). | aws-us-east-1-datacatalog.googleapis.com |
BigQuery (excepto conexiones), linaje de datos | |
| AWS: Oeste de EE.UU. (Oregón) | aws-us-west-2-datacatalog.googleapis.com |
BigQuery (excepto conexiones), linaje de datos | |
| AWS: Asia-Pacífico (Seúl) | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery (excepto conexiones), linaje de datos | |
| AWS - Asia-Pacífico (Sídney) | aws-ap-southeast-2-datacatalog.googleapis.com |
BigQuery (excepto conexiones), linaje de datos | |
| AWS: Europa occidental (Irlanda) | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery (excepto conexiones), linaje de datos | |
| AWS - Europa (Fráncfort) | aws-eu-central-1-datacatalog.googleapis.com |
BigQuery (excepto conexiones), linaje de datos | |
| Azure | |||
| Azure: Este de EE.UU. 2 (Virginia) | azure-eastus2-datacatalog.googleapis.com |
BigQuery (excepto conexiones), linaje de datos | |
| Azure: Oeste de EE.UU. 2 (Washington) | azure-westus2-datacatalog.googleapis.com |
Linaje de datos |
Multirregiones (EE.UU., UE)
Las multirregiones, como eu y us, son regiones especiales en las que Data Catalog puede replicar y entregar recursos en cualquier parte de ellas.
Accede a los recursos con API regionales
Se puede acceder a los recursos mediante extremos regionales (enumerados anteriormente en Regiones admitidas). Las bibliotecas cliente le permiten configurar puntos finales.
Para ofrecer retrocompatibilidad, las APIs regionales siguen siendo compatibles con el extremo datacatalog.googleapis.com, pero con algunas limitaciones (consulta
compatibilidad por lotes HTTP y compatibilidad con gRPC). Se recomienda bastante que utilice extremos regionales para las API regionales.
API no regionales
Si bien los elementos de datos se encuentran en regiones particulares, las funciones de búsqueda de Data Catalog tienen un alcance global. Las API no regionales como SearchCatalog y LookupEntry muestran elementos de todas las regiones y se puede acceder mediante el extremo datacatalog.googleapis.com.
Compatibilidad con lote HTTP
Data Catalog admite lotes HTTP, lo que le permite agrupar varias llamadas a la API en una sola solicitud.
Existen algunas restricciones cuando se usa el lote HTTP para API regionales:
- Una solicitud de lote HTTP solo debe incluir solicitudes a la API para recursos que pertenecen a la misma región.
- Debes usar extremos regionales cuando procesas en lotes las API regionales.
datacatalog.googleapis.comno admitirá API regionales por lotes. Las solicitudes regionales y no regionales no se pueden agrupar en conjunto. - Las API que no dependen de la región (SearchCatalog y LookupEntry) se pueden agrupar mediante el extremo
datacatalog.googleapis.com.
Si no está seguro de si está utilizando el lote HTTP, haga lo siguiente:
- Comprueba si estás realizando directamente una solicitud HTTP con una ruta de acceso establecida en
/batch, comohttp://datacatalog.googleapis.com/batch. Si utilizas el Bibliotecas cliente de la API de Google:
- Java: usa BatchRequest para llamar a las API
- Python: usar una solicitud BatchHTTP para llamar a las API
- Existen vinculaciones similares para otras bibliotecas (consulta la documentación específica de la biblioteca).
Compatibilidad con gRPC
Los extremos regionales son la forma recomendada de usar gRPC para las API regionales.
Si usas bibliotecas de gRPC creadas de forma manual para hacer llamadas a
extremo datacatalog.googleapis.com, debes especificar un x-google-request-params
con una etiqueta locations=<region> en la solicitud. El plan de
Bibliotecas cliente de Cloud
que usan gRPC internamente ya tienen implementada esta funcionalidad.