Справочник по системной таблице автоматического обновления

Important

Эта системная таблица находится в общедоступной предварительной версии.

На этой странице описывается схема таблицы журнала операций автоматического обновления и показаны примеры запросов. Автоматическое обновление автоматически включает функции рекомендаций в управляемых таблицах каталога Unity, не требуя изменений кода. Системная таблица отслеживает историю этих операций. Дополнительные сведения об автоматическом обновлении см. в разделе "Автоматическое обновление".

Путь к таблице: эта системная таблица расположена по адресу system.storage.table_auto_upgrade_operations_history.

Схема таблицы автоматического обновления

В системной таблице журнала операций автоматического обновления используется следующая схема:

Название столбца	Тип данных	Description	Example
account_id	string	Идентификатор учетной записи.	11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name	string	Имя хранилища метаданных, к которому принадлежит обновленная таблица.	metastore1
metastore_id	string	Идентификатор хранилища метаданных, к которому принадлежит обновленная таблица.	5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name	string	Имя каталога, к которому принадлежит обновленная таблица.	catalog
schema_name	string	Имя схемы, к которой принадлежит обновленная таблица.	schema
table_name	string	Имя обновленной таблицы.	table1
table_id	string	Идентификатор обновленной таблицы.	138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name	string	Функция таблицы, которая пытается включить автоматическое обновление, например deletionVectors или rowTracking.	rowTracking
operation_id	string	Уникальный идентификатор операции.	4dad1136-6a8f-418f-8234-6855cfaff18f
operation	string	Тип операции. В качестве значений выступают ENABLE или DISABLE.	ENABLE
operation_result	string	Результат попытки обновления. В качестве значений выступают SUCCESSFUL или FAILED: INTERNAL_ERROR. См. operation_result значения.	SUCCESSFUL
start_time	timestamp	Время начала операции. Сведения о часовом поясе записываются в конце значения с +00:00, представляющей UTC.	2023-01-09 10:00:00.000+00:00
end_time	timestamp	Время завершения операции. Сведения о часовом поясе записываются в конце значения с +00:00, представляющей UTC.	2023-01-09 11:00:00.000+00:00

operation_result значения

В operation_result столбце показано, успешно ли выполнена попытка обновления или не удалось включить функцию, записанную в feature_name, в соответствующей таблице. При сбое (сообщение FAILED: INTERNAL_ERROR) можно включить функцию вручную.

Примеры запросов

В следующих разделах приведены примеры запросов, которые можно использовать для получения аналитических сведений о системной таблице автоматического обновления. Необходимо заменить значения параметров собственными значениями.

Запрос операций автоматического обновления для всех функций в определенной таблице

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;

Запрос количества операций автоматического обновления за последние 30 дней

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;

Запрос частоты успешного выполнения операций автоматического обновления

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;

Запрос операций автоматического обновления, которые не удалось выполнить

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;