Regiões do Data Catalog

Os recursos do Data Catalog são hospedados em vários locais do mundo, chamados de regiões. As regiões são localizações geográficas específicas em que você acessa recursos. Para mais informações, consulte Geografia e regiões.

Para diminuir a latência da rede, recomendamos usar o ponto de extremidade da API para uma região próxima de onde você planeja usá-la. Por exemplo, se você planeja acessar o Data Catalog da Ásia, pode usar o endpoint para Taiwan.

Regiões compatíveis

Region Endpoint regional Recursos compatíveis
América
Montreal northamerica-northeast1-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
São Paulo southamerica-east1-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Iowa us-central1-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Carolina do Sul us-east1-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Virgínia do Norte us-east4-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Oregon us-west1-datacatalog.googleapis.com TagTemplates, entradas criadas pelo usuário
Los Angeles us-west2-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Salt Lake City us-west3-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Las Vegas us-west4-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Europa
Finlândia europe-north1-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Bélgica europe-west1-datacatalog.googleapis.com TagTemplates, entradas criadas pelo usuário
Londres europe-west2-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Frankfurt europe-west3-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Holanda europe-west4-datacatalog.googleapis.com TagTemplates, entradas criadas pelo usuário
Zurique europe-west6-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Ásia-Pacífico
Taiwan asia-east1-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Hong Kong asia-east2-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Tóquio asia-northeast1-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Osaka asia-northeast2-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Seul asia-northeast3-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Mumbai asia-south1-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Singapura asia-southeast1-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Jacarta asia-southeast2-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Sydney australia-southeast1-datacatalog.googleapis.com TagTemplates, BigQuery e entradas criadas pelo usuário
Multirregional Endpoint multirregional Recursos compatíveis
Global global-datacatalog.googleapis.com Pub/Sub, TagTemplates
União Europeia eu-datacatalog.googleapis.com BigQuery, TagTemplates, entradas criadas pelo usuário
Ucrânia us-datacatalog.googleapis.com BigQuery, TagTemplates, entradas criadas pelo usuário

Várias regiões (nós, eu, global)

global é uma multirregião especial, criada principalmente para veicular recursos que não têm uma única região associada a eles. Por exemplo, metadados sincronizados para tópicos do Cloud Pub/Sub. Internamente, o Data Catalog pode replicar e servir recursos globais em qualquer lugar do mundo.

Da mesma forma, várias regiões como eu e us são regiões especiais, nas quais o Data Catalog pode replicar e servir recursos em qualquer lugar dentro deles.

Como acessar recursos com APIs regionais

Os recursos podem ser acessados usando endpoints regionais (listados acima). As bibliotecas de cliente permitem que você configure endpoints.

Para compatibilidade com versões anteriores, APIs regionais ainda são suportadas pelo endpoint datacatalog.googleapis.com, com algumas limitações (consulte lote HTTP e gRPC). É altamente recomendável usar endpoints regionais para APIs regionais.

APIs não regionais

Embora os recursos de dados estejam localizados em determinadas regiões, os recursos de pesquisa do Data Catalog são definidos no escopo global. As APIs não regionais, como SearchCatalog e LookupEntry, retornam recursos de todas as regiões e podem ser acessadas com o ponto de extremidade datacatalog.googleapis.com.

Suporte a lotes HTTP

O Data Catalog é compatível com lote HTTP, permitindo que você agrupe várias chamadas de API em uma única solicitação.

Há algumas restrições ao usar o lote HTTP para APIs regionais:

  • Uma solicitação de lote HTTP deve incluir apenas solicitações de API para recursos pertencentes à mesma região.
  • Você deve usar endpoints regionais ao agrupar APIs regionais. datacatalog.googleapis.com não suportará APIs regionais em lote. Pedidos regionais e não regionais não podem ser agrupados.
  • As APIs que não dependem da região (SearchCatalog e LookupEntry) podem ser agrupadas em lote, usando o endpoint datacatalog.googleapis.com.

Se você não tiver certeza se está usando lote HTTP:

  • Verifique se você está fazendo diretamente uma solicitação HTTP com um caminho definido como /batch, tal como o http://datacatalog.googleapis.com/batch.
  • Se você estiver usando a biblioteca do Cliente da API do Google:

    • Java: uso de BatchRequest para chamar APIs.
    • Python: usando a solicitação BatchHTTP para chamar APIs.
    • Existem vínculos semelhantes para outras bibliotecas. Consulte a documentação específica da biblioteca.

Suporte ao gRPC

Os pontos de extremidade regionais são a maneira recomendada de usar o gRPC para APIs regionais.

Algumas bibliotecas de cliente do Google Cloud existentes usam o gRPC internamente. Para compatibilidade com versões anteriores, o ponto de extremidade datacatalog.googleapis.com oferece suporte a APIs regionais ao usar gRPC dessas bibliotecas.