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

info

Visualização

Esta tabela do sistema está em pré-lançamento público.

Esta página descreve o esquema da tabela de histórico de operações de atualizações automáticas e mostra consultas de exemplo. As atualizações automáticas ativam automaticamente os recursos de melhores práticas em suas tabelas gerenciadas pelo Unity Catalog sem exigir alterações no código. A tabela do sistema rastreia o histórico dessas operações. Para obter informações sobre atualizações automáticas, consulte Atualizações automáticas.

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

Esquema de tabela de atualizações automáticas

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

Nome da coluna	Tipo de dados	Descrição	Exemplo
account_id	string	O ID da account.	11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name	string	O nome do metastore ao qual a tabela atualizada pertence.	metastore1
metastore_id	string	O ID do metastore ao qual a tabela atualizada pertence.	5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name	string	O nome do catálogo ao qual a tabela atualizada pertence.	catalog
schema_name	string	O nome do esquema ao qual a tabela atualizada pertence.	schema
table_name	string	O nome da tabela atualizada.	table1
table_id	string	O ID da tabela atualizada.	138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name	string	O recurso da tabela que as atualizações automáticas tentaram ativar, como deletionVectors ou rowTracking.	rowTracking
operation_id	string	O ID exclusivo para a operação.	4dad1136-6a8f-418f-8234-6855cfaff18f
operation	string	O tipo de operação. Os valores incluem ENABLE ou DISABLE.	ENABLE
operation_result	string	O resultado de uma operação de atualização tentada. Os valores incluem SUCCESSFUL ou FAILED: INTERNAL_ERROR. Consulte os valores de operation_result.	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 ao final do valor com +00:00 representando UTC.	2023-01-09 10:00:00.000+00:00
end_time	carimbo de data/hora	A hora em que a operação terminou. As informações de fuso horário são registradas ao final do valor com +00:00 representando UTC.	2023-01-09 11:00:00.000+00:00

valores de resultado de operação

A coluna operation_result mostra se uma operação de atualização tentada foi bem-sucedida ou falhou ao ativar um recurso, registrada em feature_name, em uma tabela elegível. Se falhou (mensagem FAILED: INTERNAL_ERROR), é possível ativar o recurso manualmente.

Exemplos de consultas

As seções a seguir incluem exemplos de consultas que você pode usar para obter percepções sobre a tabela do sistema de atualizações automáticas. Você deve substituir os valores dos parâmetros pelos seus próprios valores.

Operações de atualização automática de Query para todos os recursos em uma tabela específica.

SQL

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;

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

SQL

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 de atualizações automáticas

SQL

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 de atualização automática que falharam

SQL

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;