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

Ihre aktuelle Sitzung wird beendet.

Optional können Sie die Sitzungs-ID angeben. Damit können Sie eine Sitzung beenden, wenn der Systemvorgang 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.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. So können Sie nur die Tabellenmetadaten aus diesen Unterverzeichnissen aktualisieren und 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-Caches 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.