visualizzazione SCHEMATA_LINKS

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

Autorizzazione obbligatoria

Per eseguire query sulla vista INFORMATION_SCHEMA.SCHEMATA_LINKS, è necessario il bigquery.datasets.get Autorizzazione Identity and Access Management (IAM) nel progetto livello.

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

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

Per ulteriori informazioni sulle autorizzazioni BigQuery, consulta Accesso controllo 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 è chiamato anche 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 è chiamato anche 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 su questa vista devono includere un qualificatore della regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati dalla regione degli Stati Uniti. La tabella seguente illustra 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 progetto Google Cloud. Se non viene specificato, viene utilizzato il progetto predefinito.

Esempi

Questa sezione elenca degli esempi per eseguire query su INFORMATION_SCHEMA.SCHEMATA_LINKS vista.

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

L'esempio seguente elenca tutti i set di dati collegati a fronte di un altro progetto denominato otherproject nella 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: elencare 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 chiamato sharedataset nella regione multipla 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               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+