SYSTEM$CANCEL_CLASSIFY_SCHEMA¶
Agenda o cancelamento do processo de classificação para as tabelas no esquema especificado. É possível cancelar o processo de classificação para tabelas às quais a função que chamou este procedimento armazenado tem acesso.
Uma tabela que está preparada para ter o processo de classificação cancelado não é classificada até que você a classifique novamente.
Sintaxe¶
SYSTEM$CANCEL_CLASSIFY_SCHEMA( '<object_name>' )
Argumentos¶
object_name
O nome do esquema com as tabelas cujo processo de classificação será cancelado. Se um banco de dados e esquema não estiverem em uso na sessão atual, o nome deve ser totalmente qualificado.
O nome deve ser especificado exatamente como está armazenado no banco de dados. Se o nome contiver caracteres especiais, letras maiúsculas ou espaços em branco, o nome deve ser incluído primeiro em aspas duplas e depois em aspas simples.
Retornos¶
O procedimento armazenado retorna um objeto JSON nos seguintes formatos, dependendo do nome do esquema especificado:
Se você chamar SYSTEM$CLASSIFY_SCHEMA para a classificação de estágio e, em seguida, chamar SYSTEM$CANCEL_CLASSIFY_SCHEMA com o mesmo nome de esquema para cancelar o processo de classificação, a saída será a seguinte:
{ "failed": [], "succeeded": [ { "message": "Classification Cancelled for table [T1].", "table_name": "T1" }, { "message": "Classification Cancelled for table [T2].", "table_name": "T2" }, ... } ] }
Se você chamar SYSTEM$CANCEL_CLASSIFY_SCHEMA e o esquema especificado não estiver preparado para classificação, a saída será a seguinte:
{ "failed": [ { "message": "Unable to cancel classification for table [T1] since its already complete.", "table_name": "T1" }, { "message": "Unable to cancel classification for table [T2] since its already complete.", "table_name": "T2" }, ... ], "succeeded": [] }
Onde:
failed
Especifica um motivo pelo qual o processo de cancelamento não pode ser executado para a tabela especificada.
succeeded
Confirma que o processo de cancelamento está agendado para a tabela especificada.
Notas de uso¶
O processo de cancelamento pode levar um curto período de tempo (segundos) para ser concluído. Isso é análogo a cancelar uma consulta.
O nome do esquema especificado pode conter até 1.000 objetos de tabela. Se o esquema contiver mais de 1.000 objetos de tabela, o Snowflake retornará uma mensagem de erro.
Os procedimentos armazenados fornecidos pelo Snowflake utilizam os direitos do chamador. Para obter mais detalhes, consulte Procedimentos armazenados com direitos do chamador e direitos do proprietário.
Exemplos¶
Cancela a classificação de tabelas no esquema:
CALL SYSTEM$CANCEL_CLASSIFY_SCHEMA('hr.tables');