Esquema:

DATA_SHARING_USAGE

Exibição APPLICATION_STATE

Essa exibição no esquema DATA_SHARING_USAGE pode ser usada para exibir informações sobre os apps instalados a partir de uma listagem de todos os pacotes de aplicativos na conta atual.

Se uma listagem tiver sido publicada usando o Preenchimento automático entre nuvens, esta exibição mostrará informações sobre aplicativos instalados em todas as regiões.

Colunas

Nome da coluna

Tipo de dados

Descrição

CONSUMER_SNOWFLAKE_REGION

VARCHAR

A região Snowflake da conta do consumidor onde o aplicativo está instalado.

CONSUMER_ORGANIZATION_NAME

VARCHAR

O nome da organização da conta do consumidor.

CONSUMER_ACCOUNT_LOCATOR

VARCHAR

O localizador da conta do consumidor.

CONSUMER_ACCOUNT_NAME

VARCHAR

O nome da conta do consumidor.

PROVIDER_SNOWFLAKE_REGION

VARCHAR

A região Snowflake da conta do provedor que criou o pacote do aplicativo.

PROVIDER_ACCOUNT_LOCATOR

VARCHAR

O localizador de conta do provedor.

PROVIDER_ACCOUNT_NAME

VARCHAR

O nome da conta do provedor.

PACKAGE_NAME

VARCHAR

O nome atual do pacote de aplicativos na conta do provedor a partir da qual o aplicativo foi instalado.

APPLICATION_NAME_HASH

VARCHAR

A cadeia de caracteres de hash do nome da instância do aplicativo instalado na conta do consumidor. O consumidor utiliza a função SHA1 para calcular o valor de hash do aplicativo instalado. O consumidor pode então usar esse valor ao entrar em contato com o provedor.

CREATED_ON

DATETIME

O carimbo de data/hora em que a instância do aplicativo foi instalada pela primeira vez.

CURRENT_VERSION

VARCHAR

A versão atual do aplicativo.

CURRENT_PATCH

INT

O nível de patch atual do aplicativo.

CURRENT_INSTALLED_ON

DATETIME

O carimbo de data/hora em que a versão atual do aplicativo foi instalada.

PREVIOUS_VERSION_STATE

VARCHAR

O estado da versão anterior. Os valores possíveis são COMPLETE e FINALIZING.

  • COMPLETE indica que a atualização foi concluída e que não há consultas ativas sendo executadas na versão anterior, se existir.

  • FINALIZING indica que a instância foi atualizada da versão anterior, no entanto, uma ou mais consultas ainda podem estar em execução usando a versão anterior.

PREVIOUS_VERSION

VARCHAR

A versão anterior do aplicativo.

PREVIOUS_PATCH

INT

O nível de patch anterior do aplicativo.

UPGRADE_STATE

VARCHAR

O estado de atualização da versão do aplicativo. Os valores possíveis são:

  • INSTALLING: o objeto do aplicativo está em processo de criação.

  • INSTALL_FAILED: a criação do objeto de aplicativo falhou. O objeto do aplicativo permanece no estado INSTALL_FAILED até ser descartado. Veja a coluna UPGRADE_FAILURE_REASON do comando DESCRIBE APPLICATION para obter informações sobre o motivo da falha na instalação ou atualização.

  • COMPLETE: o script de configuração foi concluído com êxito e o objeto do aplicativo foi criado ou atualizado.

  • QUEUED: o objeto do aplicativo está na fila para atualização.

  • UPGRADING: o objeto do aplicativo está em processo de atualização.

  • FAILED: todas as tentativas de atualização falharam. O motivo da falha está listado na coluna UPGRADE_FAILURE_REASON, se houver. A instância permanece no estado FAILED até que uma diretriz de versão seja atualizada para apontar para uma versão diferente daquela para a qual a atualização foi direcionada, conforme definido na coluna TARGET_UPGRADE_VERSION.

  • QUEUED_RETRY: a instância falhou em uma ou mais tentativas de atualização. O motivo da falha é indicado em UPGRADE_FAILURE_REASON: a instância está na fila para realizar outra tentativa de atualização.

  • DISABLED: o objeto do aplicativo e suas atualizações foram desativados. Nesse estado, a instância ficará inacessível para os consumidores, não será considerada para atualizações e não bloqueará a queda da versão do pacote de aplicativos. O motivo da falha está listado na coluna UPGRADE_FAILURE_REASON, se houver.

TARGET_UPGRADE_VERSION

VARCHAR

A versão de destino do aplicativo que está em execução ou com atualização pendente.

TARGET_UPGRADE_PATCH

INT

O nível de patch da versão do aplicativo que está em execução ou com atualização pendente.

UPGRADE_STARTED_ON

DATETIME

O carimbo de data/hora em que a atualização do aplicativo foi iniciada.

UPGRADE_ATTEMPT

INT

O número de tentativas de atualização para a versão ou patch de destino.

UPGRADE_ATTEMPTED_ON

DATETIME

