Esquema:: DATA_SHARING_USAGE

Exibição PAID_LISTING_ACCESS_AND_CHANGE_LOG¶

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