Ansicht SCHEMATA_LINKS

Die INFORMATION_SCHEMA.SCHEMATA_LINKS-Ansicht enthält eine Zeile für jedes verknüpfte Dataset, das über BigQuery Sharing freigegeben wird. Diese Ansicht enthält auch einzelne Ressourcen wie Tabellen oder Ansichten in einem Projekt, das über Data-Clean-Rooms freigegeben wird. In dieser Ansicht wird für jede einzelne Ressource im verknüpften Dataset eine Zeile angezeigt.

Erforderliche Berechtigung

Zum Abfragen der Ansicht INFORMATION_SCHEMA.SCHEMATA_LINKS 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 Datasetname 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 Datasetname 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.
shared_asset_id STRING Die ID des Assets, das über Data-Clean-Rooms freigegeben wird. Dieser Wert ist null, wenn link_type gleich REGULAR ist.
link_type STRING Der Typ des verknüpften Datasets. Mögliche Werte sind REGULAR oder DCR (Data-Clean-Rooms).

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 Trusted 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 für ein anderes Projekt auflisten

Im folgenden Beispiel werden alle verknüpften Datasets relevant für ein anderes Projekt namens otherproject am multiregionalen Standort 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 | linked_schema_creation_time | shared_asset_id | link_type |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|  otherproject      | source_dataset  | subscriptioproject1        |                974999999291  | linked_dataset     |  subscriptionorg1              |         2025-08-07 05:02:27 | NULL            | REGULAR   |
|  otherproject      | source_dataset1 | subscriptionproject2       |                974999999292  | test_dcr           |  subscriptionorg2              |         2025-08-07 10:08:50 | test_table      | DCR       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+

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 | linked_schema_creation_time | shared_asset_id | link_type |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|  myproject          | sharedataset   | subscriptionproject1       |                974999999291  | linked_dataset     |  subscriptionorg1              |         2025-08-07 05:02:27 | NULL            | REGULAR   |
|  myproject          | sharedataset   | subscriptionproject2       |                974999999292  | test_dcr           |  subscriptionorg2              |         2025-08-07 10:08:50 | test_table      | DCR       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+

Beispiel: Alle Ressourcen auflisten, die über einen Data-Clean-Room freigegeben wurden

Im folgenden Beispiel werden alle einzelnen Ressourcen wie Tabellen oder Ansichten aufgelistet, die über einen Data-Clean-Room aus einem anderen Projekt namens otherproject in der multiregionalen Region EU freigegeben werden:

SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS where link_type='DCR';

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 | linked_schema_creation_time | shared_asset_id | link_type |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|  otherproject       | sharedataset1  | subscriptionproject1       |                 974999999291 | test_dcr1          |  subscriptionorg1              |         2025-08-07 05:02:27 | test_view       | DCR       |
|  otherproject       | sharedataset2  | subscriptionproject2       |                 974999999292 | test_dcr2          |  subscriptionorg2              |         2025-08-07 10:08:50 | test_table      | DCR       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+