Compartilhar via

Referência de tabelas do sistema do Marketplace

  • Artigo

Importante

Esta tabela do sistema está em Visualização Pública. Para acessar a tabela, o esquema deve estar habilitado em seu catálogo system. Para obter mais informações, consulte Habilitar esquemas da tabela do sistema.

Este artigo fornece uma visão geral de como usar tabelas do sistema para ajudar a monitorar seu processo de vendas do Databricks Marketplace .

As tabelas do sistema do Marketplace estão localizadas no esquema system.marketplace. As seguintes tabelas estão disponíveis:

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

Observação

Você pode usar o Painel de Controle de Análise de Dados do Provedor para monitorar as métricas de uso do destinatário. O painel de controle extrai os dados das tabelas do sistema do Marketplace. Confira Monitorar as listagens de métricas de uso usando painéis de controle.

Listar a tabela de eventos de acesso

A tabela de eventos de acesso à listagem recupera as informações do consumidor para dados de solicitação concluídos ou eventos de obtenção de dados em suas listagens.

Caminho da tabela: Esta tabela do sistema está localizada em system.marketplace.listing_access_events.

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.
consumer_name string O nome do consumidor.
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. As informações de fuso horário são registradas no final do valor, com +00:00 representando UTC.

Listar a tabela de eventos de funil

A tabela de eventos do funil de listagem analisa as impressões e as ações realizadas em suas listagens. event_type informa a você qual ação o consumidor tomou na sua listagem.

Caminho da tabela: Esta tabela do sistema está localizada em system.marketplace.listing_funnel_events.

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. As informações de fuso horário são registradas no final do valor, com +00:00 representando UTC.
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