<service_name>!SPCS_WAIT_FOR¶
시간 제한이 있을 때 Snowpark Container Services 서비스 가 지정된 상태에 도달할 때까지 기다립니다.
비동기 작업을 실행할 때 이 도우미 함수를 사용하여 작업이 완료될 때까지 기다립니다.
서비스를 생성할 때 이 도우미 함수를 사용하여 서비스가 실행될 때까지 기다립니다.
구문¶
<service_name>!SPCS_WAIT_FOR( <status>, <timeout_sec> );
인자¶
필수 인자
'status'대기할 상태입니다. 서비스 상태 값 목록은 DESCRIBE SERVICE 명령의 출력 섹션을 참조하세요.
timeout_sec지정된 상태를 기다리는 최대 기간(초)입니다. 시간 제한 내에 지정된 상태에 도달하지 않으면 함수는 현재 서비스 상태를 포함하는 오류 메시지를 반환합니다.
반환¶
서비스가 시간 제한 내에 지정된 상태에 도달하지 않거나 Snowflake가 해당 상태에 도달할 수 없다고 판단하는 경우, 함수는 현재 서비스 상태도 제공하는 오류 메시지를 반환합니다. 그렇지 않으면 성공 메시지를 반환합니다.
액세스 제어 요구 사항¶
이 SQL 명령을 실행하는 데 사용되는 역할 에는 다음 권한 중 최소한 하나 이상 이 있어야 합니다.
권한 |
오브젝트 |
참고 |
|---|---|---|
다음 권한 중 하나: OWNERSHIP, USAGE, MONITOR 또는 OPERATE |
서비스 |
스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한.
지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.
보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.
예¶
지정된 작업이 완료될 때까지 2분 동안 기다립니다(작업 상태는 DONE).
CALL my_job!spcs_wait_for('DONE', 120)
지정된 서비스가 시작될 때까지 3분 동안 기다립니다(서비스 상태는 RUNNING).
CALL my_service!SPCS_WAIT_FOR('RUNNING', 180)