SYSTEM$GET_TABLE_ARCHIVE_METADATA¶

구문¶

SYSTEM$GET_TABLE_ARCHIVE_METADATA( '<table_name>' )

인자¶

'table_name'

보관된 데이터가 있는 테이블의 이름입니다. 테이블에는 일반적으로 저장소 수명 주기 정책에 따라 COOL 또는 COLD 계층에 보관된 데이터가 있어야 합니다.

반환¶

보관된 데이터에 대한 메타데이터가 있는 JSON이 포함된 TEXT 값을 반환합니다. JSON 구조에는 다음이 포함됩니다.

• rowCount: 아카이브의 행 수입니다.

• columns: 각 열에 대한 메타데이터가 포함된 오브젝트입니다.

  • column_id: 열 ID(COLUMNS 뷰에 표시된 대로)입니다.

  • data_type: 열 데이터 타입입니다.

  • min: 열의 최소값이거나 해당되지 않는 경우 null 입니다.

  • max: 열의 최대값이거나 해당되지 않는 경우 null 입니다.

출력에는 각 행이 보관된 시점을 나타내는 보관된 타임스탬프 열(METADATA$STORAGE_LIFECYCLE_POLICY_ARCHIVED_TIMESTAMP)도 포함됩니다.

예시 출력:

{
  "rowCount": 2304,
  "columns": {
    "CUSTOMER_ID": {
      "column_id": 10283,
      "data_type": "fixed",
      "min": -23,
      "max": 54032
    },
    "CUSTOMER_NAME": {
      "column_id": 10284,
      "data_type": "text",
      "min": null,
      "max": null
    },
    "METADATA$STORAGE_LIFECYCLE_POLICY_ARCHIVED_TIMESTAMP": {
      "data_type": "timestampltz",
      "min": "2025-01-02T03:04:05.6789Z",
      "max": "2025-11-12T13:14:15.1617Z"
    }
  }
}

사용법 노트¶

• 테이블에 대한 액세스 권한이 있는 테이블 소유자 또는 계정 관리자(ACCOUNTADMIN 역할이 있는 사용자)는 이 함수를 실행할 수 있습니다.

• 이 함수를 사용하면 아카이브 계층에서 데이터를 검색하는 데 드는 비용 없이 보관된 데이터 메타데이터를 검사할 수 있습니다.

• column_id 필드는 열이 삭제되고 나중에 동일한 이름의 새 열이 추가된 경우 열을 구분하는 데 도움이 됩니다.

• 실제 보관된 데이터를 검색하려면 CREATE TABLE … FROM ARCHIVE OF 명령을 사용합니다.

예¶

테이블의 보관된 데이터에 대한 메타데이터를 검색합니다.

SELECT SYSTEM$GET_TABLE_ARCHIVE_METADATA('my_database.my_schema.my_table');

JSON 출력을 구문 분석하여 특정 정보를 추출합니다.

SELECT PARSE_JSON(SYSTEM$GET_TABLE_ARCHIVE_METADATA('my_database.my_schema.my_table')):rowCount AS archived_row_count;