Esquema:: DATA_SHARING_USAGE

Exibição PAID_LISTING_ACCESS_AND_CHANGE_LOG¶

Nota

A coluna CURRENT_PRICING_PLAN inclui novos campos, indicado com um asterisco (*), que estão disponíveis apenas para a versão preliminar de ofertas.

Os provedores podem usar esta exibição no esquema Uso de Data Sharing para consultar o registro de alterações de listagens pagas de um consumidor para determinar o status de um plano de preços e quando os consumidores perderão o acesso a listagens pagas ou de teste.

Esta exibição é atualizada quando um consumidor altera seu plano de preços, inicia ou termina uma listagem de avaliação ou quando cancela uma assinatura.

Colunas¶

Nome da coluna	Tipo de dados	Descrição
EVENT_DATE	DATETIME	A data e a hora em que a linha foi criada.
LISTING_NAME	VARCHAR	O nome da listagem associada ao plano de preços.
LISTING_DISPLAY_NAME	VARCHAR	O nome de exibição da listagem.
LISTING_GLOBAL_NAME	VARCHAR	O localizador universal de listagem (ULL) da listagem.
CONSUMER_ACCOUNT_NAME	VARCHAR	O nome da conta do consumidor.
CONSUMER_ACCOUNT_LOCATOR	VARCHAR	O localizador de contas de consumidores Snowflake.
CONSUMER_ORGANIZATION_NAME	VARCHAR	O nome da organização do consumidor.
CONSUMER_SNOWFLAKE_REGION	VARCHAR	A região do Snowflake que corresponde aos endereços de faturamento e de entrega da organização do consumidor.
CURRENT_PRICING_PLAN	VARIANT	Informações no formato JSON sobre o plano de preços que estava ativo na data e hora especificadas na coluna EVENT_DATE. As seguintes informações podem ser retornadas: PLAN_TYPE: tipo de plano de preços. Os valores podem ser: (SUBSCRIPTION, USAGE) PLAN_SUB_TYPE: uma das opções: Se PLAN_TYPE for SUBSCRIPTION: um de INSTALLMENTS ou FIXED. Se PLAN_TYPE for USAGE: um de PER_QUERY, COMPUTE_POOL_SURCHARGE ou CUSTOM_BILLING. FREE_QUERIES_LIMIT: número de consultas gratuitas permitidas a um consumidor antes da aplicação de um preço de uso. PER_QUERY_PRICE: custo por consulta para planos baseados em uso. BASE_PRICE: taxa de uso mensal básica. MAX_MONTHLY_PRICE_LIMIT: taxa de uso mensal máxima. MAX_TRIAL_DAYS_LIMIT: limite de tempo para avaliações de consumidor. MAX_TRIAL_QUERIES_LIMIT: limite de uso para avaliações de consumidor. BILLING_DURATION_MONTHS: duração do contrato em meses. CUSTOM_BILLING_EVENTS: uma lista de eventos de faturamento personalizados existentes. Uma das opções: CLASS_NAME: nome da classe do evento de faturamento. DISPLAY_NAME: nome do evento de faturamento. UNIT_PRICE: preço por unidade faturável. DESCRIPTION: descrição do plano de preços. IS_AUTO_RENEWAL_ALLOWED: indica se o consumidor pode renovar automaticamente a listagem: `true` ou `false`. INSTALLMENT_SCHEDULE: cronograma do plano de parcelamento. INSTALLMENT_DURATION_MONTHS: número de meses em que as parcelas devem ser pagas. DEFAULT_INSTALLMENT_PRICE: valor usual em dólares de cada parcela do pagamento, desconsiderando casos como pagamentos rateados ou adiantados. INSTALLMENT_OVERRIDES: lista de parcelas substituídas. Uma das opções: INSTALLMENT_NUMBER: número da parcela sendo substituída. INSTALLMENT_PRICE: preço da parcela. IS_EARLY_ACCESS_ALLOWED: consumidores podem acessar os dados antes do pagamento. COMPUTE_POOL_SURCHARGES: lista das sobretaxas de pool de computação definidas do Snowpark Container Services (SPCS). Uma das opções: COMPUTE_POOL_NAME: nome do pool de computação. UNIT_PRICE: preço por crédito ou hora para uso do pool de computação. CURRENCY: moeda do plano de preços em dólares dos Estados Unidos. CONTRACT_TYPE: para um plano de taxa fixa, pode ser por tempo limitado ou recorrente (assinatura). Para um plano baseado em uso, sempre é “pague conforme o uso”. COMPUTE_POOL_SURCHARGE_TYPE: a unidade sobre a qual a sobretaxa seria aplicável. Pode ser `HOUR` ou `CREDIT`. CONTRACT_DURATION_MONTHS: a duração do contrato em meses. INVOICE_START_PREFERENCE: Indica se a primeira fatura é enviada quando a oferta é aceita ou em uma data especificada. Pode ser `OFFER_ACCEPTED_DATE`, `SPECIFIED_DATE` ou `FIRST_DAY_NEXT_MONTH`. Se `SPECIFIED_DATE` estiver selecionado, consulte `INVOICE_START_TIME`. INVOICE_START_TIME: a data da primeira fatura. IS_DEFAULT: este campo está sempre presente. Se `verdadeiro`, indica que esta é uma oferta padrão anexada a um plano de preços. Se `falso`, indica que esta é uma oferta privada direcionada a um consumidor específico. OFFER_DISPLAY_NAME: o nome da oferta conforme mostrado aos consumidores. PRICING_PLAN_DISPLAY_NAME: o nome do plano de preços conforme mostrado aos consumidores. PAYMENT_TERMS: as condições de pagamento. PAYMENT_TYPE: O tipo de pagamento. Pode ser `FULL` para pago integralmente ou `INSTALLMENT` para um pagamento feito em parcelas. ALLOWED_PAYMENT_METHODS: as formas de pagamento permitidas. ACCESS_START_PREFERENCE: a preferência de início do acesso. Pode ser `OFFER_ACCEPTED_DATE` ou `SPECIFIC_DATE`. ACCESS_START_TIME: a hora em que o acesso é iniciado. ACCESS_END_TIME: a data e a hora em que o acesso termina. TARGET_CONSUMER: o consumidor segmentado por esta oferta. STATE: o estado da oferta. PRODUCT_SKU: o SKU vinculado a um plano de preços vinculado a uma oferta. PRICING_MODEL: especifica se o plano de preços vinculado à oferta é uma taxa fixa ou um modelo de uso.
NEXT_PRICING_PLAN	VARIANT	Informações no formato JSON sobre o plano de preços que se torna ativo na data e hora especificadas na coluna `CURRENT_PRICING_PLAN_END_ON`. O formato JSON para esta coluna é idêntico ao de `CURRENT_PRICING_PLAN`.
IS_CONSUMER_AUTO_RENEWAL_ENABLED	BOOLEAN	O consumidor ativou a renovação automática. Isso se aplica somente a listagens de assinaturas.
PURCHASE_STATE	VARCHAR	O estado da listagem. O estado pode ser um dos seguintes: TRIAL EXPIRED DELETED PURCHASED
CURRENT_PRICING_PLAN_START_ON	DATETIME	A data e a hora em que um plano de preços se tornou ativo.
CURRENT_PRICING_PLAN_END_ON	DATETIME	A data e a hora em que o plano de preços atual termina.
TRIAL_END_ON	DATETIME	A data final da listagem de teste.
ACCESS_END_ON	DATETIME	A data e a hora em que o período de assinatura atual termina. NULL indica que o plano atual não é uma assinatura, mas sim um plano baseado no uso.

