Referência da tabela do sistema de atualizações automáticas

Important

Esta tabela do sistema está em Public Preview.

Esta página descreve o esquema da tabela de histórico de operações de atualizações automáticas e mostra exemplos de consultas. As atualizações automáticas ativam automaticamente as funcionalidades de melhores práticas nas suas tabelas geridas do Unity Catalog, sem necessidade de alterações de código. A tabela do sistema acompanha o histórico destas operações. Para informações sobre atualizações automáticas, consulte Upgrades automáticos.

Caminho da tabela: Esta tabela do sistema está localizada em system.storage.table_auto_upgrade_operations_history.

Esquema automático de tabela de atualizações

A tabela do sistema de histórico operacional de atualizações automáticas utiliza o seguinte esquema:

Nome da coluna	Tipo de dados	Description	Example
account_id	cadeia (de caracteres)	O ID da conta.	11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name	cadeia (de caracteres)	O nome da metastore a que pertence a tabela melhorada.	metastore1
metastore_id	cadeia (de caracteres)	O ID da metastore a que pertence a tabela atualizada.	5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name	cadeia (de caracteres)	O nome do catálogo ao qual pertence a tabela melhorada.	catalog
schema_name	cadeia (de caracteres)	O nome do esquema ao qual pertence a tabela atualizada.	schema
table_name	cadeia (de caracteres)	O nome da mesa melhorada.	table1
table_id	cadeia (de caracteres)	O ID da tabela melhorada.	138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name	cadeia (de caracteres)	A funcionalidade de tabela que as atualizações automáticas tentavam ativar, como deletionVectors ou rowTracking.	rowTracking
operation_id	cadeia (de caracteres)	O ID único da operação.	4dad1136-6a8f-418f-8234-6855cfaff18f
operation	cadeia (de caracteres)	O tipo de operação. Os valores incluem ENABLE ou DISABLE.	ENABLE
operation_result	cadeia (de caracteres)	Resultado de uma operação de atualização tentada. Os valores incluem SUCCESSFUL ou FAILED: INTERNAL_ERROR. Veja operation_result valores.	SUCCESSFUL
start_time	carimbo de data/hora	A hora em que a operação começou. As informações de fuso horário são registradas no final do valor com +00:00 representando UTC.	2023-01-09 10:00:00.000+00:00
end_time	carimbo de data/hora	O momento em que a operação terminou. As informações de fuso horário são registradas no final do valor com +00:00 representando UTC.	2023-01-09 11:00:00.000+00:00

operation_result valores

A operation_result coluna mostra se uma operação de atualização tentada teve sucesso ou não ao ativar uma funcionalidade, registada em feature_name, numa tabela elegível. Se falhar (mensagem FAILED: INTERNAL_ERROR), pode ativar a funcionalidade manualmente.

Exemplos de consultas

As secções seguintes incluem exemplos de consultas que pode usar para obter informações sobre a tabela do sistema de atualizações automáticas. Deve substituir os valores dos parâmetros pelos seus próprios valores.

Consultar operações automáticas de atualização para todas as funcionalidades numa tabela específica

SELECT
  feature_name,
  operation_result,
  start_time,
  end_time
FROM system.storage.table_auto_upgrade_operations_history
WHERE
  catalog_name = :catalog_name
  AND schema_name = :schema_name
  AND table_name = :table_name
ORDER BY start_time DESC;

Consultar o número de operações automáticas de atualização nos últimos 30 dias

SELECT
  feature_name,
  operation_result,
  COUNT(DISTINCT operation_id) AS operations
FROM system.storage.table_auto_upgrade_operations_history
WHERE timestampdiff(day, start_time, NOW()) < 30
GROUP BY ALL
ORDER BY operations DESC;

Consultar a taxa de sucesso para operações automáticas de atualização

WITH operation_counts AS (
  SELECT
    COUNT(DISTINCT (CASE WHEN operation_result = "SUCCESSFUL" THEN operation_id END)) AS successes,
    COUNT(DISTINCT operation_id) AS total_operations
  FROM system.storage.table_auto_upgrade_operations_history
)
SELECT successes / total_operations AS success_rate
FROM operation_counts;

Consulta para operações automáticas de atualização que falharam

SELECT
  catalog_name,
  schema_name,
  table_name,
  feature_name,
  start_time
FROM system.storage.table_auto_upgrade_operations_history
WHERE operation_result != "SUCCESSFUL"
ORDER BY start_time DESC;