Diretrizes para publicar um aplicativo no Snowflake Marketplace¶

Publicação de um aplicativo no Snowflake Marketplace¶

Quando seu pacote de aplicativo estiver pronto para ser publicado no Snowflake Marketplace, você deverá enviá-lo ao Snowflake para aprovação.

Antes de criar uma listagem, verifique se você entende os requisitos aplicados e certifique-se de que seu pacote de aplicativos siga cada requisito. Se um pacote de aplicativo não atender a esses requisitos, seu envio poderá ser rejeitado.

Se você receber uma notificação de rejeição para o pacote de aplicativo enviado, faça as alterações recomendadas e reenvie seu pacote de aplicativo para aprovação.

Padrões para o Snowflake Native Apps no Snowflake Marketplace¶

A Snowflake fornece uma plataforma que permite aos provedores criar, distribuir e monetizar aplicativos.

O processo de revisão do Snowflake garante a qualidade dos aplicativos publicados no Snowflake Marketplace. Para garantir um processo de revisão simplificado, a Snowflake fornece os seguintes requisitos e diretrizes para aplicativos publicados no Snowflake Marketplace.

Utilidade imediata

Todas as funcionalidades do aplicativo devem ser fornecidas na conta do consumidor quando o aplicativo for instalado. Por exemplo, quando um consumidor instala um aplicativo em sua conta, todas as funcionalidades do aplicativo devem estar disponíveis sem exigir que o consumidor instale componentes adicionais.

Autonomia

Os aplicativos devem oferecer a experiência do produto no Snowflake e facilitar os requisitos externos por meio da funcionalidade do Snowflake.

Centrado em dados

Os aplicativos devem ser baseados em casos de uso centrados em dados que aproveitam os dados armazenados no Snowflake.

Transparente e simples

Os aplicativos devem usar os recursos do Snowflake para divulgar os requisitos de recursos e acesso do aplicativo e simplificar o processo de configuração para o consumidor.

Requisitos aplicados¶

A Snowflake usa as seguintes diretrizes para determinar se o Snowflake Native App atende aos requisitos para publicação no Snowflake Marketplace. Esses requisitos são verificados quando você envia uma listagem com um pacote de aplicativo anexado ao Snowflake Marketplace.

1. Utilidade imediata

   1. Os aplicativos não devem ser aplicativos shell que anunciam funcionalidade.

   2. Os aplicativos devem incluir uma estrutura clara e instruções para a utilização da funcionalidade do aplicativo.

   3. Os aplicativos não devem travar, congelar ou funcionar de forma anormal.

   4. Os aplicativos devem listar todas as credenciais necessárias e os provedores devem compartilhar as credenciais necessárias com a Snowflake no momento do envio para teste.

   5. Os aplicativos devem ser imediatamente acionáveis, permitindo que os consumidores instalem e configurem totalmente o aplicativo sem a necessidade de entrar em contato com o provedor.

2. Autonomia

   1. Os aplicativos não devem redirecionar os consumidores para um serviço externo para habilitar a funcionalidade do aplicativo.

   2. As interfaces de aplicativos devem estar acessíveis após a instalação diretamente do Snowflake.

   3. Os aplicativos não podem exigir que os consumidores criem usuários ou funções que forneçam acesso a um serviço externo na conta do consumidor Snowflake.

   4. Os aplicativos não podem usar o Snowflake Marketplace como uma plataforma de distribuição para vendas cruzadas de aplicativos ou serviços externos.

3. Centrado em dados

   1. Os aplicativos devem aproveitar os dados do Snowflake de uma das seguintes maneiras:

      1. Compartilhe os dados da conta do provedor do aplicativo.

      2. Use conjuntos de dados do Snowflake Marketplace.

      3. Acesse os dados na conta do consumidor.

4. Transparência

   1. Todos os privilégios e referências de nível de conta que o aplicativo requer devem ser listados no arquivo de manifesto do pacote do aplicativo.

   2. Todos os requisitos de recurso para o Native App Snowflake devem ser listados no arquivo marketplace.yml do aplicativo. O aplicativo deve criar esses recursos como parte da instalação e configuração.

   3. Todos os privilégios e referências em nível de conta listados no arquivo de manifesto do pacote de aplicativo devem ser solicitados ao consumidor por meio do Snowsight ou do Python Permission SDK.

   4. Os aplicativos devem fornecer um arquivo readme. Os aplicativos que não incluem uma interface de usuário personalizada ou Streamlit devem incluir as seguintes informações no arquivo readme:

      1. Uma descrição do que o aplicativo faz.

      2. As etapas que o consumidor deve realizar para configurar o aplicativo após sua instalação.

      3. Os procedimentos armazenados e funções definidas pelo usuário que o aplicativo usa.

      4. Os privilégios que o aplicativo exige.

      5. Exemplo de comandos SQL que mostram aos consumidores como usar o aplicativo.

   5. Todos os comandos SQL necessários devem ser fornecidos usando o Snowflake e formatados como blocos de código.

   6. Se o aplicativo fornecer dados de amostra, você deverá incluir procedimentos sobre como usar os dados de amostra.

Práticas recomendadas ao publicar um Snowflake Native App¶

Além dos requisitos para enviar um pacote de aplicativos para Snowflake Marketplace, a Snowflake também recomenda as seguintes práticas recomendadas ao publicar um Snowflake Native App:

• Certifique-se de que todos os arquivos necessários sejam carregados no estágio nomeado para a versão do aplicativo que você está enviando, incluindo:

  • O arquivo manifest.yml.

  • O script de configuração.

  • O arquivo readme.md.

  • Quaisquer procedimentos armazenados externos ou funções definidas pelo usuário exigidas pelo pacote de aplicativos.

  • Quaisquer arquivos Streamlit exigidos pelo pacote de aplicativos.

  • Qualquer código-fonte externo, incluindo Python, Java etc.

• Certifique-se de que a versão do aplicativo que você está desenvolvendo passe na verificação de segurança automatizada.

• Teste a nova versão do seu pacote de aplicativos criando o objeto do aplicativo localmente usando o comando CREATE APPLICATION.

  • Não adicione uma nova versão ao pacote do aplicativo nem defina a propriedade DISTRIBUTION como EXTERNAL enquanto estiver desenvolvendo e testando um aplicativo. Essas ações acionam a verificação de segurança automatizada, o que atrasa o ciclo de desenvolvimento.

    Em vez disso, crie o objeto do aplicativo usando arquivos em um estágio nomeado.

  • Se seu aplicativo incluir um aplicativo Streamlit, teste-o em Snowsight para garantir que ele funcione conforme o esperado.

  • Verifique se as interações entre o aplicativo Streamlit e as planilhas Snowflake são perfeitas e se o consumidor não precisa navegar excessivamente entre os dois.

• Revise todas as partes de uma listagem antes de enviá-la para aprovação.

• Certifique-se de que não haja erros de digitação ou outros erros textuais na listagem, no arquivo readme e no aplicativo Streamlit.