Criação e gerenciamento de uma listagem¶
Este tópico contém procedimentos para a criação e publicação de uma listagem de maneira privada ou no Snowflake Marketplace.
Neste tópico:
Pré-requisitos para criação de listagem¶
Concorde com os Termos de serviço do provedor e consumidor da Snowflake. A aceitação dos Termos do Provedor e do Consumidor do Snowflake não é necessária para a criação de listagens privadas gratuitas ou pagas fora da plataforma, mas você deve analisar e aceitar os Termos da Funcionalidade de Compartilhamento de Dados Controlados pelo Cliente do Snowflake.
Revisar as Políticas do provedor.
Crie um perfil de provedor para oferecer listagens pagas ou listagens no Snowflake Marketplace.
Se você quiser cobrar pelo seu produto de dados, configure sua conta para fornecer listagens pagas.
Tenha acesso a uma função com privilégios do provedor.
Preparar os dados para sua listagem. Consulte Como preparar dados para uma listagem.
Para saber mais sobre os requisitos para se tornar um provedor, consulte Uso das listagens como um provedor.
Considerações sobre o compartilhamento de listagens com contas em regiões governamentais dos US¶
Provedores não governamentais que desejam compartilhar listagens com contas de consumidores nas regiões governamentais dos US devem considerar os seguintes detalhes:
A conta na região governamental dos US deve habilitar o compartilhamento e a colaboração de dados. Consulte Preparação para acessar listagens de contas em regiões governamentais dos EUA.
Você deve usar o preenchimento automático entre nuvens, e seu produto de dados só pode conter ou referenciar objetos compatíveis com preenchimento automático.
Se você oferecer uma listagem para regiões governamentais dos US no Snowflake Marketplace ou diretamente para uma conta de consumidor em uma região governamental dos US, a área de compartilhamento seguro (SSA) criada para preencher automaticamente a listagem para essa região incorre em custos na taxa específica para essa região. Consulte a tabela de consumo disponível em Jurídico Snowflake, o guia de preços e Custos de autoatendimento.
Compartilhamento de dados ou aplicativos com consumidores específicos usando uma listagem privada¶
Você pode criar listagens gratuitas ou pagas para compartilhar diretamente com consumidores específicos. Você pode criar uma listagem privada para atender a uma solicitação de uma listagem de avaliação limitada ou para compartilhar dados ou aplicativos com um consumidor com quem você já tem um relacionamento comercial.
Você deve saber o identificador da conta de um consumidor para compartilhar uma listagem com ele. Consulte Como encontrar o nome da conta e organização de uma conta.
Nota
Sua função deve ter os privilégios necessários para criar uma listagem. Consulte Privilégios necessários para trabalhar com listagens.
Criar uma listagem privada gratuita (ou paga fora da plataforma)¶
Faça login no Snowsight.
No menu de navegação, selecione Data sharing » Provider Studio.
Selecione + Create Listing » Specified Consumers.
Na caixa de diálogo Edit listing title, insira um nome para sua listagem.
Selecione o botão Add data product e clique em + Select para selecionar os objetos a serem anexados à listagem.
Se você selecionar um ou mais objetos de banco de dados, Snowflake cria um compartilhamento seguro com esses objetos. Você pode mudar o nome do compartilhamento seguro.
Se você selecionar um compartilhamento seguro existente, o nome desse compartilhamento será exibido.
Na lista suspensa Access type, selecione Free.
Na seção Who can access, adicione os nomes de conta e organização para os consumidores com os quais você deseja compartilhar a listagem.
Se você adicionar uma conta de consumidor em uma região diferente da sua região local, o Snowflake habilitará o preenchimento automático para replicar os dados para a região remota depois que um consumidor obtiver sua listagem. Execute as seguintes etapas adicionais:
Na seção Auto-fulfillment, insira um valor e selecione um intervalo para especificar com que frequência seu produto de dados será replicado da sua região para a região remota.
Se você não tiver um warehouse padrão definido, selecione um warehouse para usar para preenchimento automático.
Digite uma descrição para sua listagem.
Na seção Legal Terms, selecione os termos legais que se aplicam à sua listagem.
Se você não vir nenhum termo legal, primeiro deverá aceitar os Termos do Fornecedor e do Consumidor do Snowflake.
(Opcional) Na seção Attributes, adicione atributos personalizados à sua listagem. Para obter mais informações, consulte Produto de dados - Atributos.
(Opcional) Clique na seção Data dictionary para adicionar objetos em destaque do dicionário de dados da listagem. Para obter mais informações, consulte Como configurar um dicionário de dados para sua listagem.
(Opcional) Clique na seção Business needs para adicionar tags que descrevam as necessidades comerciais que seu produto de dados atende. Para obter mais informações, consulte Necessidades comerciais.
(Opcional) Clique na seção Quick Start Examples para adicionar exemplos de consultas SQL ou um notebook que demonstre como usar o produto de dados. Para obter mais informações, consulte Anexação de um notebook a uma listagem do Snowflake Marketplace.
Selecione Publish para publicar a listagem para os consumidores selecionados. O Snowflake salva sua listagem se você não a publica imediatamente.
Criação de uma listagem privada paga¶
The following example shows how to create a private listing that includes a pricing plan and an offer.
Faça login no Snowsight.
No menu de navegação, selecione Data sharing » Provider Studio.
Selecione + Create Listing » Specified Consumers.
Na caixa de diálogo Edit listing title, insira um nome para sua listagem.
Selecione o botão Add data product e clique em + Select para selecionar os objetos a serem anexados à listagem.
Se você selecionar um ou mais objetos de banco de dados, Snowflake cria um compartilhamento seguro com esses objetos. Você pode mudar o nome do compartilhamento seguro.
Se você selecionar um compartilhamento seguro existente, o nome desse compartilhamento será exibido.
In the Access type dropdown, select Paid.
Na seção Who can access, adicione os nomes de conta e organização para os consumidores com os quais você deseja compartilhar a listagem.
Se você adicionar uma conta de consumidor em uma região diferente da sua região local, o Snowflake habilitará o preenchimento automático para replicar os dados para a região remota depois que um consumidor obtiver sua listagem. Execute as seguintes etapas adicionais:
Na seção Auto-fulfillment, insira um valor e selecione um intervalo para especificar com que frequência seu produto de dados será replicado da sua região para a região remota.
Se você não tiver um warehouse padrão definido, selecione um warehouse para usar para preenchimento automático.
Digite uma descrição para sua listagem.
Na seção Legal Terms, selecione os termos legais que se aplicam à sua listagem.
Se você não vir nenhum termo legal, primeiro deverá aceitar os Termos do Fornecedor e do Consumidor do Snowflake.
(Opcional) Na seção Attributes, adicione atributos personalizados à sua listagem. Para obter mais informações, consulte Produto de dados - Atributos.
(Opcional) Clique na seção Data dictionary para adicionar objetos em destaque do dicionário de dados da listagem. Para obter mais informações, consulte Como configurar um dicionário de dados para sua listagem.
(Opcional) Clique na seção Business needs para adicionar tags que descrevam as necessidades comerciais que seu produto de dados atende. Para obter mais informações, consulte Necessidades comerciais.
(Opcional) Clique na seção Quick Start Examples para adicionar exemplos de consultas SQL ou um notebook que demonstre como usar o produto de dados. Para obter mais informações, consulte Anexação de um notebook a uma listagem do Snowflake Marketplace.
Clique na seção Pricing para configurar as informações de preços da sua listagem. Para obter mais informações sobre planos de preços e ofertas, consulte Planos de preços e ofertas.
Na guia Pricing plans, selecione Create pricing plan.
Na caixa de diálogo Settings, especifique um nome de exibição para seu plano de preços e clique em Next.
Na caixa de diálogo Pricing details, especifique um modelo de preços. Você pode escolher Usage-based ou Flat fee.
Se você selecionar Usage-based, especifique os seguintes detalhes:
A taxa de acesso baseada no uso (mensalidade).
O custo por consulta e o número de consultas incluídas (opcional).
A cobrança mensal máxima (opcional).
Se você selecionar Flat fee, especifique o valor da taxa fixa e a frequência de cobrança.
Clique em Next.
Na caixa de diálogo Summary, revise os detalhes de preços e clique em Done.
Navegue até a guia Offers.
Na guia Offers, selecione + Create offer.
Na caixa de diálogo Offer details, especifique os detalhes da oferta.
Select Standard offer.
No menu suspenso Purchase type, selecione Self-serve para permitir que os consumidores vejam o preço e comprem a listagem diretamente ou selecione Sales-led para exigir que os consumidores entrem em contato com você para comprar a listagem.
Especifique um nome para a oferta.
Selecione Next.
Na caixa de diálogo Billing and payments, selecione o plano de preços a ser associado a esta oferta.
No menu suspenso Select a pricing plan, selecione o plano de preços que você criou anteriormente.
Selecione um tipo de contrato: Limited-time ou Recurring (Subscription).
Especifique a duração do contrato.
Na lista suspensa Payment options, selecione se deseja cobrar dos clientes com base no plano de preços ou se deseja permitir o pagamento em parcelas.
Se você selecionar Accept installments, especifique o número de parcelas e a frequência das parcelas.
Especifique a data da primeira fatura ou se a fatura deve ser emitida quando a oferta for aceita.
(Optional) Specify whether to require consumers to include a credit card on file to purchase the listing.
Selecione Next.
Na caixa de diálogo Description, insira as informações sobre a oferta que estarão à disposição dos usuários.
Especifique um nome para a oferta que será exibido aos consumidores.
Especifique o preço que será exibido aos consumidores.
(Opcional) Especifique um slogan para exibir aos consumidores.
Especifique o texto do botão que os consumidores clicam para comprar a listagem.
(Opcional) Especifique as propostas de valor para a oferta.
Selecione Next.
Retorne à guia Listing details. Você verá que a oferta criada agora está vinculada à listagem.
Selecione Publish para publicar a listagem para os consumidores selecionados.
Se você sair sem publicar, a listagem será salva como rascunho.
Create a trial¶
Em uma avaliação baseada no uso, você pode oferecer uma série de consultas gratuitas que os consumidores podem executar em seu produto de dados. Depois que todas as consultas gratuitas tiverem sido usadas, o consumidor deverá comprar o produto de dados para executar consultas adicionais.
Para adicionar uma avaliação a uma listagem, a listagem deve ter um produto de dados anexado e você deve ter a função ACCOUNTADMIN ou o privilégio OWNERSHIP na listagem. Para saber mais sobre os privilégios necessários para gerenciar as listagens, consulte Como preparar dados para uma listagem.
Crie uma listagem que inclua um plano de preços e uma oferta, como criado no exemplo anterior.
On the Listing details tab, click in the Trial (optional) area, and select one of the following usage trial types:
Limited usage (available for usage-based pricing plans only)
Enter a value in the Number of Free Queries During Trial field.
This value indicates the number of free queries that consumers can run against your data product. After all free queries have been used, the consumer must purchase the data product to run additional queries.
Limited time
Enter a value in the Length of Trial field.
Limited functionality
Limit the listing’s data product to only the objects and features that you want to include in the trial.
Limited functionality and time
Enter a value in the Length of Trial field, and limit the listing’s data product to only the objects and features that you want to include in the trial.
Selecione Save.
Selecione Publish para publicar a listagem para os consumidores selecionados.
Se você sair sem publicar, a listagem será salva como rascunho.
Configuração de uma listagem¶
Você deve fornecer detalhes adicionais para listagens privadas pagas e qualquer listagem oferecida no Snowflake Marketplace antes de enviar sua listagem para aprovação ou publicá-la para consumidores específicos.
Faça login no Snowsight.
No menu de navegação, selecione Data sharing » Provider Studio.
Selecione a aba Listings, depois selecione o rascunho de listagem que você deseja configurar.
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.
Publicação de uma listagem¶
Depois de criar e configurar uma listagem, você pode publicar uma listagem.
Os procedimentos específicos para publicar uma listagem dependem se você está publicando uma listagem privada gratuita (ou paga fora da plataforma), oferecendo uma listagem paga privada ou oferecendo qualquer listagem no Snowflake Marketplace:
Para publicar uma listagem, você deve usar a função ACCOUNTADMIN ou outra função com o privilégio OWNERSHIP para a listagem que você deseja publicar.
Quando você publica uma listagem, ela fica visível aos consumidores em todas as regiões atuais e futuras do Marketplace, mas os consumidores só podem obter, comprar ou solicitar seu produto nas regiões que você selecionar.
Publicação de uma listagem para consumidores específicos¶
Para compartilhar uma listagem com as contas de consumidor selecionadas, você deve publicar a listagem para essas contas. As listagens privadas não aparecem no Snowflake Marketplace.
Faça login no Snowsight.
No menu de navegação, selecione Data sharing » Provider Studio.
Selecione a aba Listings, depois selecione o rascunho de listagem que você deseja publicar.
Selecione Publish.
Após a publicação da listagem, a listagem estará disponível para os consumidores selecionados acessarem a partir Private Sharing. Consulte Acesse e instale listagens como consumidor.
Nota
Depois de publicar uma listagem privada, você não poderá alterar o compartilhamento associado à listagem.
Publicação de uma listagem no Snowflake Marketplace¶
Toda listagem no Snowflake Marketplace deve passar pelo processo de revisão e aprovação. Depois de uma listagem ser aprovada, ela poderá ser publicada no Snowflake Marketplace. Se uma listagem for rejeitada, reveja os comentários de feedback, atualize a listagem e envie-a novamente para aprovação.
Envio de sua 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. Consulte Configuração de uma 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.
Faça login no Snowsight.
No menu de navegação, selecione Data sharing » Provider Studio.
Selecione a aba Listings, depois selecione o rascunho de listagem que você deseja enviar para aprovação.
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 para os endereços de e-mail Business Contact e Technical Contact no perfil do provedor associado à listagem.
Publicação de sua listagem¶
Faça login no Snowsight.
No menu de navegação, selecione Data sharing » Provider Studio.
Selecione a guia Listings, depois selecione a listagem aprovada que você deseja publicar.
Selecione Publish.
Depois de publicar sua listagem do Snowflake Marketplace pela primeira vez, as alterações subsequentes à listagem que requerem aprovação do Snowflake são publicadas automaticamente após a aprovação. Para evitar que sua listagem seja publicada automaticamente, consulte Desativação automática da publicação.
Quando você publica uma listagem, ela fica visível para os consumidores em todas as regiões do Snowflake Marketplace atuais e futuras. Os consumidores só podem obter, comprar ou solicitar seu produto nas regiões que você selecionar. Consulte Preenchimento automático de listagens para obter mais informações sobre a disponibilidade da região.
Após publicar sua listagem Snowflake Marketplace, você pode definir um link de referência para a listagem. Os links de referência permitem que você forneça aos consumidores um link direto para sua listagem.
Desativação automática da publicação¶
Após a publicação de uma listagem, você pode desativar a publicação automática para futuras alterações na listagem.
Faça login no Snowsight.
No menu de navegação, selecione Data sharing » Provider Studio.
Selecione a guia Listings, depois selecione a listagem aprovada para a qual você deseja desativar a publicação automática.
Na página de detalhes da listagem, selecione Settings.
Na seção Publishing de Listing Settings, selecione Edit Publishing.
Na janela Publish Setting, selecione Manual:
Selecione Save.
A listagem não será mais publicada automaticamente. Agora, quando você fizer alterações na listagem, deverá publicá-la manualmente. Consulte Publicação de sua listagem.
Anexação de um notebook a uma listagem do Snowflake Marketplace¶
Os provedores podem adicionar um notebook a uma listagem para mostrar aos consumidores em potencial como eles podem aproveitar e se beneficiar de um produto de dados. As listagens podem estar disponíveis no Marketplace público do Snowflake, no Marketplace interno ou como uma listagem privada para um conjunto seleto de consumidores.
Um provedor pode anexar um notebook que foi totalmente executado com resultados a uma listagem. Os resultados podem incluir saídas tabulares ou visualização para descrever o valor dos produtos de dados em uma listagem. Os provedores podem incluir exemplos baseados em Python e baseados em SQL no notebook e acrescentar explicações claras de Markdown para orientar os consumidores.
Nota
Os cadernos anexados a uma listagem são apenas para visualização e não podem ser clonados ou baixados nem ter a interação do consumidor.
Para anexar um notebook a uma listagem, siga estas etapas:
Faça login no Snowsight.
No menu de navegação, selecione Projects » Notebooks.
Em cada célula do notebook, selecione Run all ou Run para gerar resultados. Certifique-se de executar em cada célula.
Para verificar se o notebook é executado com êxito, localize o indicador verde de status de execução.
Para encerrar sua sessão de Notebooks, selecione o menu suspenso Active e selecione End session.
No menu de navegação, selecione Data sharing » Provider Studio. Você pode anexar um notebook a todos os tipos de listagem.
Crie uma nova listagem ou escolha uma listagem existente.
Selecione + Add data product.
Escolha + Select.
Na seção Quick Start Examples, selecione Add Notebook.
Selecione o notebook a ser anexado. É possível usar o recurso de pesquisa para encontrar um notebook específico.
Selecione Save.
Para publicar a listagem para os consumidores selecionados, selecione Publish.
Nota
Para atualizar o conteúdo do notebook após anexá-lo a uma listagem, é necessário remover o notebook da listagem e anexá-lo novamente.
Remoção de um notebook de uma listagem¶
No menu de navegação, selecione Data sharing » Provider Studio.
Na seção Quick Start Examples, selecione o notebook a ser removido.
Selecione Remove Notebook.
Nota
Se você perder a propriedade do notebook, ou se você excluí-lo ou removê-lo de seus recursos compartilhados, uma cópia permanecerá na listagem.
Limitações ao anexar notebooks a listagens¶
Os provedores só podem anexar um notebook a uma listagem e o provedor deve ter privilégios de OWNERSHIP no notebook.
Os consumidores só podem visualizar o notebook e seus resultados nas listagens.
As alterações no notebook não são atualizadas automaticamente na listagem. Para refletir as alterações mais recentes, é necessário remover o notebook e adicioná-lo novamente.