Publish an app to consumers

After developing and testing the application package containing your app, you can publish the app to consumers using listings.

Como provedor, você adiciona um pacote de aplicativo como o conteúdo de dados de uma listagem. O consumidor instala o aplicativo em sua conta a partir da listagem.

Configuração de funções e privilégios

Quando você cria uma listagem, você a cria a partir da conta que tem os dados ou pacote de aplicativo nela contidos. A função que anexa um produto de dados a uma listagem e publica a listagem deve ser a mesma que criou e, portanto, possui o pacote de aplicativo ou compartilhamento. Você não pode transferir o privilégio OWNERSHIP para um compartilhamento.

Se você usar uma função diferente para criar e gerenciar a listagem, conceda o privilégio MODIFY na listagem à função que possui o pacote de aplicativo ou compartilhamento. Por exemplo:

Função de proprietário de compartilhamento ou pacote de aplicativo:

Privilégio OWNERSHIP no pacote de aplicativo ou compartilhamento. Privilégio MODIFY na listagem.

Função de proprietário da listagem:

Privilégio OWNERSHIP na listagem.

Privilégio global CREATE LISTING.

Na conta do provedor, você pode usar um dos seguintes itens para criar e gerenciar listagens:

ACCOUNTADMIN:

Se você usar a função ACCOUNTADMIN para criar e gerenciar listagens, a função ORGADMIN deverá primeiro ser Delegar privilégios para configurar o preenchimento automático.

Função personalizada:

Se você usar uma função personalizada, a função ORGADMIN deverá primeiro ser Delegar privilégios para configurar o preenchimento automático para a função ACCOUNTADMIN, que poderá então ser usada para conceder os privilégios relevantes à função personalizada.

Para obter mais informações sobre a concessão de privilégios de compartilhamento, consulte Concessão de privilégios a outras funções:.

Pré-requisitos para publicar uma listagem para um pacote de aplicativo

Antes de criar uma listagem para um pacote de aplicativo, certifique-se de ter concluído o seguinte:

  • Crie e teste seu pacote de aplicativo.

    Antes de publicar seu pacote de aplicativo, verifique se ele está funcionando corretamente e se as funções e privilégios estão definidos corretamente.

  • Como se tornar um provedor de listagens

    Tornar-se um provedor de listagens no Snowflake facilita a gestão do compartilhamento de aplicativos da sua conta com outras contas Snowflake. Para obter mais informações, consulte Uso das listagens como um provedor.

    A criação de um perfil de provedor não é necessária para listagens privadas.

Fluxo de trabalho para publicar um pacote de aplicativo

Para publicar um pacote de aplicativo:

  1. Certifique-se de ter atendido os pré-requisitos para publicar uma listagem para um pacote de aplicativo.

  2. Defina a diretriz de versão padrão.

  3. Inicie a verificação de segurança automatizada.

  4. Crie uma listagem.

  5. (Opcional) Adicione um plano de preços para receber pagamento pelo seu aplicativo.

  6. Envie sua listagem para aprovação.

    Você só precisa aprovar as listagens publicadas no Snowflake Marketplace.

  7. Publique sua listagem.

Definição da diretriz de versão padrão

Before creating a listing for an application package, you must specify the default release directive that points to the version or patch of the app you are publishing.

If you are using release channels to manage the versions of your app, you can set custome release directive for each release channel. You must set the default release directive on the default release channel.

For more information, see Definir a diretriz de lançamento usando um canal de lançamento

If you are publishing your app using the legacy versioning method, you can set the default release directive on the application package. For more information, see Set the release directive for an app (Legacy)

Como iniciar a verificação de segurança automatizada para um pacote de aplicativo

Para publicar uma listagem de um pacote de aplicativo em uma conta fora de sua organização, seu pacote de aplicativo deve passar por uma verificação de segurança automatizada.

The automated security scan is initiated when you set the DISTRIBUTION property of the application package to EXTERNAL or when you add a new version or patch to an application package that has the DISTRIBUTION property set to EXTERNAL. For more information, see Requisitos e diretrizes de segurança para um Snowflake Native App.

Create a listing for an app

To share your app with consumers, create a listing and add the application package as the data product of the listing.

Create a private listing for an app

