Data Catalog-regionen

Data Catalog hostet Ressourcen an verschiedenen Standorten weltweit, den sogenannten Regionen. Eine Region ist ein bestimmter geografischer Standort, an dem Sie auf Ihre Ressourcen zugreifen können. Weitere Informationen finden Sie unter Geografie und Regionen.

Zur Verringerung der Netzwerklatenz sollten Sie den API-Endpunkt für eine Region verwenden, die sich in der Nähe der geplanten Verwendung befindet. Wenn Sie beispielsweise in Asien auf Data Catalog zugreifen möchten, können Sie den Endpunkt für Taiwan verwenden.

Unterstützte Regionen

Region Regionaler Endpunkt Unterstützte Ressourcen
Afrika
Johannesburg africa-south1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Amerika
Columbus us-east5-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Dallas us-south1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Iowa us-central1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Las Vegas us-west4-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Los Angeles us-west2-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Mexiko northamerica-south1-datacatalog.googleapis.com Tag-Vorlagen, vom Nutzer erstellte Einträge
Montreal northamerica-northeast1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Northern Virginia us-east4-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Oregon us-west1-datacatalog.googleapis.com Tag-Vorlagen, vom Nutzer erstellte Einträge, Datenabfolge
Salt Lake City us-west3-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Santiago southamerica-west1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
São Paulo southamerica-east1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
South Carolina us-east1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Toronto northamerica-northeast2-datacatalog.googleapis.com Tag-Vorlagen, vom Nutzer erstellte Einträge, Datenabfolge
Asiatisch-pazifischer Raum
Delhi asia-south2-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Hongkong asia-east2-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Jakarta asia-southeast2-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Melbourne australia-southeast2-datacatalog.googleapis.com Tag-Vorlagen, vom Nutzer erstellte Einträge, Datenabfolge
Mumbai asia-south1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Osaka asia-northeast2-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Seoul asia-northeast3-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Singapur asia-southeast1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Sydney australia-southeast1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Taiwan asia-east1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Tokio asia-northeast1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Europa
Belgien europe-west1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Berlin europe-west10-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Finnland europe-north1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Frankfurt europe-west3-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
London europe-west2-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Madrid europe-southwest1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Mailand europe-west8-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Niederlande europe-west4-datacatalog.googleapis.com Tag-Vorlagen, vom Nutzer erstellte Einträge, Datenabfolge
Paris europe-west9-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Turin europe-west12-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Warschau europe-central2-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Zürich europe-west6-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Naher Osten
Dammam* me-central2-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Doha me-central1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Tel Aviv me-west1-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge

* In Dammam gelten regionsspezifische Zugriffssteuerungen, die in diesem Dokument beschrieben sind.

Mehrere Regionen (EU, USA)

Multi-Regionen wie eu und us sind spezielle Regionen, in denen der Data Catalog Ressourcen überall in ihnen replizieren und bereitstellen kann.

Mehrere Regionen Multiregionaler Endpunkt Unterstützte Ressourcen
Asien asia-datacatalog.googleapis.com Tag-Vorlagen, vom Nutzer erstellte Einträge, Datenabfolge
Europäische Union eu-datacatalog.googleapis.com BigQuery, Tag-Vorlagen, vom Nutzer erstellte Einträge, Datenabfolge
USA us-datacatalog.googleapis.com BigQuery, Tag-Vorlagen, vom Nutzer erstellte Einträge, Datenabfolge

BigQuery Omni-Regionen

