CREATE NOTEBOOK

새로운 Snowflake 노트북 을 만들거나 기존 노트북을 바꿉니다.

구문

CREATE [ OR REPLACE ] NOTEBOOK [ IF NOT EXISTS ] <name>
  [ VERSION '<version_alias_name>' ]
  [ FROM '<source_location>' ]
  [ MAIN_FILE = '<main_file_name>' ]
  [ COMMENT = '<string_literal>' ]
  [ DEFAULT_VERSION = '<version_name>' ]
  [ QUERY_WAREHOUSE = <warehouse_to_run_nb_and_sql_queries_in> ]
  [ IDLE_AUTO_SHUTDOWN_TIME_SECONDS = <number_of_seconds> ]
Copy

필수 매개 변수

name

노트북의 식별자(즉, 이름)를 지정하는 문자열로, 노트북이 생성되는 스키마에 대해 고유해야 합니다.

또한, 식별자는 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예: "My object")로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

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

선택적 매개 변수

VERSION 'version_alias_name'

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

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

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

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

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

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

  • 1.0.0

  • prod-1.1.0

FROM 'source_location

파일을 복사할 위치. 이 URL은 Snowflake 스테이지 위치여야 합니다.

지정된 경우, 복사된 파일을 기반으로 노트북 오브젝트가 생성됩니다. 지정하지 않으면 노트북 오브젝트는 템플릿 노트북에서 생성됩니다.

지정된 경우, MAIN_FILE 매개 변수를 복사할 파일 이름으로 설정해야 합니다. 이 파일은 ipynb 파일이어야 합니다.

MAIN_FILE = 'main_file_name'

노트북 파일 이름을 위한 사용자 지정 식별자. 이 이름은 name 매개 변수에 지정된 노트북 오브젝트 이름과 별개입니다. 이 파일은 ipynb 파일이어야 합니다.

COMMENT = 'string_literal'

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

기본값: 값 없음

DEFAULT_VERSION = 'version_name'

노트북의 기본 버전(EXECUTE NOTEBOOK 에 대해 호출되는 버전)을 설정합니다. 버전 이름은 식별자 입니다.

기본값: LAST

QUERY_WAREHOUSE = warehouse_name

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

IDLE_AUTO_SHUTDOWN_TIME_SECONDS = number_of_seconds

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

기본값: 3,600초

액세스 제어 요구 사항

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

권한

오브젝트

USAGE

데이터베이스

USAGE 또는 OWNERSHIP

스키마

CREATE NOTEBOOK

스키마

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

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

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

사용법 노트

  • 메타데이터 관련:

    주의

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

  • CREATE OR REPLACE <오브젝트> 문은 원자성입니다. 즉, 오브젝트가 바뀔 때 단일 트랜잭션으로 이전 오브젝트가 삭제되고 새 오브젝트가 생성됩니다.

예

다음은 이름이 mynotebook 인 노트북을 생성합니다.

CREATE NOTEBOOK mynotebook;
Copy

QUERY_WAREHOUSE 매개 변수는 선택 사항이지만, 새 노트북을 생성할 때 지정해 두면 노트북에서 EXECUTE NOTEBOOK을 실행할 수 있습니다.

CREATE NOTEBOOK mynotebook
 QUERY_WAREHOUSE = my_warehouse;
Copy

다음 예제는 스테이지의 ipynb 파일에서 노트북을 만드는 예제입니다.

CREATE NOTEBOOK mynotebook
 FROM '@my_db.my_schema.my_stage'
 MAIN_FILE = 'my_notebook_file.ipynb'
 QUERY_WAREHOUSE = my_warehouse;
Copy
언어: 한국어