Referência da tabela do sistema de eventos de sala limpa

Importante

Esta tabela do sistema está em Public Preview. Para acessar a tabela, o esquema deve ser habilitado em seu catálogo de system. Para obter mais informações, consulte Habilitar esquemas de tabela do sistema.

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

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

Caminho da tabela: Esta tabela do sistema está localizada em system.access.clean_room_events.

Esquema de tabela do sistema de eventos de sala limpa

A tabela do sistema de eventos de sala limpa usa o seguinte esquema:

Nome da coluna	Tipo de dados	Description	Exemplo
account_id	string	O ID da conta Databricks	7af234db-66d7-4db3 -bbf0-956098224879
metastore_id	string	A ID do metastore do Unity Catalog	5a31ba44-bbf4-4174 -bf33-e1fa078e6765
event_id	string	A ID do evento de sala limpa	db52a413-7a0a-4d49 -b742-7ae5f06bc4b2
clean_room_name	string	Nome da sala limpa associada ao evento	market-analysis
central_clean_room_id	string	O ID da sala limpa central	e01b6a78-1336-47e1 -b63d-3e49aa5b627
initiator_global_metastore_id	string	ID de metastore global do colaborador que iniciou o evento	aws:us-west-2:ec22936d -cd29-4421-a88a-883fb356776a
event_time	carimbo de data/hora	Carimbo de data/hora quando o evento ocorreu	2023-01-01T01:01:01.123
event_type	string	O tipo de evento. Consulte Eventos de sala limpa registrados.	CLEAN_ROOM_CREATED
clean_room_created_metadata	estruturar	Os metadados do tipo de evento CLEAN_ROOM_CREATED	{ "collaborators": [ {"collaborator_global_metastore_id": "aws:us-west-2:ec22936d-cd29-4421-a88a-883fb356776a"}, {"collaborator_global_metastore_id": "azure:wesus:”3be05a26-5a83-478c-8428-9ef9aa67b5d0"}] }
clean_room_deleted_metadata	estruturar	Os metadados do tipo de evento CLEAN_ROOM_DELETED	{ "central_clean_room_id": "af0d4563-2267-412c-9d4a -8a59c4895c18" }
run_notebook_started_metadata	estruturar	Os metadados do tipo de evento RUN_NOTEBOOK_STARTED	{ "notebook_name": "market analysis", "notebook_checksum": "7072696E7468656C6C6F776F7264", "run_id": "TaskRunId-634124444694206" }
run_notebook_completed_metadata	estruturar	Os metadados do tipo de evento RUN_NOTEBOOK_COMPLETED	Consulte Bloco de anotações concluído executar metadados
clean_room_assets_updated_metadata	estruturar	Os metadados do tipo de evento CLEAN_ROOM_ASSETS_UPDATED	{ "added_assets": [{ "data_object_type": "TABLE", "name": "sales", "catalog": "demo"}], "updated_assets":[], "removed_assets": [] }
delete_output_schema_metadata	estruturar	Os metadados do tipo de evento DELETE_OUTPUT_SCHEMA	{ "name": "output_schema_55555", "owner_global_metastore_id": "aws:us-west-2:555555-55...", "action": "DELETE" expire_time: "2025-01-14T15:28:19.000Z" }
initiator_collaborator_alias	string	Alias do colaborador que iniciou o evento. Para salas limpas criadas por meio da interface do usuário, o valor é creator ou collaborator. Para salas limpas criadas via API, eles são os valores personalizados especificados na criação.	creator

Eventos de sala limpa registrados

Esta tabela do sistema regista os seguintes eventos:

• CLEAN_ROOM_CREATED: O usuário cria uma nova sala limpa.
• CLEAN_ROOM_DELETED: O utilizador elimina 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.
• DELETE_OUTPUT_SCHEMA: Um esquema de saída expira e é excluído. A initiator_global_metastore_id para esse tipo de evento é sempre system porque a exclusão ocorre quando o esquema de saída expira.

Para evitar registros duplicados, apenas um registro é emitido para cada evento em salas limpas onde os colaboradores pertencem ao mesmo metastore. Para salas limpas onde os colaboradores pertencem a metastores separados, são emitidos registos únicos para cada colaborador.

Esquema de metadados da execução do notebook concluída

A coluna run_notebook_completed_metadata contém informações de metadados para eventos RUN_NOTEBOOK_COMPLETED. Se uma tabela de saída com o identificador foi criada pela execução do caderno, as informações são registadas usando a estrutura output_schema.

A coluna run_notebook_completed_metadata usa o seguinte esquema:

notebook_name: "example_notebook"
run_id: "TaskRunId-55555129818570"
state: "SUCCESS"
duration_in_seconds: 120
output_schema:
  name: "output_schema_123450129818570"
  owner_global_metastore_id: "aws:us-west-2:55555e-55bc-55a5-55ab-555d5ec16013"
  action: "CREATE"
  expire_time: "2025-01-14T15:28:19.000Z"
  assets_added:
    0:
    name: "important_data"
    data_object_type: "TABLE"

Monitore o uso faturável da sala limpa

Para saber mais sobre o uso e os custos da sala limpa, você pode unir esta tabela com a tabela billing.usage usando a coluna central_clean_room_id. Na tabela billing.usage, o uso da sala limpa é atribuído 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:

• Listar todos os eventos de uma sala limpa especificada
• Listar todos os eventos iniciados por um colaborador especificado
• Listar todos os colaboradores relevantes das salas limpas
• Listar as execuções mais lentas do portátil
• Taxa de execução bem-sucedida para cada notebook
• Listar todos os eventos em que uma tabela especificada foi adicionada às salas limpas

Listar todos os eventos de uma sala limpa especificada

Substitua :central_clean_room_id pelo ID da sala limpa central, que pode ser encontrado no painel de detalhes da sala limpa ao lado de ID Central.

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 central_clean_room_id = :central_clean_room_id
ORDER BY event_time DESC

Listar 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 conhecido como identificador de compartilhamento. Para :collaborator_alias, insira o alias do colaborador. Por padrão, os dois aliases possíveis são creator para o criador da sala limpa e collaborator para a outra parte.

SELECT
 clean_room_name, central_clean_room_id, 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 AND (initiator_collaborator_alias = :collaborator_alias OR initiator_collaborator_alias IS NULL)
 ORDER BY clean_room_name, event_time DESC

Listar 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'

Listar as execuções de notebook mais lentas

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

Listar todos os eventos em que uma tabela especificada foi adicionada às salas limpas

Para o paramter :table_name_string, insira o nome da tabela especificada.

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