Notas de uso¶

A latência para a exibição pode ser de até dois dias.
Os dados são mantidos por até um ano.
Uma linha é criada quando qualquer coluna é alterada. Por exemplo, quando um consumidor muda seu plano de preços, inicia ou termina um teste, cancela uma assinatura ou exclui os dados.
Os dados incluem todos os consumidores que acessaram a listagem pelo menos uma vez, inclusive aqueles que cancelaram a assinatura ou a avaliação da listagem.
A exibição contém dados para listagens pagas do Snowflake com um ou mais consumidores.
Esse relatório contém uma linha por listagem e por consumidor. Por exemplo, se um consumidor comprou duas listagens de um provedor e cada compra foi atualizada três vezes, então a exibição contém seis entradas. Uma coluna individual representa o estado de uma compra única e específica.
Os dados a seguir não estão inclusos na exibição:
- Listagens de avaliação limitada
- Listagens gratuitas – fornecidas sem custo dentro ou fora da plataforma Snowflake
- Listagens gratuitas – fornecidas sem custo na plataforma, mas pagas fora da plataforma diretamente ao provedor
- Listagens que nunca foram acessadas pelos consumidores

Exemplos¶

Visualize um registro de alterações para uma listagem e um consumidor específicos:

SELECT event_date, listing_name, listing_global_name, consumer_account_name, consumer_account_locator, consumer_organization_name, current_pricing_plan, next_pricing_plan, is_consumer_auto_renewal_enabled, purchase_state, current_pricing_plan_start_on, current_pricing_plan_end_on, trial_end_on, access_end_on FROM snowflake.data_sharing_usage.paid_listing_access_and_change_log WHERE TRUE AND consumer_organization_name = 'specific_organization_name' AND listing_display_name = 'specific_listing_display_name' ORDER BY event_date DESC; 

Copy

Visualize listagens e consumidores com planos de preços que terminam no próximo período de faturamento:

SELECT event_date, listing_name, listing_global_name, consumer_account_name, consumer_account_locator, consumer_organization_name, current_pricing_plan, next_pricing_plan, is_consumer_auto_renewal_enabled, purchase_state, current_pricing_plan_start_on, current_pricing_plan_end_on, trial_end_on, access_end_on FROM snowflake.data_sharing_usage.paid_listing_access_and_change_log WHERE TRUE AND consumer_organization_name = 'specific_organization_name' AND listing_display_name = 'specific_listing_display_name' QUALIFY TRUE AND ROW_NUMBER() OVER ( PARTITION BY consumer_organization_name, consumer_snowflake_region, consumer_account_name, listing_display_name ORDER BY event_date DESC ) = 1; 

Copy