Referência de tabelas do sistema do Marketplace

Importante

Esta tabela do sistema está em Visualização Pública.

Esta página fornece uma referência sobre como usar tabelas do sistema para ajudar a monitorar o processo de venda do Databricks Marketplace .

As tabelas do sistema do Marketplace estão localizadas no esquema system.marketplace. Esse esquema é habilitado automaticamente quando uma listagem do Marketplace é criada em seu metastore. O esquema inclui as seguintes tabelas:

  • 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 cadeia A ID da conta que hospeda a listagem.
metastore_id cadeia A ID do metastore que hospeda a listagem.
metastore_cloud cadeia O provedor de nuvem do metastore que hospeda a listagem.
metastore_region cadeia A região do metastore que hospeda a listagem.
provider_id cadeia A ID do perfil do provedor.
provider_name cadeia O nome do perfil do provedor.
listing_id cadeia A ID da listagem.
listing_name cadeia O nome da listagem.
consumer_delta_sharing_recipient_name cadeia 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 cadeia Se o consumidor está em uma conta do Azure Databricks ou não. Os valores serão OPEN ou DATABRICKS.
consumer_cloud cadeia A nuvem do consumidor. Anulável se consumer_delta_sharing_recipient_type for OPEN.
consumer_region cadeia A região do consumidor. Anulável se consumer_delta_sharing_recipient_type for OPEN.
consumer_metastore_id cadeia O ID do metastore do consumidor. Anulável se consumer_delta_sharing_recipient_type for OPEN.
consumer_email cadeia O endereço de email do consumidor.
consumer_name cadeia O nome do consumidor.
consumer_company cadeia A empresa do consumidor.
consumer_intended_use cadeia O uso pretendido pelo consumidor da listagem.
consumer_comments cadeia Qualquer comentário adicional deixado pelo consumidor.
event_type cadeia O tipo de acesso. O valor pode ser REQUEST_DATA ou GET_DATA.
event_date data A data UTC em que o evento ocorreu.
event_time carimbo de data/hora 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 cadeia A ID da conta que hospeda a listagem.
metastore_id cadeia A ID do metastore que hospeda a listagem.
metastore_cloud cadeia O provedor de nuvem do metastore que hospeda a listagem.
metastore_region cadeia A região do metastore que hospeda a listagem.
provider_id cadeia A ID do perfil do provedor.
provider_name cadeia O nome do perfil do provedor.
listing_id cadeia A ID da listagem.
listing_name cadeia O nome da listagem.
event_type cadeia O tipo de ação do consumidor. Confira Tipos de evento.
event_time carimbo de data/hora 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 data A data UTC em que o evento ocorreu.
consumer_cloud cadeia A nuvem do consumidor. Anulável se consumer_delta_sharing_recipient_type for OPEN.
consumer_region cadeia 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

  • Last updated on