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`	Der 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`

Dabei gilt:

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

Hinweis: Sie müssen den Standort angeben, um die INFORMATION_SCHEMA-Ansichten abzufragen, und der Standort der Abfrageausführung muss mit der Region der Ansicht INFORMATION_SCHEMA übereinstimmen.

Beispiele

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

Beispiel: Alle verknüpften Datasets von einem anderen Projekt 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               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+