Gerenciamento de aplicativos

Este tópico descreve como gerenciar um Snowflake Native App depois que ele é instalado em uma conta de consumidor.

Exibir Snowflake Native Apps e aplicativos Streamlit instalados

Para visualizar um aplicativo instalado ou um aplicativo Streamlit que foi instalado como parte de um aplicativo, siga estas etapas:

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data Products » Apps.

  3. Confira a lista de aplicativos instalados e aplicativos Streamlit, selecionando o aplicativo na lista.

    • Se você tiver selecionado um aplicativo, o aplicativo será aberto em uma planilha.

    • Se você tiver selecionado um aplicativo Streamlit, o aplicativo Streamlit será exibido em um editor.

Exibir o arquivo leiame de um aplicativo

Para visualizar o arquivo leiame (readme) de um aplicativo instalado, siga estas etapas:

  1. Faça login na Snowsight.

  2. No menu de navegação, selecione Data Products » Apps.

  3. Selecione o aplicativo na lista e, em seguida, selecione o ícone Readme na barra de ferramentas.

Concessão de funções de aplicativo a funções de conta

Para conceder funções de aplicativo a uma função de conta em sua conta usando Snowsight, siga estas etapas:

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data Products » Apps.

  3. Selecione o aplicativo e, em seguida, Manage Access.

  4. Selecione Add roles, em seguida, selecione a função de conta à qual deseja conceder acesso a uma função de aplicativo.

  5. Selecione Done.

Para conceder uma função de aplicativo a uma função de conta na conta do consumidor usando comandos SQL, use GRANT APPLICATION ROLE do comando GRANT DATABASE ROLE como mostrado no exemplo a seguir:

GRANT APPLICATION ROLE hello_snowflake_app.app_public TO ROLE data_manager;
Copy

Usar orçamentos personalizados para monitorar o uso de crédito para um aplicativo

Os orçamentos permitem que você defina um limite mensal de gastos com os custos de computação de um aplicativo. Você pode criar e configurar um orçamento personalizado para monitorar o uso de créditos para os objetos que são de propriedade do aplicativo e que consomem créditos.

Quando você adiciona um aplicativo a um orçamento personalizado, os objetos que são de propriedade do aplicativo e que consomem créditos são adicionados automaticamente ao orçamento personalizado. Isso inclui os warehouses e os pools de computação que são de propriedade do aplicativo.

Os warehouses e pools de computação compartilhados não são rastreados automaticamente pelo orçamento personalizado, embora você possa adicioná-los manualmente ao orçamento personalizado. Ao criar um orçamento personalizado para um aplicativo, você não pode adicionar objetos criados e pertencentes a um aplicativo a um orçamento personalizado separado. No entanto, você pode adicionar warehouses e pools de computação que são compartilhados a um orçamento personalizado separado.

Configurar a função necessária para criar um orçamento personalizado para um aplicativo

Para criar ou editar um orçamento personalizado para um aplicativo, você deve usar uma função que tenha os privilégios corretos. Consulte Criação de uma função personalizada para gerenciar o orçamento de conta

Criar um orçamento personalizado para um aplicativo na Snowsight

você pode criar ou editar um orçamento personalizado para um aplicativo diretamente na página de configuração do aplicativo ou na página Gerenciamento de custos.

Para criar um orçamento personalizado para um aplicativo na página de configuração do aplicativo, siga estas etapas:

  1. Faça login na Snowsight.

  2. No menu de navegação, selecione Data Products » Apps.

  3. Selecione o aplicativo cujo orçamento personalizado você deseja visualizar.

  4. Selecione a guia Cost management.

  5. Selecione Create Budget.

  6. Selecione Budget.

  7. Insira um Budget name.

  8. Selecione o banco de dados e o esquema no qual deseja criar seu orçamento.

  9. Digite o Spending limit.

  10. Especifique os endereços de e-mail para receber notificações.

    Nota

    Cada endereço de e-mail adicionado para notificações de orçamento personalizado deve ser verificado. A configuração do e-mail de notificação falhará se algum endereço de e-mail da lista não for verificado.

  11. Selecione Resources to monitor.

  12. Selecione o aplicativo a ser adicionado ao orçamento personalizado.

    • Para adicionar um aplicativo, expanda Native Apps para selecionar um aplicativo.

    • Para adicionar um banco de dados, expanda Databases para selecionar um banco de dados.

    • Para adicionar objetos em um esquema, expanda o esquema para listar os objetos disponíveis. Expanda a categoria do objeto (por exemplo, Tables ou Tasks) para selecionar objetos.

    • Para adicionar um warehouse, expanda Warehouses e selecione um warehouse.

    • Para adicionar um pool de computação, expanda Compute Pools e selecione um pool de computação.

    Nota

    • Quando você seleciona um banco de dados ou esquema, todos os objetos compatíveis (por exemplo, tabelas) contidos no banco de dados ou esquema também são adicionados ao orçamento personalizado.

    • Você só pode adicionar um objeto a um orçamento personalizado. Se um objeto estiver atualmente incluído em um orçamento personalizado e você adicionar esse objeto a um segundo orçamento personalizado, o Snowflake removerá o objeto do primeiro orçamento personalizado sem emitir um aviso.

