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, Data Lineage | |
Toronto | northamerica-northeast2-datacatalog.googleapis.com |
Tag-Vorlagen, von Nutzern erstellte Einträge, Data Lineage | |
São Paulo | southamerica-east1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Santiago | southamerica-west1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Iowa | us-central1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
South Carolina | us-east1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Northern Virginia | us-east4-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Columbus | us-east5-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Dallas | us-south1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Northern Virginia | aws-us-east-1-datacatalog.googleapis.com , azure-eastus2-datacatalog.googleapis.com |
BigQuery (außer Verbindungen) | |
Oregon | us-west1-datacatalog.googleapis.com |
Tag-Vorlagen, von Nutzern erstellte Einträge, Data Lineage | |
Oregon | aws-us-west-2-datacatalog.googleapis.com |
BigQuery (außer Verbindungen) | |
Los Angeles | us-west2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Salt Lake City | us-west3-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Las Vegas | us-west4-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Europa | |||
Warschau | europe-central2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Finnland | europe-north1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Belgien | europe-west1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Irland | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery (außer Verbindungen) | |
London | europe-west2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Frankfurt | europe-west3-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Niederlande | europe-west4-datacatalog.googleapis.com |
Tag-Vorlagen, von Nutzern erstellte Einträge, Data Lineage | |
Zürich | europe-west6-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Mailand | europe-west8-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Paris | europe-west9-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Berlin | europe-west10-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Turin | europe-west12-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Madrid | europe-southwest1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Asiatisch-pazifischer Raum | |||
Taiwan | asia-east1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Hongkong | asia-east2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Tokio | asia-northeast1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Osaka | asia-northeast2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Seoul | asia-northeast3-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Seoul | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery (außer Verbindungen) | |
Mumbai | asia-south1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Delhi | asia-south2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Singapur | asia-southeast1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Jakarta | asia-southeast2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Sydney | australia-southeast1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Melbourne | australia-southeast2-datacatalog.googleapis.com |
Tag-Vorlagen, von Nutzern erstellte Einträge, Data Lineage | |
Naher Osten | |||
Doha | me-central1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Dammam | me-central2-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge | |
Tel Aviv | me-west1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage | |
Afrika | |||
Johannesburg | africa-south1-datacatalog.googleapis.com |
Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge |
Mehrere Regionen | Multiregionaler Endpunkt | Unterstützte Ressourcen |
---|---|---|
Asien | asia-datacatalog.googleapis.com |
Tag-Vorlagen, von Nutzern erstellte Einträge, Data Lineage |
Europäische Union | eu-datacatalog.googleapis.com |
BigQuery, Tag-Vorlagen, von Nutzern erstellte Einträge, Data Lineage |
USA | us-datacatalog.googleapis.com |
BigQuery, Tag-Vorlagen, von Nutzern erstellte Einträge, Data Lineage |
BigQuery Omni-Regionen | Regionaler Endpunkt | Unterstützte Ressourcen |
---|---|---|
AWS Asien-Pazifik (Seoul) | aws-ap-northeast-2-datacatalog.googleapis.com |
Data Lineage |
AWS EU West (Irland) | aws-eu-west-1-datacatalog.googleapis.com |
Data Lineage |
AWS US East (N. Virginia) | aws-us-east-1-datacatalog.googleapis.com |
Data Lineage |
AWS US West (Oregon) | aws-us-west-2-datacatalog.googleapis.com |
Data Lineage |
Azure East US 2 (Virginia) | azure-eastus2-datacatalog.googleapis.com |
Data Lineage |
Multiregionen (USA, EU)
Multiregionen wie eu
und us
sind spezielle Regionen, in denen Data Catalog Ressourcen überall in diesen Regionen replizieren und bereitstellen kann.
Auf Ressourcen mit regionalen APIs zugreifen
Der Zugriff auf Ressourcen ist über regionale Endpunkte möglich, die zuvor unter Unterstützte Regionen aufgeführt sind. Mit Clientbibliotheken können Sie Endpunkte konfigurieren.
Aus Gründen der Abwärtskompatibilität werden regionale APIs weiterhin vom datacatalog.googleapis.com
-Endpunkt mit einigen Einschränkungen unterstützt (siehe HTTP-Batch-Unterstützung und gRPC-Unterstützung). 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-Clientbibliotheken verwenden:
- Java: Mit BatchRequest APIs aufrufen.
- Python: BatchHTTP-Anfrage zum Aufrufen von APIs verwenden.
- Ähnliche Bindungen gibt es auch für andere Bibliotheken (siehe die bibliotheksspezifische Dokumentation).
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. In den vorhandenen Cloud-Clientbibliotheken, die gRPC intern verwenden, ist diese Funktionalität bereits implementiert.