Questa pagina è stata tradotta dall'API Cloud Translation.

Introduzione a INFORMATION_SCHEMA

Le viste INFORMATION_SCHEMA di BigQuery sono di sola lettura, definite dal sistema viste che forniscono informazioni sui metadati di oggetti strutturati. La tabella seguente elenca tutte le INFORMATION_SCHEMA viste che puoi 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`
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 vettoriali	`VECTOR_INDEXES` `VECTOR_INDEX_COLUMNS` `VECTOR_INDEX_OPTIONS`
Visualizzazioni	`VIEWS` `MATERIALIZED_VIEWS`
API Scrivi	`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 su INFORMATION_SCHEMA viste comporta un addebito minimo di 10 MB di elaborazione dati, anche se i byte elaborati dalla query sono inferiori a 10 MB. Il valore minimo è 10 MB importo di fatturazione per le query on demand. Per ulteriori informazioni, vedi Prezzi on demand.

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

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

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: devi specifica una località per esegui una query su una vista INFORMATION_SCHEMA. La query su una vista INFORMATION_SCHEMA non riesce e restituisce il seguente errore se le la località di esecuzione della query non corrisponde a quella del set di dati 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 INFORMATION_SCHEMA viste 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. È possibile utilizzare qualsiasi nome di località del set di dati REGION. Ad esempio, i seguenti qualificatori di regione sono validi:

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

Se presente, un qualificatore di regione limita i risultati ai in ogni località. Ad esempio, la seguente query restituisce i metadati per tutti i set di dati in una progetto nella località multiregionale US:

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

Le seguenti INFORMATION_SCHEMA viste non supportano i qualificatori per le regioni:

Se non viene specificato né un qualificatore di regione né un qualificatore di set di dati, ricevi un errore.

Le query su una vista INFORMATION_SCHEMA con qualifica per la regione vengono eseguite nella regione specificato, quindi non puoi scrivere una singola query per unire i dati da 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 di 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 INFORMATION_SCHEMA viste supportano i qualificatori del progetto. Se un progetto qualificatore non specificato, la vista utilizzerà per impostazione predefinita 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 GoogleSQL a riga di comando. INFORMATION_SCHEMA non supporta SQL precedente.
I risultati della query INFORMATION_SCHEMA non vengono memorizzati nella cache.
Non è possibile utilizzare INFORMATION_SCHEMA viste nelle istruzioni DDL.
INFORMATION_SCHEMA visualizzazioni non contengono informazioni su 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.