Configuração de listagens

Ao criar uma listagem, você deverá preencher campos adicionais para sua listagem antes de disponibilizá-la aos consumidores.

Dependendo de como você disponibiliza sua listagem e de como os consumidores acessam seu produto de dados, algumas seções ou campos podem ser opcionais.

Depois de configurar sua listagem, publique-a para os consumidores. Consulte Publicação de uma listagem.

Neste tópico:

Informações básicas

Preencha informações básicas sobre sua listagem. A tabela a seguir descreve os campos na seção Basic Information:

Nome do campo

Descrição

Exemplo

Title

O título da listagem. Quando os consumidores visualizam sua listagem, o título aparece abaixo do nome da sua empresa.

O título deverá ter as seguintes características para ser aprovado:

  • Deve ter entre 40–60 caracteres, até 110 caracteres

  • Todas as palavras principais estão em maiúsculas (use maiúsculas e minúsculas)

  • Deve ser único

  • Deve ser diferente de quaisquer outras listagens oferecidas pelo perfil do seu provedor

Historical Weather by Postcode.

Subtitle

Fornece uma explicação curta e informativa do seu produto de dados que fica visível para os consumidores.

O subtítulo não pode exceder 100 caracteres. Use letra maiúscula somente para a primeira letra do subtítulo e não repita o título.

Esta opção não está disponível para listagens privadas.

Histórico de dados climáticos por local.

Category

As categorias ajudam os consumidores a encontrar seus dados ou aplicativo no Snowflake Marketplace. Selecione a categoria desejada a partir da lista suspensa de valores disponíveis. Você só pode escolher uma categoria.

Esta opção não está disponível para listagens privadas.

Ambiente

Terms of Service

Especifica um link para o contrato dos Termos de Serviço da listagem. Os consumidores devem aceitar os termos antes de poderem acessar a listagem. Os contratos de termos de serviço são obrigatórios para todas as listagens.

Selecione um dos seguintes:

  • Standard Agreement for Marketplace Products: A Snowflake fornece um contrato padrão de termos de serviço para produtos do Snowflake Marketplace, chamado de Acordo Padrão para Produtos do Marketplace. Esse contrato está disponível em: https://www.snowflake.com/marketplace/standard-agreement/. Você pode escolher usar o Contrato Padrão como os termos do acordo de serviço para sua listagem. Você pode saber mais sobre o Contrato Padrão revendo as FAQs disponíveis em: https://www.snowflake.com/standard-agreement-for-marketplace-products/.

    Ao selecionar o Contrato Padrão para Produtos do Marketplace, você está confirmando que leu o contrato e a Isenção de Responsabilidade com seu consultor jurídico.

  • Custom: especifica um URL para um contrato de termos de serviço para sua listagem. O URL deve ser acessível publicamente e não exigir autenticação para acesso. Os termos podem ser um PDF ou outro documento acessível a partir de um URL.

  • Terms of service will be provided offline: disponível apenas para listagens privadas oferecidas diretamente a consumidores específicos. Esta opção permite que você forneça aos seus consumidores um contrato de termos de serviço que não está disponível em um URL.

Custom, https://www.example.com/en/legal

Detalhes

Preencha os detalhes adicionais para sua listagem.

Nota

Essa seção é opcional para listagens privadas.

A tabela a seguir descreve os campos disponíveis na seção Details:

Nome do campo

Descrição

Exemplo

Description

Descrição do produto de dados compartilhados na listagem. A descrição ajuda os consumidores a entender o que está em seu produto de dados.

Insira uma descrição que contenha de 250 e 6000 caracteres, com quebras de linha entre os parágrafos.

Use travessões em vez de caracteres marcadores. A descrição deve incluir um parágrafo introdutório com informações sobre o produto de dados, como o escopo do conjunto de dados.

Para listagens que incluem serviços ou funções seguras, a descrição deve incluir o fluxo de trabalho esperado para os consumidores acessarem seus serviços ou funções seguras.

A descrição também pode incluir as fontes de dados da sua listagem ou informações adicionais não abordadas em outros campos.

