Snowflake Notebooks 설정¶

location¶

위치는 노트북 오브젝트가 저장된 위치입니다. 최종 사용자는 자신의 역할에 액세스 권한이 있는 모든 데이터베이스 및 스키마를 쿼리할 수 있습니다.

• 컨텍스트를 다른 데이터베이스 또는 스키마로 변경하려면 SQL 셀에서 USE DATABASE 또는 USE SCHEMA 명령을 사용합니다.

컨테이너 런타임에서 노트북을 만드는 역할에는 스키마에 대한 CREATE SERVICE 권한도 필요합니다.

스키마를 소유한 역할은 자동으로 해당 스키마 내에서 노트북을 만들 수 있는 권한을 갖게 되는데, 소유자는 노트북을 포함한 모든 유형의 오브젝트를 만들 수 있기 때문입니다.

모든 사람이 특정 위치에 노트북을 만들 수 있도록 허용하기¶

다음 단계에서는 데이터베이스와 스키마에 사용 권한을 부여해 특정 위치에 노트북을 만들기 위한 액세스를 구성하는 방법을 간략하게 설명합니다. 또는 이러한 액세스 권한 부여가 필요 없는 비공개 노트북을 사용 설정할 수도 있습니다. 비공개 노트북에 대한 자세한 내용은 비공개 노트북 섹션을 참조하십시오.

<database> 및 <database.schema>를 노트북을 생성할 특정 데이터베이스와 스키마로 바꿉니다.

----------------------------------
--       Location Setup         --
----------------------------------
GRANT USAGE ON DATABASE <database> TO ROLE PUBLIC;
GRANT USAGE ON SCHEMA <database.schema> TO ROLE PUBLIC;
GRANT CREATE NOTEBOOK ON SCHEMA <database.schema> TO ROLE PUBLIC;

-- For Notebooks on Container runtime, run the following:
GRANT CREATE SERVICE ON SCHEMA <database.schema> TO ROLE PUBLIC;

----------------------------------
--    Compute Resource Setup    --
----------------------------------
GRANT USAGE ON WAREHOUSE <warehouse> TO ROLE PUBLIC;

-- For Notebooks on Container runtime:
CREATE COMPUTE POOL CPU_XS
  MIN_NODES = 1
  MAX_NODES = 15
  INSTANCE_FAMILY = CPU_X64_XS;

CREATE COMPUTE POOL GPU_S
  MIN_NODES = 1
  MAX_NODES = 5
  INSTANCE_FAMILY = GPU_NV_S;

GRANT USAGE ON COMPUTE POOL CPU_XS TO ROLE PUBLIC;
GRANT USAGE ON COMPUTE POOL GPU_S TO ROLE PUBLIC;

-------------------------------------
-- Optional: External Access --
-------------------------------------

-- Example EAI
CREATE OR REPLACE NETWORK RULE allow_all_rule
MODE = 'EGRESS'
TYPE = 'HOST_PORT'
VALUE_LIST = ('0.0.0.0:443','0.0.0.0:80');

CREATE OR REPLACE EXTERNAL ACCESS INTEGRATION allow_all_integration
ALLOWED_NETWORK_RULES = (allow_all_rule)
ENABLED = true;

GRANT USAGE ON INTEGRATION allow_all_integration TO ROLE PUBLIC;

전담 역할 만들기¶

특정 사용자만 노트북을 만들게 하려면(아직 스키마를 소유하지 않았다고 가정할 때) 액세스 제어를 위한 전용 역할을 만들 수 있습니다. 예:

CREATE ROLE notebooks_rl;

ROLE notebook_rl을 특정 사용자에게 부여합니다. 그런 다음 위의 스크립트를 사용하여 리소스를 만들고 이 역할에 권한을 부여합니다(ROLE PUBLIC 을 ROLE notebook_rl로 바꿈).

노트북 엔진¶

노트북 엔진(“커널”)과 Python 프로세스는 노트북 웨어하우스에서 실행됩니다. Snowflake는 크레딧 소모를 최소화하기 위해 X-Small 웨어하우스로 시작할 것을 권장합니다.

노트북을 사용하는 동안(예: 코드 편집, 실행, 재정렬, 셀 삭제) 또는 노트북이 유휴 시간 제한 설정 내에서 계속 활동 중인 경우, 노트북 엔진이 활성화되어 있고 노트북 세션이 사용 중임을 나타내는 EXECUTE NOTEBOOK 쿼리가 계속 실행됩니다. 이 쿼리의 상태는 Query history 에서 확인할 수 있습니다. EXECUTE NOTEBOOK 이 실행되는 동안에는 노트북 웨어하우스도 실행됩니다. EXECUTE NOTEBOOK 이 완료되면 웨어하우스에서 실행 중인 다른 쿼리나 작업이 없는 경우 자동 일시 중단 정책에 따라 종료됩니다.

EXECUTE NOTEBOOK 쿼리를 종료(노트북 세션 종료)하려면 다음 단계를 따르십시오.

1. Active 를 선택하거나 Active 드롭다운 메뉴에서 End session 을 선택합니다.

