referência de tabelas do sistema marketplace

info

Visualização

Essa tabela do sistema está em Pré-visualização Pública.

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

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

• Acesso ao anúncio: registra as informações do consumidor para obter dados de solicitações preenchidas ou obtém eventos de dados em seus anúncios.
• eventos do funil: Registra impressões e ações realizadas em suas listagens.

nota

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 do marketplace. Consulte Monitorar as métricas de uso da listagem usando painéis.

Habilite o esquema marketplace

Um administrador do site account deve ativar o esquema marketplace. O senhor pode habilitá-lo usando o comando system-schemas no diretório Databricks CLI ou o SystemSchemas API.

Habilitar o esquema do marketplace

Use o seguinte comando da CLI para ativar o esquema marketplace:

Bash

databricks system-schemas enable METASTORE_ID marketplace

Desativar o esquema do marketplace

Use o seguinte comando da CLI para desativar o esquema marketplace:

Bash

databricks system-schemas disable METASTORE_ID marketplace

Listando a 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	O ID da metastore que hospeda o anúncio.
metastore_cloud	string	O provedor de nuvem da metastore que hospeda a listagem.
metastore_region	string	A região da metastore que hospeda o anúncio.
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 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	A nuvem 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 da metastore do consumidor. Anulável se consumer_delta_sharing_recipient_type for OPEN.
consumer_email	string	O endereço email do consumidor.
consumer_name	string	O nome do consumidor.
consumer_company	string	A empresa do consumidor.
consumer_intended_use	string	O uso pretendido do anúncio 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	carimbo de data/hora	O timestamp 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.

Listagem funnel tabela de eventos

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	O ID da metastore que hospeda o anúncio.
metastore_cloud	string	O provedor de nuvem da metastore que hospeda a listagem.
metastore_region	string	A região da metastore que hospeda o anúncio.
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. Veja os tipos de eventos.
event_time	carimbo de data/hora	O timestamp 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	string	A nuvem 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 do marketplace incluem a atividade dos consumidores que usam o site Databricks on 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 ABANDON_FAIL_DATA e FAIL_GET_DATA não foram registrados antes de 30 de novembro de 2023.

Exemplos 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
• Melhores anúncios por número de solicitações
• visualizar os principais solicitantes
• visualizar o número de vezes que cada ação do consumidor foi realizada em uma listagem

Solicitações de consumidores dos últimos 10 dias

SQL

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)

Melhores anúncios por número de solicitações

SQL

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

visualizar os principais solicitantes

SQL

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

SQL

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 do marketplace

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

demonstração da tabela do sistema marketplace

Open notebook in new tab