Visualizzazione SCHEMATA_LINKS

La vista INFORMATION_SCHEMA.SCHEMATA_LINKS contiene una riga per ogni set di dati collegato condiviso tramite la condivisione BigQuery. Questa visualizzazione contiene anche risorse individuali, come tabelle o viste, in un progetto condiviso utilizzando le data clean room. Questa visualizzazione mostra una riga per ogni risorsa individuale nel set di dati collegato.

Autorizzazione obbligatoria

Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.SCHEMATA_LINKS, devi disporre dell'autorizzazione bigquery.datasets.get Identity and Access Management (IAM) a livello di progetto.

Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per eseguire query sulla visualizzazione INFORMATION_SCHEMA.SCHEMATA_LINKS:

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

Per saperne di più sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

La vista INFORMATION_SCHEMA.SCHEMATA_LINKS ha lo schema seguente:

Nome colonna Tipo di dati Valore
catalog_name STRING Il nome del progetto che contiene il set di dati di origine.
schema_name STRING Il nome del set di dati di origine. Il nome del set di dati è anche chiamato datasetId.
linked_schema_catalog_number STRING Il numero del progetto contenente il set di dati collegato.
linked_schema_catalog_name STRING Il nome del progetto contenente il set di dati collegato.
linked_schema_name STRING Il nome del set di dati collegato. Il nome del set di dati è anche chiamato datasetId.
linked_schema_creation_time TIMESTAMP L'ora in cui è stato creato il set di dati collegato.
linked_schema_org_display_name STRING Il nome visualizzato dell'organizzazione in cui viene creato il set di dati collegato.
shared_asset_id STRING L'ID della risorsa condivisa utilizzando le data clean room. Questo valore è null se link_type è REGULAR.
link_type STRING Il tipo di set di dati collegato. I valori possibili sono REGULAR o DCR (data clean room).

Ambito e sintassi

Le query su questa vista devono includere un qualificatore di regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati dalla regione Stati Uniti. La tabella seguente spiega l'ambito della regione per questa visualizzazione:

Visualizza nome Ambito risorsa Ambito regione
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA_LINKS Livello progetto Regione degli Stati Uniti
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_LINKS Livello progetto REGION
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo Trusted Cloud progetto. Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.

Esempi

Questa sezione elenca esempi di query per la visualizzazione INFORMATION_SCHEMA.SCHEMATA_LINKS.

Esempio: elenca tutti i set di dati collegati a un altro progetto

L'esempio seguente elenca tutti i set di dati collegati a un altro progetto denominato otherproject nella multiregione EU:

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

L'output è simile al seguente. Alcune colonne vengono omesse per semplificare l'output.

+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    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       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+

Esempio: elenca tutti i set di dati collegati in base a un set di dati condiviso

L'esempio seguente elenca tutti i set di dati collegati a un set di dati condiviso denominato sharedataset nella multiregione US:

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

L'output è simile al seguente. Alcune colonne vengono omesse per semplificare l'output.


+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    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       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+

Esempio: elencare tutte le risorse condivise utilizzando una data clean room

L'esempio seguente elenca tutte le singole risorse, come tabelle o viste, condivise utilizzando una data clean room di un altro progetto denominato otherproject all'interno della multiregione EU:

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

L'output è simile al seguente. Alcune colonne vengono omesse per semplificare l'output.

+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    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       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+