2. Query history 에서 해당 EXECUTE NOTEBOOK 쿼리를 찾아 Cancel query 를 선택합니다.

3. 유휴 시간 설정에 따라 노트북이 비활성으로 인해 시간 초과되도록 합니다. 노트북 웨어하우스의 STATEMENT_TIMEOUT_IN_SECONDS 및 STATEMENT_QUEUED_TIMEOUT_IN_SECONDS 매개 변수가 작은 값으로 설정되어 있으면 사용자 활동과 관계없이 노트북이 빠르게 종료되거나 시작되지 않을 수 있습니다.

쿼리¶

SQL 및 Snowpark 쿼리(예: 세션.sql)는 온디맨드에 사용되는 쿼리 웨어하우스로 푸시됩니다. SQL 및 Snowpark 쿼리 실행이 완료되면 노트북 외부에서 다른 작업이 실행되고 있지 않으면 쿼리 웨어하우스가 일시 중단됩니다. 쿼리 성능 요구 사항에 가장 적합한 웨어하우스 크기를 선택합니다. 예를 들어, 대규모 SQL 쿼리를 실행하거나 더 큰 웨어하우스가 필요한 계산 집약적 작업을 수행하려면 Snowpark Python을 사용해야 할 수 있습니다. 높은 메모리 사용량이 필수 작업의 경우 Snowpark에 최적화된 웨어하우스 를 사용하는 것이 좋습니다.

쿼리 웨어하우스는 Notebook Settings 에서 변경할 수 있습니다. 또는 노트북의 SQL 셀에서 다음 명령을 실행해 현재 노트북 세션의 모든 후속 쿼리에 대한 쿼리 웨어하우스를 변경할 수 있습니다.

USE WAREHOUSE <warehouse_name>;

유휴 시간 및 재접속¶

각 노트북에는 기본값이 30분인 IDLE_AUTO_SHUTDOWN_TIME_SECONDS 라는 유휴 시간 속성이 있습니다. Snowsight 에서 각 노트북의 유휴 시간을 구성할 수 있습니다.

1. Snowsight 에 로그인합니다.

2. Projects » Notebooks 를 선택합니다.

3. 세로 줄임표 메뉴를 선택하여 새 시간을 구성합니다.

4. Notebook settings 를 선택합니다.

5. 새로운 유휴 시간을 적용하려면 세션을 수동으로 다시 시작해야 합니다.

코드 편집, 셀 실행, 셀 재정렬, 셀 삭제 등 사용자 활동이 없을 때마다 유휴 시간이 누적됩니다. 활동을 재개할 때마다 유휴 시간이 초기화됩니다. 유휴 시간이 시간 제한 설정에 도달하면 노트북 세션이 자동으로 종료됩니다.

유휴 시간 제한 전에 페이지를 새로 고치거나 Snowsight 의 다른 부분을 방문하거나 컴퓨터를 종료하거나 절전 모드로 전환하더라도 노트북 세션은 유휴 시간 제한 기간에 도달할 때까지 활성 상태로 유지됩니다. 같은 노트북을 다시 열면 모든 세션 상태와 변수가 유지된 상태에서 동일한 세션에 다시 연결되므로 작업을 원활하게 이어갈 수 있습니다. 단, Streamlit 위젯의 상태는 유지되지 않는다는 점에 유의하십시오.

동일한 노트북을 실행하는 각 사용자는 각자의 독립적인 세션을 갖게 됩니다. 서로 간섭하지 않습니다.

비용 최적화를 위한 권장 사항¶

계정 관리자는 노트북 운영 비용을 관리하기 위해 다음 권장 사항을 고려하십시오.

• 팀에게 노트북 세션을 실행하는 전용 ‘노트북 웨어하우스’로 동일한 웨어하우스(X-Small 권장)를 사용해 동시성을 높이도록 요청하십시오. 너무 많은 노트북을 동시에 실행할 경우 세션 시작 속도가 느려지거나(웨어하우스에 큐에 대기) 메모리 부족 오류가 발생할 수 있다는 점에 유의하십시오.

• 팀에서 STATEMENT_TIMEOUT_IN_SECONDS 값이 낮은 웨어하우스를 사용하여 노트북을 실행하도록 허용하십시오. 이 웨어하우스 매개 변수는 노트북 세션을 포함해 모든 쿼리의 지속 시간을 제어합니다. 예를 들어, 매개 변수를 10분으로 설정하면 해당 시간 동안 사용자가 노트북 세션에서 활동 중인지 여부에 관계없이 노트북 세션이 최대 10분 동안 실행될 수 있습니다.

• 팀원들이 세션에서 적극적으로 작업할 의사가 없을 때는 노트북 세션을 종료하도록 요청하십시오.

• 장시간 세션을 실행할 필요가 없는 경우 팀에 유휴 시간 제한 설정을 최소화(예: 15분으로)하도록 요청하십시오.

• 또는 지원 티켓을 제기하여 전체 계정에 적용되는 유휴 시간 기본값을 설정할 수 있습니다. 이 값은 노트북 소유자가 노트북 수준에서 재정의할 수 있습니다.