Categorias:

Funções do sistema (Controle do sistema)

SYSTEM$CANCEL_QUERY

Cancela a consulta (ou instrução) especificada se ela estiver atualmente ativa/em execução.

Consulte também:

SYSTEM$CANCEL_ALL_QUERIES

Sintaxe

SYSTEM$CANCEL_QUERY( <query_id> )
Copy

Argumentos

query_id

Identificador para a consulta a ser cancelada. Para obter a ID para uma consulta executada nos últimos 14 dias, entre na interface da web e vá para a página History Guia Histórico.

Notas de uso

  • Um usuário pode cancelar suas próprias operações SQL em execução usando esta função SQL. O cancelamento de operações em execução executadas por outro usuário exige uma função com um dos seguintes privilégios:

    • OWNERSHIP sobre o usuário que executou a operação.

    • OPERATE ou OWNERSHIP no warehouse que está executando a operação (se aplicável).

    • Função ACCOUNTADMIN.

  • Para uma consulta executada por uma tarefa, o cancelamento de operações em execução requer uma função com um dos seguintes privilégios:

    • OPERATE ou OWNERSHIP na tarefa que está executando a operação.

    • Função ACCOUNTADMIN.

  • Os IDs de consulta do Snowflake são cadeias de caracteres de texto UUID com hífens, que são caracteres especiais, portanto, as cadeias de caracteres devem ser escapadas por meio de aspas simples.

  • Esta função não se destina ao cancelamento de consultas para um determinado warehouse ou usuário. Em vez disso, use:

Exemplos

SELECT SYSTEM$CANCEL_QUERY('d5493e36-5e38-48c9-a47c-c476f2111ce5');

+-------------------------------------------------------------+
| SYSTEM$CANCEL_QUERY('D5493E36-5E38-48C9-A47C-C476F2111CE5') |
|-------------------------------------------------------------|
| query [d5493e36-5e38-48c9-a47c-c476f2111ce5] terminated.    |
+-------------------------------------------------------------+
Copy