SHOW ENDPOINTS

备注

Snowflake 的支持政策和服务级别协议 中规定的服务级别目前不包括此操作。

列出 Snowpark Container Services 服务 （或作业服务）中的端点。使用此命令列出服务或作为作业运行的服务中的端点。

另请参阅：

CREATE SERVICE、ALTER SERVICE、DROP SERVICE、SHOW 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

服务

The USAGE privilege on the parent database and schema are required to perform operations on any object in a schema. Note that a role granted any privilege on a schema allows that role to resolve the schema. For example, a role granted CREATE privilege on a schema can create objects on that schema without also having USAGE granted on that schema.

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

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

使用说明

  • 该命令不需要正在运行的仓库即可执行。

  • 该命令仅返回当前用户的当前角色已获授至少一项访问权限的对象。

  • MANAGE GRANTS 访问权限隐式允许其持有者查看账户中的每个对象。默认情况下，只有账户管理员（具有 ACCOUNTADMIN 角色的用户）和安全管理员（具有 SECURITYADMIN 角色的用户）才具有 MANAGE GRANTS 权限。

  • To post-process the output of this command, you can use the pipe operator (->>) or the RESULT_SCAN function. Both constructs treat the output as a result set that you can query.

    The output column names for this command are generated in lowercase. If you consume a result set from this command with the pipe operator or the RESULT_SCAN function, use double-quoted identifiers for the column names in the query to ensure that they match the column names in the output that was scanned. For example, if the name of an output column is type, then specify "type" for the identifier.

示例

以下示例列出了 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 |
+--------------+------+------------+----------+-----------+------------------------------------------------------------------------------+-----------------------------------------------*
语言: 中文