Data Catalog-regionen

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.

Wichtig: Data Catalog garantiert keine höhere Verfügbarkeit oder Zuverlässigkeit für Multi-Regionen im Vergleich zu anderen Google Cloud-Regionen. Multi-Regionen sollten genau wie andere Regionen behandelt werden.

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.

Wichtig :Nicht regionale APIs können nicht von regionalen Endpunkten aus verwendet werden.

HTTP batch support

Hinweis: Standard-Cloud-Clientbibliotheken verwenden gRPC und unterstützen keine HTTP-Batches. Wenn Sie diese Bibliotheken verwenden, können Sie diesen Abschnitt ignorieren.

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.