Referenz zu Systemprozeduren
BigQuery unterstützt die folgenden Systemprozeduren, die ähnlich wie vom Nutzer erstellte gespeicherte Prozeduren verwendet werden können.
BQ.ABORT_SESSION
Syntax
CALL BQ.ABORT_SESSION([session_id]);
Beschreibung
Beendet die aktuelle Sitzung.
Optional können Sie die Sitzungs-ID angeben, mit der Sie eine Sitzung beenden können, wenn die Systemprozedur nicht von dieser Sitzung aufgerufen wird.
Weitere Informationen finden Sie unter Sitzungen beenden.
BQ.JOBS.CANCEL
Syntax
CALL BQ.JOBS.CANCEL(job);
Beschreibung
Bricht einen laufenden Job ab
Geben Sie den Job als String im Format '[project_id.]job_id' an. Wenn Sie dieses Systemverfahren von einem anderen Projekt als dem Job aus ausführen, müssen Sie die Projekt-ID angeben. Die Prozedur muss am selben Ort wie der Job ausgeführt werden.
Weitere Informationen erhalten Sie auch unter Job abbrechen.
BQ.CANCEL_INDEX_ALTERATION
Syntax
CALL BQ.CANCEL_INDEX_ALTERATION(table_name, index_name);
Beschreibung
Bricht eine vom Nutzer initiierte Änderung eines Suchindex oder eine Neuerstellung eines Vektorindex ab.
Geben Sie den Namen der Tabelle als String im Format '[project_id.]dataset.table' und den Indexnamen als String an.
Wenn Sie dieses Systemverfahren von einem anderen Projekt als der Tabelle aus ausführen, müssen Sie die Projekt-ID angeben.
Sie müssen diese Prozedur am selben Ort wie die indexierte Tabelle ausführen. Informationen zum Festlegen des Speicherorts Ihrer Abfrage finden Sie unter Standorte angeben.
Beispiel
CALL BQ.CANCEL_INDEX_ALTERATION('my_project.my_dataset.indexed_table', 'my_index');
BQ.REFRESH_EXTERNAL_METADATA_CACHE
Syntax
CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE(table_name [, [subdirectory_uri, …]]);
Beschreibung
Aktualisiert den Metadaten-Cache einer BigLake-Tabelle oder einer Objekttabelle.
Dieser Vorgang schlägt fehl, wenn Sie ihn für eine Tabelle ausführen, deren Metadaten-Caching-Modus auf AUTOMATIC gesetzt ist.
Zum Ausführen dieses Systemverfahrens benötigen Sie die Berechtigungen bigquery.tables.update und bigquery.tables.updateData.
Geben Sie den Namen der Tabelle als String im Format '[project_id.]dataset.table' an. Wenn Sie dieses Systemverfahren von einem anderen Projekt als der Tabelle aus ausführen, müssen Sie die Projekt-ID angeben.
Bei BigLake-Tabellen können Sie optional ein oder mehrere Unterverzeichnisse des Tabellendatenverzeichnisses in Cloud Storage im Format 'gs://table_data_directory/subdirectory/.../' angeben.
Damit eine selektive Aktualisierung ordnungsgemäß funktioniert, müssen die Cloud Storage-Pfadparameter entweder einen bestimmten Pfad oder einen Platzhalter enthalten. Weitere Informationen finden Sie unter Unterstützung von Platzhaltern für Cloud Storage-URIs.
So können Sie nur die Tabellenmetadaten aus diesen Unterverzeichnissen aktualisieren und so unnötige Metadatenverarbeitung vermeiden.
Beispiele
So aktualisieren Sie alle Metadaten für eine Tabelle:
CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE('myproject.test_db.test_table')
So aktualisieren Sie die Metadaten für eine BigLake-Tabelle selektiv:
CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE('myproject.test_db.test_table', ['gs://source/uri/sub/path/d1/*', 'gs://source/uri/sub/path/d2/*'])
Beschränkung
- Die Aktualisierung des Metadaten-Cache wird für Tabellen, auf die von verknüpften Datasets über externe Datasets verwiesen wird, nicht unterstützt.
- Die Aktualisierung des Metadaten-Cache sollte nicht in einer Transaktion mit mehreren Anweisungen verwendet werden.
BQ.REFRESH_MATERIALIZED_VIEW
Syntax
CALL BQ.REFRESH_MATERIALIZED_VIEW(view_name);
Beschreibung
Aktualisiert eine materialisierte Ansicht.
Geben Sie den Namen der materialisierten Ansicht als String im Format '[project_id.]dataset.table' an. Wenn Sie dieses Systemverfahren von einem anderen Projekt als der materialisierten Ansicht ausführen, müssen Sie die Projekt-ID angeben.
Weitere Informationen finden Sie unter Manuelle Aktualisierung.
BQ.SHOW_GRAPH_EXPAND_SCHEMA
Syntax
CALL BQ.SHOW_GRAPH_EXPAND_SCHEMA( graph_name [, start_node [, flatten_results] ] , output_schema);
Beschreibung
Füllt die von Ihnen angegebene Variable output_schema mit dem Schema der Tabelle, die durch Aufrufen der GRAPH_EXPAND-TVF für graph_name zurückgegeben wird.
Jede von der TVF GRAPH_EXPAND zurückgegebene Spalte wird im Diagramm als Attribut dargestellt. Die Ausgabe enthält den Namen, den Typ und den Modus für jede Spalte. Wenn für das Attribut eine Beschreibung oder Synonyme definiert sind, werden diese in einem description-Feld für die Spalte angezeigt. Wenn das Attribut einen Messwert definiert, enthält die Ausgabe "is_measure":true für dieses Feld.
graph_name: EinSTRING, der den Namen des Diagramms im Format'[project_id.]dataset.graph'enthält.start_node: Ein optionalerSTRING, der den Namen des Startknotens für die Durchsuchung angibt. Dieses Argument ist erforderlich, wenn der Graph mehrere Stammknotentabellen hat.flatten_results: Ein optionalerBOOL-Wert, der angibt, wie das Ausgabeschema strukturiert werden soll:TRUE: Reduziert alle Knoten- und Kantenattribute auf Spalten der obersten Ebene im Format<element>_<property>.TRUEist der Standardwert.FALSE: Gibt die Eigenschaften des Stammknotens als Spalten oberster Ebene ohne Präfix und verknüpfte Nachbartabellen alsSTRUCT-Spalten zurück.
Beispiele
DECLARE schema STRING; CALL BQ.SHOW_GRAPH_EXPAND_SCHEMA('my_project.my_dataset.my_graph', schema); SELECT schema;
Die Ausgabe sieht dann ungefähr so aus:
{
"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
}
]
}