O carimbo de data/hora quando a tentativa de atualização mais recente foi feita.

UPGRADE_FAILURE_REASON

VARCHAR

Uma descrição da falha se a atualização anterior do aplicativo falhou.

LISTING_NAME

VARCHAR

O nome da listagem na troca de dados a partir da qual o aplicativo foi instalado.

LISTING_DISPLAY_NAME

VARCHAR

O nome de exibição da listagem.

EXCHANGE_NAME

VARCHAR

O nome de troca de dados da listagem a partir da qual o aplicativo foi instalado.

LAST_HEALTH_STATUS

VARCHAR

O último status de saúde relatado do aplicativo. Os valores possíveis são:

  • OK

  • FAILED

  • PAUSED

LAST_HEALTH_STATUS_UPDATED_ON

VARCHAR

O carimbo de data/hora em que o status de saúde foi relatado pela última vez.

ENABLED_TELEMETRY_EVENT_DEFINITIONS

VARCHAR

Uma lista de definições de evento que o consumidor habilitou. Consulte Sobre definições de evento para obter mais informações.

UPGRADE_STATE_UPDATED_ON

TIMESTAMP_LTZ

O carimbo de data/hora em que o aplicativo entrou em seu estado de atualização atual. Este valor é definido automaticamente pelo Snowflake.

DISABLEMENT_REASONS

VARCHAR

Uma matriz contendo os motivos pelos quais o Snowflake Native App foi desativado. Consulte Motivos pelos quais um aplicativo pode ser desativado.

Motivos pelos quais um aplicativo pode ser desativado

A tabela a seguir lista os valores possíveis para a coluna DISABLEMENT_REASONS:

Valor

Descrição do status

É recuperável?

MANUALLY_DISABLED

O aplicativo foi desabilitado pelo Snowflake

Sim. Para reativar o aplicativo, entre em contato com o suporte Snowflake.

ACCOUNT_INACTIVE

A conta fica inativa ao ser bloqueada ou suspensa, fazendo com que o aplicativo fique indisponível. Nesse estado, o consumidor não pode executar nenhuma consulta SQL em sua conta e o aplicativo não pode ser atualizado.

Sim. O aplicativo é reativado automaticamente se o bloqueio ou suspensão da conta for removido

PACKAGE_VERSION_IS_MISSING

A versão do pacote de aplicativo para o aplicativo foi descartada pelo provedor.

Não. O aplicativo não pode mais ser usado e deve ser descartado e reinstalado a partir de uma listagem válida ou pacote de aplicativo.

CMK_ACCESS_DENIED

O consumidor gerencia a chave de criptografia (ENCRYPT_USE_CMK_KMS está habilitado) e o Snowflake não tem acesso a essa chave.

Sim. Para reativar o aplicativo, certifique-se de que a configuração do provedor de nuvem para recuperar a CMK esteja correta e que o Snowflake tenha acesso à chave.

LISTING_ACCESS_REVOKED

A listagem usada para criar o aplicativo não está mais disponível. Possíveis razões para esse status incluem:

  • O provedor excluiu a listagem

  • O provedor removeu manualmente o acesso à listagem privada da conta do consumidor

Possivelmente. A recuperabilidade depende do motivo pelo qual o acesso foi revogado.

Por exemplo, se o listagem foi excluída, ela não poderá ser recuperada. Se uma conta de consumidor foi removida manualmente da listagem privada, o acesso à listagem e ao aplicativo pode ser restaurado.

LISTING_TRIAL_USAGE_EXCEEDED

O aplicativo excedeu o limite de uso para uma listagem de teste baseada no uso.

Não

LISTING_PAYMENT_REQUIRED

A listagem usada para instalar o aplicativo é uma listagem paga e exige pagamento para uso posterior.

Sim. O consumidor deve definir corretamente o pagamento do aplicativo.

LISTING_TRIAL_TIME_EXCEEDED

O aplicativo excedeu o período de teste.

Não

APPLICATION_PACKAGE_NOT_AVAILABLE

O pacote de aplicativo usado para criar o aplicativo não existe mais. O provedor pode ter descartado o pacote de aplicativo correspondente.

Não

APPLICATION_PACKAGE_DISABLED

O pacote de aplicativo usado para criar o aplicativo é desabilitado pelo Snowflake.

Sim. O aplicativo será reativado se o Snowflake reativar o pacote do aplicativo.

APPLICATION_SUSPENDED

Os recursos do aplicativo, por exemplo, tarefas, serviços e pools de computação, são suspensos porque o aplicativo está desabilitado.

Os objetos suspensos permanecem suspensos até que o aplicativo seja reativado e não haja outros motivos para a desativação do aplicativo.

Sim

APPLICATION_SUSPEND_RESUME_IN_PROGRESS

Os recursos do aplicativo, por exemplo, tarefas, serviços e pools de computação, estão sendo retomados no momento.

Sim

Notas de uso

  • Não há retenção de dados para esta exibição. Se um aplicativo for desinstalado, as informações contidas nessa exibição não estarão mais disponíveis.