<service_name>!SPCS_WAIT_FOR¶
Snowpark Container Servicesのサービス を待ち、タイムアウトのある指定された状態に達します。
非同期ジョブを実行する場合は、このヘルパー関数を使用してジョブが完了するまで待機します。
サービスを作成する場合は、このヘルパー関数を使用してサービスが実行されるまで待機します。
- こちらもご参照ください。
構文¶
<service_name>!SPCS_WAIT_FOR( <status>, <timeout_sec> );
引数¶
必要な引数
'status'待機するステータス。サービスステータス値のリストについては、DESCRIBE SERVICE コマンドの出力セクションをご覧ください。
timeout_sec指定されたステータスを待機する最大時間（秒単位）。タイムアウトまでに指定されたステータスに達しなかった場合、この関数は現在のサービスステータスを含むエラーメッセージを返します。
戻り値¶
タイムアウトまでにサービスが指定されたステータスに達しなかった場合、または、そのステータスに達することができないとSnowflakeが判断した場合、この関数はエラーメッセージを返し、現在のサービスステータスも提示します。それ以外の場合は成功メッセージを返します。
アクセス制御の要件¶
この SQL コマンドの実行に使用される ロール には、 最低 1 つ の次の 権限 が必要です。
権限 |
オブジェクト |
メモ |
|---|---|---|
これらの権限のいずれか1つ: OWNERSHIP、 USAGE、 MONITOR または OPERATE |
サービス |
Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
例¶
指定されたジョブが完了するまで2分待ちます（ジョブステータスは DONE）。
CALL my_job!spcs_wait_for('DONE', 120)
指定されたサービスが開始するまで3分待ちます（サービスステータスは RUNNING）。
CALL my_service!SPCS_WAIT_FOR('RUNNING', 180)