Modificação de listagens publicadas¶
Este tópico descreve como modificar as listagens após terem sido publicadas no Snowflake Marketplace ou compartilhadas com os consumidores como uma listagem privada.
Neste tópico:
Privilégios necessários para editar listagens¶
Para modificar as listagens, você deve ser o proprietário da listagem ou ter o privilégio MODIFY em uma listagem. Consulte Privilégio MODIFY em uma listagem.
Edição de uma listagem publicada no Snowflake Marketplace¶
Ao editar uma listagem publicada no Snowflake Marketplace, considere o seguinte:
Quando você edita uma listagem publicada no Snowflake Marketplace, um novo rascunho de listagem é criado. Para disponibilizar essas mudanças aos consumidores, é necessário enviar novamente o rascunho da listagem para aprovação e publicá-la.
A edição das regiões e campos de necessidades comerciais disponíveis não requer aprovação. Você pode fazer essas mudanças a qualquer momento.
Se você remover uma região que estava disponível anteriormente, os consumidores dessa região não terão mais acesso ao conjunto de dados compartilhado.
Quando a nova versão de uma listagem é publicada, a versão anterior será substituída e não poderá ser recuperada.
Se você quiser atualizar o produto de dados associado a uma listagem, consulte Atualizar um compartilhamento de dados.
Para editar uma listagem publicada no Snowflake Marketplace, conclua as seguintes etapas:
Faça login no Snowsight.
No menu de navegação, selecione Data Products » Provider Studio.
Selecione Listings, depois selecione a listagem que você deseja editar.
Para adicionar ou remover regiões onde a listagem está disponível, clique em Edit na seção Region Availability. As etapas seguintes não exigem aprovação do administrador e podem ser ignoradas.
Para alterar outros campos, como a descrição da listagem, clique em Edit na seção aplicável e selecione Continue quando solicitado. Isso cria um novo rascunho da listagem que só ficará visível para os consumidores quando for enviado, aprovado e publicado.
Se houver mudanças em andamento, selecione a opção New Draft ao lado do título da listagem para continuar trabalhando em um rascunho existente. Você pode descartar esse rascunho selecionando o botão Delete no canto superior direito da página.
Selecione Submit for Approval quando estiver tudo pronto para enviar seu novo rascunho da listagem para análise.
Edição de uma listagem privada¶
Você pode editar rascunhos ou publicar listagens privadas no Provider Studio. Se você editar uma listagem privada publicada, quaisquer mudanças que você fizer estarão imediatamente disponíveis para os consumidores após salvar essas mudanças.
Se você quiser atualizar o produto de dados associado a uma listagem, consulte Atualizar um compartilhamento de dados para fins de orientação.
Para editar uma listagem privada, faça o seguinte:
Faça login no Snowsight.
No menu de navegação, selecione Data Products » Provider Studio.
Selecione Listings e escolha a listagem que você deseja editar.
Faça as mudanças desejadas e clique em Save.
Adição de selos de conformidade a uma listagem¶
O Snowflake oferece dois métodos para adicionar selos de certificação a listagens:
Atualize uma listagem usando um estágio.
Atualize uma listagem usando arquivos locais.
Nota
Atualmente, a adição de selos de conformidade a listagens só pode ser feita por meio de APIs de listagem.
Atualização de uma listagem usando um estágio¶
Para atualizar uma listagem que inclui selos de conformidade usando um estágio, conclua as etapas a seguir:
Para encontrar o nome da listagem, use SHOW LISTINGS; por exemplo:
SHOW LISTINGS IN DATA EXCHANGE snowflake_data_marketplace;
Para revisar o arquivo manifesto.yml da listagem, use DESCRIBE LISTING em uma listagem; por exemplo:
DESCRIBE LISTING <listing_name>;
Na saída do comando DESCRIBE LISTING, copie o conteúdo da coluna manifest.yml para um novo arquivo de manifesto.
No novo arquivo de manifesto, adicione o campo
compliance_badgese inclua uma linha para cada tipo de certificação; por exemplo:title: "My listing title" subtitle: "My listing subtitle" description: "My listing description" profile: "MyProfile" … compliance_badges: - type: SOC2 expiry: 12-25-2026 files: - soc2_compliance_verification.pdf - type: HIPAA expiry: 06-07-2026 files: - hipaa_compliance_verification.pdf
Para carregar seu novo arquivo de manifesto de listagem em um estágio do Snowflake, execute o seguinte comando:
PUT file:///<path_to_new_manifest_file> @<stage_name> SOURCE_COMPRESSION=None AUTO_COMPRESSION=False OVERWRITE=True;
Para carregar sua documentação de suporte para o mesmo estágio do Snowflake, execute o seguinte comando:
PUT file:///<path_to_soc2_compliance_report> @<stage_name> PUT file:///<path_to_hipaa_compliance_report> @<stage_name> SOURCE_COMPRESSION=None AUTO_COMPRESSION=False OVERWRITE=True;
Para carregar uma nova versão da listagem do estágio, use ALTER LISTING; por exemplo:
ALTER LISTING <listing_name> ADD VERSION FROM @<stage_name>;
Para enviar a listagem para revisão, execute o seguinte comando:
ALTER LISTING <listing_name> REVIEW;
Para publicar a listagem atualizada após ela ter sido aprovada, execute o seguinte comando:
ALTER LISTING <listing_name> PUBLISH;
Atualização de uma listagem usando arquivos locais¶
Para atualizar uma listagem que inclui selos de conformidade usando arquivos locais, conclua as etapas a seguir:
Para encontrar o nome da listagem, use SHOW LISTINGS; por exemplo:
SHOW LISTINGS IN DATA EXCHANGE snowflake_data_marketplace;
Para revisar o arquivo manifesto.yml da listagem, use DESCRIBE LISTING em uma listagem; por exemplo:
DESCRIBE LISTING <listing_name>;
Na saída de DESCRIBE LISTING, copie o conteúdo da coluna manifest.yml em um novo arquivo de manifesto.
No novo arquivo de manifesto, adicione uma seção
compliance_badgese inclua uma linha para cada tipo de certificação; por exemplo:title: "My listing title" subtitle: "My listing subtitle" description: "My listing description" profile: "MyProfile" … compliance_badges: - type: SOC2 expiry: 12-25-2026 files: - soc2_compliance_verification.pdf
Para adicionar uma versão editável e ativa da listagem, use ALTER LISTING; por exemplo:
ALTER LISTING <listing_name> ADD LIVE VERSION FROM LAST;
Para adicionar os arquivos de selo e o arquivo de manifesto atualizado à versão ativa da listagem, execute os seguintes comandos:
PUT file:///<path_to_soc2_compliance_report> snow://listing/<name>/versions/live SOURCE_COMPRESSION=None AUTO_COMPRESSION=False OVERWRITE=True; PUT file:///<path_to_new_manifest_file> snow://listing/<name>/versions/live SOURCE_COMPRESSION=None AUTO_COMPRESSION=False OVERWRITE=True;
Para confirmar a versão ativa da listagem, use ALTER LISTING.
Isso adicionará as alterações recentes à solicitação de aprovação.
ALTER LISTING <listing_name> COMMIT;
Para enviar a listagem para revisão, execute o seguinte comando:
ALTER LISTING <listing_name> REVIEW;
Para publicar a listagem atualizada após ela ter sido aprovada, execute o seguinte comando:
ALTER LISTING <listing_name> PUBLISH;
Confirme que o selo de conformidade foi adicionado à listagem¶
Após adicionar um selo de conformidade a uma listagem, você pode confirmar que o selo foi adicionado corretamente usando SQL.
Para confirmar que o selo de conformidade foi adicionado a uma listagem, conclua as etapas a seguir:
Execute o seguinte comando:
DESCRIBE LISTING <listing_name> REVISION = DRAFT;
Na saída, verifique se a coluna
manifest.ymlinclui uma seçãocompliance_badges.
Cancelamento da publicação de uma listagem¶
Para ocultar uma listagem do Snowflake Marketplace sem excluí-la, você pode cancelar a publicação da listagem.
Nota
Ao cancelar a publicação de uma listagem, os consumidores existentes ainda poderão acessar o produto de dados associado à listagem, a menos que você o remova do compartilhamento. Consulte Atualizar um compartilhamento de dados. Para remover uma listagem e o acesso à listagem de todos os consumidores que a utilizam, exclua a listagem. Consulte Remoção de listagens como um provedor.
Para cancelar a publicação de uma listagem, faça o seguinte:
No menu de navegação de Snowsight, selecione Data Products » Provider Studio.
Selecione Listings.
Selecione o nome da listagem cuja publicação você deseja cancelar.
No canto superior direito, a partir da lista suspensa Live, selecione Unpublish.
Nota
Se a listagem for automaticamente replicada para outras regiões usando o preenchimento automático, a listagem permanecerá replicada para as regiões remotas. Para remover o produto de dados replicados de outras regiões, altere a disponibilidade da listagem na região. Consulte Region availability (somente listagens do Marketplace).
Republicação de uma listagem¶
Ao republicar uma listagem no Snowflake Marketplace, você não precisa enviar a listagem para aprovação, a menos que tenha feito alterações na listagem.
Para republicar uma listagem, faça o seguinte:
No menu de navegação de Snowsight, selecione Data Products » Provider Studio.
Selecione Listings.
Selecione o nome da listagem que você deseja republicar.
No canto superior direito, na lista suspensa, selecione Publish Listing.
Modificação de listagens pagas¶
Você pode modificar o preço e o plano de preços para listagens pagas, com algumas restrições.
Alteração do preço de uma listagem paga¶
Se você quiser alterar o preço de uma listagem paga no Snowflake Marketplace, você deve enviar a listagem para aprovação novamente. A aprovação é uma parte técnica do processo de republicação de uma listagem modificada. A Snowflake não fornece feedback sobre a mudança de preço.
Você não pode alterar o preço de uma listagem para zero dólares. Para transformar uma listagem paga em gratuita, você deve criar uma nova listagem.
Após a aprovação e a publicação da listagem com novo preço, o Snowflake notifica automaticamente os consumidores atuais sobre a alteração do preço.
Depois de alterar o preço do seu plano de preços:
Novos consumidores veem e são cobrados de acordo com o novo plano de preços imediatamente.
Os consumidores existentes serão cobrados pela tarifa anterior até o fim do ciclo de faturamento atual.
Se você alterar o preço menos de 30 dias antes do início do próximo ciclo de faturamento, os clientes serão cobrados pela taxa anterior para o próximo ciclo de faturamento e pela nova taxa para o ciclo de faturamento seguinte.
Se você alterar o preço mais de 30 dias antes do início do próximo ciclo de faturamento, os clientes receberão a nova taxa para o próximo ciclo de faturamento.
Por exemplo, para um plano de preços baseado no uso com cobrança mensal, se você alterar o preço em 15 de outubro, os consumidores existentes serão cobrados pela taxa anterior da fatura de outubro e da fatura de novembro, mas serão cobrados pela nova taxa na fatura de dezembro.
Para cenários específicos, consulte esta tabela de exemplo:
Plano de preços |
Ciclo de faturamento |
Data de início do plano |
Data de alteração de preço |
Fatura onde o novo preço é refletido |
|---|---|---|---|---|
Baseado no uso |
1 mês |
1.º de janeiro de 2023 |
15 de junho de 2023 |
1.º de agosto de 2023 |
Baseado no uso |
1 mês |
1.º de janeiro de 2023 |
2 de junho de 2023 |
1.º de agosto de 2023 |
Baseado no uso |
1 mês |
1.º de janeiro de 2023 |
30 de maio de 2023 |
1.º de julho de 2023 |
Baseado em assinatura |
3 meses, recorrente |
1.º de janeiro de 2023 |
15 de fevereiro de 2023 |
1.º de abril de 2023 |
Baseado em assinatura |
3 meses, recorrente |
1.º de janeiro de 2023 |
15 de março de 2023 |
1.º de julho de 2023 |
Alteração do plano de preço de uma listagem paga¶
Você pode alterar o plano de preços de uma listagem paga ao editar a listagem. Se você quiser alterar o plano de preços, considere o seguinte:
Você não pode remover um plano de preços de uma listagem paga para torná-la uma listagem gratuita. Consulte Alteração de listagens existentes para listagens pagas.
Você não pode alterar o tipo de plano de preços. Se sua listagem tiver atualmente um plano de preços baseado no uso, você não poderá alterar o plano para um plano de preços baseado em assinatura e vice-versa.
Se sua listagem paga for publicada no Snowflake Marketplace, você deve enviar a listagem novamente para aprovação após alterar o plano de preços. Depois que o plano de preços atualizado for aprovado e a listagem atualizada for publicada, o Snowflake notificará automaticamente os consumidores atuais da listagem sobre a alteração do plano de preços.
Quando você altera o plano de preços, os consumidores existentes serão cobrados com base no novo plano de preços após o fim do próximo ciclo de faturamento. Os novos consumidores veem o novo plano de preços imediatamente.
Alteração de listagens existentes para listagens pagas¶
Você não pode converter uma listagem gratuita em uma listagem paga. Se você tiver publicado uma lista sem um plano de preços, não será possível adicionar um posteriormente.
Para oferecer uma listagem paga, você deve anexar um plano de preços à listagem antes da primeira publicação.
Da mesma forma, você não poderá converter uma listagem paga em uma listagem gratuita. Se você tiver publicado uma listagem com um plano de preços, você não poderá alterar o plano de preços para nulo, ou alterar o preço para zero. Para alterar o preço para algum outro valor, consulte Alteração do preço de uma listagem paga.
Se você quiser mudar o tipo de listagem que oferece, crie a nova listagem que deseja oferecer e cancele a publicação da listagem existente. Por exemplo, se você quiser substituir uma listagem gratuita por uma listagem paga, cancele a publicação da listagem gratuita e crie uma listagem paga com o mesmo conteúdo. Consulte Cancelamento da publicação de uma listagem.