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

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:

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)

  1. Faça uma das seguintes opções:

  2. Selecione + Create Listing » Specified Customers.

  3. Na caixa de diálogo Create Listing, digite um nome para sua listagem.

  4. Na seção Who can discover the listing?, selecione Only specified consumers.

  5. Na seção What type of listing would you like to publish?, selecione Free (or paid off-platform).

  6. Selecione Next.

  7. Escolha + 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.

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

  9. Opcional: se você tiver vários perfis de provedor, selecione o perfil de provedor que deseja usar para publicar essa listagem. Se você não selecionar um perfil de provedor, o Snowflake usará sua organização e conta por padrão.

  10. Na seção Consumer Data Sharing Account ID, adicione os nomes de conta e organização para os consumidores com os quais você deseja compartilhar a listagem.

  11. Se você adicionar uma conta de consumidor em uma região que não seja sua região local, o Snowflake habilita o preenchimento automático para permitir a replicação de dados para a região remota depois que o consumidor obtém sua listagem. Execute as seguintes etapas adicionais:

    1. Na seção Auto-fulfillment, insira um valor e selecione um intervalo para especificar a frequência de replicação de seu produto de dados da sua região para a região remota.

    2. Se você não tiver um warehouse padrão definido, selecione um warehouse para usar para preenchimento automático.

    Consulte Preenchimento automático de listagens para obter mais detalhes.

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

Criação de uma listagem privada paga

  1. Criar uma listagem.

  2. Configurar a listagem para prepará-la para publicação.

  3. Enviar a listagem para aprovação e publicação.

  4. Faça login no Snowsight.

  5. Selecione + Create Listing » Specified Customers.

  6. Na janela Create Listing, digite um nome para sua listagem.

  7. Na seção Who can discover the listing?, selecione Only specified consumers.

  8. Para cobrar pela listagem, na seção What type of listing would you like to publish?, selecione Paid on Snowflake.

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

  10. Configure recursos adicionais obrigatórios e opcionais. Consulte Configuração de uma listagem.

Criar uma avaliação baseada no uso

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.

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data Products > Provider Studio.

  3. Selecione Listings e, em seguida, selecione uma listagem existente ou crie uma nova listagem.

  4. Na seção Access & Pricing, selecione Edit ou Add ao lado de Pricing & Trial.

  5. Selecione Usage-based.

  6. No campo Monthly Fee, insira uma taxa mensal.

  7. Opcional. Na área Queries, insira o custo por consulta e o número de consultas incluídas.

  8. Se você inseriu um custo por consulta, insira a cobrança mensal máxima no campo Maximum Monthly Charge.

  9. Na área Free Trial, selecione um dos seguintes tipos de avaliação de uso:

    • Limited Usage

    • Limited Time

    • Limited Functionality

    • Limited Functionality & Time

  10. Se você selecionou Limited Usage, digite um valor no campo Number of Free Queries During Trial.

  11. Se você selecionou Limited Time ou Limited Functionality & Time, digite um valor no campo Length of Trial.

  12. Selecione Save.

Converter um compartilhamento direto em uma listagem privada gratuita (ou paga fora da plataforma)

Você pode converter um compartilhamento direto em uma listagem privada gratuita (ou paga fora da plataforma) ou em uma listagem publicada no Snowflake Marketplace. Quando você faz isso:

  • Os consumidores existentes mantêm acesso ao compartilhamento.

  • Você obtém acesso à análise de uso a partir da data de publicação da listagem. Os dados históricos de uso não estão disponíveis.

  • Você poderá usar o preenchimento automático para compartilhar com consumidores em regiões remotas se ainda não estiver usando a replicação para os objetos em seu compartilhamento e se seu compartilhamento contiver apenas objetos compatíveis com o preenchimento automático. Consulte objetos compatíveis com preenchimento automático.

  • Você não pode converter sua ação em uma listagem paga se ela tiver consumidores ativos.

Se você decidir usar o preenchimento automático para dar suporte aos consumidores remotos do seu compartilhamento, coordene o seguinte fluxo de trabalho com os consumidores remotos dos seus dados:

  • Depois de publicar a listagem, informe aos consumidores em regiões remotas como acessá-la. Consulte Acesso a uma listagem privada.

  • Depois que os consumidores em regiões remotas obtêm sua listagem, o preenchimento automático replica os dados para a região remota. Consulte Objetos suportados para preenchimento automático.

  • Quando o preenchimento automático é concluído, o consumidor recebe um e-mail informando que os dados estão disponíveis. Nesse ponto, o consumidor deve fazer o seguinte:

    • Eliminar o banco de dados importado existente criado no compartilhamento direto.

    • Obter a listagem e criar um banco de dados usando o mesmo nome do banco de dados importado do compartilhamento direto.

Depois de configurar seu compartilhamento direto como uma listagem, você poderá usar Provider Studio para gerenciar e modificar sua listagem. Consulte Modificação de listagens publicadas e Monitoramento do uso de listagem.

Compartilhamento de dados ou aplicativos no Snowflake Marketplace

Nota

Antes de criar e publicar uma listagem paga no Snowflake Marketplace, entre em contato com seu parceiro de desenvolvimento de negócios na Snowflake. Se você não tiver um parceiro de desenvolvimento de negócios, envie um caso ao Marketplace Operations. Esta etapa é necessária para a aprovação da listagem.

Nota

