Referensi tabel sistem peningkatan otomatis

Important

Tabel sistem ini berada dalam Pratinjau Umum.

Halaman ini menjelaskan skema tabel riwayat operasi peningkatan otomatis dan memperlihatkan kueri sampel. Peningkatan otomatis secara otomatis mengaktifkan fitur praktik terbaik pada tabel terkelola Unity Catalog Anda tanpa memerlukan perubahan kode. Tabel sistem melacak riwayat operasi ini. Untuk informasi tentang peningkatan otomatis, lihat Peningkatan otomatis.

Jalur tabel: Tabel sistem ini terletak di system.storage.table_auto_upgrade_operations_history.

Skema tabel peningkatan otomatis

Tabel sistem riwayat operasi peningkatan otomatis menggunakan skema berikut:

Nama kolom	Jenis data	Deskripsi	Example
account_id	string	ID akun.	11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name	string	Nama metastore tempat tabel yang ditingkatkan berada.	metastore1
metastore_id	string	ID metastore tempat tabel yang ditingkatkan berada.	5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name	string	Nama katalog tempat tabel yang ditingkatkan berada.	catalog
schema_name	string	Nama skema tempat tabel yang ditingkatkan berada.	schema
table_name	string	Nama tabel yang ditingkatkan.	table1
table_id	string	ID tabel yang ditingkatkan.	138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name	string	Fitur tabel yang dicoba untuk mengaktifkan peningkatan otomatis, seperti deletionVectors atau rowTracking.	rowTracking
operation_id	string	ID unik untuk operasi.	4dad1136-6a8f-418f-8234-6855cfaff18f
operation	string	Jenis operasi. Nilai termasuk ENABLE atau DISABLE.	ENABLE
operation_result	string	Hasil dari operasi peningkatan yang dicoba. Nilai termasuk SUCCESSFUL atau FAILED: INTERNAL_ERROR. Lihat nilai operation_result.	SUCCESSFUL
start_time	stempel waktu	Waktu dimulainya operasi. Informasi zona waktu dicatat di akhir nilai dengan +00:00 mewakili UTC.	2023-01-09 10:00:00.000+00:00
end_time	stempel waktu	Waktu di mana operasi berakhir. Informasi zona waktu dicatat di akhir nilai dengan +00:00 mewakili UTC.	2023-01-09 11:00:00.000+00:00

nilai operation_result

Kolom operation_result menunjukkan apakah operasi peningkatan yang dicoba berhasil atau gagal mengaktifkan fitur, yang direkam di feature_name, pada tabel yang memenuhi syarat. Jika gagal (pesan FAILED: INTERNAL_ERROR), Anda dapat mengaktifkan fitur secara manual.

Contoh pertanyaan

Bagian berikut menyertakan kueri sampel yang dapat Anda gunakan untuk mendapatkan wawasan tentang tabel sistem peningkatan otomatis. Anda harus mengganti nilai parameter dengan nilai Anda sendiri.

Mengkueri operasi peningkatan otomatis untuk semua fitur pada tabel tertentu

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;

Mengkueri jumlah operasi peningkatan otomatis dalam 30 hari terakhir

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;

Mengkueri tingkat keberhasilan untuk operasi peningkatan otomatis

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;

Kueri untuk operasi peningkatan otomatis yang gagal

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;