ACME é o provedor número um de avisos meteorológicos personalizados e precisos para grandes empresas, bem como uma fonte de informações vitais para previsões meteorológicas, dados e serviços de consultoria meteorológica em todo o mundo. Esta listagem fornece dados climáticos históricos para códigos postais dos US que podem ser usados para melhorar ainda mais seus dados existentes para fornecer uma análise mais profunda.

Fluxo de trabalho esperado:

  • O consumidor compartilha uma lista de CEPs com o fornecedor usando uma listagem privada.

  • O provedor enriquece os códigos postais.

  • O provedor compartilha dados enriquecidos com o consumidor usando uma listagem privada.

Link to Documentation

Um link para uma página em seu site do provedor com documentação mais detalhada da listagem. A documentação deve ser clara e fazer referência aos objetos do esquema corretos presentes no compartilhamento de dados ou Snowflake Native App associado à listagem. O link deve estar acessível na Internet, e não exigir autenticação para acesso.

https://www.example.com/documentation/

Link to Video

Um link para um vídeo do YouTube não listado ou público da listagem. Vídeos privados não são suportados. As miniaturas dos vídeos são exibidas na página de detalhes da listagem e os vídeos não são reproduzidos automaticamente.

Dica

Ao criar um vídeo para exibir na página de detalhes de uma listagem, tenha em mente o seguinte:

  • Os frames finais do vídeo são exibidos após a reprodução dos vídeos e devem incluir uma frase de chamariz.

  • Os vídeos devem ser curtos e mostrar o uso real do produto, sendo os primeiros 5 segundos os mais importantes.

https://www.youtube.com/watch?v=MEFlT3dc3uc

Produto de dados

Configure o produto de dados para sua listagem, seja um compartilhamento seguro ou um Snowflake Native App.

Você pode selecionar objetos e fazer com que o Snowflake crie um compartilhamento seguro ou adicione um compartilhamento que você já criou. Consulte Preparação dos compartilhamentos para sua listagem para obter orientação sobre como criar compartilhamentos para listagens pagas.

Ao adicionar um produto de dados à sua listagem, considere o seguinte:

  • Compartilhamentos seguros só podem ser anexados a uma única listagem.

  • Após a publicação da listagem, você não pode anexar um compartilhamento diferente.

  • Você só pode ver os compartilhamentos pertencentes à sua função atual.

  • Os dados devem ser legalmente compartilháveis (ou seja, o provedor deve ser proprietário dos dados ou ter o direito de compartilhá-los).

  • Até que uma listagem seja publicada, ela só pode ser associada com um compartilhamento na conta local/primária. Após a publicação da listagem, ela pode ser associada a um compartilhamento em regiões adicionais que você tenha selecionado.

A tabela a seguir descreve os campos disponíveis na seção Data Product:

Nome do campo

Descrição

Objetos de banco de dados ou compartilhamento seguro

Dados que você deseja compartilhar como parte da listagem.

Produto de dados - Dicionários de dados

Depois de adicionar um produto de dados à sua listagem, você pode adicionar um dicionário de dados. Um dicionário de dados fornece aos consumidores informações sobre o conteúdo e a estrutura de uma listagem gratuita ou paga oferecida no Snowflake Marketplace antes de instalar o produto de dados em sua conta.

Nota

Essa seção é opcional para listagens privadas.

Sobre dicionários de dados

Você pode usar um dicionário de dados para tornar o conteúdo de sua listagem visível para os consumidores. Um dicionário de dados é gerado para tabelas e exibições em uma listagem.

Seus dados ficam visíveis de duas maneiras:

  • Objetos em destaque: permite ao consumidor visualizar rapidamente o conteúdo do objeto. Você pode selecionar até cinco dos objetos de banco de dados mais importantes na listagem.

  • Todos os objetos: permite ao consumidor visualizar todos os objetos de uma listagem. Ele é gerado automaticamente quando você publica uma listagem.

Configuração de um dicionário de dados para sua listagem

Antes de adicionar um dicionário de dados, você deve adicionar um produto de dados à listagem. Todas as listagens oferecidas em Snowflake Marketplace devem incluir um dicionário de dados.

