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 tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Toronto | northamerica-northeast2-datacatalog.googleapis.com |
Modelos de tags, entradas criadas pelo usuário, linhagem de dados | |
| São Paulo | southamerica-east1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Santiago | southamerica-west1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Iowa | us-central1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Carolina do Sul | us-east1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Norte da Virgínia | us-east4-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Columbus | us-east5-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Dallas | us-south1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Norte da Virgínia | aws-us-east-1-datacatalog.googleapis.com, azure-eastus2-datacatalog.googleapis.com |
BigQuery (exceto conexões) | |
| Oregon | us-west1-datacatalog.googleapis.com |
Modelos de tags, entradas criadas pelo usuário, linhagem de dados | |
| Oregon | aws-us-west-2-datacatalog.googleapis.com |
BigQuery (exceto conexões) | |
| Los Angeles | us-west2-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Salt Lake City | us-west3-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Las Vegas | us-west4-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Europa | |||
| Varsóvia | europe-central2-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Finlândia | europe-north1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Bélgica | europe-west1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Irlanda | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery (exceto conexões) | |
| Londres | europe-west2-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Frankfurt | europe-west3-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Países Baixos | europe-west4-datacatalog.googleapis.com |
Modelos de tags, entradas criadas pelo usuário, linhagem de dados | |
| Zurique | europe-west6-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Milão | europe-west8-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Paris | europe-west9-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Berlim | europe-west10-datacatalog.googleapis.com |
Modelos de tag, BigQuery e entradas criadas pelo usuário | |
| Turim | europe-west12-datacatalog.googleapis.com |
Modelos de tag, BigQuery e entradas criadas pelo usuário | |
| Madri | europe-southwest1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Ásia-Pacífico | |||
| Taiwan | asia-east1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Hong Kong | asia-east2-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Tóquio | asia-northeast1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Osaka | asia-northeast2-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Seul | asia-northeast3-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Seul | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery (exceto conexões) | |
| Mumbai | asia-south1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Délhi | asia-south2-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Singapura | asia-southeast1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Jacarta | asia-southeast2-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Sydney | australia-southeast1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| Melbourne | australia-southeast2-datacatalog.googleapis.com |
Modelos de tags, entradas criadas pelo usuário, linhagem de dados | |
| Oriente Médio | |||
| Doha | me-central1-datacatalog.googleapis.com |
Modelos de tag, BigQuery e entradas criadas pelo usuário | |
| Damã | me-central2-datacatalog.googleapis.com |
Modelos de tag, BigQuery e entradas criadas pelo usuário | |
| Tel Aviv | me-west1-datacatalog.googleapis.com |
Modelos de tags, BigQuery, entradas criadas pelo usuário, linhagem de dados | |
| África | |||
| Johannesburgo | africa-south1-datacatalog.googleapis.com |
Modelos de tag, BigQuery e entradas criadas pelo usuário |
| Multirregional | Endpoint multirregional | Recursos suportados |
|---|---|---|
| Ásia | asia-datacatalog.googleapis.com |
Modelos de tags, entradas criadas pelo usuário, linhagem de dados |
| União Europeia | eu-datacatalog.googleapis.com |
BigQuery, modelos de tags, entradas criadas pelo usuário, linhagem de dados |
| Estados Unidos | us-datacatalog.googleapis.com |
BigQuery, modelos de tags, entradas criadas pelo usuário, linhagem de dados |
| Regiões do BigQuery Omni | Endpoint regional | Recursos suportados |
|---|---|---|
| AWS Ásia-Pacífico (Seul) | aws-ap-northeast-2-datacatalog.googleapis.com |
Linhagem de dados |
| AWS EU West (Irlanda) | aws-eu-west-1-datacatalog.googleapis.com |
Linhagem de dados |
| AWS Leste dos EUA (Norte da Virginia) | aws-us-east-1-datacatalog.googleapis.com |
Linhagem de dados |
| AWS US West (Oregon) | aws-us-west-2-datacatalog.googleapis.com |
Linhagem de dados |
| Azure Leste dos EUA 2 (Virgínia) | azure-eastus2-datacatalog.googleapis.com |
Linhagem de dados |
Multirregiões (EUA, UE)
Multirregiões, como eu e us, são regiões especiais, em que o Data Catalog pode replicar e disponibilizar 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 compatíveis. As bibliotecas de cliente permitem que você configure endpoints.
Para compatibilidade com versões anteriores, as APIs regionais ainda são compatíveis com o endpoint datacatalog.googleapis.com, com algumas limitações. Consulte
Suporte a lote HTTP e Suporte ao 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. As bibliotecas de cliente do Cloud que usam o gRPC internamente já têm essa funcionalidade implementada.