SHOW ENDPOINTS

注釈

この操作は現在、 Snowflake’s Support Policy and Service Level Agreement に規定されたService Levelセットの対象外です。

Snowpark Container Servicesサービス (またはジョブサービス)のエンドポイントをリストします。サービスまたはジョブとして実行されているサービス内のエンドポイントをリストするには、このコマンドを使用します。

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

CREATE SERVICEALTER SERVICEDROP SERVICESHOW SERVICES

構文

SHOW ENDPOINTS IN SERVICE <name>
Copy

パラメーター

name

エンドポイントをリストするサービスの識別子を指定します。

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

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

出力

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

説明

name

対応するポートを表す分かりやすいエンドポイント名。

port

サービスがリッスンしているネットワークポート。NULL が portRange が指定されている場合にのみ適用されます。

port_range

サービスがリストしているネットワークポート。NULL が port が指定されている場合にのみ適用されます。

protocol

サポートされているネットワークプロトコル(TCP、 HTTP、 HTTPS)。デフォルトは HTTP です。パブリックエンドポイントとサービス関数(サービスの使用 を参照)には HTTP または HTTPS が必要です。

is_public

エンドポイントが公開されていて、インターネットからアクセスできる場合はTrueです。

ingress_url

インターネットからアクセス可能なエンドポイント URL。

privatelink_ingress_url

エンドポイント URL はプライベート接続でアクセス可能です。この列は ビジネスクリティカル アカウントに対してのみ返されます。

アクセス制御の要件

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

権限

オブジェクト

注意

USAGE

サービス

スキーマ内のオブジェクトに対して操作を実行するには、親データベースとスキーマに対する USAGE 権限が必要です。

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

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

使用上の注意

  • このコマンドの実行には、稼働中のウェアハウスは必要ありません。

  • このコマンドは、現在のユーザーの現在のロールに少なくとも1つのアクセス権限が付与されているオブジェクトのみを返します。

  • MANAGE GRANTS アクセス権限により、所有者はアカウント内のすべてのオブジェクトを暗黙的に参照できます。デフォルトでは、アカウント管理者( ACCOUNTADMIN ロールを持つユーザー)とセキュリティ管理者( SECURITYADMIN ロールを持つユーザー)のみが MANAGE GRANTS 権限を持っています。

  • このコマンドの出力を後処理するには、 パイプ演算子->>)または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。

    このコマンドの出力列名は小文字で生成されます。パイプ演算子または でこのコマンドの結果セットを消費する場合 RESULT_SCAN 関数の場合は、を使用します 二重引用符で囲まれた識別子 クエリの列名に を使用し、スキャンされた出力の列名と一致するようにします。たとえば、出力列の名前が次の場合 type``次に を指定します ``"type" 識別子用。

次の例では、 echo_service サービスが公開するエンドポイントをリストしています。

SHOW ENDPOINTS IN SERVICE echo_service;
Copy
+--------------+------+------------+----------+-----------+------------------------------------------------------------------------------+-----------------------------------------------+
| name         | port | port_range | protocol | is_public | ingress_url                                                                  | privatelink_ingress_url                       |
|--------------+------+------------+----------+-----------+------------------------------------------------------------------------------|-----------------------------------------------*
| echoendpoint | 8080 |            | HTTP     | true      | d7qoajz-orgname-acctname.pp-snowflakecomputing.app                           | d7qoajz.spcs.pdxaac.privatelink.snowflake.app |
+--------------+------+------------+----------+-----------+------------------------------------------------------------------------------+-----------------------------------------------*