Questa pagina è stata tradotta dall'API Cloud Translation.

Introduzione a INFORMATION_SCHEMA

Le visualizzazioni INFORMATION_SCHEMA di BigQuery sono visualizzazioni predefinite di sola lettura che forniscono informazioni sui metadati degli oggetti BigQuery. La tabella seguente elenca tutte le visualizzazioni INFORMATION_SCHEMA su cui puoi eseguire query per recuperare le informazioni sui metadati:

Tipo di risorsa	Visualizzazione INFORMATION_SCHEMA
Controllo degli accessi	`OBJECT_PRIVILEGESscience`
BI Engine	`BI_CAPACITIES` `BI_CAPACITY_CHANGES`
Configurazioni	`EFFECTIVE_PROJECT_OPTIONS` `ORGANIZATION_OPTIONS` `ORGANIZATION_OPTIONS_CHANGES` `PROJECT_OPTIONS` `PROJECT_OPTIONS_CHANGES`
Set di dati	`SCHEMATA SCHEMATA_LINKS SCHEMATA_OPTIONS SHARED_DATASET_USAGE SCHEMATA_REPLICASscience SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATIONscience`
Job	`JOBS_BY_PROJECT^†` `JOBS_BY_USER` `JOBS_BY_FOLDER` `JOBS_BY_ORGANIZATION`
Job per intervallo di tempo	`JOBS_TIMELINE_BY_PROJECT^†` `JOBS_TIMELINE_BY_USER` `JOBS_TIMELINE_BY_FOLDER` `JOBS_TIMELINE_BY_ORGANIZATION`
Consigli e approfondimenti	`INSIGHTS` `RECOMMENDATIONS` `RECOMMENDATIONS_BY_ORGANIZATION`
Prenotazioni	`ASSIGNMENTS_BY_PROJECT^†` `ASSIGNMENT_CHANGES_BY_PROJECT^†` `CAPACITY_COMMITMENTS_BY_PROJECT^†` `CAPACITY_COMMITMENT_CHANGES_BY_PROJECT^†` `RESERVATIONS_BY_PROJECT^†` `RESERVATION_CHANGES_BY_PROJECT^†` `RESERVATIONS_TIMELINE_BY_PROJECT^†`
Routine	`PARAMETERS` `ROUTINES` `ROUTINE_OPTIONS`
Indici di ricerca	`SEARCH_INDEXES` `SEARCH_INDEX_COLUMNS`
Sessioni	`SESSIONS_BY_PROJECT^†` `SESSIONS_BY_USER`
Streaming	`STREAMING_TIMELINE_BY_PROJECT^†` `STREAMING_TIMELINE_BY_FOLDER` `STREAMING_TIMELINE_BY_ORGANIZATION`
Tabelle	`COLUMNS` `COLUMN_FIELD_PATHS` `CONSTRAINT_COLUMN_USAGE` `KEY_COLUMN_USAGE` `PARTITIONSscience` `TABLES` `TABLE_OPTIONS` `TABLE_CONSTRAINTS` `TABLE_SNAPSHOTS` `TABLE_STORAGE_BY_PROJECT^†` `TABLE_STORAGE_BY_ORGANIZATION` `TABLE_STORAGE_USAGE_TIMELINEscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATIONscience`
Indici di vettori	`VECTOR_INDEXES` `VECTOR_INDEX_COLUMNS` `VECTOR_INDEX_OPTIONS`
Visualizzazioni	`VIEWS` `MATERIALIZED_VIEWS`
API Write	`WRITE_API_TIMELINE_BY_PROJECT^†` `WRITE_API_TIMELINE_BY_FOLDER` `WRITE_API_TIMELINE_BY_ORGANIZATION`

^† Per le visualizzazioni *BY_PROJECT, il suffisso BY_PROJECT è facoltativo. Ad esempio, le query su INFORMATION_SCHEMA.JOBS_BY_PROJECT e INFORMATION_SCHEMA.JOBS restituisce gli stessi risultati.

Prezzi

Per i progetti che utilizzano i prezzi on demand, le query sulle visualizzazioni INFORMATION_SCHEMA hanno un costo minimo di 10 MB per l'elaborazione dei dati, anche se i byte elaborati dalla query sono inferiori a 10 MB. 10 MB è l'importo minimo per le query on demand. Per ulteriori informazioni, consulta Prezzi on demand.

