Esquema:

DATA_SHARING_USAGE

Exibição MARKETPLACE_PAID_USAGE_DAILY

Como consumidor, você pode usar a exibição MARKETPLACE_PAID_USAGE_DAILY no esquema DATA_SHARING_USAGE para consultar o histórico diário de seu uso de uma listagem paga específica. Recupere as cobranças pelo uso e a contagem de consultas executadas por seus usuários em listagens específicas.

Esta exibição inclui o histórico de pagamentos do consumidor para uma listagem específica.

Nota

Como parte da versão preliminar do Custom Event Billing, a coluna CHARGE_TYPE contém valores adicionais.

Colunas

Nome da coluna

Tipo de dados

Descrição

REPORT_DATE

DATETIME

Data em que o relatório foi gerado.

USAGE_DATE

DATETIME

Data do uso.

PROVIDER_NAME

VARCHAR

Nome do provedor a partir da listagem.

PROVIDER_ACCOUNT_NAME

VARCHAR

Nome da conta do provedor.

PROVIDER_ACCOUNT_LOCATOR

VARCHAR

Localizador da conta do provedor. Para obter mais informações sobre identificadores de contas, consulte identificador da conta.

PROVIDER_ORGANIZATION_NAME

VARCHAR

Nome da organização do provedor.

LISTING_DISPLAY_NAME

VARCHAR

Nome de exibição da listagem.

LISTING_GLOBAL_NAME

VARCHAR

Nome global da listagem.

DATABASE_NAME

VARCHAR

Nome do banco de dados associado à listagem.

PO_NUMBER

VARCHAR

Número do pedido de compra associado à listagem.

PRICING_PLAN

VARIANT

JSON valor que inclui os detalhes do plano de preços. Somente incluído nos resultados do uso pago.

CHARGE_TYPE

VARCHAR

Tipo de cobrança avaliada. Para obter mais informações sobre os componentes do modelo de preços de listagens pagas, consulte Modelos de preços de listagens pagas.

Possíveis valores:

  • SAMPLE: nenhuma cobrança. As consultas foram executadas dentro do período de avaliação da listagem.

  • FIXED: cobranças por mês.

  • GRACE: nenhuma cobrança. As consultas foram contadas entre as consultas gratuitas permitidas no mês civil (após a primeira consulta) antes de ser aplicada a cobrança por consulta.

  • VARIABLE: cobranças por consulta.

  • MAX_VARIABLE_USAGE_REACHED: nenhuma cobrança. As consultas foram executadas após o custo total mensal máximo para a listagem ter sido atingido.

Valores adicionais fazem parte da funcionalidade da versão preliminar:

  • NON_MONETIZABLE_BILLING_EVENTS: nenhuma cobrança. Esses eventos faturáveis foram emitidos durante o uso de teste de um produto de dados ou para eventos faturáveis que não fazem parte de um plano de preços na listagem.

  • MONETIZABLE_BILLING_EVENTS: cobranças de faturamento de evento personalizado.

  • MAX_BILLING_EVENT_USAGE_REACHED: nenhuma cobrança. Esses eventos faturáveis foram emitidos depois que o custo mensal total máximo da listagem foi atingido.

UNITS

VARCHAR

Número de consultas incluídas na cobrança. Para uma cobrança FIXED, esse valor é 1.

UNIT_PRICE

DECIMAL

Taxa por mês ou por consulta. Para dados de amostra, o valor é 0.

CHARGE

DECIMAL

Cobrança total para este item neste dia (sem impostos).

CURRENCY

VARCHAR

USD

Notas de uso

  • A latência da exibição pode ser de até 48 horas (2 dias).

  • Os dados são retidos por 365 dias (1 ano).

  • Você só pode ver o uso da sua conta, que deve ser a conta do consumidor que gerou as cobranças.

Exemplos

Veja o valor total cobrado por mês e a listagem:

SELECT
  DATE_TRUNC(MONTH, usage_date) AS usage_month
, listing_display_name
, listing_global_name
, SUM(charge) AS charge
FROM snowflake.data_sharing_usage.marketplace_paid_usage_daily
GROUP BY 1,2,3;
Copy

Veja o valor total cobrado por mês, a listagem e o tipo de cobrança:

SELECT
  DATE_TRUNC(MONTH, usage_date) AS usage_month
, listing_display_name
, listing_global_name
, SUM(charge) AS charge
, charge_type
FROM snowflake.data_sharing_usage.marketplace_paid_usage_daily
GROUP BY 1,2,3,4;
Copy

Recupere o valor total cobrado pelo uso de um aplicativo que usa o plano de preços do Custom Event Billing:

SELECT listing_global_name,
   listing_display_name,
   charge_type,
   charge
FROM SNOWFLAKE.DATA_SHARING_USAGE.MARKETPLACE_PAID_USAGE_DAILY
WHERE charge_type='MONETIZABLE_BILLING_EVENTS';
Copy