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:
|
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