Naslaginformatie over systeemtabellen voor automatische upgrades

Important

Deze systeemtabel bevindt zich in Openbare Preview.

Op deze pagina wordt het schema van de tabel met de bewerkingsgeschiedenis van automatische upgrades beschreven en worden voorbeeldquery's weergegeven. Automatische upgrades schakelen automatisch aanbevolen procedures in voor beheerde tabellen van Unity Catalog zonder dat er codewijzigingen nodig zijn. De systeemtabel houdt de geschiedenis van deze bewerkingen bij. Zie Automatische upgrades voor meer informatie over automatische upgrades.

tabelpad: deze systeemtabel bevindt zich op system.storage.table_auto_upgrade_operations_history.

Tabelschema voor automatische upgrades

In de systeemtabel voor automatische upgrades voor bewerkingsgeschiedenis wordt het volgende schema gebruikt:

Kolomnaam	Gegevenstype	Description	Example
account_id	string	De id van het account.	11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name	string	De naam van de metastore waartoe de bijgewerkte tabel behoort.	metastore1
metastore_id	string	De id van de metastore waartoe de bijgewerkte tabel behoort.	5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name	string	De naam van de catalogus waartoe de bijgewerkte tabel behoort.	catalog
schema_name	string	De naam van het schema waartoe de bijgewerkte tabel behoort.	schema
table_name	string	De naam van de bijgewerkte tabel.	table1
table_id	string	De id van de bijgewerkte tabel.	138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name	string	De tabelfunctie die automatische upgrades heeft geprobeerd in te schakelen, zoals deletionVectors of rowTracking.	rowTracking
operation_id	string	De unieke id voor de bewerking.	4dad1136-6a8f-418f-8234-6855cfaff18f
operation	string	Het type bewerking. Waarden bevatten ENABLE of DISABLE.	ENABLE
operation_result	string	Het resultaat van een poging tot upgradebewerking. Waarden bevatten SUCCESSFUL of FAILED: INTERNAL_ERROR. Zie operation_result waarden.	SUCCESSFUL
start_time	timestamp	Het tijdstip waarop de bewerking is gestart. Tijdzone-informatie wordt vastgelegd aan het einde van de waarde, waarbij +00:00 UTC vertegenwoordigt.	2023-01-09 10:00:00.000+00:00
end_time	timestamp	Het tijdstip waarop de bewerking is beëindigd. Tijdzone-informatie wordt vastgelegd aan het einde van de waarde, waarbij +00:00 UTC vertegenwoordigt.	2023-01-09 11:00:00.000+00:00

operation_result waarden

In de operation_result kolom ziet u of een upgradebewerking is geslaagd of mislukt om een functie in te schakelen, vastgelegd in , in feature_nameeen in aanmerking komende tabel. Als dit is mislukt (bericht FAILED: INTERNAL_ERROR), kunt u de functie handmatig inschakelen.

Voorbeeldvragen

De volgende secties bevatten voorbeeldquery's die u kunt gebruiken om inzicht te krijgen in de systeemtabel voor automatische upgrades. U moet de parameterwaarden vervangen door uw eigen waarden.

Query's uitvoeren op automatische upgradebewerkingen voor alle functies in een specifieke tabel

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;

Het aantal automatische upgradebewerkingen in de afgelopen 30 dagen opvragen

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;

Query uitvoeren op het slagingspercentage voor bewerkingen voor automatische upgrades

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;

Query uitvoeren op automatische upgradebewerkingen die zijn mislukt

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;