Como preparar dados para uma listagem¶

Preparação para criar uma listagem¶

Antes de criar uma listagem, faça o seguinte:

1. Decida como oferecer seu produto de dados. Consulte Opções de disponibilidade da listagem e Opções de acesso à listagem.

2. Configure as funções e privilégios para simplificar a criação de listagens. Consulte Configuração de funções e privilégios para listagens.

3. Identifique os objetos que você deseja compartilhar. Consulte Decisão sobre o que colocar em uma listagem.

4. Prepare os objetos para serem compartilhados com outras pessoas. Consulte Preparação dos compartilhamentos para sua listagem.

5. Determine como você deseja gerenciar o acesso ao seu produto de dados:

   • Forneça acesso gratuitamente, sem restrições.

   • Cobre pela sua listagem criando uma listagem paga. Consulte Como se preparar para oferecer uma listagem paga.

   • Ofereça acesso limitado ao seu produto de dados como uma avaliação gratuita e, em seguida, ofereça acesso ilimitado ao seu produto de dados mediante solicitação. Consulte Prepare-se para oferecer uma listagem de teste limitada.

6. Escolha em qual(is) região(ões) de nuvem você deseja oferecer sua listagem. Consulte Preparação de sua listagem para compartilhamento com outras regiões.

A listagem e o compartilhamento de dados devem estar em conformidade com as Políticas do provedor do Snowflake.

Configuração de funções e privilégios para listagens¶

Quando você cria uma listagem, você a cria a partir da conta que tem os dados ou pacote de aplicativo nela contidos. A função que anexa um produto de dados a uma listagem e publica a listagem deve ser a mesma que criou e, portanto, possui o pacote de aplicativo ou compartilhamento. Você não pode transferir o privilégio OWNERSHIP para um compartilhamento.

Se você usar uma função diferente para criar e gerenciar a listagem, conceda o privilégio MODIFY na listagem à função que possui o pacote de aplicativo ou compartilhamento. Por exemplo:

Função de proprietário de compartilhamento ou pacote de aplicativo:

Privilégio OWNERSHIP no pacote de aplicativo ou compartilhamento. Privilégio MODIFY na listagem.

Função de proprietário da listagem:

Privilégio OWNERSHIP na listagem.

Privilégio global CREATE DATA EXCHANGE LISTING.

Na conta do provedor, você pode usar um dos seguintes itens para criar e gerenciar listagens:

ACCOUNTADMIN:

Se você usar a função ACCOUNTADMIN para criar e gerenciar listagens, a função ORGADMIN deverá primeiro delegar privilégios para configurar o preenchimento automático.

Função personalizada:

Se você usar uma função personalizada, a função ORGADMIN deverá primeiro delegar privilégios para configurar o preenchimento automático à função ACCOUNTADMIN, que poderá então ser usada para conceder os privilégios relevantes à função personalizada.

Para obter mais informações sobre a concessão de privilégios de compartilhamento, consulte Concessão de privilégios a outras funções.

Decisão sobre o que colocar em uma listagem¶

Enquanto você se prepara para compartilhar dados de sua conta com uma listagem, decida o que colocar na listagem.

Primeiro, certifique-se de que os dados que você deseja compartilhar estejam no Snowflake, e que você tem os direitos legais e contratuais para compartilhar os dados. Se necessário, carregue os dados que você deseja compartilhar no Snowflake. Consulte Visão geral do carregamento de dados.

Em seguida, decida como oferecer os dados que você tem como uma listagem. Se você planeja oferecer listagens no Snowflake Marketplace ou apenas como listagens privadas diretamente a clientes específicos, você pode tomar decisões diferentes sobre o que colocar na listagem.

• Considere a disponibilidade de seus dados.

• Considere os consumidores que você espera que tenham acesso às suas listagens.

• Considere os formatos dos dados que você seleciona para o compartilhamento, tais como tabela, exibição, exibição segura ou outro objeto de banco de dados.

Por exemplo, se você quiser fornecer listas sobre o tratamento de cães, você pode tomar decisões como as seguintes:

• Ofereça uma listagem gratuita disponível ao público no Snowflake Marketplace com informações sobre raças de cães e comprimento do pelo.

• Ofereça uma listagem de avaliação limitada no Snowflake Marketplace com um exemplo de produto de dados que contém dados sobre o tempo necessário para cuidar de um poodle padrão, com a opção para os consumidores solicitarem um produto de dados completo sobre insights de preparação para mais raças de cães.

• Ofereça uma listagem de avaliação limitada no Snowflake Marketplace com um produto de dados que contém dados sobre o tempo necessário para cuidar de qualquer raça de cachorro, com a opção para os consumidores solicitarem acesso ilimitado ao seu produto de dados.

• Ofereça uma listagem privada a uma organização parceira com informações sobre o tempo necessário para cuidar de vários cães, e a frequência típica de consultas para diferentes raças de cães.

Neste exemplo, você oferece dados valiosos no Snowflake Marketplace, mas oferece insights mais específicos a uma organização com a qual você já tem uma relação comercial de confiança.

Preparação dos compartilhamentos para sua listagem¶

Você pode criar um compartilhamento antes de criar uma listagem, ou selecionar o banco de dados, tabelas e exibições para englobar seu produto de dados ao criar a listagem. Consulte Como trabalhar com compartilhamentos.

