SHOW SERVICES

アクセス権限がある Snowpark Container Servicesサービス をリストします。

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

CREATE SERVICEALTER SERVICEDROP SERVICEDESCRIBE SERVICE

構文

SHOW SERVICES [ LIKE '<pattern>' ]
           [ IN
                {
                  ACCOUNT                  |

                  DATABASE                 |
                  DATABASE <database_name> |

                  SCHEMA                   |
                  SCHEMA <schema_name>     |
                  <schema_name>            |

                  COMPUTE POOL <compute_pool_name>
                }
           ]
           [ STARTS WITH '<name_string>' ]
           [ LIMIT <rows> [ FROM '<name_string>' ] ]
Copy

パラメーター

LIKE 'pattern'

オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字(% および _)をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。

たとえば、次のパターンは 同じ 結果を返します。

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. デフォルト: 値なし(フィルタリングは出力に非適用)。

[ IN ... ]

オプションで、コマンドのスコープを指定します。次のいずれかを指定します。

ACCOUNT

アカウント全体の記録を返します。

DATABASE. DATABASE db_name

現在使用中のデータベースまたは指定されたデータベース(db_name)の記録を返します。

db_name なしで DATABASE を指定し、かつデータベースが使用されていない場合、キーワードは出力に影響しません。

SCHEMA. SCHEMA schema_name. schema_name

現在使用中のスキーマまたは指定されたスキーマ(schema_name)の記録を返します。

データベースが使用中の場合、または完全修飾 schema_name (例: db.schema) を指定する場合、 SCHEMA はオプションです。

データベースが使用されていない場合は、 SCHEMA を指定しても出力には影響しません。

デフォルト: セッションで現在使用中のデータベースがあるかどうかによって異なります。

  • データベース: DATABASE がデフォルトです(つまり、コマンドはデータベースで表示する権限を持つオブジェクトを返します)。

  • データベースなし: ACCOUNT はデフォルトです(つまり、コマンドは、アカウントで表示する権限を持つオブジェクトを返します)。

STARTS WITH 'name_string'

オプションで、オブジェクト名の先頭に表示される文字に基づいてコマンド出力をフィルタリングします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します

たとえば、次の文字列は 異なる 結果を返します。

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

. デフォルト: 値なし(フィルターは出力に適用されない)

LIMIT rows

オプションで、返される行の最大数を制限します。実際に返される行数は、指定された制限より少ない場合があります。例えば、既存のオブジェクトの数が指定された制限より少ないなどです。

デフォルト: 値なし(出力に制限は非適用)。

出力

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

説明

name

Snowpark Container Servicesのサービス名。

database_name

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

schema_name

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

owner

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

compute_pool

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

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 コマンドの実行に使用される ロール には、 最低 1 つ の次の 権限 が必要です。

権限

オブジェクト

メモ

これらの権限のいずれか1つ: OWNERSHIP、 USAGE、 MONITOR または OPERATE

サービス

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

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

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

使用上の注意

  • プレフィックス is_ で始まる列は、 Y (はい)または N (いいえ)のいずれかを返します。

  • このコマンドは、実行中のウェアハウスを必要としません。

  • コマンドは、コマンドを実行するために使用されるロールのアクセス権によって決定された通り、指定されたオブジェクトタイプに対して 最大 10Kの記録を返します。フィルタが適用されていても、10Kの制限を超える記録は返されません。

    10Kを超える記録が存在する結果を表示するには、 Snowflake Information Schema で対応するビュー(存在する場合)をクエリします。

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

次の例は、セッションの現在のデータベースとスキーマのサービスをリストしています。

SHOW SERVICES;
Copy

次の例は、1つのサービスをリストしています。

SHOW SERVICES LIMIT 1;
Copy

次の例は、名前に「echo」が含まれるサービスをリストしています。

SHOW SERVICES LIKE '%echo%';
Copy

次の例は、名前に「echo」が含まれる1つのサービスをリストしています。

SHOW SERVICES LIKE '%echo%' LIMIT 1;
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            |
+--------------------+---------------+-------------+----------+-----------------------+-----------------------------------------------------------------------+---------------+---------------+-------------+--------------------------------+-------------------------------+--------------------------------+------------+---------+-----------------+-----------------+