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>' )
Copy

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"
        },
        ...
        }
      ]
    }
    
    Copy
  • 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": []
    }
    
    Copy

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');
Copy