자동 업그레이드 시스템 테이블 참조

중요

이 시스템 테이블은 공개 프리뷰 상태에있습니다.

이 페이지에서는 자동 업그레이드 작업 기록 테이블 스키마를 설명하고 샘플 쿼리를 보여 줍니다. 자동 업그레이드는 코드를 변경하지 않고도 Unity 카탈로그 관리 테이블에서 모범 사례 기능을 자동으로 설정합니다. 시스템 테이블은 이러한 작업의 기록을 추적합니다. 자동 업그레이드에 대한 자세한 내용은 자동 업그레이드를 참조하세요.

테이블 경로: 이 시스템 테이블은 system.storage.table_auto_upgrade_operations_history에 위치해 있습니다.

자동 업그레이드 테이블 스키마

자동 업그레이드 작업 기록 시스템 테이블은 다음 스키마를 사용합니다.

열 이름 데이터 형식 Description Example
account_id string 계정의 ID입니다. 11e22ba4-87b9-4cc2-9770-d10b894b7118
metastore_name string 업그레이드된 테이블이 속한 메타스토어의 이름입니다. metastore1
metastore_id string 업그레이드된 테이블이 속한 메타스토어의 ID입니다. 5a31ba44-bbf4-4174-bf33-e1fa078e6765
catalog_name string 업그레이드된 테이블이 속한 카탈로그의 이름입니다. catalog
schema_name string 업그레이드된 테이블이 속한 스키마의 이름입니다. schema
table_name string 업그레이드된 테이블의 이름입니다. table1
table_id string 업그레이드된 테이블의 ID입니다. 138ebb4b-3757-41bb-9e18-52b38d3d2836
feature_name string 자동 업그레이드를 켜려고 시도한 테이블 기능(예: deletionVectors 또는 rowTracking. rowTracking
operation_id string 작업에 대한 고유 ID입니다. 4dad1136-6a8f-418f-8234-6855cfaff18f
operation string 작업의 유형입니다. 값에는 ENABLE 또는 DISABLE가 포함됩니다. ENABLE
operation_result string 업그레이드 작업이 시도된 결과입니다. 값에는 SUCCESSFUL 또는 FAILED: INTERNAL_ERROR가 포함됩니다. operation_result 값을 참조하세요. SUCCESSFUL
start_time timestamp 작업이 시작된 시간입니다. 표준 시간대 정보는 UTC를 나타내는 +00:00와 함께 값의 끝에 기록됩니다. 2023-01-09 10:00:00.000+00:00
end_time timestamp 작업이 종료된 시간입니다. 표준 시간대 정보는 UTC를 나타내는 +00:00와 함께 값의 끝에 기록됩니다. 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;
  • Last updated on