Criar um orçamento personalizado para um aplicativo usando SQL

Para criar um orçamento personalizado para um aplicativo usando SQL, consulte Usar comandos SQL para criar um orçamento personalizado.

O que fazer se um aplicativo não estiver disponível

Após a instalação, um Snowflake Native App pode ficar indisponível por vários motivos. Para verificar o status de um aplicativo, consulte o valor de upgrade_status no comando SHOW APPLICATION. Se um aplicativo não estiver disponível, o comando DESCRIBE APPLICATION falhará. A mensagem de erro retornada fornece informações sobre o motivo pelo qual o aplicativo está indisponível.

A tabela a seguir lista algumas das maneiras pelas quais um aplicativo pode ficar indisponível e possíveis maneiras de resolver o problema:

Motivo

Possível resolução

O Snowflake desabilitou o aplicativo.

Entre em contato com o suporte Snowflake

A conta do consumidor fica inativa após ser bloqueada ou suspensa.

O aplicativo é reativado quando a conta é restaurada.

A versão do aplicativo foi descartada do pacote de aplicativos na conta do provedor.

Nessa situação, o aplicativo não pode mais ser utilizado e deve ser desinstalado e reinstalado a partir de uma listagem atual.

O consumidor excedeu o limite de uso de uma avaliação baseada no uso.

Consulte a avaliação baseada no uso para possíveis opções.

O aplicativo foi instalado a partir de uma listagem paga, mas as informações de pagamento não foram fornecidas ou não estão atualizadas.

Pague pela listagem. Consulte Pague por listagens para obter mais informações.

O período de avaliação da listagem foi excedido.

Entre em contato com o provedor do aplicativo.

Desinstalação de um Snowflake Native App

Você pode desinstalar um aplicativo usando Snowsight ou executando os comandos SQL.

Privilégios necessários para desinstalar um aplicativo

Para desinstalar um aplicativo, você deve usar uma função que tenha o privilégio OWNERSHIP no aplicativo. GRANT OWNERSHIP para mais informações.

Para transferir a propriedade de objetos pertencentes ao aplicativo que existem fora do aplicativo, você deve usar uma função que tenha o privilégio MANAGE GRANTS nos objetos. Consulte Considerações sobre o controle de acesso para obter mais informações.

Desinstalar um aplicativo na Snowsight

Para desinstalar um aplicativo usando Snowsight, siga estas etapas:

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data Products » Apps.

  3. Ao lado do aplicativo, selecione e, em seguida, selecione Uninstall.

    Se o aplicativo criou objetos que existem fora do aplicativo, uma caixa de diálogo será exibida mostrando uma lista dos objetos e seus tipos.

    1. Selecione um dos seguintes:

      • Yes, transfer selected objects to a role.

        Se você selecionar esta opção, escolha uma função na lista. Essa função se torna o novo proprietário do objeto.

        Cuidado

        Ao usar Snowsight, apenas os seguintes objetos pertencentes a Snowflake Native App podem ser transferidos para uma função diferente:

        • Banco de dados

        • Esquema

        • Tabela

        • Exibições

      • No, delete all objects created outside the app.

        Se você selecionar esta opção, os objetos serão excluídos quando o aplicativo for desinstalado.

  4. Selecione Uninstall.

Desinstalação do aplicativo usando comandos SQL

Para desinstalar um aplicativo usando os comandos SQL, siga estas etapas:

  1. Use o comando SHOW OBJECTS OWNED BY APPLICATION para visualizar os objetos pertencentes ao Snowflake Native App que existem fora do aplicativo, conforme mostrado no exemplo a seguir:

    SHOW OBJECTS OWNED BY APPLICATION hello_snowflake_app;
    
    Copy

    Este comando mostra uma lista de objetos e seus tipos.

  2. Opcionalmente, para transferir a propriedade de um objeto para uma função diferente, use o comando GRANTOWNERSHIP como mostrado no exemplo a seguir:

    GRANT OWNERSHIP ON DATABASE na_external_db TO ROLE consumer_role;
    
    Copy
  3. Para excluir um objeto, execute o comando DROP APPLICATION como mostrado no exemplo a seguir:

    DROP APPLICATION hello_snowflake_app CASCADE;
    
    Copy

    Nota

    Se você não transferir a propriedade para uma função diferente, deverá usar a opção CASCADE.