Share via

Referência de tabelas do sistema do Marketplace

  • Artigo

Importante

Esse recurso está em uma versão prévia.

Este artigo fornece uma visão geral de como utilizar as tabelas do sistema para ajudar a operacionalizar seu processo de vendas no Databricks Marketplace.

As tabelas do sistema do Marketplace estão ativas no esquema system.marketplace. Atualmente, as seguintes tabelas estão ativas:

  • Acesso de listagem: registra as informações do consumidor para eventos de solicitação de dados ou obtenção de dados em suas listagens.
  • Eventos de funil: registra impressões e ações executadas em suas listagens.

Listar a tabela de eventos de acesso

A tabela listing_access_events recupera as informações do consumidor para eventos de solicitação de dados ou obtenção de dados em suas listagens.

system.marketplace.listing_access_events tem o seguinte esquema:

Nome da coluna Tipo de dados Descrição
account_id string A ID da conta que hospeda a listagem.
metastore_id string A ID do metatore que hospeda a listagem.
metastore_cloud string O provedor de nuvem do metastore que hospeda a listagem.
metastore_region string A região do metastore que hospeda a listagem.
provider_id string A ID do perfil do provedor.
provider_name string O nome do perfil do provedor.
listing_id string A ID da listagem.
listing_name string O nome da listagem.
consumer_delta_sharing_recipient_name string O nome do destinatário subjacente do Compartilhamento Delta para o consumidor. O valor é null quando o event_type é REQUEST_DATA.
consumer_delta_sharing_recipient_type string Se o consumidor está em uma conta do Azure Databricks ou não. Os valores serão OPEN ou DATABRICKS.
consumer_cloud string A nuvem do consumidor. Anulável se consumer_delta_sharing_recipient_type for OPEN.
consumer_region string A região do consumidor. Anulável se consumer_delta_sharing_recipient_type for OPEN.
consumer_metastore_id string A ID do metastore do consumidor. Anulável se consumer_delta_sharing_recipient_type for OPEN.
consumer_email string O endereço de email do consumidor. PII.
consumer_name string O nome do consumidor. PII.
consumer_company string A empresa do consumidor.
consumer_intended_use string O uso que o consumidor pretende fazer da listagem.
consumer_comments string Qualquer comentário adicional deixado pelo consumidor.
event_type string O tipo de acesso. O valor pode ser REQUEST_DATA ou GET_DATA.
event_date date A data UTC em que o evento ocorreu.
event_time timestamp O carimbo de data/hora UTC exato em que o evento ocorreu.

Listar a tabela de eventos de funil

A tabela listing_funnel_events analisa impressões e ações executadas em suas listagens. event_type informa a você qual ação o consumidor tomou na sua listagem.

system.marketplace.listing_funnel_events tem o seguinte esquema:

Nome da coluna Tipo de dados Descrição
account_id string A ID da conta que hospeda a listagem.
metastore_id string A ID do metatore que hospeda a listagem.
metastore_cloud string O provedor de nuvem do metastore que hospeda a listagem.
metastore_region string A região do metastore que hospeda a listagem.
provider_id string A ID do perfil do provedor.
provider_name string O nome do perfil do provedor.
listing_id string A ID da listagem.
listing_name string O nome da listagem.
event_type string O tipo de ação do consumidor. Confira Tipos de evento.
event_time timestamp O carimbo de data/hora UTC exato em que o evento ocorreu.
event_date date A data UTC em que o evento ocorreu.
consumer_cloud string A nuvem do consumidor. Anulável se consumer_delta_sharing_recipient_type for OPEN.
consumer_region string A região do consumidor. Anulável se consumer_delta_sharing_recipient_type for OPEN.

Tipos de evento

Os valores possíveis para a coluna event_type são:

  • VIEW_LISTING
  • START_REQUEST_DATA
  • COMPLETE_REQUEST_DATA
  • ABANDON_REQUEST_DATA
  • START_GET_DATA
  • COMPLETE_GET_DATA
  • ABANDON_GET_DATA
  • UNINSTALL_DATA
  • FAIL_REQUEST_DATA
  • FAIL_GET_DATA

Limitações conhecidas

  • A partir de 12 de março de 2024, as tabelas do sistema do Marketplace incluem atividades de consumidores que usam o Databricks no Google Cloud. As tabelas não incluem a atividade do consumidor do Google Cloud antes desta data.
  • Na tabela listing_funnel_events, os tipos de evento ABANDON_FAIL_DATA e FAIL_GET_DATA não foram registrados antes de 30 de novembro de 2023.

Consultas de exemplo

Esta seção inclui os seguintes exemplos de consultas que você pode utilizar para obter insights sobre a atividade do consumidor em suas listagens.

Solicitações de consumidores dos últimos 10 dias

SELECT event_date, provider_name, listing_name, listing_id, consumer_delta_sharing_recipient_name, consumer_cloud, consumer_region, consumer_name, consumer_email, consumer_company
FROM system.marketplace.listing_access_events
WHERE event_type = 'REQUEST_DATA'
AND event_date >= date_add(current_date(), -10)

Principais listagens por número de solicitações

SELECT listing_name, consumer_cloud, count(*) as requestCount
FROM system.marketplace.listing_access_events
GROUP BY listing_name, consumer_cloud
ORDER BY requestCount DESC

Exibir os principais solicitantes

SELECT consumer_name, consumer_email, count(*) as requestCount
FROM system.marketplace.listing_access_events
GROUP BY consumer_name, consumer_email
ORDER BY requestCount DESC

Exibir o número de vezes que cada ação do consumidor foi tomada em uma listagem

SELECT event_type, COUNT(*) as occurrences
FROM system.marketplace.listing_funnel_events
WHERE listing_name = `{{listing_name}}`
GROUP BY event_type

Demonstração do notebook: analisar as tabelas do sistema do Marketplace

O notebook a seguir inclui os exemplos de consultas deste artigo, juntamente com células adicionais que fornecem análises adicionais.

Demonstração da tabela do sistema do Marketplace

Obter notebook