SYSTEM$GET_SERVICE_CALLER_TOKEN_EXPIRY

SYSTEM$GET_SERVICE_CALLER_TOKEN_EXPIRY

기능 — 일반 공개 (Generally Available). Snowpark Container Services는 AWS, Microsoft Azure, Google Cloud Platform의 상용 지역에 있는 계정에서 사용할 수 있으며, 일부 예외가 있어요. 자세한 내용은 사용 가능한 지역 및 고려 사항 문서를 참고해요.

Snowpark Container Services 서비스에 대한 호출자의 권리 로그인 토큰(caller's rights login token)의 만료 타임스탬프를 반환해요.

출처: Snowflake SYSTEM$GET_SERVICE_CALLER_TOKEN_EXPIRY 함수 문서

본문

참고 항목: 로그인 토큰 유효 기간 구성(Configuring the login token validity)

구문 (Syntax)

SYSTEM$GET_SERVICE_CALLER_TOKEN_EXPIRY( '' )

인자 (Arguments)

필수:

  • token_string — Snowflake가 서비스 컨테이너에 전달하는 Sf-Context-Current-User-Token HTTP 헤더에서 얻은 호출자의 권리 로그인 토큰 문자열이에요.

반환 값 (Returns)

토큰의 만료 시간을 나타내는 타임스탬프 문자열을 반환해요 (예: 2026-07-18T14:30:00Z).

사용 노트 (Usage Notes)

  • 서비스 애플리케이션이 이 함수를 호출하여 호출자 토큰이 언제 만료될지 결정할 수 있어요.
  • 토큰은 사용자가 호출자 권리(executeAsCaller: true)로 서비스에 접근할 때 Snowflake가 컨테이너에 제공하는 Sf-Context-Current-User-Token 헤더에서 얻어요.
  • 이 함수를 사용하여 장기 실행 서비스에서 토큰 갱신 로직을 구현해요.

예제 (Examples)

다음 문장은 호출자 토큰의 만료 시간을 확인해요:

SELECT SYSTEM$GET_SERVICE_CALLER_TOKEN_EXPIRY('');

예제 출력:

+-------------------------------------------------------+
| SYSTEM$GET_SERVICE_CALLER_TOKEN_EXPIRY                |
|-------------------------------------------------------|
| 2026-07-18T14:30:00Z                                  |
+-------------------------------------------------------+

더 알아보기