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 usuarios, linaje de datos | |
| Toronto | northamerica-northeast2-datacatalog.googleapis.com |
Plantillas de etiquetas, entradas creadas por usuarios, linaje de datos | |
| São Paulo | southamerica-east1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Santiago | southamerica-west1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Iowa | us-central1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Carolina del Sur | us-east1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Virginia del Norte | us-east4-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Columbus | us-east5-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Dallas | us-south1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Virginia del Norte | aws-us-east-1-datacatalog.googleapis.com de azure-eastus2-datacatalog.googleapis.com |
BigQuery (excepto las conexiones) | |
| Oregón | us-west1-datacatalog.googleapis.com |
Plantillas de etiquetas, entradas creadas por usuarios, linaje de datos | |
| Oregón | aws-us-west-2-datacatalog.googleapis.com |
BigQuery (excepto las conexiones) | |
| Los Ángeles | us-west2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Salt Lake City | us-west3-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Las Vegas | us-west4-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Europa | |||
| Varsovia | europe-central2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Finlandia | europe-north1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Bélgica | europe-west1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Irlanda | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery (excepto las conexiones) | |
| Londres | europe-west2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Fráncfort | europe-west3-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Países Bajos | europe-west4-datacatalog.googleapis.com |
Plantillas de etiquetas, entradas creadas por usuarios, linaje de datos | |
| Zúrich | europe-west6-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Milán | europe-west8-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| París | europe-west9-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Berlín | europe-west10-datacatalog.googleapis.com |
TagTemplates, BigQuery, entradas creadas por el usuario | |
| Turín | europe-west12-datacatalog.googleapis.com |
TagTemplates, BigQuery, entradas creadas por el usuario | |
| Madrid | europe-southwest1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Asia-Pacífico | |||
| Taiwán | asia-east1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Hong Kong | asia-east2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Tokio | asia-northeast1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Osaka | asia-northeast2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Seúl | asia-northeast3-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Seúl | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery (excepto las conexiones) | |
| Bombay | asia-south1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Delhi | asia-south2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Singapur | asia-southeast1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Yakarta | asia-southeast2-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Sídney | australia-southeast1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| Melbourne | australia-southeast2-datacatalog.googleapis.com |
Plantillas de etiquetas, entradas creadas por usuarios, linaje de datos | |
| Oriente Medio | |||
| Doha | me-central1-datacatalog.googleapis.com |
TagTemplates, BigQuery, entradas creadas por el usuario | |
| Dammam | me-central2-datacatalog.googleapis.com |
TagTemplates, BigQuery, entradas creadas por el usuario | |
| Tel Aviv | me-west1-datacatalog.googleapis.com |
Plantillas de etiquetas, BigQuery, entradas creadas por usuarios, linaje de datos | |
| África | |||
| Johannesburgo | africa-south1-datacatalog.googleapis.com |
TagTemplates, BigQuery, entradas creadas por el usuario |
| Multirregional | Extremo multirregional | Recursos admitidos |
|---|---|---|
| Asia | asia-datacatalog.googleapis.com |
Plantillas de etiquetas, entradas creadas por usuarios, 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 Asia-Pacífico (Seúl) | aws-ap-northeast-2-datacatalog.googleapis.com |
Linaje de datos |
| UE oeste (Irlanda) de AWS | aws-eu-west-1-datacatalog.googleapis.com |
Linaje de datos |
| AWS (este de EE.UU.) Norte) | aws-us-east-1-datacatalog.googleapis.com |
Linaje de datos |
| AWS, EE.UU. oeste (Oregón) | aws-us-west-2-datacatalog.googleapis.com |
Linaje de datos |
| Azure: Este de EE.UU. 2 (Virginia) | azure-eastus2-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 lugar de ellas.
Accede a los recursos con API regionales
Se puede acceder a los recursos con extremos regionales (enumerados anteriormente en Regiones admitidas). Las bibliotecas cliente le permiten configurar puntos finales.
Para ofrecer retrocompatibilidad, el extremo datacatalog.googleapis.com aún admite las APIs regionales, 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 usas las bibliotecas cliente de las APIs de Google, haz lo siguiente:
- 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 realizar llamadas al extremo datacatalog.googleapis.com, debes especificar un encabezado x-google-request-params con una etiqueta locations=<region> en la solicitud. Las bibliotecas cliente de Cloud existentes que usan gRPC de forma interna ya tienen esta funcionalidad implementada.