Compartilhar via

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