Ansicht SCHEMATA_LINKS

Die INFORMATION_SCHEMA.SCHEMATA_LINKS-Ansicht enthält eine Zeile für jedes verknüpfte Dataset. Ein verknüpftes Dataset ist mit einem freigegebenen Dataset in einem Projekt verknüpft, auf das der aktuelle Nutzer Zugriff hat.

Erforderliche Berechtigung

Zum Abfragen der INFORMATION_SCHEMA.SCHEMATA_LINKS-Ansicht benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.datasets.get auf Projektebene.

Jede der folgenden vordefinierten IAM-Rollen enthält die Berechtigungen, die Sie zum Abfragen der INFORMATION_SCHEMA.SCHEMATA_LINKS-Ansicht benötigen:

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer

Weitere Informationen zu BigQuery-Berechtigungen finden Sie unter Zugriffssteuerung mit IAM.

Schema

Die Ansicht INFORMATION_SCHEMA.SCHEMATA_LINKS hat das folgende Schema:

Spaltenname Datentyp Wert
CATALOG_NAME STRING Der Name des Projekts, das das Quell-Dataset enthält.
SCHEMA_NAME STRING Name des Quell-Datasets. Der Dataset-Name wird auch als datasetId bezeichnet.
LINKED_SCHEMA_CATALOG_NUMBER STRING Die Nummer des Projekts, das das verknüpfte Dataset enthält
LINKED_SCHEMA_CATALOG_NAME STRING Der Name des Projekts, das das verknüpfte Dataset enthält
LINKED_SCHEMA_NAME STRING Der Name des verknüpften Datasets. Der Dataset-Name wird auch als datasetId bezeichnet.
LINKED_SCHEMA_CREATION_TIME TIMESTAMP Die Zeit, zu der das verknüpfte Dataset erstellt wurde.
LINKED_SCHEMA_ORG_DISPLAY_NAME STRING Der Anzeigename der Organisation, in der das verknüpfte Dataset erstellt wird.

Bereich und Syntax

Für Abfragen dieser Ansicht muss ein Regions-Qualifier verwendet werden. Wenn Sie keinen Regions-Qualifier angeben, werden Metadaten aus der US-Region abgerufen. In der folgenden Tabelle wird der Regionsbereich für diese Ansicht erläutert:

Ansichtsname Ressourcenbereich Regionsbereich
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA_LINKS Projektebene US-Region
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_LINKS Projektebene REGION
Ersetzen Sie Folgendes:

  • Optional: PROJECT_ID: die ID Ihres Google Cloud-Projekts. Wenn keine Angabe erfolgt, wird das Standardprojekt verwendet.
  • REGION: ist ein beliebiger Dataset-Regionsname. Beispiel: region-us

Beispiele

In diesem Abschnitt sind Beispiele für das Abfragen der INFORMATION_SCHEMA.SCHEMATA_LINKS-Ansicht aufgeführt.

Beispiel: Alle verknüpften Datasets anhand eines anderen Projekts auflisten

Im folgenden Beispiel werden alle verknüpften Datasets relevant für ein anderes Projekt namens otherproject innerhalb der Region eu aufgelistet:

SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

Die entsprechende Ausgabe sieht etwa so aus: Einige Spalten werden weggelassen, um die Ausgabe zu vereinfachen.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| otherproject   | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg2               |
| otherproject   | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg2               |
| otherproject   | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg3               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

Beispiel: Alle verknüpften Datasets von einem freigegebenen Dataset auflisten

Im folgenden Beispiel werden alle verknüpften Datasets von einem freigegebenen Dataset namens sharedataset am multiregionalen Standort US aufgelistet:

SELECT * FROM INFORMATION_SCHEMA.SCHEMATA_LINKS WHERE schema_name = 'sharedataset';

Die entsprechende Ausgabe sieht etwa so aus: Einige Spalten werden weggelassen, um die Ausgabe zu vereinfachen.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | sharedataset| subscriptionproject1       |                 674999999291 | subscriptionld1    | subscriptionorg1               |
| myproject      | sharedataset| subscriptionproject2       |                 774999999292 | subscriptionld2    | subscriptionorg3               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+