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, devi disporre dell'autorizzazione INFORMATION_SCHEMA.SCHEMATA_LINKS Identity and Access Management (IAM) a livello di progetto.bigquery.datasets.get

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 ulteriori informazioni 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 contenente 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 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 è 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 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: 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 chiamato 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: 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               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+