Para configurar um dicionário de dados, faça o seguinte:

  1. Entre em Snowsight.

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

  3. Localize e selecione a listagem onde deseja adicionar um dicionário de dados.

  4. Selecione Save and Create Data Dictionary.

    Nota

    Ao salvar este compartilhamento, você concorda que a Snowflake tem permissão para criar um dicionário de dados para o compartilhamento e exibi-lo aos consumidores quando a listagem for publicada.

    Depois de salvar a listagem, o dicionário de dados é exibido, listando todas as tabelas, exibições e funções dentro da listagem.

  5. Pesquise ou selecione um objeto que deseja incluir como um objeto em destaque e selecione Add to featured.

    Opcionalmente, repita esta etapa para adicionar outros objetos em destaque. Você pode ter até cinco objetos em destaque em uma listagem.

  6. Selecione Save.

Você pode editar descrições de coluna para tabelas no Provider Studio ou você pode usar SQL. Use o parâmetro COMMENT nos comandos CREATE \ <object> e ALTER \ <object> ou o comando COMMENT para adicionar um comentário descrevendo um objeto ou colunas individuais da tabela.

Produto de dados - Atributos

Após especificar um produto de dados, você pode definir atributos adicionais para uma listagem.

Nota

Essa seção é opcional para listagens privadas.

A tabela a seguir descreve os campos disponíveis na seção Attributes para um produto de dados:

Nome do campo

Descrição

Update Frequency

Com que frequência seu produto de dados é atualizado no Snowflake. Se o seu produto de dados for atualizado em frequências diferentes, escolha a frequência mais alta de atualizações para o seu produto de dados.

Geographic Coverage

Selecione uma ou mais regiões geográficas para as quais seu produto de dados tem cobertura. Se aplicável, escolha países específicos ou estados dos EUA.

Geographic Granularity

Se você especificar estados ou países globais ou múltiplos como a cobertura geográfica do seu conjunto de dados, selecione uma granularidade para o produto de dados.

Você só pode escolher uma opção, portanto selecione a opção mais granular disponível em seu produto de dados.

Time Range

Especifique o período que seu produto de dados cobre. Você pode especificar datas personalizadas como um intervalo de tempo fixo (2020-01-01 - 2021-01-01) ou um intervalo de tempo dinâmico (Próximo/Último X dias, semanas, meses ou anos).

Timestamp Granularity

Se você especificar um intervalo de tempo, selecione uma granularidade de carimbo de data/hora para o produto de dados.

Você só pode escolher uma opção, portanto selecione o tipo de carimbo de data/hora mais granular em seu produto de dados.

Additional attributes (opcional)

Qualquer informação adicional que você queira comunicar a seus consumidores. Você pode incluir até 4 atributos adicionais dos dados. Use 2-5 palavras para cada atributo para maximizar a legibilidade. Cada atributo deve ter menos de 80 caracteres.

Acesso e preços - Acesso à listagem

Para listagens oferecidas no Snowflake Marketplace, você pode visualizar o Listing Access de uma listagem e modificá-lo se a listagem ainda estiver em rascunho.

O acesso à listagem controla como os consumidores podem acessar seu produto de dados. Consulte Opções de acesso à listagem para obter mais detalhes.

Acesso e preços - Avaliação

Adicione uma avaliação para uma listagem de avaliação limitada oferecida no Snowflake Marketplace. Para adicionar uma avaliação de uma listagem paga, consulte Acesso e preços - Preços e avaliação.

Nota

Esta opção é necessária para listagens de avaliação limitada.

A tabela a seguir descreve os campos disponíveis na seção Trial:

Campo

Descrição

Trial Type

Escolha o tipo de avaliação a oferecer:

  • Limited time. Os consumidores podem testar seu produto de dados por um período limitado. Escolha esta opção se você oferecer todo o seu produto de dados aos consumidores por um curto período.

  • Unlimited time. Os consumidores podem testar seu produto de dados indefinidamente. Escolha esta opção se você oferecer uma amostra do seu produto de dados completo. Por exemplo, dados meteorológicos de apenas uma cidade, enquanto seu produto de dados completo inclui dados meteorológicos de um país inteiro.

Acesso e preços - Preços e avaliação

Adicione o plano de preços e a avaliação para uma listagem paga nesta seção.

