ALTER NOTEBOOK

기존 노트북 의 속성을 수정합니다.

구문

ALTER NOTEBOOK [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER NOTEBOOK [ IF EXISTS ] <name> SET
  [ VERSION = '<version_alias_name>' ]
  [ COMMENT = '<string_literal>' ]
  [ DEFAULT_VERSION = '<default_version_name_or_alias>' ]
  [ QUERY_WAREHOUSE = <warehouse_to_run_nb_and_sql_queries_in> ]
  [ IDLE_AUTO_SHUTDOWN_TIME_SECONDS = <number_of_seconds> ]
  [ SECRETS = ('<secret_variable_name>' = <secret_name>) [ , ... ] ]

ALTER NOTEBOOK [ IF EXISTS ] <name> UNSET
  [ QUERY_WAREHOUSE ]
  [ COMMENT ]

ALTER NOTEBOOK <name> ADD LIVE VERSION
  [ FROM LAST ]
  [ COMMENT = '<string_literal>' ]

ALTER NOTEBOOK <name> COMMIT [ VERSION '<live_version_alias>' ] [ COMMENT = '<string_literal>' ]
Copy

매개 변수

name

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

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

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

RENAME TO new_name

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

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

선택적으로 오브젝트의 이름을 바꾸는 동안 오브젝트를 다른 데이터베이스 및/또는 스키마로 이동할 수 있습니다. 그러려면 각각 db_name.schema_name.object_name 또는 schema_name.object_name 형식으로 새 데이터베이스 및/또는 스키마 이름을 포함하는 정규화된 new_name 값을 지정하십시오.

참고

  • 대상 데이터베이스 및/또는 스키마가 이미 있어야 합니다. 또한, 새 위치에 이름이 같은 오브젝트가 있으면 안 됩니다. 그렇지 않으면 문이 오류를 반환합니다.

  • 오브젝트 소유자(즉, 오브젝트에 대한 OWNERSHIP 권한이 있는 역할) 역시 대상 스키마를 소유하지 않는 한 오브젝트를 관리되는 액세스 스키마로 이동하는 것은 금지됩니다.

오브젝트의 이름이 바뀌면 그 오브젝트를 참조하는 다른 오브젝트도 새 이름으로 업데이트해야 합니다.

SET ...

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

VERSION = 'version_alias_name'

사용자가 지정한 버전 별칭입니다. 자동 생성된 버전 이름 식별자와 동일한 네임스페이스를 공유하는 식별자 입니다. 다음 규칙을 준수해야 합니다.

  • 버전이 생성된 노트북에 대해 고유합니다.

  • FIRST, LAST, LIVE 또는 DEFAULT로 설정되지 않습니다. 예약된 키워드입니다.

  • version$ 으로 시작하지 않습니다. version$ 으로 시작하는 자동 생성 버전 이름입니다.

  • 슬래시를 포함하지 않습니다.

유효한 버전 별칭 이름의 예는 다음과 같습니다.

  • 1.0.0

  • prod-1.1.0

COMMENT = 'string_literal'

노트북이나 노트북 버전에 대한 설명을 설정합니다.

DEFAULT_VERSION = 'version_name'

노트북의 기본 버전을 설정합니다. 버전 이름은 식별자 입니다.

기본값: LAST

QUERY_WAREHOUSE = warehouse_name

노트북의 SQL 쿼리가 실행되는 웨어하우스를 지정합니다. 이 매개 변수는 선택 사항입니다. 하지만 EXECUTE NOTEBOOK 명령을 실행해야 합니다.

IDLE_AUTO_SHUTDOWN_TIME_SECONDS = number_of_seconds

노트북이 자동으로 종료되기 전의 유휴 시간(초)입니다. 이 매개 변수는 컨테이너 런타임에서 실행되는 노트북에서만 사용할 수 있습니다. 값은 60~259200(72시간) 사이의 정수여야 합니다.

기본값: 3,600초

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

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

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

  • secret_name - Snowflake 시크릿의 이름입니다.

UNSET ...

노트북에 대해 지정된 속성 또는 매개 변수 하나 이상을 설정 해제하여 속성을 기본값으로 재설정합니다.

  • QUERY_WAREHOUSE

  • COMMENT

단일 ALTER 문으로 여러 속성 또는 매개 변수의 설정을 해제하려면 각 속성 또는 매개 변수를 쉼표로 구분합니다.

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

ADD LIVE VERSION

노트북에 LIVE 버전(EXECUTE NOTEBOOK 에 대해 호출되는 버전)을 추가합니다.

FROM LAST

LIVE 버전을 노트북의 LAST 버전으로 설정합니다.

COMMENT = 'string_literal''

노트북이나 노트북 버전에 대한 설명을 설정합니다.

COMMIT

노트북에 Git 연결이 설정되어 있는 경우, 노트북의 LIVE 버전을 Git 리포지토리에 커밋합니다.

노트북에 Git 리포지토리가 설정되어 있지 않은 경우, 이 명령을 실행하면 LIVE 버전이 null 로 설정되고 자동 생성된 버전 별칭이 증가합니다.

액세스 제어 요구 사항

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

권한

오브젝트

참고

USAGE 또는 OWNERSHIP

노트북

OWNERSHIP은 오브젝트를 생성한 역할에 자동으로 부여되는 오브젝트에 대한 특별한 권한입니다.

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

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

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

사용법 노트

  • 메타데이터 관련:

    주의

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

예

다음 예제에서는 노트북의 이름을 my_notebook 에서 notebook_v2 로 변경합니다

ALTER NOTEBOOK my_notebook RENAME notebook_v2;
Copy

다음 예제는 QUERY_WAREHOUSE 속성을 설정 해제하는 예제입니다.

ALTER NOTEBOOK my_notebook UNSET QUERY_WAREHOUSE;
Copy

다음 예제에서는 my_notebook 의 현재 LAST 버전을 LIVE 버전으로 설정합니다.

ALTER notebook my_notebook ADD LIVE VERSION FROM LAST;
Copy

다음 예제에서는 my_notebook 의 현재 LIVE 버전을 커밋합니다.

ALTER NOTEBOOK my_notebook COMMIT;
Copy
언어: 한국어