Referencia de tabla del sistema de actualizaciones automáticas

Important

Esta tabla del sistema está en versión preliminar pública.

En esta página se describe el esquema de la tabla del historial de operaciones de actualización automática y se muestran consultas de ejemplo. Las actualizaciones automáticas activan automáticamente las características de procedimientos recomendados en las tablas administradas del catálogo de Unity sin necesidad de cambios en el código. La tabla del sistema realiza un seguimiento del historial de estas operaciones. Para obtener información sobre las actualizaciones automáticas, consulte Actualizaciones automáticas.

Ruta de la tabla: esta tabla del sistema se encuentra en system.storage.table_auto_upgrade_operations_history.

Esquema de tabla de actualizaciones automáticas

La tabla del sistema del historial de operaciones de actualizaciones automáticas usa el esquema siguiente:

Nombre de la columna	Tipo de dato	Description	Example
account_id	string	Id. de la cuenta.	11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name	string	Nombre del metastore al que pertenece la tabla actualizada.	metastore1
metastore_id	string	Identificador del metastore al que pertenece la tabla actualizada.	5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name	string	Nombre del catálogo al que pertenece la tabla actualizada.	catalog
schema_name	string	Nombre del esquema al que pertenece la tabla actualizada.	schema
table_name	string	Nombre de la tabla actualizada.	table1
table_id	string	Identificador de la tabla actualizada.	138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name	string	La característica de tabla que las actualizaciones automáticas intentaron activar, como deletionVectors o rowTracking.	rowTracking
operation_id	string	Identificador único de la operación.	4dad1136-6a8f-418f-8234-6855cfaff18f
operation	string	Tipo de operación. Los valores incluyen ENABLE o DISABLE.	ENABLE
operation_result	string	Resultado de una operación de actualización intentada. Los valores incluyen SUCCESSFUL o FAILED: INTERNAL_ERROR. Consulte operation_result valores.	SUCCESSFUL
start_time	timestamp	La hora a la que empezó la operación. La información de zona horaria se registra al final del valor con +00:00, que representa la hora UTC.	2023-01-09 10:00:00.000+00:00
end_time	timestamp	La hora a la que finalizó la operación. La información de zona horaria se registra al final del valor con +00:00, que representa la hora UTC.	2023-01-09 11:00:00.000+00:00

valores de operation_result

La operation_result columna muestra si una operación de actualización intentada se realizó correctamente o no pudo activar una característica, registrada en , en feature_nameuna tabla apta. Si se produjo un error (mensaje FAILED: INTERNAL_ERROR), puede habilitar la característica manualmente.

Consultas de ejemplo

En las secciones siguientes se incluyen consultas de ejemplo que puede usar para obtener información sobre la tabla del sistema de actualizaciones automáticas. Debe reemplazar los valores de parámetro por sus propios valores.

Consulta de operaciones de actualización automática para todas las características de una tabla 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 el número de operaciones de actualización automática en los últimos 30 días

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;

Consulta de la tasa de éxito para las operaciones de actualizaciones automáticas

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 de operaciones de actualización automática que no se pudieron realizar

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;