Visualizzazione SCHEMATA_LINKS

La vista INFORMATION_SCHEMA.SCHEMATA_LINKS contiene una riga per ogni set di dati collegato. Un set di dati collegato si collega a un set di dati condiviso in un progetto a cui ha accesso l'utente corrente.

Autorizzazione obbligatoria

Per eseguire una query sulla vista 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 vista INFORMATION_SCHEMA.SCHEMATA_LINKS:

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

Per ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

La vista INFORMATION_SCHEMA.SCHEMATA_LINKS ha il seguente schema:

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 è indicato anche come datasetId.
LINKED_SCHEMA_CATALOG_NUMBER STRING Il numero del progetto che contiene il set di dati collegato.
LINKED_SCHEMA_CATALOG_NAME STRING Il nome del progetto che contiene il set di dati collegato.
LINKED_SCHEMA_NAME STRING Il nome del set di dati collegato. Il nome del set di dati è indicato anche come 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.

Ambito e sintassi

Le query in questa vista devono includere un qualificatore regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati dalla regione degli 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 A livello di progetto Regione USA
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_LINKS A livello di progetto REGION
Sostituisci quanto segue:

  • (Facoltativo) PROJECT_ID: l'ID del tuo progetto Google Cloud. 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 per eseguire query sulla vista INFORMATION_SCHEMA.SCHEMATA_LINKS.

Esempio: elenco di tutti i set di dati collegati in base a un altro progetto

L'esempio seguente elenca tutti i set di dati collegati rispetto a un altro progetto denominato otherproject all'interno della regione 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 |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| otherproject   | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg2               |
| otherproject   | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg2               |
| otherproject   | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg3               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

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

L'esempio seguente elenca tutti i set di dati collegati da un set di dati condiviso denominato sharedataset nella località multiregionale 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 |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | sharedataset| subscriptionproject1       |                 674999999291 | subscriptionld1    | subscriptionorg1               |
| myproject      | sharedataset| subscriptionproject2       |                 774999999292 | subscriptionld2    | subscriptionorg3               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+