APPLICATION_CONFIGURATION_VALUE_HISTORY

APPLICATION_CONFIGURATION_VALUE_HISTORY

APPLICATION_CONFIGURATION_VALUE_HISTORY() 함수는 지정한 Snowflake 네이티브 앱(Native App)의 애플리케이션 구성(application configuration) 값이 변경된 내역을 반환해요.

이 함수를 호출하면 애플리케이션 구성 값이 변경된 이력을 확인할 수 있어요. 자세한 내용은 애플리케이션 구성을 참고하세요.

출처: Snowflake SQL Reference

본문

문법

APPLICATION_CONFIGURATION_VALUE_HISTORY(
  [ APPLICATION_NAME => '<application_name>' ]
  [ , CONFIGURATION_NAME => '<config_name>' ]
)

인자

필수: 없음

선택:

인자 설명
APPLICATION_NAME 구성 내역을 조회할 네이티브 앱 이름을 지정해요.
CONFIGURATION_NAME 내역을 조회할 구성의 이름을 지정해요.

반환

이 함수는 다음 컬럼을 반환해요.

Column Data type Description
NAME STRING 공급자(provider)가 정의한 구성의 이름이에요.
APPLICATION_NAME STRING 구성이 속한 애플리케이션의 이름이에요.
CREATED_ON TIMESTAMP 구성 객체가 생성된 시각이에요.
UPDATED_ON TIMESTAMP 구성 객체가 마지막으로 갱신된 시각이에요.
TYPE STRING 구성의 타입이에요. 가능한 값은 APPLICATION_NAME과 STRING이에요.
STATUS STRING 구성의 상태예요. 가능한 값은 PENDING과 DONE이에요.
SENSITIVE BOOLEAN 값이 민감(sensitive)한지 여부예요.
VALUE STRING 소비자(consumer)가 설정한 값이에요. APPLICATION_NAME 타입의 애플리케이션 구성에서는 소비자가 지정한 애플리케이션의 최신 이름이에요. 애플리케이션이 이름 변경된 경우 초기에 제공된 이름과 다를 수 있어요. 애플리케이션이 삭제(drop)되면 값이 설정되지 않은 것처럼 여기에 값이 표시되지 않아요. SENSITIVE=TRUE인 경우, 실행 중인 역할이 구성을 소유한 애플리케이션이 아니라면 값이 숨겨져요.
VALUE_UPDATED_ON TIMESTAMP 값이 설정되거나 해제된 마지막 갱신 시각이에요.
LABEL STRING 공급자가 제공한, UI에 표시할 사용자 친화적인 이름이에요.
DESCRIPTION STRING 구성에 대한 설명이에요.
APPLICATION_ROLES STRING 구성에 접근 권한이 있는 앱 역할 이름을 쉼표로 구분한 목록이에요. 역할이 이름 변경되어도 최신 이름으로 표시돼요. 앱 역할이 삭제되면 출력 목록에서 제외돼요.

사용 메모

  • 이 뷰는 세션의 현재 역할에 접근 권한이 부여된 구성만 표시해요.
  • 삭제된 구성은 뷰에 포함되지 않아요.
  • Information Schema 테이블 함수를 호출할 때는 세션에서 사용 중인 INFORMATION_SCHEMA 스키마가 있어야 하거나, 함수 이름을 정규화(fully-qualified)해야 해요. 자세한 내용은 Snowflake Information Schema를 참고하세요.

예제

application_name 애플리케이션에서 config_name 애플리케이션 구성의 값 변경 내역을 가져와요.

SELECT * FROM TABLE(information_schema.application_configuration_value_history(application_name => 'my_app', configuration_name => 'my_configuration'));

더 알아보기