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

info

Visualização

Essa tabela do sistema está em Pré-visualização Pública. Para acessar a tabela, o esquema deve estar habilitado em seu catálogo system. Para obter mais informações, consulte Habilitar esquemas de tabelas do sistema.

A tabela de eventos de sala limpa registra as ações realizadas pelo senhor ou por seus colaboradores em salas limpas no seu site account. Essa tabela inclui dados regionais do site account.

Para obter mais informações sobre salas limpas, consulte What is Databricks Clean Rooms?

Caminho da tabela : Essa 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	Descrição	Exemplo
account_id	string	O ID do site Databricks account	7af234db-66d7-4db3 -bbf0-956098224879
metastore_id	string	O ID do metastore do Unity Catalog	5a31ba44-bbf4-4174 -bf33-e1fa078e6765
event_id	string	O ID do evento da 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 global da metastore do colaborador que iniciou o evento	aws:us-west-2:ec22936d -cd29-4421-a88a-883fb356776a
event_time	carimbo de data/hora	Data e hora em que o evento ocorreu	2023-01-01T01:01:01.123
event_type	string	O tipo do evento. Veja os registros de eventos da sala limpa.	CLEAN_ROOM_CREATED
clean_room_created_metadata	struct	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	struct	Os metadados do tipo de evento CLEAN_ROOM_DELETED	{ "central_clean_room_id": "af0d4563-2267-412c-9d4a -8a59c4895c18" }
run_notebook_started_metadata	struct	Os metadados do tipo de evento RUN_NOTEBOOK_STARTED	{ "notebook_name": "market analysis", "notebook_checksum": "7072696E7468656C6C6F776F7264", "run_id": "TaskRunId-634124444694206" }
run_notebook_completed_metadata	struct	Os metadados do tipo de evento RUN_NOTEBOOK_COMPLETED	Ver metadados de execução do Notebook concluído
clean_room_assets_updated_metadata	struct	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	struct	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 por meio da API, eles são os valores personalizados especificados na criação.	creator

registra eventos de sala limpa

Essa tabela do sistema logs 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 usuário inicia a execução de um Notebook em uma sala limpa.
• RUN_NOTEBOOK_COMPLETED: A execução do Notebook foi concluída. Verifique o site run_notebook_completed_metadata para ver se a execução foi bem-sucedida ou não.
• CLEAN_ROOM_ASSETS_UPDATED: Os ativos de um quarto limpo são atualizados. Isso pode ser feito adicionando, atualizando ou excluindo ativos.
• DELETE_OUTPUT_SCHEMA: um esquema de saída expira e é excluído. O 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, somente um registro é emitido para cada evento em salas limpas onde os colaboradores pertencem à mesma metastore. Para salas limpas em que os colaboradores pertencem a metástores diferentes, registros exclusivos são emitidos para cada colaborador.

Esquema de metadados de execução do Notebook concluído

A coluna run_notebook_completed_metadata contém informações de metadados para eventos RUN_NOTEBOOK_COMPLETED. Se uma tabela de saída foi criada pela execução do Notebook, as informações são registradas 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 de salas limpas, o senhor pode join essa 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 o usage_metadata.central_clean_room_id key.

Exemplos de consultas

Os exemplos de consultas a seguir ajudam o senhor a entender a atividade da sala limpa em seu site account:

• Listar todos os eventos de uma sala limpa especificada
• Listar todos os eventos iniciados por um colaborador específico
• Liste todos os colaboradores relevantes das salas limpas
• Listar a execução mais lenta do Notebook
• 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 pela ID central da sala limpa, que pode ser encontrada no painel de detalhes da sala limpa ao lado da ID central .

SQL

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 específico

Para o parâmetro :initiator_global_metastore_id, insira o ID do metastore global do colaborador, também conhecido como identificador de compartilhamento. Para :collaborator_alias, insira o alias do colaborador. Em default, os dois aliases possíveis são creator para o criador da sala limpa e collaborator para a outra parte.

SQL

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

Liste todos os colaboradores relevantes das salas limpas

SQL

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 a execução mais lenta do Notebook

SQL

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

SQL

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 parâmetro :table_name_string, insira o nome da tabela especificada.

SQL

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