Se você planeja oferecer muitas listagens, crie os compartilhamentos separadamente das listagens para que você possa gerenciar mais facilmente seus produtos de dados. Você não pode fornecer múltiplas listagens a partir do mesmo compartilhamento.

Prepare-se para oferecer uma listagem de teste limitada¶

Uma listagem de avaliação limitada permite que você ofereça uma amostra do seu produto de dados como uma avaliação gratuita, dando aos consumidores informações sobre o que pode estar disponível em um produto de dados completo, ou acesso por tempo limitado ao seu produto de dados completo. Os provedores podem definir o período de disponibilidade para listagens de teste limitadas de 1 a 90 dias. Para obter mais informações sobre listagens de testes limitadas, consulte Listagens de avaliação limitada.

Se você optar por oferecer uma amostra do seu produto de dados completo, o produto de dados de amostra idealmente fornecerá um subconjunto dos dados reais incluídos no seu produto de dados completo e será representativo do produto de dados completo das seguintes maneiras:

• Contém as mesmas colunas.

• Contém intervalos e distribuições de valores iguais ou semelhantes nos dados.

As listagens de avaliação limitada incluem um dicionário de dados, portanto, a forma geral dos dados no produto de dados completo deve ficar clara no produto de dados de amostra que você oferece.

Por exemplo, se você for uma empresa de treinamento e cuidados com cães, considere oferecer um dos seguintes produtos de dados de amostra com uma listagem de avaliação limitada:

Oferecer um subconjunto relevante e completo de seu produto de dados completo como produto de dados de amostra para sua listagem de avaliação limitada ajuda os consumidores a compreender o valor de seu produto de dados completo e aumenta a probabilidade de eles solicitarem o produto de dados completo.

CREATE OR REPLACE SECURE VIEW limited_functionality_view
  AS
  SELECT *
    FROM db_name.schema_name.table_name
    WHERE SYSTEM$IS_LISTING_TRIAL() = false;

CREATE OR REPLACE SECURE FUNCTION schema_name.shared_function()
  RETURNS VARCHAR
  AS
  $$
    CASE
      WHEN SYSTEM$IS_LISTING_TRIAL() = FALSE
        THEN 'full product'
      ELSE 'trial'
    END
  $$;

# Import python packages
import streamlit as st
from snowflake.snowpark.context import get_active_session

session = get_active_session()
# Here we assign result of our function to a variable
result = session.sql("SELECT SYSTEM$IS_LISTING__TRIAL()")

# Write directly to the app
if result:
  st.title("Enjoy your limited trial of this application!")
else:
  st.title("Welcome to the full version of this application!")

Como se preparar para oferecer uma listagem paga¶

Se você quiser cobrar por sua listagem, você deve fazer o seguinte:

1. Determine se você pode oferecer listagens pagas. Consulte Quem pode fornecer listagens pagas.

2. Prepare os dados para oferecer um período de teste dos dados. Consulte Como preparar ações para uma listagem paga.

3. Decida sobre o plano de preços que melhor se adequa à sua listagem. Consulte Modelos de preços de listagens pagas para rever os planos de preços disponíveis.

CREATE SECURE VIEW paid_v
  AS
  SELECT
    *
  FROM
    paid_t
  WHERE
    SYSTEM$IS_LISTING_PURCHASED() = TRUE;

CREATE SECURE VIEW paid_v
  AS
  SELECT
    *
  FROM
    paid_t
  WHERE
    is_free
    OR
    SYSTEM$IS_LISTING_PURCHASED() = TRUE;

CREATE SECURE VIEW paid_v
  AS
  SELECT *
  FROM
    paid_t
  WHERE
    (timestamp > current_timestamp() - interval '7 days')
    OR
    SYSTEM$IS_LISTING_PURCHASED() = TRUE;

EXECUTE USING SHARE_CONTEXT(SYSTEM$IS_LISTING_PURCHASED=>{ 'TRUE' | 'FALSE' })
  AS <query>

EXECUTE USING share_context(system$is_listing_purchased=>'FALSE')
  AS
    SELECT
      *
    FROM
      example_database.example_schema.PURCHASED_VIEW

Query produced no results

EXECUTE USING share_context(system$is_listing_purchased=>'TRUE')
  AS
    SELECT
      *
    FROM
      example_database.example_schema.PURCHASED_VIEW

Preparação de sua listagem para compartilhamento com outras regiões¶

Ao configurar sua listagem, você pode optar por oferecê-la em diferentes regiões. Oferecer listagens em outras regiões requer a replicação de dados.

Considere o tempo necessário para replicar os dados e os custos envolvidos na replicação.

• Para uma listagem no Snowflake Marketplace, você pode escolher em quais regiões disponibilizar sua listagem. Ao fazer isso, você pode replicar manualmente os dados ou usar o preenchimento automático para disponibilizar seu produto aos consumidores que acessam sua listagem. Consulte Replicação manual dos dados para atender a uma solicitação de listagem ou Configuração do preenchimento automático entre nuvens para obter mais detalhes.

• Para uma listagem privada, você precisa compartilhar sua listagem com as regiões onde estão as contas de seu consumidor. Você usa o preenchimento automático para replicar o produto para os consumidores de sua listagem. Consulte Configuração do preenchimento automático entre nuvens para obter mais detalhes.

Todo compartilhamento de dados entre regiões no Snowflake usa a funcionalidade de replicação de dados do Snowflake. Consulte Compartilhamento de dados de forma segura entre regiões e plataformas de nuvem