SHOW ENDPOINTS¶
참고
이 작업은 현재 Snowflake의 지원 정책 및 서비스 수준 계약 에 명시된 서비스 수준에 포함되지 않습니다.
Snowpark Container Services 서비스 (또는 작업 서비스)의 엔드포인트를 나열합니다. 이 명령을 사용하면 작업으로 실행 중인 서비스 또는 서비스의 엔드포인트를 나열할 수 있습니다.
- 참고 항목:
CREATE SERVICE , ALTER SERVICE, DROP SERVICE , SHOW SERVICES
구문¶
SHOW ENDPOINTS IN SERVICE <name>
매개 변수¶
name
엔드포인트를 나열할 서비스의 식별자를 지정합니다.
식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.
자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.
출력¶
명령 출력은 다음 열에 서비스 속성과 메타데이터를 제공합니다.
열 |
설명 |
---|---|
|
해당 포트를 나타내는 사용자에게 친숙한 엔드포인트 이름입니다. |
|
서비스가 수신 대기 중인 네트워크 포트입니다. |
|
서비스가 수신 대기 중인 네트워크 포트 범위입니다. |
|
지원되는 네트워크 프로토콜(TCP, HTTP 또는 HTTPS)입니다. 기본값은 HTTP입니다. 공용 엔드포인트 및 서비스 함수(서비스 사용하기 참조)에는 HTTP 또는 HTTPS가 필요합니다. |
|
인터넷에서 액세스할 수 있는 엔드포인트가 공용인 경우 True입니다. |
|
인터넷에서 액세스할 수 있는 엔드포인트 URL입니다. |
액세스 제어 요구 사항¶
이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.
권한 |
오브젝트 |
참고 |
---|---|---|
USAGE |
서비스 |
스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.
지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.
보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.
사용법 노트¶
이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.
예¶
다음 예에서는 echo_service
서비스에 의해 노출된 엔드포인트를 나열합니다.
SHOW ENDPOINTS IN SERVICE echo_service;
+--------------+------+------------+----------+-----------+------------------------------------------------------------------------------+
| name | port | port_range | protocol | is_public | ingress_url |
|--------------+------+------------+----------+-----------+------------------------------------------------------------------------------|
| echoendpoint | 8080 | | HTTP | true | d7qoajz-orgname-acctname.pp-snowflakecomputing.app |
+--------------+------+------------+----------+-----------+------------------------------------------------------------------------------+