O Data Catalog hospeda recursos em vários locais do mundo, chamados de regiões. As regiões são localizações geográficas específicas em que você pode acessar seus 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 suportados | |
|---|---|---|---|
| África | |||
| Johannesburgo | africa-south1-datacatalog.googleapis.com |
Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| América | |||
| 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 | |
| Iowa | us-central1-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 | |
| Los Angeles | us-west2-datacatalog.googleapis.com |
Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| México | northamerica-south1-datacatalog.googleapis.com |
Modelos de tag, entradas criadas pelo usuário | |
| Montreal | northamerica-northeast1-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 | |
| Oregon | us-west1-datacatalog.googleapis.com |
Modelos de tag, 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 | |
| Santiago | southamerica-west1-datacatalog.googleapis.com |
Modelos de tag, BigQuery, 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 | |
| Carolina do Sul | us-east1-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 | |
| Ásia-Pacífico | |||
| Délhi | asia-south2-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 | |
| Jacarta | asia-southeast2-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 | |
| Mumbai | asia-south1-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 | |
| Singapura | asia-southeast1-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 | |
| Taiwan | asia-east1-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 | |
| Europa | |||
| Bélgica | europe-west1-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 | |
| Finlândia | europe-north1-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 | |
| Londres | europe-west2-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 | |
| Milão | europe-west8-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 | |
| Paris | europe-west9-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 | |
| Varsóvia | europe-central2-datacatalog.googleapis.com |
Modelos de tag, BigQuery, 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 | |
| Oriente Médio | |||
| Dammam* | me-central2-datacatalog.googleapis.com |
Modelos de tag, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Doha | me-central1-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 |
* Damã tem controles de acesso específicos da região descritos neste documento.
Várias regiões (eu, us)
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.
| 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
| Regiões do BigQuery Omni | Endpoint regional | Recursos suportados | |
|---|---|---|---|
| AWS | |||
| AWS – Ásia-Pacífico (Seul) | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery (exceto conexões), linhagem de dados | |
| AWS: Ásia-Pacífico (Sydney) | aws-ap-southeast-2-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 | |
| AWS - Europa (Irlanda) | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery (exceto conexões), linhagem de dados | |
| 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 | |
| Azure | |||
| Azure - East US 2 (Virginia) | 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 |
Acessar recursos com APIs regionais
Os recursos podem ser acessados usando endpoints regionais (consulte Regiões com suporte). As bibliotecas de cliente permitem configurar endpoints.
Para compatibilidade com versões anteriores, as APIs regionais têm suporte do endpoint
datacatalog.googleapis.com, com algumas limitações. Para mais
informações, consulte
Suporte a lotes HTTP e Suporte a gRPC.
Recomendamos usar endpoints regionais para APIs regionais.
APIs não regionais
Embora os recursos de dados estejam localizados em determinadas regiões,
a pesquisa do Data Catalog é definida 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 endpoint datacatalog.googleapis.com.
Suporte a lotes HTTP
O Data Catalog é compatível com o lote HTTP, que permite agrupar várias chamadas de API em uma única solicitação.
Confira a seguir algumas restrições ao usar o lote HTTP para APIs regionais:
- Uma solicitação de lote HTTP precisa incluir apenas solicitações de API para recursos pertencentes à mesma região.
- Você deve usar endpoints regionais ao agrupar APIs regionais.
A
datacatalog.googleapis.comnão oferece suporte a APIs regionais em lote. Pedidos regionais e não regionais não podem ser agrupados. - As APIs que não dependem da região (
SearchCatalogeLookupEntry) podem ser agrupadas em lote usando o endpointdatacatalog.googleapis.com.
Se você não tiver certeza se está usando o lote HTTP, faça o seguinte:
- 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, confira o seguinte:
- Java: uso de BatchRequest para chamar APIs.
- Python: usar 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. As
bibliotecas de cliente do Google Cloud
que usam o gRPC internamente já têm isso especificado.