カテゴリ：: Information Schema、テーブル関数

BIND_VALUES¶

注釈

この関数を使用するには、2025_06動作変更バンドルをアカウントで有効にする必要があります。このバンドルはデフォルトで無効になっています。

この INFORMATION_SCHEMA テーブル関数は、クエリで使用されたバインド変数の値に関する情報を返します。

構文¶

BIND_VALUES( <query_id> )

Copy

引数¶

query_id

1つ以上のバインド変数を含むクエリの文字列識別子。

Snowflakeクエリ IDs は、 01b71944-0001-b181-0000-0129032279f6 に似たユニークな文字列です。

NULL の場合は、空のテーブルが返されます。

使用上の注意¶

現在のユーザーが実行するクエリのバインド変数の値を返します。また、ユーザーのセッションで現在アクティブなロールまたは階層内の上位ロールが、クエリが実行されたユーザー管理ウェアハウスに対する MONITOR または OPERATE 権限を持っている場合は、任意のユーザーによって実行されたクエリのバインド変数値を返します。詳細については、仮想ウェアハウス権限をご参照ください。
Information Schemaテーブル関数を呼び出す場合、セッションには使用中の INFORMATION_SCHEMA スキーマまたは完全修飾の関数名が必要です。詳細については、 Snowflake Information Schema をご参照ください。
この関数は、過去7日間に実行されたすべてのクエリを返すことができます。
次のシナリオでは、この関数はバインド値を返さないか、エラーを返す可能性があります。
- ALLOW_BIND_VALUES_ACCESS アカウントレベルパラメーターが FALSE に設定されている。
- バインド変数が、Snowflakeストレージのしきい値を超える大きな値である。
- クエリに、Snowflakeストレージのしきい値を超える多数のバインド変数がある。
- バインド変数に機密データが含まれている。抽出と処理がベストエフォート方式で行われ、コンテキストによってデータが機密と見なされるかどうかが異なる。
- 関数呼び出しが、配列バインドを含むクエリを指定する。
- 関数呼び出しが、存在しないクエリを指定する。
- 関数呼び出しが、期限切れでクエリ履歴にないクエリを指定する。

出力¶

BIND_VALUES テーブル関数は、指定されたクエリで使用されるバインド変数ごとに1つの行を生成します。各行には次の列が含まれます。

列名	データ型	説明
QUERY_ID	VARCHAR	クエリの ID。
POSITION	NUMBER	位置バインド変数の場合は、バインド変数の位置。名前付きバインド変数の場合、フィールドは NULL です。
NAME	VARCHAR	名前付きバインド変数の場合は、バインド変数の名前。位置バインド変数の場合、フィールドは NULL です。
TYPE	VARCHAR	バインド変数のSnowflakeデータ型。
VALUE	VARCHAR	バインド変数の値。100,000文字を超える文字を含むバインド値は切り捨てられます。

例¶

バインド変数の値を取得するをご参照ください。