- Categorias:
BIND_VALUES¶
Nota
Para utilizar essa função, o pacote de alteração de comportamento 2025_06 deve estar ativado em sua conta. Este pacote fica desativado por padrão.
Esta função de tabela INFORMATION_SCHEMA retorna informações sobre os valores das variáveis de vinculação utilizadas em consultas.
Sintaxe¶
BIND_VALUES( <query_id> )
Argumentos¶
query_idO identificador de cadeia de caracteres de uma consulta que inclui uma ou mais variáveis de vinculação.
IDs de consulta Snowflake são cadeias de caracteres exclusivas que se assemelham a
01b71944-0001-b181-0000-0129032279f6.Se NULL, uma tabela vazia será retornada.
Notas de uso¶
Retorna valores de variáveis de vinculação para consultas executadas pelo usuário atual. Também retorna valores de variáveis de vinculação para consultas executadas por qualquer usuário quando a função atualmente ativa na sessão de um usuário, ou uma função superior em uma hierarquia, tem o privilégio MONITOR ou OPERATE nos warehouses gerenciados pelo usuário onde as consultas foram executadas. Para obter mais informações, consulte Privilégios de warehouse virtual.
Ao chamar uma função de tabela Information Schema, a sessão deve ter um esquema INFORMATION_SCHEMA em uso ou o nome da função deve ser totalmente qualificado. Para obter mais informações, consulte Snowflake Information Schema.
Esta função pode retornar todas as consultas executadas nos últimos sete dias.
Esta função pode não retornar os valores de vinculação ou pode retornar um erro nos seguintes cenários:
O parâmetro de nível de conta ALLOW_BIND_VALUES_ACCESS está definido como
FALSE.As variáveis de vinculação têm valores grandes que excedem os limites de armazenamento do Snowflake.
As consultas têm um grande número de variáveis de vinculação que excedem os limites de armazenamento do Snowflake.
As variáveis de vinculação contêm dados confidenciais. A extração e o processamento são feitos com base no melhor esforço, e a consideração de dados confidenciais depende do contexto.
A chamada de função especifica uma consulta que inclui vinculações de matriz.
A chamada de função especifica uma consulta que não existe.
A chamada de função especifica uma consulta que expirou e não está mais no histórico de consultas.
Saída¶
A função de tabela BIND_VALUES produz uma linha para cada variável de vinculação utilizada na consulta especificada. Cada linha contém as seguintes colunas:
Nome da coluna |
Tipo de dados |
Descrição |
|---|---|---|
QUERY_ID |
VARCHAR |
A ID da consulta. |
POSITION |
NUMBER |
Para variáveis de vinculação posicionais, a posição da variável de vinculação. O campo é NULL para variáveis de vinculação nomeadas. |
NAME |
VARCHAR |
Para variáveis de vinculação nomeadas, o nome da variável de vinculação. O campo é NULL para variáveis de vinculação posicionais. |
TYPE |
VARCHAR |
O tipo de dados Snowflake da variável de vinculação. |
VALUE |
VARCHAR |
O valor da variável de vinculação. Valores de vinculação que contêm mais de 100.000 caracteres são truncados. |