DESCRIBE SERVICE¶

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

DESCRIBE は DESCに短縮できます。

こちらもご参照ください。: CREATE SERVICE、 ALTER SERVICE、 DROP SERVICE、 SHOW 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            |
+--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------+-----------------+-----------------+