Categorias:

Funções de tabela (Tabelas)

APPLICATION_CONFIGURATION_VALUE_HISTORY

Fornece um histórico das alterações de valor para as configurações de aplicativos no Snowflake Native App especificado.

Você pode chamar essa função para verificar o histórico das alterações de valor de uma configuração de aplicativo. Para obter mais informações, consulte Configuração do aplicativo.

Sintaxe

APPLICATION_CONFIGURATION_VALUE_HISTORY(
  [ APPLICATION_NAME => '<application_name>' ]
  [ , CONFIGURATION_NAME => '<config_name>' ]
)
Copy

Argumentos

Obrigatório:

application_name

Nome do aplicativo no qual a configuração está.

Opcional:

config_name

Nome da configuração. Se não for fornecido, a função retornará o histórico de todas as configurações no aplicativo.

Retornos

A função retorna as seguintes colunas:

Coluna

Tipo de dados

Descrição

NAME

STRING

O nome da configuração, definido pelo provedor.

APPLICATION_NAME

STRING

O nome do aplicativo no qual a configuração está.

CREATED_ON

TIMESTAMP

O carimbo de data/hora em que o objeto de configuração foi criado.

UPDATED_ON

TIMESTAMP

O carimbo de data/hora da última atualização do objeto de configuração.

TYPE

STRING

O tipo da configuração. Os valores possíveis são APPLICATION_NAME e STRING.

STATUS

STRING

O status da configuração. Os valores possíveis são PENDING e DONE.

SENSITIVE

BOOLEAN

Se o valor é confidencial ou não.

VALUE

STRING

O valor definido pelo consumidor.

Para configurações de aplicativos do tipo APPLICATION_NAME, este é o nome mais atualizado do aplicativo especificado pelo consumidor. Esse nome poderá ser diferente do fornecido inicialmente se o aplicativo tiver sido renomeado. Se o aplicativo tiver sido removido, nenhum valor será exibido aqui, como se o valor não estivesse definido.

Quando SENSITIVE=TRUE, o valor fica oculto, a menos que a função de execução seja o aplicativo proprietário da configuração.

VALUE_UPDATED_ON

TIMESTAMP

O carimbo de data/hora da última atualização, quando o valor foi definido ou removido.

LABEL

STRING

Um nome amigável para ser exibido na UI, fornecido pelo provedor.

DESCRIPTION

STRING

A descrição da configuração.

APPLICATION_ROLES

STRING

Os nomes das funções do app, separados por vírgulas, que têm acesso à configuração.

Isso exibe os nomes mais atualizados, mesmo que as funções tenham sido renomeadas. Se uma função do aplicativo tiver sido removida, ela não será incluída na lista de saída.

Notas de uso

  • A exibição mostra apenas as configurações para as quais a função atual da sessão recebeu privilégios de acesso.

  • A exibição não inclui configurações que foram removidas.

  • Ao chamar uma função de tabela do Information Schema, a sessão deve ter um esquema INFORMATION_SCHEMA em uso ou o nome da função deve ser totalmente qualificado. Para obter mais detalhes, consulte Snowflake Information Schema.

Exemplos

Recupere o histórico das alterações de valor para a configuração do aplicativo config_name no aplicativo application_name:

SELECT * FROM TABLE(information_schema.application_configuration_value_history(application_name => 'my_app', configuration_name => 'my_configuration'));
Copy