ALTER NOTEBOOK

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

구문

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

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

매개 변수

name

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

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

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

RENAME TO new_name

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

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

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

참고

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

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

RENAME TO 매개 변수를 사용해 비공개 노트북을 다른 데이터베이스로 옮길 수는 없습니다. 노트북을 다른 데이터베이스로 옮겨 다른 사람들이 노트북을 사용할 수 있게 하려면(예: 공유 사용), 개인 노트북을 템플릿으로 사용해 다른 데이터베이스에 새 노트북을 만드십시오. 개인 노트북을 일반 사용자가 사용할 수 있도록 설정하기 섹션을 참조하십시오.

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

SET ...

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

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 문으로 여러 속성 또는 매개 변수의 설정을 해제하려면 각 속성 또는 매개 변수를 쉼표로 구분합니다.

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

액세스 제어 요구 사항

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

권한

오브젝트

참고

USAGE 또는 OWNERSHIP

노트북

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

스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한.

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

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

사용법 노트

  • 메타데이터 관련:

    주의

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

예

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

ALTER NOTEBOOK my_notebook RENAME TO notebook_v2;
Copy

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

ALTER NOTEBOOK my_notebook UNSET QUERY_WAREHOUSE;
Copy
언어: 한국어