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=> ?, ...
Copy

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', ?, ...
Copy

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

AUTO_REFRESH_REGISTRATION_HISTORY

OBJECT_TYPE

OBJECT_NAME

COPY_HISTORY

TABLE_NAME

START_TIME

CURRENT_TASK_GRAPHS

ROOT_TASK_NAME

DYNAMIC_TABLE_REFRESH_HISTORY

RESULT_LIMIT

EXTERNAL_TABLE_FILE_REGISTRATION_HISTORY

TABLE_NAME

INFER_SCHEMA

LOCATION

FILE_FORMAT

FILES

POLICY_REFERENCES

POLICY_NAME

REF_ENTITY_NAME

REF_ENTITY_DOMAIN

QUERY_HISTORY

END_TIME_RANGE_START

END_TIME_RANGE_END

RESULT_LIMIT

QUERY_HISTORY_BY_SESSION

SESSION_ID

RESULT_LIMIT

QUERY_HISTORY_BY_USER

USER_NAME

QUERY_HISTORY_BY_WAREHOUSE

WAREHOUSE_NAME

END_TIME_RANGE_START

END_TIME_RANGE_END

RESULT_LIMIT

TAG_REFERENCES

OBJECT_NAME (o argumento object_name)

TASK_DEPENDENTS

TASK_NAME

TASK_HISTORY

RESULT_LIMIT

TASK_NAME

WAREHOUSE_LOAD_HISTORY

DATE_RANGE_START

DATE_RANGE_END

WAREHOUSE_NAME

WAREHOUSE_METERING_HISTORY

DATE_RANGE_START

DATE_RANGE_END

Ref: 1410