サービスの管理¶
Snowpark Container Servicesを使用すると、コンテナ化されたアプリケーションを簡単に展開、管理、スケーリングできるようになります。アプリケーションイメージをアカウント内のリポジトリにアップロードしたら、アプリケーションコンテナをサービスまたはジョブとして実行します。このトピックでは、サービスの操作について説明します。
サービスは、ウェブサービスのように長期間継続し、自動的に終了することはありません。Snowflakeは実行中のサービスを管理します。たとえば、何らかの理由でサービスコンテナが終了した場合、Snowflakeはそのコンテナを再起動し、サービスが中断されることなく実行されるようにします。サービスにより多くのコンピューティングパワーなどのリソースが必要な場合、Snowflakeはコンピューティングプールに追加のノードをプロビジョニングします。
コンテナサービスの操作の詳細については、 Snowpark Container Services: サービスの操作 をご参照ください。
このトピックでは、サービスを使用して次のタスクを実行する方法を説明します。
リスト表示やドロップなどの一般的な操作では、 Snowflake CLI は Snowflakeオブジェクトの管理 で説明されている snow object コマンドを使用します。
Snowpark Container Servicesのサービスを作成する¶
Snowparkのコンテナサービスには、次が必要です。
コンピューティングプール: Snowflakeは指定したコンピューティングプールでサービスを実行します。
サービス仕様ファイル: この仕様により、サービスを設定および実行するために必要な情報がSnowflakeに提供されます。
サービスを作成するには、次のようなコマンドを入力します。
snow spcs service create "job_1" --compute-pool "pool_1" --spec-path "/some-dir/spec_file.yaml"
詳細については、 Snowflakeオブジェクトの管理 をご参照ください。
サービスを一時停止および再開する¶
名前付きサービスを一時停止するには、次のようなコマンドを入力します。
snow spcs service suspend echo_service
+-------------------------------------------+
| key | value |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+
一時停止したサービスを再開するには、次のようなコマンドを入力します。
snow spcs service resume echo_service
+-------------------------------------------+
| key | value |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+
サービスのステータス情報を取得する¶
注釈
現在のロールがサービスのステータスを取得するには、 MONITOR 権限を持っている必要があります。
サービスをリストする¶
snow spcs service list コマンドは、 PENDING や RUNNING といったサービスの実行時の状態や、アップグレードの状況など、すべてのサービスの概要を返します。名前付きサービスのステータスを取得するには、次のようなコマンドを入力します。
snow spcs service list
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| | | | | | | | | | | | | extern | | | | | | | | | | | |
| | | | | | | | | | | | | al_acc | | | | | | | | | | managin | managi |
| | | databa | | | | | curren | target | min_in | max_in | | ess_in | | | | | owner_r | query_ | | | | g_objec | ng_obj |
| | | se_nam | schema | | comput | dns_na | t_inst | _insta | stance | stance | auto_re | tegrat | created | update | resumed | commen | ole_typ | wareho | | spec_di | is_upg | t_domai | ect_na |
| name | status | e | _name | owner | e_pool | me | ances | nces | s | s | sume | ions | _on | d_on | _on | t | e | use | is_job | gest | rading | n | me |
|--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+---------+--------+---------+--------+---------+--------+---------+--------+--------+---------+--------+---------+--------|
| ECHO_S | RUNNIN | TEST00 | TEST_S | SYSADM | TUTORI | echo-s | 1 | 1 | 1 | 1 | true | None | 2024-10 | 2024-1 | None | This | ROLE | COMPUT | false | 52e62d1 | false | None | None |
| ERVICE | G | _DB | CHEMA | IN | AL_COM | ervice | | | | | | | -16 | 0-16 | | is a | | E_WH | | f19c720 | | | |
| | | | | | PUTE_P | .imhd. | | | | | | | 15:09:3 | 15:09: | | test | | | | 6b5f4ef | | | |
| | | | | | OOL | svc.sp | | | | | | | 0.49300 | 31.905 | | servic | | | | c069557 | | | |
| | | | | | | cs.int | | | | | | | 0-07:00 | 000-07 | | e | | | | 8b6c2b3 | | | |
| | | | | | | ernal | | | | | | | | :00 | | | | | | 806ad76 | | | |
| | | | | | | | | | | | | | | | | | | | | 67d78cc | | | |
| | | | | | | | | | | | | | | | | | | | | ce8b6ed | | | |
| | | | | | | | | | | | | | | | | | | | | 6501a8a | | | |
| | | | | | | | | | | | | | | | | | | | | 3 | | | |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
名前付きサービスのステータスを取得する¶
個々のサービスのステータスを取得するには、次のような:codenowrap:snow spcs service describe コマンドを入力します:
snow spcs service describe echo_service
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| | | | | | | | | | | | | extern | | | | | | | | | | | |
| | | | | | | | | | | | | al_acc | | | | | | | | | | managin | managi |
| | | databa | | | | | curren | target | min_in | max_in | | ess_in | | | | | owner_r | query_ | | | | g_objec | ng_obj |
| | | se_nam | schema | | comput | dns_na | t_inst | _insta | stance | stance | auto_re | tegrat | created | update | resumed | commen | ole_typ | wareho | | spec_di | is_upg | t_domai | ect_na |
| name | status | e | _name | owner | e_pool | me | ances | nces | s | s | sume | ions | _on | d_on | _on | t | e | use | is_job | gest | rading | n | me |
|--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+---------+--------+---------+--------+---------+--------+---------+--------+--------+---------+--------+---------+--------|
| ECHO_S | RUNNIN | TEST00 | TEST_S | SYSADM | TUTORI | echo-s | 1 | 1 | 1 | 1 | true | None | 2024-10 | 2024-1 | None | This | ROLE | COMPUT | false | 52e62d1 | false | None | None |
| ERVICE | G | _DB | CHEMA | IN | AL_COM | ervice | | | | | | | -16 | 0-16 | | is a | | E_WH | | f19c720 | | | |
| | | | | | PUTE_P | .imhd. | | | | | | | 15:09:3 | 15:09: | | test | | | | 6b5f4ef | | | |
| | | | | | OOL | svc.sp | | | | | | | 0.49300 | 31.905 | | servic | | | | c069557 | | | |
| | | | | | | cs.int | | | | | | | 0-07:00 | 000-07 | | e | | | | 8b6c2b3 | | | |
| | | | | | | ernal | | | | | | | | :00 | | | | | | 806ad76 | | | |
| | | | | | | | | | | | | | | | | | | | | 67d78cc | | | |
| | | | | | | | | | | | | | | | | | | | | ce8b6ed | | | |
| | | | | | | | | | | | | | | | | | | | | 6501a8a | | | |
| | | | | | | | | | | | | | | | | | | | | 3 | | | |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
インスタンスとコンテナをリストする¶
サービスのインスタンスとコンテナは、それぞれ:codenowrap:snow spcs service list-instances と:codenowrap:snow spcs service list-containers コマンドで一覧表示できます。
echo_service サービスのインスタンスのリストを取得するには、以下のコマンドを入力します:
snow spcs service list-instances echo_service
+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| database_name | schema_name | service_name | instance_id | status | spec_digest | creation_time | start_time |
|---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------|
| TEST00_DB | TEST_SCHEMA | ECHO_SERVICE | 0 | READY | 336c065739dd2b96e770f01804affdc7810e6df68a23b23052d851627abfbdf9 | 2024-10-10T06:06:30Z | 2024-10-10T06:06:30Z |
+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
echo_service サービスに含まれるコンテナのリストを取得するには、以下のコマンドを入力します:
snow spcs service list-containers echo_service
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| database_name | schema_name | service_name | instance_id | container_name | status | message | image_name | image_digest | restart_count | start_time |
|---------------+-------------+--------------+-------------+----------------+--------+---------+-------------------------------------------+-------------------------------------------+---------------+----------------------|
| TEST00_DB | TEST_SCHEMA | ECHO_SERVICE | 0 | main | READY | Running | org-test-account-00.registry.registry.sno | sha256:06c3d54edc24925abe398eda70d37eb6b8 | 0 | 2024-10-16T22:09:35Z |
| | | | | | | | wflakecomputing.com/test00_db/test_schema | 7b1c4dd6211317592764e1e7d94498 | | |
| | | | | | | | /test00_repo/echo_service:latest | | | |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
サービス内のエンドポイントをリストする¶
名前付きサービスのエンドポイントをリストするには、次のようなコマンドを入力します。
snow spcs service list-endpoints echo_service
+--------------+------+----------+-----------------+-----------------------------------------+
| name | port | protocol | ingress_enabled | ingress_url |
|--------------+------+----------+-----------------+-----------------------------------------|
| echoendpoint | 8000 | TCP | true | org-id-acct-id.snowflakecomputing.app |
+--------------+------+----------+-----------------+-----------------------------------------+
サービスに関連付けられているすべてのサービスロールをリストする¶
サービス仕様でサービスの役割と権限を定義することで、サービスによって公開される個々のエンドポイントへのアクセスを管理できます。サービス・ロールの使用方法の詳細については、 GRANT SERVICE ROLE をご参照ください。
サービスに対して作成されたサービス・ロールのリストを取得するには、図のように、snow spcs service list-roles コマンドを使用します:
snow spcs service list-roles my_service
+------------------------------------------------------------------+
| created_on | name | comment |
|----------------------------------+---------------------+---------|
| 2024-10-09 16:48:52.980000-07:00 | ALL_ENDPOINTS_USAGE | None |
+------------------------------------------------------------------+
サービスのプロパティまたはパラメーターを設定および設定解除する¶
注釈
プロパティを設定するには、現在のロールがサービス上で OPERATE 権限を持っている必要があります。
サービスのプロパティまたはパラメーターを設定するには、次のようなコマンドを入力します。
snow spcs service set echo_service --min-instances 2 --max-instances 4
+-------------------------------------------+
| key | value |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+
サービスのプロパティまたはパラメーターをデフォルト値にリセットするには、次のようなコマンドを入力します。
snow spcs compute-pool unset tutorial_compute_pool --auto-resume
+-------------------------------------------+
| key | value |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+
名前付きサービスのログを表示する¶
注釈
ログを表示するには、現在のロールに MONITOR 権限が必要です。
名前付きサービスのローカルログを表示するには、以下のようなコマンドを入力します。
snow spcs service logs "service_1" --container-name "container_1" --instance-id "0"
名前付きサービスをアップグレードする¶
注釈
サービスをアップグレードするには、現在のロールに OPERATE 権限が必要です。
名前付きサービスをアップグレードするには、次のようなコマンドを入力します。
snow spcs service upgrade echo_service --spec-path spec.yml
+-------------------------------------------+
| key | value |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+