BIND_VALUES¶

备注

要使用此函数，必须在您的账户中启用 2025_06 行为变更捆绑包。此捆绑包默认禁用。

此 INFORMATION_SCHEMA 表函数返回有关查询中所用绑定变量的值的信息。

语法¶

BIND_VALUES( <query_id> )

Copy

query_id

包含一个或多个绑定变量的查询的字符串标识符。

Snowflake 查询 IDs 是类似 01b71944-0001-b181-0000-0129032279f6 的唯一字符串。

如果为 NULL，则返回一个空表。

返回当前用户运行的查询的绑定变量值。当用户会话中当前处于活动状态的角色或层次结构中的更高角色对运行查询的用户管理仓库具有 MONITOR 或 OPERATE 权限时，还会为任何用户运行的查询返回绑定变量值。有关更多信息，请参阅虚拟仓库权限。
当调用 Information Schema 表函数时，会话必须具有正在使用的 INFORMATION_SCHEMA 架构，或者函数名称必须是完全限定的。有关更多信息，请参阅 Snowflake Information Schema。
此函数可以返回过去七天内运行的所有查询。
在以下情况下，此函数可能不会返回绑定值，或者可能会返回错误：
- ALLOW_BIND_VALUES_ACCESS 账户级参数设置为 FALSE。
- 绑定变量的值较大，超过了 Snowflake 存储阈值。
- 查询具有大量超过 Snowflake 存储阈值的绑定变量。
- 绑定变量包含敏感数据。提取和处理是在尽力而为的基础上进行的，数据是否被视为敏感取决于具体上下文。
- 函数调用指定一个查询，其中包括数组绑定。
- 函数调用指定不存在的查询。
- 函数调用指定已过期且不再出现在查询历史记录中的查询。

BIND_VALUES 表函数为指定查询中使用的每个绑定变量生成一行。此表包含以下列：

列名称	数据类型	描述
QUERY_ID	VARCHAR	查询的 ID。
POSITION	NUMBER	对于位置绑定变量，为绑定变量的位置。对于命名绑定变量，该字段为 NULL。
NAME	VARCHAR	对于命名的绑定变量，为绑定变量的名称。对于位置绑定变量，该字段为 NULL。
TYPE	VARCHAR	绑定变量的 Snowflake 数据类型。
VALUE	VARCHAR	绑定变量的值。包含超过 100,000 个字符的绑定值将被截断。