To publish your app to specific consumers, create a listing:

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data sharing » Provider Studio.

  3. Selecione + Create Listing. A janela Create Listing é aberta.

  4. Digite um nome para sua listagem.

  5. Na seção Who can discover the listing, selecione Only specified consumers para compartilhar privadamente a listagem com contas específicas.

  6. Clique em + Select para selecionar o pacote de aplicativo a serem incluídos na listagem.

  7. Digite uma descrição para sua listagem.

  8. (Opcional) Se você tiver vários perfis do provedor, selecione o perfil de provedor usado para publicar esta listagem.

  9. Na seção Add consumer accounts, adicione os identificadores de conta para os consumidores com os quais você deseja compartilhar a listagem.

  10. Se as contas do consumidor estiverem localizadas em outra região, configure o preenchimento automático:

    1. Revise a frequência de atualização configurada no nível da conta. Se precisar usar uma frequência de atualização diferente, consulte Definir o intervalo de atualização no nível da conta.

    2. Opcional: selecione um warehouse a ser usado para configurar o preenchimento automático.

  11. Selecione Publish para publicar a listagem para os consumidores selecionados, ou selecione Save Draft para salvá-la como um rascunho.

Para monetizar seu aplicativo, adicione um plano de preços.

Create a listing for an app published to the Snowflake Marketplace

To publish your app on the Snowflake Marketplace, create a listing:

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data sharing » Provider Studio.

  3. Selecione + Create Listing. A janela Create Listing é aberta.

  4. Digite um nome para sua listagem.

  5. Na seção Who can discover the listing, selecione Anyone on the Marketplace para publicar a listagem no Snowflake Marketplace.

  6. Na seção How will consumers access the data product?, selecione Free ou Paid.

  7. Selecione Next. É criado um rascunho da listagem.

Antes de publicar o rascunho de sua listagem, você deve configurar capacidades adicionais necessárias e opcionais.

Configuração de uma listagem do Snowflake Marketplace para um pacote de aplicativo

Depois de criar uma listagem privada para o Snowflake Marketplace, você deve configurar as informações adicionais para sua listagem antes de enviá-la para aprovação e publicá-la.

Para configurar uma listagem:

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data sharing » Provider Studio.

  3. Selecione a aba Listings, depois selecione o rascunho de listagem que você deseja configurar.

  4. Selecione Add ao lado de cada seção que aparece na página e forneça as informações necessárias.

    À medida que você fornece informações para cada seção, consulte Configuração de listagens para obter mais informações sobre cada campo. As propriedades específicas disponíveis para edição dependem do tipo de listagem que você cria.

    Se você deseja monetizar seu Snowflake Native App, adicione um plano de preços para ser pago por seu Snowflake Native App.

Envie uma listagem para aprovação.

Antes de poder publicar uma listagem no Snowflake Marketplace, você deve enviar a listagem ao Snowflake para aprovação.

Se você quiser enviar sua listagem para aprovação, mas a opção de Submit for Approval estiver desativada, verifique o seguinte:

  • Você concluiu as etapas para configurar a listagem.

  • Você é o ACCOUNTADMIN ou tem o privilégio OWNERSHIP para o produto de dados anexado à listagem.

  • Todas as consultas SQL de amostra anexadas à validação de aprovação da listagem.

Para enviar uma listagem para aprovação:

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data sharing » Provider Studio.

  3. Selecione a aba Listings, depois selecione o rascunho de listagem que você deseja enviar para aprovação.

  4. Selecione Submit for Approval.

    Após a listagem ser revista pela Snowflake, o estado muda para Approved ou Denied.

    Se a listagem tiver sido recusada, atualize a listagem com base no feedback fornecido nos comentários e envie-a novamente para aprovação.

    Quando uma listagem é aprovada ou rejeitada, uma notificação por e-mail é enviada tanto para o contato comercial quanto para o contato técnico no perfil do provedor associado à listagem.

Publish a listing for an app

Para publicar uma listagem aprovada no Snowflake Marketplace:

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data sharing » Provider Studio.

  3. Selecione a aba Listings, depois selecione a listagem que você deseja publicar.

  4. Selecione Publish.

Depois de publicar sua listagem no Snowflake Marketplace, você pode definir um link de referência para compartilhar um link direto para sua listagem com os consumidores.