Tabelas dinâmicas: alterações no valor de retorno e novas colunas adicionadas a DYNAMIC_TABLE_GRAPH_HISTORY, DYNAMIC_TABLE_REFRESH_HISTORY e SHOW DYNAMIC TABLES (pendente)

Atenção

Essa mudança de comportamento está no pacote 2024_02.

Para saber o status atual do pacote, consulte Histórico do pacote.

Comportamento do valor de retorno

O comportamento das funções DYNAMIC_TABLE_GRAPH_HISTORY, DYNAMIC_TABLE_REFRESH_HISTORY e SHOW DYNAMIC TABLES mudou. Os valores de retorno para essas funções são exibidos como segue.

Comportamento do valor de retorno para a função DYNAMIC_TABLE_GRAPH_HISTORY

Quando esse pacote de mudança de comportamento está ativado, a saída da função DYNAMIC_TABLE_GRAPH_HISTORY inclui as seguintes alterações no valor de retorno:

Antes da mudança:
  • A coluna SCHEDULING_STATE retorna "state": "RUNNING" ou "state": "SUSPENDED" para descrever o estado da tabela dinâmica.

  • A coluna SCHEDULING_STATE retorna RUNNING se uma tabela upstream foi suspensa e você não tinha o privilégio MONITOR nessa tabela upstream.

Após a mudança:
  • A coluna SCHEDULING_STATE retorna "state": "ACTIVE" ou "state": "SUSPENDED" para descrever o estado da tabela dinâmica.

  • A coluna SCHEDULING_STATE retorna SUSPENDED, mesmo se você não tiver o privilégio MONITOR em tabelas upstream.

Comportamento do valor de retorno para a função DYNAMIC_TABLE_REFRESH_HISTORY

Quando esse pacote de mudança de comportamento está ativado, a saída da função DYNAMIC_TABLE_REFRESH_HISTORY inclui as seguintes alterações no valor de retorno:

Antes da mudança:
  • A coluna LAST_COMPLETED_DEPENDENCY pode retornar valores NULL incorretamente.

  • A coluna STATE retornou SKIPPED para trabalhos de atualização que foram ignorados devido a uma falha upstream.

  • Os históricos de atualização foram exibidos para todos os estados dinâmicos da tabela.

Após a mudança:
  • A coluna LAST_COMPLETED_DEPENDENCY agora retorna valores precisos.

  • A coluna STATE agora retorna UPSTREAM_FAILED para trabalhos de atualização ignorados devido a uma falha upstream.

  • Os históricos de atualização não serão mais exibidos se a coluna STATE retornar QUEUED ou SKIPPED. (Se a atualização dinâmica da tabela foi ignorada devido a uma falha no upstream, a coluna STATE agora retornará UPSTREAM_FAILED.)

Comportamento do valor de retorno para a função SHOW DYNAMIC TABLE

Quando esse pacote de mudança de comportamento está ativado, a saída do comando SHOW DYNAMIC TABLES inclui as seguintes alterações no valor de retorno:

Antes da mudança:
  • A coluna SCHEDULING_STATE retorna RUNNING ou SUSPENDED para descrever o estado da tabela dinâmica.

Após a mudança:
  • A coluna SCHEDULING_STATE retorna ACTIVE ou SUSPENDED para descrever o estado da tabela dinâmica.

Mudanças de coluna

Quando ativado, as colunas adicionais a seguir são adicionadas às funções DYNAMIC_TABLE_GRAPH_HISTORY e DYNAMIC_TABLE_REFRESH_HISTORY.

Função DYNAMIC_TABLE_GRAPH_HISTORY: nova coluna na saída

Quando esse pacote de mudança de comportamento está ativado, a saída da função DYNAMIC_TABLE_GRAPH_HISTORY inclui a(s) seguinte(s) nova(s) coluna(s):

Nome da coluna

Tipo de dados

Descrição

ALTER_TRIGGER

ARRAY

Descreve por que uma nova entrada é criada na função DYNAMIC_TABLE_GRAPH_HISTORY. Isso pode ser o seguinte:

  • NONE (compatível com versões anteriores)

  • CREATE_DYNAMIC_TABLE

  • ALTER_TARGET_LAG

  • SUSPEND

  • RESUME

  • REPLICATION_REFRESH

  • ALTER_WAREHOUSE

Função DYNAMIC_TABLE_REFRESH_HISTORY: novas colunas na saída

Quando esse pacote de mudança de comportamento está ativado, a saída da função DYNAMIC_TABLE_REFRESH_HISTORY inclui a(s) seguinte(s) nova(s) coluna(s):

Nome da coluna

Tipo de dados

Descrição

TARGET_LAG

TEXT

Esta coluna descreve o valor TARGET_LAG da tabela dinâmica no momento em que ocorreu a atualização.

GRAPH_HISTORY_VALID_FROM

TIMESTAMP_NTZ

Codifica o carimbo de data/hora VALID_FROM da função de tabela DYNAMIC_TABLE_GRAPH_HISTORY quando a atualização ocorreu.

Ref: 1543