Sistema de eventos de sala limpa table referência

Os eventos de sala limpa table registam as ações realizadas por si ou pelos seus colaboradores em salas limpas (Pré-visualização Pública) na sua conta. Este table inclui dados regionais de toda a sua conta.

Para obter mais informações sobre salas limpas, consulte O que é o Azure Databricks Clean Rooms?.

Table caminho: Este sistema table está localizado em system.access.clean_room_events.

Sistema de eventos de sala limpa tableschema

O sistema de eventos de sala limpa table usa os seguintes schema:

Eventos de sala limpa registrados

Este sistema table regista os seguintes eventos:

• CLEAN_ROOM_CREATED: O usuário cria uma nova sala limpa
• CLEAN_ROOM_DELETED: O usuário exclui uma sala limpa
• RUN_NOTEBOOK_STARTED: O utilizador inicia uma execução de notebook numa sala limpa
• RUN_NOTEBOOK_COMPLETED: Uma execução do bloco de anotações foi concluída. Verifique o run_notebook_completed_metadata para ver se a execução foi bem-sucedida ou não.
• CLEAN_ROOM_ASSETS_UPDATED: Os ativos de uma sala limpa são atualizados. Isso pode ser adicionar, atualizar ou excluir ativos.

Monitore o uso faturável da sala limpa

Para saber mais sobre o uso e os custos da sala limpa, você pode join este table com o billing.usagetable usando o central_clean_room_idcolumn. No billing.usagetable, a utilização da zona limpa é atribuída usando a chave usage_metadata.central_clean_room_id.

Consultas de amostra

As consultas de exemplo a seguir ajudam você a obter informações sobre a atividade de sala limpa em sua conta:

• List todos os eventos a partir de uma sala limpa especificada
• List todos os eventos iniciados por um colaborador especificado
• List todos os colaboradores relevantes nas salas limpas
• List o notebook mais lento é executado
• Taxa de execução bem-sucedida para cada notebook
• List todos os eventos where um(a) table especificado(a) foi adicionado(a) às salas limpas

List todos os eventos a partir de uma sala limpa especificada

SELECT
 event_time, initiator_global_metastore_id, event_type,
 CASE
   WHEN event_type = 'CLEAN_ROOM_CREATED' THEN to_json(clean_room_created_metadata)
   WHEN event_type = 'CLEAN_ROOM_DELETED' THEN to_json(clean_room_deleted_metadata)
   WHEN event_type = 'RUN_NOTEBOOK_STARTED' THEN to_json(run_notebook_started_metadata)
   WHEN event_type = 'RUN_NOTEBOOK_COMPLETED' THEN to_json(run_notebook_completed_metadata)
   WHEN event_type = 'CLEAN_ROOM_ASSETS_UPDATED' THEN to_json(clean_room_assets_updated_metadata)
   ELSE ""
 END AS event_metadata
 FROM system.access.clean_room_events
 WHERE clean_room_name = '<clean_room_name>'
ORDER BY event_time DESC

List todos os eventos iniciados por um colaborador especificado

Para o parâmetro :initiator_global_metastore_id, insira o ID global do metastore do colaborador, também designado por identifierde partilha.

SELECT
  clean_room_name,
  event_type,
  event_time,
  CASE
    WHEN event_type = 'CLEAN_ROOM_CREATED' THEN to_json(clean_room_created_metadata)
    WHEN event_type = 'CLEAN_ROOM_DELETED' THEN to_json(clean_room_deleted_metadata)
    WHEN event_type = 'RUN_NOTEBOOK_STARTED' THEN to_json(run_notebook_started_metadata)
    WHEN event_type = 'RUN_NOTEBOOK_COMPLETED' THEN to_json(run_notebook_completed_metadata)
    WHEN event_type = 'CLEAN_ROOM_ASSETS_UPDATED' THEN to_json(clean_room_assets_updated_metadata)
    ELSE ""
  END AS event_metadata
FROM
  system.access.clean_room_events
WHERE
  initiator_global_metastore_id = :initiator_global_metastore_id
ORDER BY
  clean_room_name,
  event_time DESC

List todos os colaboradores relevantes das salas limpas

SELECT DISTINCT explode(transform(clean_room_created_metadata.collaborators, x -> x.collaborator_global_metastore_id)) AS collaborator
FROM system.access.clean_room_events
WHERE event_type = 'CLEAN_ROOM_CREATED'

List o portátil mais lento funciona

SELECT
 clean_room_name,
 run_notebook_completed_metadata.notebook_name AS notebook_name,
 run_notebook_completed_metadata.duration_in_seconds AS duration_in_seconds,
 run_notebook_completed_metadata.run_id AS run_id
FROM system.access.clean_room_events
WHERE event_type = 'RUN_NOTEBOOK_COMPLETED'
 AND run_notebook_completed_metadata.state = 'SUCCESS'
 AND run_notebook_completed_metadata.duration_in_seconds IS NOT NULL
ORDER BY duration_in_seconds DESC

Taxa de execução bem-sucedida para cada notebook

SELECT
 clean_room_name,
 run_notebook_completed_metadata.notebook_name AS notebook_name,
 ROUND(COUNT(CASE WHEN run_notebook_completed_metadata.state = 'SUCCESS' THEN 1 END) * 1.0 / COUNT(*) * 100) AS success_rate
FROM system.access.clean_room_events
WHERE event_type = 'RUN_NOTEBOOK_COMPLETED'
GROUP BY clean_room_name, notebook_name
ORDER BY clean_room_name, notebook_name

List todos os eventos where um table específico foi adicionado às salas limpas

Para o parâmetro :table_name_string, insira o nome especificado do table.

SELECT
  clean_room_name,
  initiator_global_metastore_id,
  event_time,
  clean_room_assets_updated_metadata
FROM
  system.access.clean_room_events
WHERE
  event_type = 'CLEAN_ROOM_ASSETS_UPDATED'
  AND exists(
    clean_room_assets_updated_metadata.added_assets,
    item -> item.data_object_type = 'TABLE'
    AND item.name = :table_name_string
  )
ORDER BY
  clean_room_name,
  event_time DESC