Partilhar 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 ser habilitado em seu system catálogo. Para obter mais informações, consulte Habilitar esquemas de tabela do sistema.

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

As tabelas do sistema do Marketplace vivem no system.marketplace esquema. Estão disponíveis as seguintes tabelas:

  • Acesso ao anúncio: regista as informações do consumidor para obter dados de pedidos concluídos ou obter eventos de dados nos seus anúncios.
  • Eventos de funil: registra impressões e ações realizadas em seus anúncios.

Nota

Você pode usar o Painel do Provider Analytics para monitorar as métricas de uso do destinatário. O painel extrai dados das tabelas do sistema do Marketplace. Consulte Monitorar métricas de uso de listagem usando painéis.

Listando 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 obtém eventos 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 Description
account_id string O ID da conta que hospeda o anúncio.
metastore_id string O ID 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 O ID do perfil do provedor.
provider_name string O nome do perfil do provedor.
listing_id string O ID do anúncio.
listing_name string O nome do anúncio.
consumer_delta_sharing_recipient_name string O nome do destinatário do Delta Sharing subjacente 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 ou OPEN DATABRICKS.
consumer_cloud string A nuvem do consumidor. Nulo se consumer_delta_sharing_recipient_type for OPEN.
consumer_region string A região do consumidor. Nulo se consumer_delta_sharing_recipient_type for OPEN.
consumer_metastore_id string O ID do metastore do consumidor. Nulo se consumer_delta_sharing_recipient_type for OPEN.
consumer_email string O endereço de e-mail do consumidor. PII.
consumer_name string O nome do consumidor. PII.
consumer_company string A empresa do consumidor.
consumer_intended_use string A utilização prevista do anúncio pelo consumidor.
consumer_comments string Qualquer comentário adicional que o consumidor deixou.
event_type string O tipo de acesso. O valor pode ser REQUEST_DATA ou GET_DATA.
event_date data A data UTC em que o evento aconteceu.
event_time carimbo de data/hora O carimbo de data/hora UTC exato quando o evento aconteceu. As informações de fuso horário são registradas no final do valor com +00:00 a representação UTC.

Tabela de eventos do funil de listagem

A tabela de eventos do funil de listagem analisa as impressões e ações realizadas em seus anúncios. O event_type informa qual ação o consumidor tomou em relação ao seu anúncio.

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

Nome da coluna Tipo de dados Description
account_id string O ID da conta que hospeda o anúncio.
metastore_id string O ID 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 O ID do perfil do provedor.
provider_name string O nome do perfil do provedor.
listing_id string O ID do anúncio.
listing_name string O nome do anúncio.
event_type string O tipo de ação do consumidor. Consulte Tipos de eventos.
event_time carimbo de data/hora O carimbo de data/hora UTC exato quando o evento aconteceu. As informações de fuso horário são registradas no final do valor com +00:00 a representação UTC.
event_date data A data UTC em que o evento aconteceu.
consumer_cloud string A nuvem do consumidor. Nulo se consumer_delta_sharing_recipient_type for OPEN.
consumer_region string A região do consumidor. Nulo se consumer_delta_sharing_recipient_type for OPEN.

Tipos de eventos

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 Marketplace incluem a atividade dos consumidores que usam o Databricks no Google Cloud. As tabelas não incluem a atividade do consumidor do Google Cloud antes dessa data.
  • Na tabela, os listing_funnel_events tipos de eventos não FAIL_GET_DATA foram registrados antes de 30 de novembro de ABANDON_FAIL_DATA 2023.

Consultas de exemplo

Esta seção inclui os seguintes exemplos de consultas que você pode usar para obter informações sobre a atividade do consumidor em seus anúncios.

Pedidos dos 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 anúncios por número de pedidos

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

Ver 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

Ver o número de vezes que cada ação do consumidor foi executada num anúncio

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: Analise as tabelas do sistema Marketplace

O bloco de anotações a seguir inclui as consultas de exemplos deste artigo, juntamente com células adicionais que fornecem uma análise mais aprofundada.

Demonstração da tabela do sistema Marketplace

Obter o bloco de notas