EXECUTE SERVICE¶

構文¶

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> [ , ... ] ) ]

必須パラメーター¶

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 [ , ... ] )

サービスがアクセスできる、インターネット上の外部の宛先を特定します。デフォルトでは、アプリケーションコンテナにはインターネットにアクセスする権限がありません。外部アクセス統合（EAIs）を使用してインターネットアクセスを有効にする必要があります。詳細については、 ネットワークエグレス をご参照ください。

アクセス制御の要件¶

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

スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する 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';