CREATE NOTEBOOK

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

구문

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

필수 매개 변수

name

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

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

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

선택적 매개 변수

FROM 'source_location'

지정된 스테이지 위치에 있는 .ipynb 파일 또는 비공개 노트북 에서 노트북을 만들도록 지정합니다.

  • 스테이지에 있는 파일로 노트북을 생성하려면 source_location 을 파일의 스테이지 위치로 설정하고 MAIN_FILE 매개 변수를 파일 이름으로 설정합니다.

  • 개인 노트북에서 노트북을 생성하려면(예를 들어, 개인 노트북을 공유 사용 가능으로 설정하려면) 이 매개 변수를 다음과 같이 설정합니다.

    'snow://notebook/USER$username.schema.notebook/versions/version$1/'

    여기서

    • username 은 사용자 이름입니다.

    • schema 는 비공개 노트북이 포함된 스키마의 이름입니다.

    • notebook 은 비공개 노트북의 이름입니다.

    검은색 Snowflake 로고(텍스트 없음) 미리 보기 기능 — 공개

    비공개 노트북은 모든 계정이 사용할 수 있는 기능입니다.

이 매개 변수를 지정하지 않으면 템플릿 노트북에서 노트북 오브젝트가 만들어집니다.

MAIN_FILE = 'main_file_name'

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

QUERY_WAREHOUSE = warehouse_name

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

IDLE_AUTO_SHUTDOWN_TIME_SECONDS = number_of_seconds

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

기본값: 3,600초

액세스 제어 요구 사항

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

권한

오브젝트

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
언어: 한국어