Diese Seite wurde von der Cloud Translation API übersetzt.

Data Catalog-regionen

Data Catalog-Ressourcen werden an mehreren Standorten weltweit gehostet, Regionen genannt werden. Eine Region ist ein bestimmter geografischer Standort, auf Ihre Ressourcen zugreifen. 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
Amerika
	Montreal	`northamerica-northeast1-datacatalog.googleapis.com`	Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
	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, vom Nutzer erstellte Einträge, Datenabfolge
	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, vom Nutzer erstellte Einträge, Datenabfolge
	Dallas	`us-south1-datacatalog.googleapis.com`	Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage
	Oregon	`us-west1-datacatalog.googleapis.com`	Tag-Vorlagen, von Nutzern erstellte Einträge, Data Lineage
	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, vom Nutzer erstellte Einträge, Datenabfolge
	Las Vegas	`us-west4-datacatalog.googleapis.com`	Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
Europa
	Warschau	`europe-central2-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
	Belgien	`europe-west1-datacatalog.googleapis.com`	Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage
	London	`europe-west2-datacatalog.googleapis.com`	Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
	Frankfurt	`europe-west3-datacatalog.googleapis.com`	Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage
	Niederlande	`europe-west4-datacatalog.googleapis.com`	Tag-Vorlagen, vom Nutzer erstellte Einträge, Datenabfolge
	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, vom Nutzer erstellte Einträge, Datenabfolge
	Paris	`europe-west9-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
	Turin	`europe-west12-datacatalog.googleapis.com`	Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage
	Madrid	`europe-southwest1-datacatalog.googleapis.com`	Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
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
	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, vom Nutzer erstellte Einträge, Datenabfolge
	Singapur	`asia-southeast1-datacatalog.googleapis.com`	Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
	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, vom Nutzer erstellte Einträge, Datenabfolge
Naher Osten
	Doha	`me-central1-datacatalog.googleapis.com`	Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge, Data Lineage
	Dammam	`me-central2-datacatalog.googleapis.com`	Tag-Vorlagen, BigQuery, vom Nutzer erstellte Einträge, Datenabfolge
	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, Data Lineage

Mehrere Regionen (USA, EU)

Multiregionen wie eu und us sind spezielle Regionen, in denen Data Catalog kann Ressourcen überall innerhalb von .

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, vom Nutzer erstellte Einträge, Datenabfolge
USA	`us-datacatalog.googleapis.com`	BigQuery, Tag-Vorlagen, von Nutzern erstellte Einträge, Data Lineage

BigQuery Omni-Regionen

	BigQuery Omni-Regionen	Regionaler Endpunkt	Unterstützte Ressourcen
AWS
	AWS – US East (N. Virginia)	`aws-us-east-1-datacatalog.googleapis.com`	BigQuery (außer Verbindungen), Data Lineage
	AWS – US West (Oregon)	`aws-us-west-2-datacatalog.googleapis.com`	BigQuery (außer Verbindungen), Datenabfolge
	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 (Irland)	`aws-eu-west-1-datacatalog.googleapis.com`	BigQuery (außer Verbindungen), Data Lineage
	AWS – Europa (Frankfurt)	`aws-eu-central-1-datacatalog.googleapis.com`	BigQuery (außer Verbindungen), Datenabfolge
Azure
	Azure – East US 2 (Virginia)	`azure-eastus2-datacatalog.googleapis.com`	BigQuery (außer Verbindungen), Data Lineage
	Azure – West US 2 (Washington)	`azure-westus2-datacatalog.googleapis.com`	Data Lineage

Auf Ressourcen mit regionalen APIs zugreifen

Auf Ressourcen kann über regionale Endpunkte (siehe Unterstützte Regionen) 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, mit einigen Einschränkungen (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-Assets in bestimmten Regionen befinden, sind die Suchfunktionen von Data Catalog global beschränkt. Nicht regional APIs wie SearchCatalog und LookupEntry geben Assets aus allen Regionen zurück, Sie können mit dem Endpunkt datacatalog.googleapis.com aufgerufen werden.

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 den Google API-Clientbibliotheken:
- Java: Mit BatchRequest APIs aufrufen.
- Python: BatchHTTP-Anfrage zum Aufrufen von APIs verwenden.
- Ähnliche Bindungen gibt es auch für andere Bibliotheken (siehe 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. Diese Funktion ist in den vorhandenen Cloud-Clientbibliotheken, die gRPC intern verwenden, bereits implementiert.