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.comnã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 ohttp://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.