Partilhar via

GET declaração DIAGNÓSTICO

Aplica-se a:marcado como sim Databricks SQL marcado como sim Databricks Runtime 16.3 e superior

Recupere informações sobre uma condição manipulada em um manipulador de exceções.

Esta instrução só pode ser usada dentro de um gestor de condições numa instrução composta .

Sintaxe

GET DIAGNOSTICS CONDITION 1
  { variable_name = condition_info_item } [, ...]

condition_info_item
  { MESSAGE_TEXT |
    RETURNED_SQLSTATE |
    MESSAGE_ARGUMENTS |
    CONDITION_IDENTIFIER |
    LINE_NUMBER }

Parâmetros

  • variable_name

    Uma variável local ou variável de sessão.

  • CONDITION 1

    Retorna a condição que acionou o manipulador de condições. Você deve chamar a instrução GET DIAGNOSTICS CONDITION 1 como a primeira declaração no controlador.

    • MESSAGE_TEXT

      Retorna o texto da mensagem associado à condição como um STRING. variable_name deve ser um STRING.

    • RETURNED_SQLSTATE

      Retorna o SQLSTATE associado à condição que está a ser tratada como um STRING. variable_name deve ser um STRING.

    • MESSAGE_ARGUMENTS

      Retorna um mapeamento de MAP<STRING, STRING> fornecido como argumentos para os parâmetros das condições do Databricks. Para condições declaradas, a única chave de mapa é MESSAGE_TEXT. variable_name deve ser um MAP<STRING, STRING>

    • CONDITION_IDENTIFIER

      Retorna o nome da condição que causou a exceção. variable_name deve ser um STRING.

    • LINE_NUMBER

      Retorna o número da linha da instrução que gera a condição. NULL se não estiver disponível.

Exemplos

-- Retrieve the number of rows inserted by an INSERT statement
> CREATE OR REPLACE TABLE emp(name STRING, salary DECIMAL(10, 2));

> BEGIN
    DECLARE EXIT HANDLER FOR DIVIDE_BY_ZERO
      BEGIN
        DECLARE cond STRING;
        DECLARE message STRING;
        DECLARE state STRING;
        DECLARE args MAP<STRING, STRING>;
        DECLARE line BIGINT;
        DECLARE argstr STRING;
        DECLARE log STRING;
        GET DIAGNOSTICS CONDITION 1
           cond    = CONDITION_IDENTIFIER,
           message = MESSAGE_TEXT,
           state   = RETURNED_SQLSTATE,
           args    = MESSAGE_ARGUMENTS,
           line    = LINE_NUMBER;
        SET argstr = array_join(transform(map_entries(args), t -> concat_ws(' ', 'Param:', t.key, 'Val:', t.value)), ' ');
        SET log = 'Condition: ' || cond ||
                  ' Message: ' || message ||
                  ' SQLSTATE: ' || state ||
                  ' Args: ' || argstr ||
                  ' Line: ' || line;
        VALUES (log);
      END;
    SELECT 10/0;
  END;
 Condition: DIVIDE_BY_ZERO Message: Division by zero. Use try_divide to tolerate divisor being 0 and return NULL instead. If necessary, set <config> to “false” to bypass this error. SQLATTE: 22012 Args:  Parm: config Val: ANSI_MODE Line: 28
  • Last updated on