BigQuery Omni-Regionen Regionaler Endpunkt Unterstützte Ressourcen
AWS
AWS – Asiatisch-pazifischer Raum (Seoul) aws-ap-northeast-2-datacatalog.googleapis.com BigQuery (außer Verbindungen), Datenabfolge
AWS – Asiatisch-pazifischer Raum (Sydney) aws-ap-southeast-2-datacatalog.googleapis.com BigQuery (außer Verbindungen), Datenabfolge
AWS – Europa (Frankfurt) aws-eu-central-1-datacatalog.googleapis.com BigQuery (außer Verbindungen), Datenabfolge
AWS - Europa (Irland) aws-eu-west-1-datacatalog.googleapis.com BigQuery (außer Verbindungen), Datenabfolge
AWS – US East (N. Virginia) aws-us-east-1-datacatalog.googleapis.com BigQuery (außer Verbindungen), Datenabfolge
AWS – US West (Oregon) aws-us-west-2-datacatalog.googleapis.com BigQuery (außer Verbindungen), Datenabfolge
Azure
Azure – East US 2 (Virginia) azure-eastus2-datacatalog.googleapis.com BigQuery (außer Verbindungen), Datenabfolge
Azure – West US 2 (Washington) azure-westus2-datacatalog.googleapis.com Data Lineage

Auf Ressourcen mit regionalen APIs zugreifen

Auf Ressourcen kann über regionale Endpunkte zugegriffen werden (siehe Unterstützte Regionen). Mit Clientbibliotheken können Sie Endpunkte konfigurieren.

Aus Gründen der Abwärtskompatibilität werden regionale APIs vom Endpunkt datacatalog.googleapis.com unterstützt, allerdings mit einigen Einschränkungen. Weitere Informationen finden Sie unter HTTP-Batch-Unterstützung und gRPC-Unterstützung. Wir empfehlen, regionale Endpunkte für regionale APIs zu verwenden.

Nicht regionale APIs

Während sich Daten-Assets in bestimmten Regionen befinden, ist die Data Catalog-Suche global. Nicht regionale APIs wie SearchCatalog und LookupEntry geben Assets aus allen Regionen zurück und können mit dem Endpunkt datacatalog.googleapis.com auf sie zugreifen.

HTTP batch support

Der Data Catalog unterstützt HTTP-Batch, sodass Sie mehrere API-Aufrufe in einer einzigen Anforderung stapeln können.

Bei der Verwendung von HTTP-Batch für regionale APIs gelten einige Einschränkungen:

  • Eine HTTP-Batchanfrage darf nur API-Anfragen für Ressourcen enthalten, die zu derselben Region gehören.
  • Regionale Endpunkte müssen beim Batching regionaler APIs verwendet werden. datacatalog.googleapis.com unterstützt keine regionalen Batch-APIs. Regionale und nicht regionale Anfragen können nicht in einem Batch zusammengefasst werden.
  • Nicht regional abhängige APIs (SearchCatalog und LookupEntry) können mithilfe des Endpunkts datacatalog.googleapis.com zusammengefasst werden.

Wenn Sie nicht sicher sind, ob Sie HTTP-Batch verwenden, gehen Sie so vor:

  • Prüfen Sie, ob Sie direkt eine HTTP-Anfrage mit einem auf /batch gesetzten Pfad stellen, z. B. http://datacatalog.googleapis.com/batch.

  • Wenn Sie die Google API-Clientbibliotheken verwenden, prüfen Sie Folgendes:

    • Java: Mit BatchRequest APIs aufrufen.
    • Python: BatchHTTP-Anfrage zum Aufrufen von APIs verwenden.
    • Ähnliche Bindungen gibt es für andere Bibliotheken. Weitere Informationen finden Sie in der Dokumentation zur jeweiligen Bibliothek.

gRPC-Unterstützung

Regionale Endpunkte sind die empfohlene Methode, um gRPC für regionale APIs zu verwenden.

Wenn Sie manuell erstellte gRPC-Bibliotheken verwenden, um Aufrufe an den Endpunkt datacatalog.googleapis.com zu senden, müssen Sie in der Anfrage einen x-google-request-params-Header mit einem locations=<region>-Tag angeben. Diese Angabe ist in den vorhandenen Cloud-Clientbibliotheken, die gRPC intern verwenden, bereits enthalten.