Referência das tabelas do sistema do Marketplace

Visualização

Este recurso está em visualização pública.

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

Todas as tabelas do sistema do marketplace estão no esquema system.marketplace. Atualmente, as tabelas a seguir estão ativas:

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

Listagem da tabela de eventos de acesso

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

system.marketplace.listing_access_events tem o seguinte esquema:

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.

Tabela de eventos do funil de listagem

A tabela listing_funnel_events analisa as impressões e as ações realizadas em seus anúncios. O event_type informa ao senhor qual ação o consumidor realizou no seu anúncio.

system.marketplace.listing_funnel_events tem o seguinte esquema:

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.

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 

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