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
Toronto northamerica-northeast2-datacatalog.googleapis.com Tag-Vorlagen, von Nutzern 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
Tulsa us-central2-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
North Virginia us-east4-datacatalog.googleapis.com Tag-Vorlagen, BigQuery, von Nutzern erstellte Einträge
Oregon us-west1-datacatalog.googleapis.com Tag-Vorlagen, von Nutzern 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, von Nutzern 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 Nutzern erstellte BigQuery-Einträge
Hong Kong 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, von Nutzern 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, von Nutzern 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, von Nutzern erstellte Einträge
Europäische Union eu-datacatalog.googleapis.com BigQuery, Tag-Vorlagen, von Nutzern erstellte Einträge
USA us-datacatalog.googleapis.com BigQuery, Tag-Vorlagen, von Nutzern 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. Die vorhandenen Google Cloud-Clientbibliotheken, die intern gRPC verwenden, haben diese Funktion bereits implementiert.