Kategorien:: Information Schema, Tabellenfunktionen

BIND_VALUES¶

Bemerkung

Um diese Funktion verwenden zu können, muss Verhaltensänderungs-Bundle 2025_06 in Ihrem Konto aktiviert sein. Dieses Bundle ist standardmäßig deaktiviert.

Diese INFORMATION_SCHEMA-Tabellenfunktion gibt Informationen zu den Werten von Bindungsvariablen zurück, die in Abfragen verwendet werden.

Syntax¶

BIND_VALUES( <query_id> )

Copy

Argumente¶

query_id

Der Zeichenfolgenbezeichner einer Abfrage, die eine oder mehrere Bindungsvariablen enthält.

Snowflake-Abfragen IDs sind eindeutige Zeichenfolgen, die wie 01b71944-0001-b181-0000-0129032279f6 aussehen.

Wenn der Wert NULL ist, wird eine leere Tabelle zurückgegeben.

Nutzungshinweise¶

Gibt Bindungsvariablenwerte für Abfragen zurück, die vom aktuellen Benutzenden ausgeführt werden. Gibt auch Bindungsvariablenwerte für Abfragen zurück, die von einem beliebigen Benutzenden ausgeführt werden, wenn die Rolle derzeit in der Sitzung eines Benutzenden aktiv ist, oder eine höhere Rolle in einer Hierarchie, über die MONITOR- oder OPERATE-Berechtigung für die benutzerverwalteten Warehouses verfügt, in denen die Abfragen ausgeführt wurden. Weitere Informationen dazu finden Sie unter Berechtigungen von virtuellen Warehouses.
Beim Aufrufen einer Information Schema-Tabellenfunktion muss die Sitzung über ein aktives INFORMATION_SCHEMA-Schema verfügen oder der Funktionsname muss vollqualifiziert sein. Weitere Informationen dazu finden Sie unter Snowflake Information Schema.
Diese Funktion kann alle Abfragen zurückgeben, die in den letzten sieben Tagen ausgeführt wurden.
Diese Funktion gibt in den folgenden Szenarios möglicherweise nicht die Bindungswerte bzw. einen Fehler zurück:
- Der Parameter ALLOW_BIND_VALUES_ACCESS auf Kontoebene ist auf FALSE gesetzt.
- Die Bindungsvariablen haben große Werte, die die Snowflake-Speicherschwellenwerte überschreiten.
- Die Abfragen haben eine große Anzahl von Bindungsvariablen, die die Snowflake-Speicherschwellenwerte überschreiten.
- Die Bindungsvariablen enthalten sensible Daten. Die Extraktion und Verarbeitung erfolgt auf bestmöglicher Basis. Ob Daten als sensibel gelten, hängt vom Kontext ab.
- Der Funktionsaufruf gibt eine Abfrage an, die -Array-Bindungen enthält.
- Der Funktionsaufruf gibt eine Abfrage an, die nicht existiert.
- Der Funktionsaufruf gibt eine Abfrage an, die abgelaufen ist und sich nicht mehr im Abfrageverlauf befindet.

Ausgabe¶

Die BIND_VALUES-Tabellenfunktion erzeugt eine Zeile für jede Bindungsvariable, die in der angegebenen Abfrage verwendet wird. Jede Zeile enthält die folgenden Spalten:

Spaltenname	Datentyp	Beschreibung
QUERY_ID	VARCHAR	Die ID der Abfrage.
POSITION	NUMBER	Bei positionsbezogenen Bindungsvariablen die Position der Bindungsvariablen. Das Feld ist NULL für benannte Bindungsvariablen.
NAME	VARCHAR	Bei benannten Bindungsvariablen der Name der Bindungsvariablen. Das Feld ist NULL für positionsbezogene Bindungsvariablen.
TYPE	VARCHAR	Der Snowflake-Datentyp der Bindungsvariablen.
VALUE	VARCHAR	Der Wert der Bindungsvariablen. Bindungswerte, die mehr als 100.000 Zeichen enthalten, werden abgeschnitten.

Beispiele¶

Siehe Abrufen der Werte der Bindungsvariablen.