SHOW ENDPOINTS

列出 :doc:` Snowpark Container Services 服务 </developer-guide/snowpark-container-services/working-with-services>` (或作业服务)中的端点。使用此命令列出服务或作为作业运行的服务中的端点。

另请参阅:

CREATE SERVICEALTER SERVICEDROP SERVICESHOW SERVICES

语法

SHOW ENDPOINTS IN SERVICE <name>
Copy

参数

name

指定要列出其端点的服务的标识符。

如果标识符包含空格或特殊字符,则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

有关更多信息,请参阅 标识符要求

输出

命令输出在以下列中提供服务属性和元数据:

描述

name

用户友好的端点名称,代表相应的端口。

port

服务正在监听的网络端口。

protocol

支持的网络协议(TCP、HTTP 或 HTTPS)。默认为 HTTP。公共端点和服务函数(请参阅 使用服务)需要使用 HTTP 或 HTTPS。

is_public

如果端点是可从互联网访问的公共端点,则为 true。

ingress_url

可从互联网访问的端点 URL。

访问控制要求

用于执行此 SQL 命令的 角色 必须至少具有以下 权限

权限

对象

备注

USAGE

服务

请注意,对架构中的对象进行操作还需要对父数据库和架构具有 USAGE 权限。

有关创建具有指定权限集的自定义角色的说明,请参阅 创建自定义角色

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息,请参阅 访问控制概述

使用说明

  • 若要对此命令的输出进行后处理,可以使用 RESULT_SCAN 函数,该函数会将输出视为可查询的表。

示例

以下示例列出了 echo_service 服务公开的端点:

SHOW ENDPOINTS IN SERVICE echo_service;
Copy
+--------------+------+----------+-----------+------------------------------------------------------------------------------+
| name         | port | protocol | is_public | ingress_url                                                                  |
|--------------+------+----------+-----------+------------------------------------------------------------------------------|
| echoendpoint | 8080 | HTTP     | true      | d7qoajz-orgname-acctname.pp-snowflakecomputing.app                           |
+--------------+------+----------+-----------+------------------------------------------------------------------------------+
语言: 中文