Configuração dos recursos de listagem¶
Este tópico descreve os campos de capacidades que você pode configurar para uma listagem. Dependendo se você oferece uma listagem paga, uma listagem privada ou uma listagem no marketplace, você deve preencher campos diferentes.
Depois de configurar a listagem, publique a listagem. Consulte Publicação de uma listagem.
Neste tópico:
Informações básicas¶
A tabela a seguir descreve os campos disponíveis na seção Basic Information.
Nome do campo |
Descrição |
Exemplo |
---|---|---|
Type |
O tipo de listagem. Depois de criar uma listagem e anexar um compartilhamento, você não pode alterar o tipo de listagem. |
Valores disponíveis: Free, Personalized ou Paid. |
Publishing as |
O perfil do provedor usado para publicar a listagem para os consumidores. Você precisa criar um perfil de provedor antes de poder publicar uma listagem. Consulte Como se tornar um provedor de listagens. |
|
Title |
O título da listagem. O título da listagem não pode exceder 110 caracteres, mas é recomendado que o título esteja entre 40-60 caracteres. Todas as palavras principais devem ficar em maiúsculas (isto é, seguir o formato de caixa de título). O título aparece abaixo do nome de sua empresa na listagem e deve ser único (ou seja, diferente de quaisquer outras listagens que você tiver). Se você decidir oferecer listagens semelhantes, como uma listagem Free para mostrar um subconjunto de seus dados, e uma listagem Personalized para permitir que os consumidores solicitem o conjunto de dados completo, use títulos semelhantes, mas distintos. Neste exemplo, você poderia anexar - Amostra ao título da listagem Free. Se você fornecer listagens gratuitas para mostrar outras listagens no Snowflake Marketplace, use um sufixo - Demo ou - Amostra. Se você fornecer listagens gratuitas por um tempo limitado, use um sufixo - Teste. Essa opção não está disponível para listagens privadas gratuitas (ou pagas fora da plataforma). |
Historical Weather by Postcode. |
Subtitle |
Legenda para listagem. O subtítulo não pode exceder 110 caracteres. Use letra maiúscula somente para a primeira letra do subtítulo e não repita o título. Essa opção não está disponível para listagens privadas gratuitas (ou pagas fora da plataforma). |
Histórico de dados climáticos por local. |
Category |
As listagens são categorizadas para torná-las fáceis de encontrar no Snowflake Marketplace. Selecione a categoria desejada a partir da lista suspensa de valores disponíveis. Essa opção não está disponível para listagens privadas gratuitas (ou pagas fora da plataforma). |
|
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. Contratos de Termos de Serviço são obrigatórios para listagens gratuitas e opcionais para listagens personalizadas. Selecione um dos seguintes:
|
|
Detalhes¶
A tabela a seguir descreve os campos disponíveis na seção Details.
Nota
Essa seção é opcional para listagens privadas.
Nome do campo |
Descrição |
Exemplo |
---|---|---|
Description |
Descrição do produto de dados compartilhados na listagem. 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 o seguinte: . - Um parágrafo introdutório com informações sobre o produto de dados, tais como o escopo do conjunto de dados. . - Uma descrição das tabelas ou exibições incluídas . - Campos de dados-chave . Para listagens que incluem serviços ou funções seguras, a descrição deve incluir o fluxo de trabalho esperado para que os consumidores tenham acesso a seus serviços ou funções seguras. . A descrição também pode incluir as fontes de dados para sua listagem, ou informações adicionais não cobertas 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. . Amostras/tabelas incluídas: . - Dados meteorológicos históricos diários de 2016 até o presente . - Dados meteorológicos diários de 15 dias . - Dados climatológicos diários de 15 anos (estatísticas climáticas, ou seja, avg, std, freq, etc.) . Campos incluídos: . Date . - Zip Code . - Country . - Estatísticas meteorológicas Min, Max, Avg (temperatura, precipitação, vento, umidade etc.) |
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 associado à listagem. O link deve estar acessível na Internet, e não exigir autenticação para acesso. |
|
Data Product - Attributes¶
Após especificar um produto de dados, você pode definir atributos adicionais para uma listagem.
Nota
Essa seção é opcional para listagens privadas.
Nome do campo |
Descrição |
---|---|
Update Frequency |
Com que frequência seu produto de dados é atualizado no Snowflake |
Geographic Coverage |
A área geográfica que os dados cobrem. |
Time Range |
O intervalo de tempo que os dados cobrem. |
Additional attributes (opcional) |
Qualquer informação adicional que você queira comunicar a seus consumidores. Por exemplo, você pode incluir uma descrição do escopo e da escala de seus dados e por que alguém pode achar seus dados úteis. |
Produto de dados - Período de teste e preços (somente listagens pagas)¶
Adicione o plano de preços e o período de teste para sua listagem 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 baseados no uso. Os preços estão atualmente apenas em dólares dos US. |
Free Trial |
Escolha o tipo de teste para a listagem:
|
Produto de dados - Dicionários 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 do Marketplace antes de instalá-la em sua conta. Adicionar um dicionário de dados para uma listagem privada é opcional.
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: permitem 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: esta lista 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 compartilhamento de dados à listagem.
Para configurar um dicionário de dados para listagens gratuitas e pagas oferecidas no Snowflake Marketplace, faça o seguinte:
Entre em Snowsight.
Na barra de navegação à esquerda, selecione Data » Provider Studio » Listings.
Localize e selecione a listagem onde deseja adicionar um dicionário de dados.
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.
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.
Clique em Save.
Você pode editar descrições de coluna para tabelas no Provider Studio. Além disso, você pode usar 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.
Necessidades comerciais¶
A tabela a seguir descreve os campos disponíveis na seção Business Needs.
Nota
Essa seção é opcional para listagens privadas.
Nome do campo |
Descrição |
---|---|
Business Need |
As listagens são agrupadas por necessidades comerciais para facilitar a sua descoberta pelos consumidores no Snowflake Marketplace. Você pode selecionar até seis necessidades comerciais para sua listagem. Se você não estiver vendo uma necessidade comercial relevante na lista suspensa, você pode criar uma necessidade personalizada. No entanto, as necessidades comerciais personalizadas que você cria só ficam visíveis nos detalhes de sua listagem. 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. |
Description |
Descrição de como sua listagem atende às necessidades comerciais selecionadas. |
Consultas SQL de exemplo¶
Você pode especificar uma consulta SQL de exemplo válida que os consumidores podem usar para verificar se seu produto de dados foi instalado com sucesso na conta Snowflake deles.
Nota
Uma consulta SQL válida é necessária para você publicar uma listagem no Marketplace. 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
.
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 os dados. Você pode acrescentar mais de um exemplo. |
Determine se um evento ao ar livre pode ser afetado pela chuva. |
Description (Optional) |
Descrição do exemplo com instruções adicionais; como nome do esquema, tabelas de amostra, campos, casos de uso. 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 clientes podem criar 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. 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 pelo menos 8 dias. 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 antes de atender a uma solicitação de listagem |
Contas de consumidores (somente listagens privadas)¶
Se você estiver configurando uma listagem privada, você deve configurar os campos da tabela a seguir.
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. |
|
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. |
Consulte Configuração do preenchimento automático entre nuvens para obter mais informações.