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

Os aplicativos devem fornecer aos consumidores utilidade imediata e ser usados no Snowflake sem requisitos externos.

Autonomia

Os aplicativos devem ser autônomos. Os consumidores devem poder usar o aplicativo e a funcionalidade do aplicativo em sua conta.

Acesso responsável aos dados

Os aplicativos que acessam os dados do Snowflake devem usar os dados adequadamente.

Monetizado na plataforma

A Snowflake recomenda que os aplicativos monetizados usem os recursos de monetização fornecidos pela Snowflake. Quando um aplicativo usa a monetização na plataforma do Snowflake, os usuários do Snowflake podem usar seus compromissos de capacidade para comprar soluções de terceiros.

Transparência

Os aplicativos devem usar os recursos do Snowflake para maximizar a visibilidade do recurso e do acesso do aplicativo. Os aplicativos devem simplificar o processo de configuração ao consumidor.

Requisitos aplicados¶

A Snowflake usa os seguintes padrões para determinar se um 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 para utilizar a funcionalidade do aplicativo.

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 do aplicativo devem ser acessíveis após a instalação diretamente do Snowflake com uma UI do Streamlit ou uma UI personalizada hospedada no 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. Acesso responsável aos dados

   1. Os aplicativos devem aproveitar os dados 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. Monetizado na plataforma

   1. Os aplicativos monetizados na plataforma devem incluir todas as funcionalidades do Snowflake.

5. 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. Se uma listagem incluir um privilégio ou referência no nível da conta na seção security do arquivo de manifesto e o pacote do aplicativo contiver um aplicativo Streamlit, você deverá usar o Snowsight para criar uma interface de usuário para solicitar privilégios e referências do consumidor.

   4. Se um pacote de aplicativo não incluir um aplicativo Streamlit ou uma interface de usuário personalizada para o aplicativo, o arquivo leiame incluído no pacote do aplicativo deverá conter as seguintes informações:

      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. Se o arquivo leia-me incluir instruções SQL ou exemplos de código, você deverá usar blocos de código.

   6. Use um aplicativo Streamlit de página única ou múltiplas páginas em vez de vários aplicativos Streamlit separados, sempre que possível. Isso inclui aplicativos Streamlit multiusuário.

   7. Se o aplicativo fornecer dados de amostra, você deverá incluir procedimentos sobre como usar os dados de amostra, incluindo o código necessário para criar o banco de dados, se necessário.

   8. Se um pacote de aplicativo não contiver um arquivo leiame, será necessário fornecer exemplos de uso na seção Sample SQL da listagem, configurar um aplicativo Streamlit padrão ou um ponto de extremidade da Web padrão.

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.