Partilhar via


Referência de tabelas do sistema do Marketplace

Importante

Esta tabela do sistema está em Public Preview.

Esta página fornece uma referência sobre como usar tabelas do sistema para ajudar a monitorar seu processo de venda do Databricks Marketplace .

As tabelas do sistema do Marketplace encontram-se no esquema system.marketplace. Esse esquema é ativado automaticamente quando uma listagem do Marketplace é criada em sua metastore. O esquema inclui as seguintes tabelas:

  • Acesso ao anúncio: Regista as informações do consumidor para dados de pedidos concluídos ou eventos de obtenção 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 ao anúncio recupera as informações dos consumidores sobre os eventos de dados de solicitação concluídos ou recebe dados de dentro dos seus anúncios.

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 (de caracteres) O ID da conta que hospeda o anúncio.
metastore_id cadeia (de caracteres) O ID do metastore que hospeda a listagem.
metastore_cloud cadeia (de caracteres) O provedor de nuvem do metastore que hospeda a listagem.
metastore_region cadeia (de caracteres) A região do metastore que hospeda a listagem.
provider_id cadeia (de caracteres) O ID do perfil do provedor.
provider_name cadeia (de caracteres) O nome do perfil do provedor.
listing_id cadeia (de caracteres) O ID do anúncio.
listing_name cadeia (de caracteres) O nome do anúncio.
consumer_delta_sharing_recipient_name cadeia (de caracteres) 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 cadeia (de caracteres) Se o consumidor está em uma conta do Azure Databricks ou não. Os valores serão OPEN ou DATABRICKS.
consumer_cloud cadeia (de caracteres) A nuvem do consumidor. Nulo se consumer_delta_sharing_recipient_type for OPEN.
consumer_region cadeia (de caracteres) A região do consumidor. Nulo se consumer_delta_sharing_recipient_type for OPEN.
consumer_metastore_id cadeia (de caracteres) ID de metastore do consumidor. Nulo se consumer_delta_sharing_recipient_type for OPEN.
consumer_email cadeia (de caracteres) O endereço de e-mail do consumidor.
consumer_name cadeia (de caracteres) O nome do consumidor.
consumer_company cadeia (de caracteres) A empresa do consumidor.
consumer_intended_use cadeia (de caracteres) A utilização prevista do anúncio pelo consumidor.
consumer_comments cadeia (de caracteres) Qualquer comentário adicional que o consumidor deixou.
event_type cadeia (de caracteres) 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 representando UTC.

Tabela de eventos do funil de listagem

A tabela de eventos do funil de listagem analisa as impressões e ações realizadas nos 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 Descrição
account_id cadeia (de caracteres) O ID da conta que hospeda o anúncio.
metastore_id cadeia (de caracteres) O ID do metastore que hospeda a listagem.
metastore_cloud cadeia (de caracteres) O provedor de nuvem do metastore que hospeda a listagem.
metastore_region cadeia (de caracteres) A região do metastore que hospeda a listagem.
provider_id cadeia (de caracteres) O ID do perfil do provedor.
provider_name cadeia (de caracteres) O nome do perfil do provedor.
listing_id cadeia (de caracteres) O ID do anúncio.
listing_name cadeia (de caracteres) O nome do anúncio.
event_type cadeia (de caracteres) 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 representando UTC.
event_date data A data UTC em que o evento aconteceu.
consumer_cloud cadeia (de caracteres) A nuvem do consumidor. Nulo se consumer_delta_sharing_recipient_type for OPEN.
consumer_region cadeia (de caracteres) 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 listing_funnel_events, os tipos de eventos de 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 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 caderno