Esta seção é necessária para listagens pagas oferecidas no Snowflake Marketplace, mas os períodos de teste são opcionais para listagens privadas pagas.

Nota

Somente administradores de conta (usuários com a função ACCOUNTADMIN) ou o proprietário da listagem (uma função com privilégio OWNERSHIP na listagem) podem completar esta seção.

A tabela a seguir descreve os campos disponíveis na seção Trial & Pricing:

Campo

Descrição

Pricing Plan

Escolha o plano de preços para a listagem. Consulte Modelos de preços de listagens pagas. Os preços são apenas em dólares dos US.

Free Trial

Escolha o tipo de teste para a listagem:

  • Tempo limitado: esta opção permite que os consumidores participem de um período de teste gratuito por um período que você especifica (1, 7, 30, 60 ou 90 dias). O período de teste máximo é de 90 dias. Quando o período de teste termina, a conta do consumidor perde o acesso ao produto de dados. Outras contas na mesma organização podem realizar um novo período de teste de sua listagem.

  • Funcionalidade limitada: esta opção permite aos consumidores participar de um período de teste gratuito com funcionalidade limitada do produto de dados pago. Este modo de teste não expira até que o consumidor atualize a listagem paga.

  • Funcionalidade e tempo limitados: esta opção permite que os consumidores participem de um período de teste gratuito por um período que você especifica (1, 7, 30, 60 ou 90 dias). A versão de avaliação oferece funcionalidade limitada de seu produto de dados, e quando o período de teste termina, a conta que realiza o teste perde o acesso ao produto de dados.

Necessidades comerciais

Adicione as necessidades comerciais nas quais seu produto de dados pode ajudar os consumidores.

Nota

Essa seção é opcional para listagens privadas.

A tabela a seguir descreve os campos disponíveis na seção Business Needs:

Nome do campo

Descrição

Exemplo

Business Need

Ajude os consumidores a encontrar sua listagem no Snowflake Marketplace especificando necessidades comerciais relevantes atendidas por seu produto de dados. Você pode selecionar até seis necessidades comerciais relevantes.

Se você não estiver vendo uma necessidade comercial relevante na lista suspensa, você pode criar uma necessidade personalizada usando 2-4 palavras. No entanto, os consumidores não podem filtrar por necessidades comerciais personalizadas no Snowflake Marketplace.

Você pode editar a lista de necessidades comerciais a qualquer momento sem enviar a lista para aprovação novamente.

Enriquecimento de dados de localização

Description

Descrição de como sua listagem atende às necessidades comerciais selecionadas, usando um exemplo específico para um caso de uso de cliente ou necessidade comercial.

Adicione uma descrição exclusiva para cada necessidade comercial.

Enriquecimento de dados de localização: identifique todos os CEPs associados a um determinado condado, setor censitário ou área estatística baseada em núcleo.

Consultas SQL de exemplo

Você pode especificar exemplos de consultas SQL válidas que os consumidores podem usar para obter valor do seu produto de dados ou, pelo menos, verificar se o seu produto de dados foi instalado com êxito na conta Snowflake.

Nota

É necessária pelo menos uma consulta SQL válida para que você publique uma listagem no Snowflake Marketplace. Recomenda-se incluir 3–4 exemplos de consultas.

Consultas SQL são opcionais ao publicar listagens privadas.

O SQL de exemplo tem os seguintes requisitos:

  • A consulta deve retornar pelo menos uma linha.

  • A consulta deve fazer referência a objetos que estão explicitamente no compartilhamento.

  • Os objetos devem ser qualificados usando SCHEMA.OBJECT. Não inclua o nome do banco de dados. Por exemplo, EXAMPLE_SCHEMA.TABLE_A.

Selecione Add para adicionar uma consulta SQL. A tabela a seguir descreve os campos disponíveis na seção Sample SQL Queries:

Nome do campo

Descrição

Exemplo

Title

Título descritivo da consulta para ajudar os consumidores a entender como eles podem usar o produto de dados.

Determine se um evento ao ar livre pode ser afetado pela chuva.

Description (Optional)

