노트북 수정하기

노트북 수정하기 (ALTER NOTEBOOK)

이 기능은 중화인민공화국에서는 사용할 수 없어요.

기존 notebook의 속성을 수정해요.

출처: 문서

본문

구문

ALTER NOTEBOOK [ IF EXISTS ]  RENAME TO 

ALTER NOTEBOOK [ IF EXISTS ]  SET
  [ COMMENT = '' ]
  [ QUERY_WAREHOUSE =  ]
  [ IDLE_AUTO_SHUTDOWN_TIME_SECONDS =  ]
  [ SECRETS = ('' = ) [ , ... ] ]

매개 변수

name

변경할 노트북의 식별자를 지정합니다.

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

자세한 내용은 식별자 요구 사항을 참조하세요.

RENAME TO new_name

노트북의 이름을 new_name으로 변경합니다. 새 식별자는 스키마 내에서 고유해야 합니다.

식별자에 대한 자세한 내용은 식별자 요구 사항을 참조하세요.

객체의 이름을 선택적으로 변경하면서 다른 데이터베이스 및/또는 스키마로 이동할 수 있습니다. 이렇게 하려면 각각 db_name.schema_name.object_name 또는 schema_name.object_name 형식으로 새 데이터베이스 및/또는 스키마 이름을 포함하는 정규화된 new_name 값을 지정하세요.

대상 데이터베이스 및/또는 스키마는 이미 존재해야 합니다. 또한 새 위치에 같은 이름의 객체가 이미 있으면 안 됩니다. 그렇지 않으면 문이 오류를 반환합니다.
객체 소유자(즉, 객체에 대한 OWNERSHIP 권한이 있는 역할)가 대상 스키마도 소유하지 않는 한, 객체를 관리형 액세스 스키마로 이동하는 것은 금지됩니다.

객체 이름을 변경하면 해당 객체를 참조하는 다른 객체도 새 이름으로 업데이트해야 합니다.

SET ...

노트북에 대해 하나 이상의 지정된 속성 또는 매개 변수를 설정합니다:

QUERY_WAREHOUSE = warehouse_name

노트북에서 SQL 쿼리가 실행되는 웨어하우스를 지정합니다. 이 매개 변수는 선택 사항입니다. 그러나 EXECUTE NOTEBOOK 명령을 실행하려면 필요합니다.

IDLE_AUTO_SHUTDOWN_TIME_SECONDS = number_of_seconds

노트북이 자동으로 종료되기 전의 유휴 시간(초)입니다. 이 매개 변수는 Warehouse 및 Container Runtime에서 실행되는 노트북 모두에 사용할 수 있습니다. 값은 60에서 259200(72시간) 사이의 정수여야 합니다.

기본값: 3600초

SECRETS = '(secret_variable_name' = secret_name [ , ... ])

노트북에 대한 시크릿 변수를 설정합니다.

secret_variable_name - 시크릿에서 정보를 검색할 때 노트북 셀에서 사용할 변수입니다.
secret_name - Snowflake 시크릿의 이름입니다.

UNSET ...

노트북에 대해 지정된 하나 이상의 속성 또는 매개변수를 설정 해제하며, 속성이 기본값으로 재설정됩니다:

QUERY_WAREHOUSE
COMMENT

단일 ALTER 문으로 여러 속성이나 매개변수를 설정 해제하려면 각 속성 또는 매개변수를 쉼표로 구분하세요.

속성이나 매개변수를 설정 해제할 때는 속성 또는 매개변수 이름만 지정하세요(위 구문에서 값을 지정하라고 명시한 경우는 제외). 값을 지정하면 오류가 반환됩니다.

액세스 제어 요구 사항

이 작업을 실행하는 데 사용되는 role은 최소한 다음 privileges을(를) 보유해야 합니다:

권한	객체	참고
USAGE or OWNERSHIP	Notebook	OWNERSHIP은 객체에 대한 특별한 권한으로, 객체를 생성한 역할에 자동으로 부여됩니다.

스키마의 객체를 운영하려면 상위 데이터베이스에 대한 권한이 하나 이상, 상위 스키마에 대한 권한이 하나 이상 필요합니다.

지정된 권한 집합을 가진 사용자 정의 역할을 만드는 방법은 을(를) 참조하세요.

securable objects에 대해 SQL 작업을 수행하기 위한 역할 및 권한 부여에 대한 일반 정보는 Overview of Access Control을(를) 참조하세요.

사용 참고 사항

메타데이터 관련:

고객은 Snowflake 서비스를 사용할 때 메타데이터로 개인 데이터(User 객체의 경우 제외), 민감한 데이터, 수출 통제 데이터 또는 기타 규제 대상 데이터가 입력되지 않도록 해야 합니다. 자세한 내용은 Metadata fields in Snowflake을(를) 참조하세요.

예제

다음 예제는 my_notebook이라는 노트북의 이름을 notebook_v2로 바꿉니다:

ALTER NOTEBOOK my_notebook RENAME TO notebook_v2;

다음 예제는 QUERY_WAREHOUSE 속성을 설정 해제합니다:

ALTER NOTEBOOK my_notebook UNSET QUERY_WAREHOUSE;

더 알아보기 (Learn more)

Snowflake SQL Reference