Data Catalog-Ressourcen werden an verschiedenen Standorten weltweit gehostet, den sogenannten Regionen. Eine Region ist ein bestimmter geografischer Standort, an dem Sie auf Ihre Ressourcen zugreifen können. Weitere Informationen hierzu 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 | |
---|---|---|---|
Amerika | |||
Montreal | northamerica-northeast1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Toronto | northamerica-northeast2-datacatalog.googleapis.com |
Tag-Vorlagen, vom Nutzer erstellte Einträge | |
São Paulo | southamerica-east1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Iowa | us-central1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
South Carolina | us-east1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Northern Virginia | us-east4-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Northern Virginia | aws-us-east-1-datacatalog.googleapis.com , azure-eastus2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery (derzeit außer Verbindungen), vom Nutzer erstellte Einträge | |
Oregon | us-west1-datacatalog.googleapis.com |
Tag-Vorlagen, vom Nutzer erstellte Einträge | |
Los Angeles | us-west2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Salt Lake City | us-west3-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Las Vegas | us-west4-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Europa | |||
Warschau | europe-central2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Finnland | europe-north1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Belgien | europe-west1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
London | europe-west2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Frankfurt | europe-west3-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Niederlande | europe-west4-datacatalog.googleapis.com |
Tag-Vorlagen, vom Nutzer erstellte Einträge | |
Zürich | europe-west6-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Asia Pacific | |||
Taiwan | asia-east1-datacatalog.googleapis.com |
Tag-Vorlagen, von BigQuery-Nutzern erstellte Einträge | |
Hongkong | asia-east2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Tokio | asia-northeast1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Osaka | asia-northeast2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Seoul | asia-northeast3-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Mumbai | asia-south1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Delhi | asia-south2-datacatalog.googleapis.com |
Tag-Vorlagen, vom Nutzer erstellte Einträge | |
Singapur | asia-southeast1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Jakarta | asia-southeast2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Sydney | australia-southeast1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Melbourne | australia-southeast2-datacatalog.googleapis.com |
Tag-Vorlagen, vom Nutzer erstellte Einträge |
Mehrere Regionen | Multiregionaler Endpunkt | Unterstützte Ressourcen |
---|---|---|
Global | global-datacatalog.googleapis.com |
Pub/Sub, Tag-Vorlagen |
Asien | asia-datacatalog.googleapis.com |
BigQuery, Tag-Vorlagen, vom Nutzer erstellte Einträge |
Europäische Union | eu-datacatalog.googleapis.com |
BigQuery, Tag-Vorlagen, vom Nutzer erstellte Einträge |
USA | us-datacatalog.googleapis.com |
BigQuery, Tag-Vorlagen, vom Nutzer erstellte Einträge |
Multi-regionen (us, eu, global)
global
ist eine spezielle Multiregion, die hauptsächlich für die Bereitstellung von Ressourcen erstellt wurde, denen keine einzige Region zugeordnet ist, z. B. für Cloud Pub/Sub-Themen synchronisierte Metadaten. Intern kann Data Catalog globale Ressourcen rund um den Globus replizieren und bereitstellen.
In ähnlicher Weise sind Multi-Regionen wie eu
und us
spezielle Regionen, in denen der Data Catalog Ressourcen überall in ihnen replizieren und bereitstellen kann.
Auf Ressourcen mit regionalen APIs zugreifen
Auf Ressourcen kann über regionale Endpunkte (siehe oben) zugegriffen werden. Mit Clientbibliotheken können Sie Endpunkte konfigurieren.
Aus Gründen der Abwärtskompatibilität werden regionale APIs weiterhin vom Endpunkt datacatalog.googleapis.com
unterstützt, allerdings mit einigen Einschränkungen (siehe HTTP-Batch und gRPC). Es wird dringend empfohlen, regionale Endpunkte für regionale APIs zu verwenden.
Nicht regionale APIs
Während sich Daten-Asset in bestimmten Regionen befinden, sind die Suchfunktionen von Data Catalog global beschränkt. 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-batch-anforderung darf nur API-Anforderungen 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-Clientbibliothek verwenden:
- 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 Funktion ist in den vorhandenen Google Cloud-Clientbibliotheken, die gRPC intern verwenden, bereits implementiert.