Sua função deve ter os privilégios necessários para criar uma listagem. Consulte Privilégios necessários para trabalhar com listagens.

  1. Faça login no Snowsight.

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

  3. Selecione + Create Listing » Snowflake Marketplace.

  4. Na janela Create Listing, digite um nome para sua listagem.

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

  6. Na seção What type of listing would you like to publish?, selecione uma das seguintes opções:

    • Free para oferecer um produto de dados que está disponível gratuitamente para os consumidores.

    • Limited trial para oferecer uma avaliação do seu produto de dados, com acesso ilimitado ao produto de dados disponível mediante solicitação.

    • Paid on Snowflake para cobrar pelo seu produto de dados no Snowflake.

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

  8. Configurar a listagem para prepará-la para publicação.

  9. Enviar a listagem para aprovação e publicação.

Criação de uma listagem no Snowflake Marketplace que inclui um selo de conformidade

Nota

Atualmente, a criação de listagens que incluem selos de conformidade só pode ser feita por meio de APIs de listagem.

Para criar uma listagem que inclua selos de conformidade, siga estes passos:

  1. Usando um perfil aprovado, crie seu manifest.yml de listagem.

  2. No arquivo de manifesto, adicione o campo compliance_badges e 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
    Copy

  3. Instalação e configuração do SnowSQL.

  4. Para conectar-se aoSnowSQL, execute o seguinte comando:

    snowsql -c my_example_connection
    Copy

  5. Para criar um banco de dados, um esquema e um estágio, execute os seguintes comandos:

    CREATE DATABASE <db name>;
CREATE SCHEMA <schema name>;
CREATE STAGE <stage_name>;
    Copy

  6. Para carregar seu arquivo de manifesto de listagem do local para o estágio, execute o seguinte comando:

    PUT file:///<local_path>/manifest.yml @<stage_name>/<prefix>
  SOURCE_COMPRESSION=None
  AUTO_COMPRESSION=False
  OVERWRITE=True;
    Copy

    Nota

    Para usar o Snowsight para carregar arquivos em um estágio, siga as etapas em Preparação de arquivos usando o Snowsight.

  7. Para carregar os documentos de conformidade listados no manifesto no estágio, execute os seguintes comandos:

    PUT file:///<local_path>/soc2_compliance_verification.pdf @<stage_name>/<prefix>
PUT file:///<local_path>/hipaa_compliance_verification.pdf @<stage_name>/<prefix>
PUT file:///<local_path>/sample.pdf @<stage_name>/<prefix>
  SOURCE_COMPRESSION=None
  AUTO_COMPRESSION=False
  OVERWRITE=True;
    Copy

  8. Para verificar se os arquivos foram carregados com sucesso e com os nomes corretos, execute o seguinte comando:

    LIST @<stage_name>/<prefix>;
    Copy

  9. Para criar uma listagem usando o arquivo de manifesto que você carregou no estágio, use CREATE LISTING; por exemplo:

    CREATE EXTERNAL LISTING <listing_name>
  APPLICATION PACKAGE <app package name>
  FROM @<staging_name>/<prefix>
  REVIEW = True
  PUBLISH = True;
    Copy

Depois de adicionar um selo de conformidade a uma listagem, você pode verificar se o selo foi adicionado corretamente usando o SQL.

Para confirmar que o selo de conformidade foi adicionado a uma listagem, conclua as etapas a seguir:

  1. Execute o seguinte comando:

    DESCRIBE LISTING <listing_name> REVISION = DRAFT;
    Copy

  2. Na saída, verifique a coluna manifest.yml para a seção compliance_badges.

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.

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data Products » 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.

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.

  1. Faça login na Snowsight.

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

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

  4. 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.

  1. Faça login na Snowsight.

  2. No menu de navegação, selecione Data Products » 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.

  5. 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

  1. Faça login na Snowsight.

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

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

  4. 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 saber mais sobre a disponibilidade por 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.

  1. Faça login no Snowsight.

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

  3. Selecione a guia Listings, depois selecione a listagem aprovada para a qual você deseja desativar a publicação automática.

  4. Na página de detalhes da listagem, selecione Settings.

  5. Na seção Publishing de Listing Settings, selecione Edit Publishing.

  6. Na janela Publish Setting, selecione Manual:

  7. 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:

  1. Faça login na Snowsight.

  2. No menu de navegação do lado esquerdo, selecione Projects » Notebooks.

  3. Criação de um notebook.

  4. Em cada célula do notebook, selecione Run all ou Run para gerar resultados. Certifique-se de executar em cada célula.

  5. Para verificar se o notebook é executado com êxito, localize o indicador verde de status de execução.

  6. Para encerrar sua sessão de Notebooks, selecione o menu suspenso Active e selecione End session.

  7. Selecione Data Products » Provider Studio. Você pode anexar um notebook a todos os tipos de listagem.

  8. Crie uma nova listagem ou escolha uma listagem existente.

  9. Selecione + Add data product.

  10. Escolha + Select.

  11. Na seção Quick Start Examples, selecione Add Notebook.

  12. Selecione o notebook a ser anexado. É possível usar o recurso de pesquisa para encontrar um notebook específico.

  13. Selecione Save.

  14. 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

  1. Selecione Data Products » Provider Studio.

  2. Na seção Quick Start Examples, selecione o notebook a ser removido.

  3. 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

  • 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.

Linguagem: Português