EXECUTE SERVICE

重要

Snowpark Container Servicesのジョブ機能は現在プライベートプレビュー中であり、 https://snowflake.com/legal のプレビュー規約に従うものとします。詳細については、Snowflakeの担当者にお問い合わせください。

Snowpark Container Servicesジョブ を開始します。ジョブは同期的に実行され、すべてのコンテナが終了すると完了します。

こちらもご参照ください。

SYSTEM$GET_JOB_STATUSSYSTEM$GET_JOB_LOGS

構文

EXECUTE SERVICE
  IN COMPUTE POOL <compute_pool_name>
  {
    FROM @<stage>
    SPECIFICATION_FILE = '<yaml_file_stage_path>'
    |
    FROM SPECIFICATION <specification_text>
  }
  [ EXTERNAL_ACCESS_INTEGRATIONS = ( <EAI_name> [ , ... ] ) ]
Copy

必須パラメーター

IN COMPUTE POOL compute_pool_name

サービスを実行するアカウントのコンピューティングプール名を指定します。

FROM stage

仕様ファイルが保管されているSnowflake内部ステージを指定します。例えば、 @tutorial_stage です。

SPECIFICATION_FILE = 'yaml_file_stage_path'

ステージ上の サービス仕様 ファイルへのパスを指定します。例えば、 'some-dir/echo_spec.yaml' です。

FROM SPECIFICATION specification_text

サービス仕様 を指定します。 ドル記号のペア$$)を使用して、仕様文字列の最初と最後を区切ることができます。

オプションのパラメーター

EXTERNAL_ACCESS_INTEGRATIONS = ( EAI_name [ , ... ] )

ジョブに外部サイトへのアクセスを許可する 外部アクセス統合 の名前を指定します。このリストの名前は大文字と小文字を区別します。デフォルトでは、アプリケーションコンテナーはインターネットにアクセスする権限を持っていません。ジョブが外部サイトにアクセスできるようにするには、外部アクセス統合(EAI)を作成し、その統合を使用するようにジョブを構成します。詳細については、 ネットワークエグレス をご参照ください。

アクセス制御の要件

この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

メモ

USAGE

コンピューティングプール

READ

ステージ

これは仕様が保管されるステージです。

READ

イメージリポジトリ

仕様によって参照されるイメージのリポジトリ。

スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意

  • EXECUTE SERVICE コマンドが返すクエリ ID は、Snowpark Container Servicesジョブの一意の識別子です。

    この ID を使用して、ジョブの進行中にジョブコンテナ(SYSTEM$GET_JOB_LOGS)からジョブステータス(SYSTEM$GET_JOB_STATUS)またはログを取得できます。

    EXECUTE SERVICE コマンドを実行した直後に LAST_QUERY_ID 関数を呼び出すと、後で参照するためにクエリジョブの ID をキャプチャできることに注意してください。また、 Snowsight ウェブインターフェイスを使用して、ジョブのクエリ ID を見つけることもできます。

  • メタデータについて:

    注意

    Snowflakeサービスを使用する場合、お客様は、個人データ(ユーザーオブジェクト向け以外)、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。

Snowpark Container Servicesジョブを作成します。

EXECUTE SERVICE
  IN COMPUTE POOL tutorial_compute_pool
  FROM @tutorial_stage
  SPECIFICATION_FILE='my_job_spec.yaml';
Copy