Descrição do exemplo que vincula o título a um caso de uso específico do produto de dados. A descrição é carregada automaticamente como um comentário quando os consumidores executam a consulta de amostra após instalar o produto de dados. Você também pode incluir instruções adicionais, como o nome do esquema, tabelas de amostra ou campos.

Use o formato <esquema>.<tabela> ao referenciar tabelas e exibições na consulta SQL.

Não inclua o nome do banco de dados na consulta, pois os consumidores criam nomes de banco de dados personalizados quando acessarem sua listagem.

Se você estiver hospedando um evento ao ar livre nos próximos 7 dias, use nossos dados de previsão para determinar se o evento pode ser afetado pela chuva.

SQL Query

Código para suas consultas SQL de exemplo. As consultas devem responder diretamente ao título e à descrição.

O Snowflake valida automaticamente suas consultas de exemplo. Para ser válida, uma consulta de exemplo deve retornar pelo menos uma linha.

Se uma consulta não for validada, você pode salvar a listagem, mas a listagem não poderá ser publicada até que todas as consultas de amostra sejam validadas com sucesso. Você deve selecionar um warehouse para validar a consulta SQL.

Region availability (somente listagens do Marketplace)

A tabela a seguir descreve os campos disponíveis na seção Region Availability.

Nome do campo

Descrição

Region Availability

Por padrão, sua listagem está disponível em All regions. A escolha de todas as regiões garante a disponibilidade de sua listagem em qualquer região futura adicionada pela Snowflake. Para listagens pagas, a seleção dessa opção torna a listagem disponível em regiões suportadas e em qualquer região suportada futura adicionada pelo Snowflake.

Se sua listagem tiver limitações regionais específicas, selecione All regions para alterar a disponibilidade da região para Custom regions e selecione as regiões nas quais deseja oferecer seu produto de dados. Quando você escolhe regiões personalizadas, sua listagem ainda fica visível em todas as regiões do Snowflake Marketplace, mas os consumidores só podem obter seu produto de dados nas regiões que você especificar.

Fulfillment method

O preenchimento Automatic é selecionado por padrão. Com o preenchimento automático entre nuvens, seu produto de dados será preenchido automaticamente em uma região e você incorre em custos somente quando há demanda do consumidor nessa região.

Ao usar o preenchimento automático, você também deve selecionar uma frequência de atualização para atualizar o produto de dados compartilhado com os consumidores. Você deve selecionar uma frequência de atualização de, no máximo, 8 dias. Se seu produto de dados for um Snowflake Native App, você só poderá definir uma frequência de atualização no nível da conta.

Para obter mais detalhes sobre o preenchimento automático, consulte Configuração do preenchimento automático entre nuvens.

Se não for possível usar o preenchimento automático, selecione Manual para replicar manualmente o produto de dados. Para atender às solicitações, você deve configurar as contas nas regiões com demanda do consumidor, replicar manualmente os produtos em cada conta, criar compartilhamentos seguros em cada conta e anexar esses compartilhamentos a esta listagem. Consulte Replicação manual dos dados para atender a uma solicitação de listagem.

Contas de consumidores (somente listagens privadas)

Para publicar uma listagem para consumidores específicos, você deve especificar os identificadores das contas com as quais deseja compartilhar:

Nome do campo

Descrição

Exemplo

Consumer Accounts

Especifica as contas Snowflake com as quais você deseja compartilhar sua listagem privada. Você pode usar identificadores de conta Snowflake ou URLs. Consulte Como encontrar o nome da conta e organização de uma conta para obter detalhes.

ORGABC.ACCOUNT123 https://<nome_da_organização>-<nome_da_conta>.snowflakecomputing.com

Se você estiver compartilhando com uma conta de consumidor em uma região diferente da sua conta, você também deverá criar um preenchimento automático.

Nome do campo

Descrição

Auto-fulfillment

Selecione o intervalo e a frequência de replicação para seu produto de dados. Por exemplo, você pode configurar a replicação para ocorrer a cada duas horas. Se seu produto de dados for um pacote de aplicativo, você só poderá definir a frequência e o intervalo de atualização no nível da conta.

Consulte Configuração do preenchimento automático entre nuvens para obter mais informações.