Riferimento alle procedure di sistema
BigQuery supporta le seguenti procedure di sistema, che possono essere utilizzate in modo simile alle stored procedure create dagli utenti.
BQ.ABORT_SESSION
Sintassi
CALL BQ.ABORT_SESSION([session_id]);
Descrizione
Termina la sessione corrente.
Facoltativamente, puoi specificare l'ID sessione, che ti consente di terminare una sessione se la procedura di sistema non viene chiamata da quella sessione.
Per saperne di più, consulta Termina sessioni.
BQ.JOBS.CANCEL
Sintassi
CALL BQ.JOBS.CANCEL(job);
Descrizione
Annulla un job in esecuzione.
Specifica il job come stringa con il formato '[project_id.]job_id'. Se esegui questa procedura di sistema da un progetto diverso da quello del job, devi includere l'ID progetto. Devi eseguire la procedura nella stessa località del job.
Per saperne di più, consulta Annullamento di un job.
BQ.CANCEL_INDEX_ALTERATION
Sintassi
CALL BQ.CANCEL_INDEX_ALTERATION(table_name, index_name);
Descrizione
Annulla una modifica di un indice della Ricerca o una ricostruzione di un indice vettoriale avviata dall'utente.
Specifica il nome della tabella come stringa con il formato '[project_id.]dataset.table' e il nome dell'indice come stringa.
Se esegui questa procedura di sistema da un progetto diverso da quello della tabella, devi includere l'ID progetto.
Devi eseguire questa procedura nella stessa località della tabella indicizzata. Per impostare la località della query, consulta Specifica le località.
Esempio
CALL BQ.CANCEL_INDEX_ALTERATION('my_project.my_dataset.indexed_table', 'my_index');
BQ.REFRESH_EXTERNAL_METADATA_CACHE
Sintassi
CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE(table_name [, [subdirectory_uri, …]]);
Descrizione
Aggiorna la cache dei metadati di una tabella BigLake o di una tabella degli oggetti.
Questa procedura non va a buon fine se la esegui su una tabella con la modalità di memorizzazione nella cache dei metadati impostata su AUTOMATIC.
Per eseguire questa procedura di sistema, devi disporre delle autorizzazioni bigquery.tables.update e bigquery.tables.updateData.
Specifica il nome della tabella come stringa con il formato
'[project_id.]dataset.table'. Se esegui questa procedura di sistema da un progetto diverso da quello della tabella, devi includere l'ID progetto.
Per le tabelle BigLake, puoi facoltativamente specificare una o più sottodirectory della directory dei dati della tabella in Cloud Storage nel formato 'gs://table_data_directory/subdirectory/.../'.
Affinché un aggiornamento selettivo funzioni correttamente, i parametri del percorso Cloud Storage devono includere un percorso specifico o un carattere jolly. Per saperne di più, consulta Supporto dei caratteri jolly per gli URI Cloud Storage.
In questo modo puoi aggiornare solo i metadati della tabella di queste sottodirectory ed evitare un'elaborazione non necessaria dei metadati.
Esempi
Per aggiornare tutti i metadati di una tabella:
CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE('myproject.test_db.test_table')
Per aggiornare in modo selettivo i metadati di una tabella BigLake:
CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE('myproject.test_db.test_table', ['gs://source/uri/sub/path/d1/*', 'gs://source/uri/sub/path/d2/*'])
Limitazione
- L'aggiornamento della cache dei metadati non è supportato per le tabelle a cui fanno riferimento i set di dati collegati su set di dati esterni.
- L'aggiornamento della cache dei metadati non deve essere utilizzato in una transazione con più istruzioni.
BQ.REFRESH_MATERIALIZED_VIEW
Sintassi
CALL BQ.REFRESH_MATERIALIZED_VIEW(view_name);
Descrizione
Aggiorna una vista materializzata.
Specifica il nome della vista materializzata come stringa con il formato '[project_id.]dataset.table'. Se esegui questa procedura di sistema da un progetto diverso dalla vista materializzata, devi includere l'ID progetto.
Per saperne di più, consulta Aggiornamento manuale.
BQ.SHOW_GRAPH_EXPAND_SCHEMA
Sintassi
CALL BQ.SHOW_GRAPH_EXPAND_SCHEMA( graph_name [, start_node [, flatten_results] ] , output_schema);
Descrizione
Completa la variabile output_schema che fornisci con lo schema della tabella restituita chiamando la TVF GRAPH_EXPAND su graph_name.
Ogni colonna restituita dalla TVF GRAPH_EXPAND rappresenta una proprietà nel grafico. L'output include il nome, il tipo e la modalità di ogni colonna. Se per la proprietà sono stati definiti una descrizione o dei sinonimi, questi vengono visualizzati in un campo description per la colonna. Se la proprietà definisce una misura, l'output include "is_measure":true per quel campo.
graph_name: unSTRINGcontenente il nome del grafo nel formato'[project_id.]dataset.graph'.start_node: unSTRINGfacoltativo che specifica il nome del nodo di partenza per l'esplorazione. Questo argomento è obbligatorio se il grafico ha più tabelle di nodi root.flatten_results: un valoreBOOLfacoltativo che indica come strutturare lo schema di output:TRUE: appiattisce tutte le proprietà di nodi e archi in colonne di primo livello nel formato<element>_<property>.TRUEè il valore predefinito.FALSE: restituisce le proprietà del nodo principale come colonne di primo livello senza prefisso e le tabelle adiacenti unite come colonneSTRUCT.
Esempi
DECLARE schema STRING; CALL BQ.SHOW_GRAPH_EXPAND_SCHEMA('my_project.my_dataset.my_graph', schema); SELECT schema;
L'output è simile al seguente:
{
"fields":[
{
"name":"Department_dept_name",
"type":"STRING",
"mode":"NULLABLE",
"description":
"{\"description\":\"The name of the academic department\",
\"synonyms\":[\"division\"]}"
},
{
"name":"Department_budget",
"type":"FLOAT",
"mode":"NULLABLE"
},
{
"name":"Department_total_budget",
"type":"FLOAT",
"mode":"NULLABLE",
"is_measure":true
}
]
}