Visualizzazione SCHEMATA_OPTIONS
La visualizzazione INFORMATION_SCHEMA.SCHEMATA_OPTIONS
contiene una riga per ogni opzione impostata in ogni set di dati di un progetto.
Prima di iniziare
Per eseguire query sulla visualizzazione SCHEMATA_OPTIONS
per i metadati dei set di dati, 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 visualizzare la visualizzazione SCHEMATA_OPTIONS
:
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
Quando esegui una query nella visualizzazioneINFORMATION_SCHEMA.SCHEMATA_OPTIONS
, i risultati della query contengono una riga per ogni opzione impostata in ogni set di dati di un progetto.
La vista INFORMATION_SCHEMA.SCHEMATA_OPTIONS
ha lo schema seguente:
Nome colonna | Tipo di dati | Valore |
---|---|---|
CATALOG_NAME |
STRING |
Il nome del progetto contenente il set di dati |
SCHEMA_NAME |
STRING |
Il nome del set di dati, chiamato anche datasetId |
OPTION_NAME |
STRING |
Il nome dell'opzione. Per un elenco delle opzioni supportate, consulta l'elenco delle opzioni dello schema.
L'opzione |
OPTION_TYPE |
STRING |
Il tipo di dati dell'opzione |
OPTION_VALUE |
STRING |
Il valore dell'opzione |
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_OPTIONS |
Livello progetto | Regione degli Stati Uniti |
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS |
Livello progetto | REGION |
Facoltativo: PROJECT_ID
: l'ID del tuo progetto Google Cloud. Se non viene specificato, viene utilizzato il progetto predefinito.
REGION
: qualsiasi nome della regione del set di dati.
Ad esempio: `region-us`
.
Esempio
-- Returns metadata for datasets in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA_OPTIONS;
Esempi
Recupera la data e l'ora di scadenza predefinita della tabella per tutti i set di dati del progetto
Per eseguire la query su un progetto diverso da quello predefinito, aggiungi l'ID progetto al set di dati nel seguente formato:
`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS
`myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS
.
SELECT * FROM INFORMATION_SCHEMA.SCHEMATA_OPTIONS WHERE option_name = 'default_table_expiration_days';
Il risultato è simile al seguente:
+----------------+---------------+-------------------------------+-------------+---------------------+ | catalog_name | schema_name | option_name | option_type | option_value | +----------------+---------------+-------------------------------+-------------+---------------------+ | myproject | mydataset3 | default_table_expiration_days | FLOAT64 | 0.08333333333333333 | | myproject | mydataset2 | default_table_expiration_days | FLOAT64 | 90.0 | | myproject | mydataset1 | default_table_expiration_days | FLOAT64 | 30.0 | +----------------+---------------+-------------------------------+-------------+---------------------+
Recupera le etichette per tutti i set di dati del progetto
Per eseguire la query su un progetto diverso da quello predefinito, aggiungi l'ID progetto al set di dati nel seguente formato:
`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS
`myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS
.
SELECT * FROM INFORMATION_SCHEMA.SCHEMATA_OPTIONS WHERE option_name = 'labels';
Il risultato è simile al seguente:
+----------------+---------------+-------------+---------------------------------+------------------------+ | catalog_name | schema_name | option_name | option_type | option_value | +----------------+---------------+-------------+---------------------------------+------------------------+ | myproject | mydataset1 | labels | ARRAY<STRUCT<STRING, STRING>> | [STRUCT("org", "dev")] | | myproject | mydataset2 | labels | ARRAY<STRUCT<STRING, STRING>> | [STRUCT("org", "dev")] | +----------------+---------------+-------------+---------------------------------+------------------------+