Dokumentacja tabeli systemu aktualizacji automatycznych

Ważna

Ta tabela systemowa jest dostępna w publicznej wersji zapoznawczej.

Na tej stronie opisano schemat tabeli historii operacji automatycznego uaktualniania i przedstawiono przykładowe zapytania. Automatyczne uaktualnienia automatycznie włączają funkcje najlepszych rozwiązań w tabelach zarządzanych przez wykaz aparatu Unity bez konieczności wprowadzania zmian w kodzie. Tabela systemowa śledzi historię tych operacji. Aby uzyskać informacje na temat automatycznych uaktualnień, zobacz Automatyczne uaktualnienia.

ścieżka tabeli: ta tabela systemowa znajduje się w system.storage.table_auto_upgrade_operations_history.

Schemat tabeli automatycznego uaktualniania

Tabela systemu historii operacji automatycznego uaktualniania używa następującego schematu:

Nazwa kolumny	Typ danych	Opis	Example
account_id	ciąg	Identyfikator konta.	11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name	ciąg	Nazwa magazynu metadanych, do którego należy uaktualniona tabela.	metastore1
metastore_id	ciąg	Identyfikator magazynu metadanych, do którego należy uaktualniona tabela.	5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name	ciąg	Nazwa wykazu, do którego należy uaktualniona tabela.	catalog
schema_name	ciąg	Nazwa schematu, do którego należy uaktualniona tabela.	schema
table_name	ciąg	Nazwa uaktualnionej tabeli.	table1
table_id	ciąg	Identyfikator uaktualnionej tabeli.	138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name	ciąg	Funkcja tabeli, która próbowała włączyć automatyczne uaktualnienia, na przykład deletionVectors lub rowTracking.	rowTracking
operation_id	ciąg	Unikatowy identyfikator operacji.	4dad1136-6a8f-418f-8234-6855cfaff18f
operation	ciąg	Typ operacji. Wartości obejmują ENABLE lub DISABLE.	ENABLE
operation_result	ciąg	Wynik próby wykonania operacji uaktualniania. Wartości obejmują SUCCESSFUL lub FAILED: INTERNAL_ERROR. Zobacz operation_result wartości.	SUCCESSFUL
start_time	sygnatura czasowa	Godzina rozpoczęcia operacji. Informacje o strefie czasowej są rejestrowane na końcu wartości, przy czym +00:00 reprezentuje UTC.	2023-01-09 10:00:00.000+00:00
end_time	sygnatura czasowa	Godzina zakończenia operacji. Informacje o strefie czasowej są rejestrowane na końcu wartości, przy czym +00:00 reprezentuje UTC.	2023-01-09 11:00:00.000+00:00

operation_result wartości

W operation_result kolumnie pokazano, czy próba wykonania operacji uaktualnienia zakończyła się pomyślnie, czy nie można włączyć funkcji zarejestrowanej w pliku w feature_namekwalifikujących się tabelach. Jeśli niepowodzenie (komunikat FAILED: INTERNAL_ERROR), możesz włączyć tę funkcję ręcznie.

Przykłady zapytań

Poniższe sekcje zawierają przykładowe zapytania, których można użyć, aby uzyskać wgląd w tabelę systemu aktualizacji automatycznych. Należy zastąpić wartości parametrów własnymi wartościami.

Wykonywanie zapytań dotyczących operacji automatycznego uaktualniania dla wszystkich funkcji w określonej tabeli

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;

Wykonywanie zapytań dotyczących liczby operacji automatycznego uaktualniania w ciągu ostatnich 30 dni

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;

Wykonywanie zapytań dotyczących współczynnika powodzenia dla operacji automatycznego uaktualniania

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;

Wykonywanie zapytań dotyczących operacji automatycznego uaktualniania, które zakończyły się niepowodzeniem

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;