Referência de tabelas de sistema do Marketplace

Visualização

Esse 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 processo de venda do Databricks Marketplace .

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

  • Acesso à listagem: registra as informações do consumidor para dados de solicitação concluída ou obtém eventos de dados em suas listagens.

  • Eventos de funil: registra impressões e ações realizadas em suas listagens.

Listando tabela de eventos de acesso

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

system.marketplace.listing_access_events tem o seguinte esquema:

Nome da coluna

Tipo de dados

Descrição

account_id

String

O ID account que hospeda a listagem.

metastore_id

String

O ID do metatore que hospeda a listagem.

metastore_cloud

String

O provedor clouds 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 da listagem.

listing_name

String

O nome da listagem.

consumer_delta_sharing_recipient_name

String

O nome subjacente do destinatário do compartilhamento Delta para o consumidor. O valor é null quando event_type é REQUEST_DATA.

consumer_delta_sharing_recipient_type

String

Quer o consumidor esteja numa account Databricks ou não. Os valores serão OPEN ou DATABRICKS.

consumer_cloud

String

As clouds do consumidor. 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 pretendido da listagem pelo consumidor.

consumer_comments

String

Qualquer comentário adicional que o consumidor tenha deixado.

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

Timestamp

O carimbo de data/hora UTC exato em que o evento aconteceu.

Listando tabela de eventos de funil

A tabela listing_funnel_events analisa impressões e ações realizadas em suas listagens. O event_type informa qual ação o consumidor realizou em sua listagem.

system.marketplace.listing_funnel_events tem o seguinte esquema:

Nome da coluna

Tipo de dados

Descrição

account_id

String

O ID account que hospeda a listagem.

metastore_id

String

O ID do metatore que hospeda a listagem.

metastore_cloud

String

O provedor clouds 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 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 carimbo de data/hora UTC exato em que o evento aconteceu.

event_date

Data

A data UTC em que o evento aconteceu.

consumer_cloud

String

As clouds do consumidor. 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 Databricks on Google Cloud. As tabelas não incluem as atividades de consumo do Google Clouds anteriores a essa data.

  • Na tabela listing_funnel_events , os tipos de eventos ABANDON_FAIL_DATA e FAIL_GET_DATA não foram registrados antes de 30 de novembro de 2023.

queryde exemplo

Esta seção inclui o seguinte exemplo de query que você pode usar para entender a atividade do consumidor em suas listagens.

Solicitações do consumidor 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

Veja 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

Veja 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

Demonstração Notebook : analise as tabelas do sistema do Marketplace

O Notebook a seguir inclui exemplos de consultas destes artigos, juntamente com células adicionais que fornecem análises adicionais.

Demonstração da tabela do sistema do Marketplace

Abra o bloco de anotações em outra guia