Per i progetti che utilizzano i prezzi basati sulla capacità, le query sulle viste e sulle tabelle INFORMATION_SCHEMA consumano gli slot BigQuery acquistati. Per ulteriori informazioni, consulta la sezione Prezzi basati sulla capacità.

Poiché le query INFORMATION_SCHEMA non vengono memorizzate nella cache, ti viene addebitato un importo ogni volta che esegui una query INFORMATION_SCHEMA, anche se il testo della query è lo stesso ogni volta.

Non ti vengono addebitate tariffe di archiviazione per le visualizzazioni di INFORMATION_SCHEMA.

Sintassi

Una vista INFORMATION_SCHEMA deve essere qualificata con un set di dati o una regione.

Nota: per eseguire query su una visualizzazione INFORMATION_SCHEMA, devi specificare una località. La query di una vista INFORMATION_SCHEMA non va a buon fine con il seguente errore se la località dell'esecuzione della query non corrisponde a quella del set di dati o del qualificatore regionale utilizzato:

Table myproject: region-us.INFORMATION_SCHEMA.[VIEW] not found in location US

Qualificatore del set di dati

Se presente, un qualificatore del set di dati limita i risultati al set di dati specificato. Ad esempio:

-- Returns metadata for tables in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLES;

Le seguenti visualizzazioni INFORMATION_SCHEMA supportano i qualificatori dei set di dati:

COLUMNS
COLUMN_FIELD_PATHS
MATERIALIZED_VIEWS
PARAMETERS
PARTITIONS
ROUTINES
ROUTINE_OPTIONS
TABLES
TABLE_OPTIONS
VIEWS

Qualificatore regione

I qualificatori di regione sono rappresentati utilizzando una sintassi region-REGION. Per REGION puoi utilizzare qualsiasi nome della località del set di dati. Ad esempio, i seguenti qualificatori di regione sono validi:

region-us
region-asia-east2
region-europe-north1

Se presente, un qualificatore della regione limita i risultati alla località specificata. Ad esempio, la seguente query restituisce i metadati di tutti i set di dati di un progetto nella regione multipla US:

-- Returns metadata for all datasets in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA;

Le seguenti visualizzazioni INFORMATION_SCHEMA non supportano i qualificatori di regione:

Se non viene specificato né un qualificatore di regione né un qualificatore di set di dati, verrà visualizzato un errore.

Le query relative a una visualizzazione INFORMATION_SCHEMA con regione specificata vengono eseguite nella regione da te specificata, il che significa che non puoi scrivere una singola query per unire i dati delle visualizzazioni in regioni diverse. Per combinare le INFORMATION_SCHEMA visualizzazioni di più regioni, scrivi i risultati delle query nelle tabelle, quindi copia le tabelle o sposta i set di dati in una regione comune.

Qualificatore progetto

Se presente, un qualificatore del progetto limita i risultati al progetto specificato. Ad esempio:

-- Returns metadata for the specified project and region.
SELECT * FROM myProject.`region-us`.INFORMATION_SCHEMA.TABLES;

-- Returns metadata for the specified project and dataset.
SELECT * FROM myProject.myDataset.INFORMATION_SCHEMA.TABLES;

Tutte le visualizzazioni INFORMATION_SCHEMA supportano i qualificatori del progetto. Se non viene specificato un qualificatore del progetto, per impostazione predefinita la visualizzazione sarà il progetto in cui viene eseguita la query.

La specifica di un qualificatore del progetto per le visualizzazioni a livello di organizzazione (ad es. STREAMING_TIMELINE_BY_ORGANIZATION) non influisce sui risultati.

Limitazioni

Le query INFORMATION_SCHEMA di BigQuery devono essere in sintassi GoogleSQL. INFORMATION_SCHEMA non supporta SQL precedente.
I risultati della query INFORMATION_SCHEMA non vengono memorizzati nella cache.
Le viste INFORMATION_SCHEMA non possono essere utilizzate nelle istruzioni DDL.
Le visualizzazioni INFORMATION_SCHEMA non contengono informazioni sui set di dati nascosti.
Le query INFORMATION_SCHEMA con i qualificatori di regione potrebbero includere i metadati delle risorse nella regione in questione provenienti da set di dati eliminati che rientrano nel periodo di viaggio nel tempo.
Quando elenchi le risorse da una visualizzazione INFORMATION_SCHEMA, le autorizzazioni vengono controllate solo a livello di elemento principale, non a livello di singola riga. Pertanto, qualsiasi criterio di rifiuto (anteprima) che abbia come target una singola riga utilizzando i tag viene ignorato.