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 Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Toronto northamerica-northeast2-datacatalog.googleapis.com Modelos de tag, entradas criadas pelo usuário, linhagem de dados
São Paulo southamerica-east1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Santiago southamerica-west1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Iowa us-central1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Carolina do Sul us-east1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Norte da Virgínia us-east4-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Columbus us-east5-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Dallas us-south1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Oregon us-west1-datacatalog.googleapis.com Modelos de tag, entradas criadas pelo usuário, linhagem de dados
Los Angeles us-west2-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Salt Lake City us-west3-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Las Vegas us-west4-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Europa
Varsóvia europe-central2-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Finlândia europe-north1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Bélgica europe-west1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Londres europe-west2-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Frankfurt europe-west3-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Países Baixos europe-west4-datacatalog.googleapis.com Modelos de tag, entradas criadas pelo usuário, linhagem de dados
Zurique europe-west6-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Milão europe-west8-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Paris europe-west9-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Berlim europe-west10-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Turim europe-west12-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Madri europe-southwest1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Ásia-Pacífico
Taiwan asia-east1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Hong Kong asia-east2-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Tóquio asia-northeast1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Osaka asia-northeast2-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Seul asia-northeast3-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Mumbai asia-south1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Délhi asia-south2-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Singapura asia-southeast1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Jacarta asia-southeast2-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Sydney australia-southeast1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Melbourne australia-southeast2-datacatalog.googleapis.com Modelos de tag, entradas criadas pelo usuário, linhagem de dados
Oriente Médio
Doha me-central1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Damã me-central2-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Tel Aviv me-west1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
África
Johannesburgo africa-south1-datacatalog.googleapis.com Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados
Multirregional Endpoint multirregional Recursos suportados
Ásia asia-datacatalog.googleapis.com Modelos de tag, entradas criadas pelo usuário, linhagem de dados
União Europeia eu-datacatalog.googleapis.com BigQuery, modelos de tag, entradas criadas pelo usuário, linhagem de dados
Estados Unidos us-datacatalog.googleapis.com BigQuery, modelos de tag, entradas criadas pelo usuário, linhagem de dados
Regiões do BigQuery Omni Endpoint regional Recursos suportados
AWS
AWS - US East (N. Virginia) aws-us-east-1-datacatalog.googleapis.com BigQuery (exceto conexões), linhagem de dados
AWS - Oeste dos EUA (Oregon) aws-us-west-2-datacatalog.googleapis.com BigQuery (exceto conexões), linhagem de dados
AWS – Ásia-Pacífico (Seul) aws-ap-northeast-2-datacatalog.googleapis.com BigQuery (exceto conexões) e linhagem de dados
AWS: Ásia-Pacífico (Sydney) aws-ap-southeast-2-datacatalog.googleapis.com BigQuery (exceto conexões), linhagem de dados
AWS - Europa Ocidental (Irlanda) aws-eu-west-1-datacatalog.googleapis.com BigQuery (exceto conexões), linhagem de dados
AWS: Europa (Frankfurt) aws-eu-central-1-datacatalog.googleapis.com BigQuery (exceto conexões), linhagem de dados
Azure
Azure - Leste dos EUA 2 (Virgínia) azure-eastus2-datacatalog.googleapis.com BigQuery (exceto conexões), linhagem de dados
Azure - West US 2 (Washington) azure-westus2-datacatalog.googleapis.com Linhagem de dados

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

Várias regiões, como eu e us, são regiões especiais em que o Data Catalog pode replicar e veicular recursos em qualquer lugar dentro delas.

Como acessar recursos com APIs regionais

Os recursos podem ser acessados usando endpoints regionais (listados anteriormente em Regiões com suporte). As bibliotecas de cliente permitem que você configure endpoints.

Para compatibilidade com versões anteriores, as APIs regionais ainda são suportadas pelo endpoint datacatalog.googleapis.com, com algumas limitações (consulte suporte a lote HTTP e suporte a 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 as bibliotecas de cliente das APIs do Google:

    • Java: uso de BatchRequest para chamar APIs.
    • Python: usando a solicitação BatchHTTP para chamar APIs.
    • Existem vinculações 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.

Se você estiver usando bibliotecas gRPC criadas manualmente para fazer chamadas para o endpoint datacatalog.googleapis.com, especifique um cabeçalho x-google-request-params com uma tag locations=<region> na solicitação. O modelo Bibliotecas de cliente do Cloud que usam gRPC internamente já têm essa funcionalidade implementada.