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

  1. Faça login no Snowsight.

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

    Uma lista de aplicativos instalados e aplicativos Streamlit é exibida na lista Installed Apps.

Exibir o arquivo leiame de um aplicativo

  1. Faça login no Snowsight.

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

  3. Selecione um aplicativo.

  4. Selecione o ícone Settings na barra de ferramentas.

  5. Selecione a guia About the app.

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

  1. Faça login no Snowsight.

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

  3. Selecione um aplicativo.

  4. Selecione o ícone Settings na barra de ferramentas.

  5. Selecione a guia Access management.

  6. No painel Account roles with access, selecione Add.

  7. Selecione uma função na lista Account roles.

  8. Selecione Close.

Usar um comando SQL para conceder funções de aplicativo a funções de conta

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

Iniciar um aplicativo

  1. Faça login no Snowsight.

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

  3. Selecione um aplicativo.

  4. Selecione o ícone Settings na barra de ferramentas.

  5. Clique em Launch App.

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

Para verificar o status de um aplicativo, execute o comando SHOW APPLICATIONS e determine o valor upgrade_status. Quando um aplicativo não está disponível, o comando DESCRIBE APPLICATION falha e a mensagem de erro fornece informações sobre o motivo pelo qual o aplicativo não está disponível.

A tabela a seguir lista os motivos pelos quais um aplicativo não está disponível e os métodos para 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 Avaliação de uma listagem para ver as opções possíveis.

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 Pagar por uma listagem 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.

Para desinstalar um aplicativo, você deve usar uma função que tenha o privilégio OWNERSHIP no aplicativo. Consulte GRANT OWNERSHIP.

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.

Desinstalar um aplicativo na Snowsight

  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.

Use os comandos SQL para desinstalar um aplicativo

  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 GRANT OWNERSHIP como mostrado no exemplo a seguir.

    GRANT OWNERSHIP ON DATABASE na_external_db TO ROLE consumer_role;
    
    Copy
  3. Para excluir o aplicativo, 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.