작업 공간의 노트북 제한 사항

노트북 서비스 및 런타임

  • 노트북 서비스에는 200개의 활성 서비스 계정 제한이 적용됩니다.

  • 다른 작업 공간에 있는 노트북은 서비스를 공유할 수 없습니다.

  • 동일한 작업 공간에 있는 노트북은 기본적으로 공유 서비스에 연결됩니다.

  • 사용자는 작업 공간 내에서 여러 서비스를 생성하고 필요에 따라 노트북을 다른 서비스에 할당할 수 있습니다.

  • 노트북 서비스는 컨테이너 서비스 유지 관리를 위해 주말 동안 다시 시작될 수 있습니다. 다시 시작한 후 노트북을 다시 실행하고 모든 패키지를 다시 설치하여 변수와 패키지를 복원해야 합니다. 자세한 내용은 :ref:`서비스 유지 관리 <label-nb_in_ws_service_maintenance>`를 참조하세요.

  • uv`와 표준 :code:`pip 간의 패키지 설치와 나열 동작은 다릅니다. Snowflake는 :code:`uv pip install`을 사용하여 패키지 설치를 지원하며, :code:`uv pip freeze`는 :code:`uv pip install`을 사용하여 설치된 패키지만 나열합니다. :code:`pip freeze`는 기본 이미지의 패키지, 표준 pip install로 설치된 패키지, :code:`uv pip install`로 설치된 패키지를 포함하여 해당 환경에서 사용 가능한 모든 패키지를 나열합니다.

  • 외부 스테이지에서 패키지를 설치하는 기능은 지원되지 않습니다.

작업 공간에서 노트북 사용하기

  • 커널을 종료할 때까지 SQL 셀은 Query History 창에 표시되지 않습니다.

    1. Connected 을 선택합니다.

    2. Shut down kernel 을 선택합니다.

    3. 노트북 서비스를 일시 중단합니다.

  • 노트북 파일, 폴더 또는 작업 공간의 이름을 바꾸면 서비스 연결 해제, 노트북의 출력 캐시 지우기 또는 참조된 파일 업데이트 지연 등 예기치 않은 동작이 발생할 수 있습니다.

  • 연결이 해제된 경우 노트북을 다시 연결해 보세요. 작업 공간의 이름을 바꾼 경우 새 서비스를 생성하고 사용합니다.

  • 계정 세션 정책이 보조 역할의 사용을 차단하는 경우 노트북은 공유 작업 공간에서 실행할 수 없습니다.

  • 셀별 렌더링은 현재 Git 통합 작업 공간에서 차이점을 보거나 공유 작업 공간에서 게시 기록을 볼 때 지원되지 않습니다. 전체 노트북 파일은 통합된 diff로 표시됩니다.

노트북 편집 및 실행하기

  • 노트북에서 가져온 Python 파일 업데이트(.py)는 활성 노트북 서비스에서 자동으로 감지되지 않습니다. 변경 사항을 적용하려면 파일 업데이트가 자동으로 감지되도록 초기 가져오기 전에 노트북 커널을 다시 시작하거나 :code:`%autoreload`를 사용합니다.

  • 각 셀의 출력 제한은 1MB입니다.

  • 이전 노트북 실행의 출력은 아직 :doc:`Tri-Secret Secure </user-guide/security-encryption-tss>`가 적용되지 않은 내부 저장소 시스템에 캐시되지 않습니다. 이 캐시에 대한 액세스는 미사용 시 암호화되며 캐시의 결과는 거버넌스 규칙에 의해 보호됩니다.

  • iPywidget은 아직 지원되지 않습니다.

  • Embedding remote images via URLs is not yet supported. To embed an image, upload it to your workspace and display it in a Markdown or Python cell. Example:

    ![My Image](path/to/example_image.png)
    
    from IPython.display import Image, display
    display(Image(filename="path/to/example_image.png"))
    
  • SQL 셀은 :doc:`EXECUTE NOTEBOOK PROJECT </sql-reference/sql/execute-notebook-project>`를 실행할 수 없습니다(비대화형 실행). 노트북을 연결하려면 동일한 Python 프로세스에서 다른 노트북을 실행하는 :code:`%run`과 같은 Jupyter 매직 명령을 사용합니다. 자세한 내용은 :ref:`Jupyter 매직 <label-nb_in_ws_edit_run_jupyter_magics>`을 참조하세요.

  • 작업 공간에서 노트북을 실행할 때 실행 컨텍스트(데이터베이스 및 스키마) 또는 쿼리 웨어하우스가 설정되어 있지 않으면 코드 셀과 셀 참조에 테이블 결과를 표시하기 위한 대화형 DataGrid가 올바르게 작동하지 않을 수 있습니다. 실행 컨텍스트 설정에 대한 자세한 내용은 실행 컨텍스트 설정 섹션을 참조하세요.

  • 다음 값은 열 이름으로 지원되지 않습니다.

    • CURRENT_DATE

    • CURRENT_TIME

    • CURRENT_TIMESTAMP

    • LOCALTIME

    • LOCALTIMESTAMP

    • CURRENT_USER

    • SESSION_USER

    • SYSTEM_USER

레거시 노트북에서 마이그레이션하기

레거시 노트북을 작업 공간으로 마이그레이션하는 방법에 대한 자세한 내용은 레거시 노트북을 작업 공간으로 마이그레이션하기 섹션을 참조하세요.