Regiones de Data Catalog

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
Toronto northamerica-northeast2-datacatalog.googleapis.com Plantillas de etiqueta, entradas creadas por el usuario
São Paulo southamerica-east1-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Iowa us-central1-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Tulsa us-central2-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Carolina del Sur us-east1-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Virginia del Norte us-east4-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Oregón us-west1-datacatalog.googleapis.com Plantillas de etiqueta, entradas creadas por el usuario
Los Ángeles us-west2-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Salt Lake City us-west3-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Las Vegas us-west4-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Europa
Varsovia europe-central2-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Finlandia europe-north1-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Bélgica europe-west1-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Londres europe-west2-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Fráncfort europe-west3-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Netherlands europe-west4-datacatalog.googleapis.com Plantillas de etiqueta, entradas creadas por el usuario
Zúrich europe-west6-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Asia-Pacífico
Taiwán asia-east1-datacatalog.googleapis.com Plantillas de etiqueta y entradas de BigQuery creadas por el usuario
Hong Kong asia-east2-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Tokio asia-northeast1-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Osaka asia-northeast2-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Seúl asia-northeast3-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Bombay asia-south1-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Delhi asia-south2-datacatalog.googleapis.com Plantillas de etiqueta, entradas creadas por el usuario
Singapur asia-southeast1-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Yakarta asia-southeast2-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Sídney australia-southeast1-datacatalog.googleapis.com Plantillas de etiquetas, BigQuery, entradas creadas por el usuario
Melbourne australia-southeast2-datacatalog.googleapis.com Plantillas de etiqueta, entradas creadas por el usuario
Multirregión Extremo multirregional Recursos admitidos
Global global-datacatalog.googleapis.com Pub/Sub, plantillas de etiqueta
Asia asia-datacatalog.googleapis.com BigQuery, plantillas de etiquetas, entradas creadas por el usuario
Unión Europea eu-datacatalog.googleapis.com BigQuery, plantillas de etiquetas, entradas creadas por el usuario
United States us-datacatalog.googleapis.com BigQuery, plantillas de etiquetas, entradas creadas por el usuario

Varias regiones (EE.UU, UE, global)

global es una región múltiple especial, creada principalmente para entregar recursos que no tienen una sola región asociada a ellos, por ejemplo, metadatos sincronizados para temas de Cloud Pub/Sub. Internamente, Data Catalog puede replicar y entregar recursos globales en cualquier parte del mundo.

Del mismo modo, las regiones múltiples como eu y us son regiones especiales, donde Data Catalog puede replicar y servir recursos en cualquier lugar dentro de ellas.

Accede a los recursos con API regionales

Se puede acceder a los recursos mediante extremos regionales (enumerados arriba). Las bibliotecas cliente le permiten configurar puntos finales.

Para la compatibilidad con versiones anteriores, las API regionales aún son compatibles con el extremo datacatalog.googleapis.com, con algunas limitaciones (consulte lote HTTP y 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.com no 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, como http://datacatalog.googleapis.com/batch.
  • Si está utilizando la biblioteca cliente de las 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 manualmente 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 Google Cloud existentes que usan gRPC de forma interna ya tienen implementada esta funcionalidad.