카테고리:: Information Schema , 테이블 함수

APPLICATION_CALLBACK_HISTORY¶

Snowflake 계정의 Snowflake Native Apps 에 대한 콜백 호출의 기록에 대한 정보를 반환합니다. 각 행은 콜백 유형, 실행 모드, 상태 및 모든 오류 정보를 포함하여 콜백 호출을 나타냅니다.

구문¶

APPLICATION_CALLBACK_HISTORY(
  [ APPLICATION_NAME => '<application_name>' ]
  [ , CALLBACK_TYPE => '<callback_manifest_name>' ]
  [ , LIMIT => <number> ]
)

선택적 인자¶

APPLICATION_NAME => 'application_name': 콜백 기록을 검색할 앱의 이름입니다. 지정하지 않으면 계정의 모든 앱에 대한 기록을 반환합니다.
CALLBACK_TYPE => 'callback_manifest_name': 매니페스트 파일에 정의된 콜백 유형입니다. 지정하지 않으면 지정된 앱의 모든 콜백 유형에 대한 기록을 반환합니다.
LIMIT => number: 반환할 최대 행 수입니다. 기본값은 100입니다. 최대값은 10000입니다.

사용법 노트¶

Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.
QUERY_TEXT 및 ERROR_MESSAGE 열은 호출자가 앱 자체가 아닌 한 수정됩니다.
이 함수를 사용하려면 다음 중 하나가 필요합니다.
- 앱에 대한 OWNERSHIP 권한.
- 앱에 대한 MONITOR 권한.
- 앱 자체로 실행.

출력¶

이 함수는 다음 열을 반환합니다.


열 이름	데이터 타입	설명
TYPE	VARCHAR	매니페스트 파일에 정의된 콜백 유형입니다.
EXECUTION_MODE	VARCHAR	콜백의 실행 모드입니다. 가능한 값은 `SYNC`, ``ASYNC``입니다.
APPLICATION_NAME	VARCHAR	콜백을 정의하는 앱의 이름입니다.
STATE	VARCHAR	콜백 실행의 상태입니다. 콜백 상태 섹션을 참조하십시오.
STARTED_ON	TIMESTAMP_LTZ	콜백이 호출된 타임스탬프입니다.
COMPLETED_ON	TIMESTAMP_LTZ	완료 타임스탬프입니다. 콜백이 아직 완료되지 않은 경우 NULL입니다.
TRIGGERING_QUERY_ID	VARCHAR	콜백을 트리거한 SQL 문의 쿼리 ID입니다. 콜백이 SQL 쿼리에 의해 트리거되지 않은 경우(예: 업그레이드가 완료된 후 트리거되는 경우) NULL입니다.
QUERY_ID	VARCHAR	콜백 프로시저 실행의 쿼리 ID입니다. 콜백이 아직 완료되지 않은 경우 NULL입니다.
QUERY_TEXT	VARCHAR	프로시저 호출 SQL 텍스트입니다. 콜백이 아직 완료되지 않은 경우 NULL입니다. 이 열은 호출자가 앱 자체가 아닌 한 수정됩니다.
ERROR_CODE	VARCHAR	오류 코드입니다. STATE가 `FAILED` 또는 ``ABORTED``가 아닌 경우 NULL입니다.
ERROR_MESSAGE	VARCHAR	오류 메시지입니다. STATE가 `FAILED` 또는 ``ABORTED``가 아닌 경우 NULL입니다. 이 열은 호출자가 앱 자체가 아닌 한 수정됩니다.

콜백 상태¶

다음 테이블에서는 STATE 열에 대해 가능한 값을 설명합니다.


상태	적용 대상	설명
`QUEUED`	비동기 전용	콜백이 예약 대기 중입니다.
`SCHEDULED`	비동기 전용	콜백이 예약되어 실행 대기 중입니다.
`EXECUTING`	비동기 및 동기	콜백 프로시저가 현재 실행 중입니다.
`COMPLETED`	비동기 및 동기	콜백 프로시저가 성공적으로 완료되었습니다.
`FAILED`	비동기 및 동기	콜백 프로시저가 유효성 검사(예: 잘못된 서명) 또는 실행에 실패했습니다.
`ABORTED`	비동기 전용	내부 일정 오류가 발생했습니다. 이 상태에서는 지원 개입이 필요합니다.

예¶

특정 애플리케이션에 대한 콜백 기록을 검색합니다.

SELECT *
FROM TABLE(
    INFORMATION_SCHEMA.APPLICATION_CALLBACK_HISTORY(
        APPLICATION_NAME => 'my_app'));

사용자 지정 제한이 있는 특정 콜백 유형에 대한 콜백 기록을 검색합니다.

SELECT *
FROM TABLE(
    INFORMATION_SCHEMA.APPLICATION_CALLBACK_HISTORY(
        APPLICATION_NAME => 'my_app',
        CALLBACK_TYPE => 'after_configuration_change',
        LIMIT => 100));