Variáveis de vinculação: não são mais ignoradas como parâmetros para algumas funções de tabela integradas¶
Atenção
Essa mudança de comportamento está no pacote 2023_08.
Para saber o status atual do pacote, consulte Histórico do pacote.
No Script Snowflake, em um driver ou no SQL REST API, você pode usar variáveis de vinculação nas instruções SQL. (Para exemplos de uso de variáveis de vinculação, consulte Como usar uma variável em uma instrução SQL (vinculação), Vinculação de dados e Como usar variáveis de vinculação em uma instrução.
Essa mudança de comportamento afeta os casos em que você passa uma variável de vinculação diretamente como um dos argumentos de função de tabela integrados listados abaixo. O comportamento muda da seguinte maneira:
- Antes da mudança:
A variável de vinculação é ignorada e o argumento não é passado para a função de tabela.
- AFter a mudança:
A variável de vinculação é passada como argumento para a função de tabela.
Observe que isso não afeta os casos em que você passa uma variável de vinculação para outra função antes de passar o resultado para um argumento de função de tabela. Por exemplo, se você estiver chamando a função COPY_HISTORY, essa alteração afetará os casos em que você passa uma variável de vinculação diretamente como o argumento START_TIME:
COPY_HISTORY( START_TIME=> ?, ...
Isso não afeta os casos em que você passa primeiro a variável de vinculação para outra função interna:
COPY_HISTORY( START_TIME=> DATEADD('days', ?, ...
Se quiser preservar o comportamento antes da alteração, você pode reescrever seu código para evitar passar o argumento que usa a variável de vinculação. Por exemplo, se você estiver chamando a função TASK_HISTORY e não quiser que os resultados sejam filtrados por uma tarefa específica, omita o argumento TASK_NAME da chamada.
Os seguintes argumentos de função de tabela são afetados por esta mudança:
Função de tabela |
Argumentos afetados |
---|---|
OBJECT_TYPE |
|
OBJECT_NAME |
|
TABLE_NAME |
|
START_TIME |
|
ROOT_TASK_NAME |
|
RESULT_LIMIT |
|
TABLE_NAME |
|
LOCATION |
|
FILE_FORMAT |
|
FILES |
|
POLICY_NAME |
|
REF_ENTITY_NAME |
|
REF_ENTITY_DOMAIN |
|
END_TIME_RANGE_START |
|
END_TIME_RANGE_END |
|
RESULT_LIMIT |
|
SESSION_ID |
|
RESULT_LIMIT |
|
USER_NAME |
|
WAREHOUSE_NAME |
|
END_TIME_RANGE_START |
|
END_TIME_RANGE_END |
|
RESULT_LIMIT |
|
OBJECT_NAME (o argumento |
|
TASK_NAME |
|
RESULT_LIMIT |
|
TASK_NAME |
|
DATE_RANGE_START |
|
DATE_RANGE_END |
|
WAREHOUSE_NAME |
|
DATE_RANGE_START |
|
DATE_RANGE_END |
Ref: 1410