SHOW ENDPOINTS

SHOW ENDPOINTS 명령은 Snowpark Container Services 서비스(또는 작업 서비스)의 엔드포인트(endpoint) 목록을 보여주는 명령이에요. 서비스나 작업으로 실행되는 서비스의 엔드포인트를 나열할 때 사용해요.

출처: 문서

본문

이 명령은 Snowpark Container Services 서비스(또는 작업 서비스)의 엔드포인트를 나열해요.

기능 상태: 일반 공급(Generally Available). Snowpark Container Services는 일부 예외를 제외하고 AWS, Microsoft Azure, Google Cloud Platform 상용 리전의 계정에서 사용할 수 있어요.

참고: 이 작업은 현재 Snowflake 지원 정책과 서비스 수준 계약에 명시된 서비스 수준(Service Level)의 적용을 받지 않아요.

SHOW ENDPOINTS IN SERVICE <name>

name — 엔드포인트를 나열할 서비스의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 묶어야 해요. 큰따옴표로 묶은 식별자는 대소문자를 구분해요. 자세한 내용은 식별자 요구 사항을 참고해요.

명령 출력은 서비스 속성과 메타데이터를 다음 컬럼으로 제공해요:

name — 해당 포트를 나타내는 사용자 친화적 엔드포인트 이름.
port — 서비스가 수신 대기 중인 네트워크 포트. portRange가 지정되면 NULL.
port_range — 서비스가 수신 대기 중인 네트워크 포트 범위. port가 지정되면 NULL.
protocol — 지원되는 네트워크 프로토콜 (TCP, HTTP, HTTPS). 기본값은 HTTP. 공개 엔드포인트와 서비스 함수는 HTTP 또는 HTTPS가 필요해요.
is_public — 엔드포인트가 인터넷에서 접근 가능한 공개 엔드포인트이면 True.
ingress_url — 인터넷에서 접근 가능한 엔드포인트 URL.
privatelink_ingress_url — Private Connectivity를 통해 접근 가능한 엔드포인트 URL. 이 컬럼은 Business Critical 계정에서만 반환돼요.

이 작업을 실행하는 역할은 최소한 다음 권한을 가져야 해요:

권한 (Privilege)	객체 (Object)	비고
USAGE	서비스

스키마의 객체를 조작하려면 상위 데이터베이스에 최소 하나, 상위 스키마에 최소 하나의 권한이 필요해요.

실행에 실행 중인 웨어하우스를 요구하지 않아요.
현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
MANAGE GRANTS 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요.

echo_service 서비스가 노출하는 엔드포인트를 나열해요:

SHOW ENDPOINTS IN SERVICE echo_service;