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`
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`
Cerca indici	`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 *BY_PROJECT visualizzazioni, 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. Il valore minimo è 10 MB importo di fatturazione per le query on demand. Per ulteriori informazioni, consulta 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 addebitati i costi di archiviazione per le viste 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 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 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 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, ricevi 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 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.
Le visualizzazioni INFORMATION_SCHEMA non contengono informazioni sui set di dati nascosti.
INFORMATION_SCHEMA query con qualificatori di regione potrebbero includere metadati da risorse in quella regione set di dati eliminati che rientrano nella tua finestra di spostamento cronologico.
Quando elenchi le risorse da una vista INFORMATION_SCHEMA, le autorizzazioni vengono selezionata solo a livello principale, non a livello di singola riga. Pertanto, Qualsiasi norma di negazione (anteprima) che sceglie come target in modo condizionale una una singola riga che utilizza tag viene ignorata.