Referência das tabelas do sistema do Marketplace

Visualização

Essa tabela do sistema está em Pré-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 de tabelas do sistema.

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

As tabelas do sistema de marketplace estão no esquema system.marketplace. As tabelas a seguir estão disponíveis:

Acesso à listagem: Registra as informações do consumidor para eventos de solicitação de dados ou obtenção de dados concluídos em suas listagens.
Eventos de funil: Registra impressões e ações realizadas em suas listagens.

Observação

O senhor pode usar o Provider analítica Dashboard para monitorar as métricas de uso do destinatário. O dashboard extrai dados das tabelas do sistema marketplace. Consulte Monitorar as métricas de uso da listagem usando painéis.

Listagem da tabela de eventos de acesso

A tabela de eventos de acesso ao anúncio recupera as informações do consumidor para obter dados de solicitação preenchidos ou obtém eventos de dados em seus anúncios.

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

Nome da coluna	Tipo de dados	Descrição
`account_id`	string	A ID account que hospeda a listagem.
`metastore_id`	string	A ID do metatore que hospeda a listagem.
`metastore_cloud`	string	O provedor cloud 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	O ID da listagem.
`listing_name`	string	O nome da listagem.
`consumer_delta_sharing_recipient_name`	string	O nome do destinatário subjacente do Delta Sharing para o consumidor. O valor é `null` quando o event_type é `REQUEST_DATA`.
`consumer_delta_sharing_recipient_type`	string	Independentemente de o consumidor estar em um Databricks account ou não. Os valores serão `OPEN` ou `DATABRICKS`.
`consumer_cloud`	string	O site do consumidor cloud. 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	O ID do metastore do consumidor. Anulável se `consumer_delta_sharing_recipient_type` for `OPEN`.
`consumer_email`	string	O endereço 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`	Data	A data UTC em que o evento ocorreu.
`event_time`	timestamp	O registro de data e 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.

Tabela de eventos do funil de listagem

A tabela de eventos da listagem funnel analisa as impressões e ações realizadas em suas listagens. O event_type mostra qual ação o consumidor realizou em seu anúncio.

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

Nome da coluna	Tipo de dados	Descrição
`account_id`	string	A ID account que hospeda a listagem.
`metastore_id`	string	A ID do metatore que hospeda a listagem.
`metastore_cloud`	string	O provedor cloud 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	O ID da listagem.
`listing_name`	string	O nome da listagem.
`event_type`	string	O tipo de ação do consumidor. Consulte Tipos de eventos.
`event_time`	timestamp	O registro de data e 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`	string	O site do consumidor cloud. 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 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 site Databricks on Google Cloud. As tabelas não incluem as atividades de consumo do Google cloud anteriores a essa 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.

Exemplo de consultas

Esta seção inclui os seguintes exemplos de consultas que o senhor pode usar para obter entendimento da atividade do consumidor em suas listagens.

Solicitações de consumidores dos últimos 10 dias
Principais listagens por número de solicitações
view principais solicitantes
view o número de vezes que cada ação do consumidor foi realizada em uma listagem

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

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

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

Notebook Demonstração: Analisar as tabelas do sistema marketplace

O site 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 Marketplace

Abra o bloco de anotações em outra guia