DESCRIBE SERVICE

Snowpark Container Servicesサービス のプロパティについて説明します。

DESCRIBE は DESCに短縮できます。

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

CREATE SERVICEALTER SERVICEDROP SERVICESHOW SERVICES

構文

DESC[RIBE] SERVICE <name>
Copy

パラメーター

name

説明するサービスの識別子を指定します。

識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

出力

コマンド出力では、次の列にサービスプロパティとメタデータが提供されます。

説明

name

Snowpark Container Servicesのサービス名。

database_name

サービスが作成されるデータベース。

schema_name

サービスが作成されるスキーマ。

owner

サービスを所有するロール。

compute_pool

Snowflakeがサービスを実行するコンピューティングプール名。

spec

サービス仕様ファイル。コマンド実行時にサービス所有者ロールを使用している場合のみ、出力にこの列が含まれます。

dns_name

サービスのSnowflakeが割り当てた DNS 名。DNS 名はサービス間通信を可能にします(チュートリアル3 をご参照ください)。

min_instances

Snowflakeが実行する必要があるサービスインスタンスの最小数。

max_instances

Snowflakeが必要に応じてスケールできるサービスインスタンスの最大数。

auto_resume

trueの場合で、サービス関数が呼び出されたとき、または受信リクエスト(ingres)を受信したとき(サービスの使用 を参照)にサービスが中断している場合、Snowflakeはサービスを自動再開します。

external_access_integrations

サービスに関連する外部アクセス統合のリスト。詳細については、 ネットワークエグレス をご参照ください。

created_on

サービスが作成されたタイムスタンプ。

updated_on

サービスが最後に更新されたタイムスタンプ。

resumed_on

サービスが最後に再開されたタイムスタンプ。

comment

サービスに関するコメント

owner_role_type

オブジェクトを所有するロールの型(ROLE または DATABASE_ROLE)。

query_warehouse

サービスコンテナがクエリを実行するためにSnowflakeに接続し、使用するウェアハウスを明示的に指定しなかった場合、Snowflakeはデフォルトとしてこのウェアハウスを使用します。

アクセス制御の要件

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

権限

オブジェクト

メモ

MONITOR

サービス

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

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

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

使用上の注意

  • このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。

次の例は、 echo_service という名前のサービスについて説明しています。

DESCRIBE SERVICE echo_service;
Copy
+--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------+-----------------+-----------------+
| name               | database_name | schema_name | owner    | compute_pool          | dns_name                                                              | min_instances | max_instances | auto_resume | external_access_integrations   | created_on                    | updated_on                     | resumed_on | comment | owner_role_type | query_warehouse |
|--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------------------------+-----------------|
| ECHO_SERVICE       | TUTORIAL_DB   | DATA_SCHEMA | TST_ROLE | TUTORIAL_COMPUTE_POOL | echo-service.data-schema.tutorial-db.snowflakecomputing.internal      |             1 |             1 | true        | ["example_access_integration"] |2023-10-26 10:53:32.150 -0700  | 2023-10-31 23:56:49.041 -0700  | NULL       | NULL    | ROLE            | NULL            |
+--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------+-----------------+-----------------+