ALTER SERVICE

ALTER SERVICE

Snowpark Container Services의 기존 서비스(service) 속성을 수정하는 명령이에요.

출처: 문서

본문

Snowpark Container Services는 AWS, Microsoft Azure, Google Cloud Platform 상용 리전의 계정에서 사용할 수 있어요. 서비스에 대한 자세한 내용은 서비스 문서를 참고하세요.

구문 (Syntax)

ALTER SERVICE [ IF EXISTS ] <name> SET
  [ MIN_INSTANCES = <min> ]
  [ MAX_INSTANCES = <max> ]
  [ COMMENT = '<string_literal>' ]
  [ EXTERNAL_ACCESS_INTEGRATIONS = ( <integration_name> [ , ... ] ) ]
  [ QUERY_WAREHOUSE = <warehouse_name> ]
  [ AUTO_RESUME = { TRUE | FALSE } ]
  [ EMAIL = '<string_literal>' ]
  [ SPEC = '<inline_spec>' ]
  [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] ]

ALTER SERVICE [ IF EXISTS ] <name> UNSET
  [ MIN_INSTANCES | MAX_INSTANCES | AUTO_RESUME | QUERY_WAREHOUSE | EMAIL | COMMENT ]
  [ , ... ]

ALTER SERVICE [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

매개변수 (Parameters)

name — 수정할 서비스의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되어 있으면 전체 문자열을 큰따옴표로 묶어야 해요. 큰따옴표로 묶은 식별자는 대소문자를 구분해요.

SET ... — 서비스에 설정할 하나 이상의 매개변수를 지정해요.

MIN_INSTANCES = min — 서비스에서 실행될 최소 작업자 인스턴스 수를 지정해요. 범위: 1 ~ 1024. 기본값: 1.

MAX_INSTANCES = max — 서비스에서 실행될 최대 작업자 인스턴스 수를 지정해요. 범위: 1 ~ 1024. 기본값: 1. Snowflake는 워크로드에 따라 인스턴스를 자동으로 축소/확장해요.

COMMENT = 'string_literal' — 서비스에 대한 주석을 추가하거나 기존 주석을 덮어써요.

EXTERNAL_ACCESS_INTEGRATIONS = ( integration_name [ , ... ] ) — 서비스 코드가 외부 네트워크에 접근하는 데 필요한 외부 접근 통합의 이름을 지정해요. 서비스에 네트워크 규칙과 비밀(외부 접근 통합에서 참조)이 제공돼야 해요.

QUERY_WAREHOUSE = warehouse_name — 서비스 코드가 SQL 쿼리를 실행하는 데 사용할 웨어하우스를 지정해요.

AUTO_RESUME = { TRUE | FALSE } — 서비스가 작업을 받을 때 자동으로 재개되는지 지정해요.

  • TRUE — 서비스가 자동 재개를 위해 예약됨.
  • FALSE — 서비스가 자동 재개되지 않음.

EMAIL = 'string_literal' — 서비스의 접촉 이메일 주소를 지정해요.

SPEC = '<inline_spec>' — 서비스 사양의 인라인 YAML을 지정해요. 이 매개변수는 서비스가 지정된 스테이지 파일이 아닌 인라인 사양으로 생성된 경우에만 설정할 수 있어요.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ] — 태그 이름과 태그 문자열 값을 지정해요.

사용 메모 (Usage notes)

  • 서비스를 수정하는 역할은 서비스에 대한 OWNERSHIP 또는 OPERATE 권한이 있어야 해요.
  • 메타데이터 관련: Snowflake 서비스를 사용할 때 메타데이터로 개인 데이터(User 객체 외), 민감한 데이터, 수출 통제 데이터 또는 기타 규제 대상 데이터를 입력하지 않도록 주의해야 해요. 자세한 내용은 Snowflake의 메타데이터 필드를 참고하세요.

예시 (Examples)

서비스의 최대 인스턴스 수를 변경해요.

ALTER SERVICE my_service SET MAX_INSTANCES = 3;

서비스의 주석을 변경해요.

ALTER SERVICE my_service SET COMMENT = 'updated service comment';

더 알아보기 (Learn more)