ALTER SERVICE

Snowpark Container Services 서비스 구성을 수정하고 서비스 코드를 업그레이드하며 서비스를 일시 중단하거나 재개할 수 있습니다. 다음을 할 수 있습니다.

  • 실행 중인 서비스에 수정 사항을 적용합니다. 예를 들어 서비스를 일시 중단하거나 재개하고 실행 중인 서비스 인스턴스 수를 업데이트합니다.

  • 서비스가 다시 시작된 후에만 적용되는 수정 사항을 적용합니다. 예를 들어 쿼리에 대한 기본 웨어하우스를 지정합니다.

  • Snowflake가 서비스를 종료하도록 수정 사항을 적용하고 새 코드를 사용하여 다시 시작합니다. 예를 들어 업데이트된 서비스 코드를 배포할 수도 있습니다.

참고 항목:

CREATE SERVICE , DESCRIBE SERVICE, DROP SERVICE , SHOW SERVICES

구문

ALTER SERVICE [ IF EXISTS ] <name> { SUSPEND | RESUME }

ALTER SERVICE [ IF EXISTS ] <name>
  {
    FROM @<stage>
    SPECIFICATION_FILE = '<yaml_file_stage_path>'
    |
    FROM SPECIFICATION <specification_text>
  }

ALTER SERVICE [ IF EXISTS ] <name> SET [ MIN_INSTANCES = <num> ]
                                       [ MAX_INSTANCES = <num> ]
                                       [ QUERY_WAREHOUSE = <warehouse_name> ]
                                       [ AUTO_RESUME = { TRUE | FALSE } ]
                                       [ COMMENT = '<string_literal>' ]

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

매개 변수

name

변경할 서비스의 식별자를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

{ SUSPEND | RESUME }

서비스를 일시 중단할지, 재개할지 지정합니다.

서비스를 일시 중단하면 Snowflake가 컨테이너를 종료하고 삭제합니다. 나중에 일시 중단된 서비스를 재개하면 Snowflake가 컨테이너를 다시 만듭니다. 즉, Snowflake는 리포지토리에서 이미지를 가져와 컨테이너를 시작합니다. 리포지토리의 이미지가 업데이트된 경우 Snowflake는 업데이트된 이미지를 사용하여 컨테이너를 다시 만듭니다.

서비스 함수를 사용하거나 공용 엔드포인트(수신)를 호출하여 일시 중단된 서비스를 호출하면 Snowflake가 자동으로 서비스를 재개합니다.

FROM stage

사양 파일이 저장되는 Snowflake 내부 스테이지(예: “@tutorial_stage”)를 지정합니다.

SPECIFICATION_FILE = 'yaml_file_stage_path'

스테이지의 서비스 사양 파일 경로(예: “/some-dir/echo_spec.yaml”)를 지정합니다.

FROM SPECIFICATION specification_text

서비스 사양을 지정합니다. 달러 기호 쌍($$)을 사용하여 사양 문자열의 시작과 끝을 구분할 수 있습니다.

SET ...

서비스에 대해 하나 이상의 지정된 속성 또는 매개 변수를 설정합니다.

MIN_INSTANCES = num

서비스 인스턴스의 최소 개수를 지정합니다.

MAX_INSTANCES = num

서비스 인스턴스의 최대 개수를 지정합니다.

QUERY_WAREHOUSE = warehouse_name

서비스 컨테이너가 Snowflake에 연결하여 쿼리를 실행하지만 사용할 웨어하우스를 명시적으로 지정하지 않은 경우 사용할 웨어하우스입니다.

AUTO_RESUME = { TRUE | FALSE }

서비스 함수가 호출되거나 요청이 수신될 때 서비스를 자동으로 재개할지 여부를 지정합니다.

COMMENT = 'string_literal'

컴퓨팅 풀에 대한 설명을 지정합니다.

UNSET ...

서비스에 대해 설정 해제할 하나 이상의 속성 및/또는 매개 변수를 지정하여 기본값으로 재설정합니다(CREATE SERVICE 참조).

  • MIN_INSTANCES

  • MAX_INSTANCES

  • QUERY_WAREHOUSE

  • AUTO_RESUME

  • COMMENT

액세스 제어 요구 사항

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한

오브젝트

참고

OPERATE

서비스

스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트

  • 메타데이터 관련:

    주의

    고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

서비스를 일시 중단합니다.

ALTER SERVICE echo_service SUSPEND;
Copy

기존 서비스의 MIN_INSTANCES 및 MAX_INSTANCES 속성을 수정합니다.

ALTER SERVICE echo_service SET MIN_INSTANCES=3 MAX_INSTANCES=5;
Copy