Los recursos de Data Catalog se alojan en múltiples ubicaciones de 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 planeas acceder Data Catalog de Asia, podrías 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 |
Varias regiones (EE.UU. y UE)
Las multirregiones, como eu y us, son regiones especiales, en las que
Data Catalog puede replicar y entregar recursos en cualquier lugar dentro
de ellos.
| 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
| 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 (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 las conexiones), linaje de datos | |
| Azure | |||
| Azure: Este de EE.UU. 2 (Virginia) | azure-eastus2-datacatalog.googleapis.com |
BigQuery (excepto las conexiones), linaje de datos | |
| Azure - West US 2 (Washington) | azure-westus2-datacatalog.googleapis.com |
Linaje de datos |
Accede a los recursos con API regionales
Se puede acceder a los recursos mediante extremos regionales (enumerados anteriormente en Regiones admitidas). Las bibliotecas cliente te permiten configurar puntos finales.
Para ofrecer retrocompatibilidad, las APIs regionales aún son compatibles con el
extremo datacatalog.googleapis.com, 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 recursos de datos
se encuentran en regiones particulares
Las funciones de búsqueda de Data Catalog tienen un alcance global. No regional
Las APIs como SearchCatalog y LookupEntry muestran recursos de todas las regiones,
y se puede acceder con 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 por lotes HTTP solo debe incluir solicitudes a la API para los 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 documentación).
Compatibilidad con gRPC
Los extremos regionales son la forma recomendada de usar gRPC para las API regionales.
Si usas bibliotecas 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 implementada esta funcionalidad.