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

노트북 서비스 및 런타임

  • 노트북 서비스에는 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은 아직 지원되지 않습니다.

  • 마크다운 셀에 이미지를 삽입하거나 URLs를 통해 원격 이미지를 사용하는 기능은 아직 지원되지 않습니다.

    노트북에 이미지를 삽입하려면 이미지를 작업 공간에 업로드하고 Python 셀을 사용하여 표시합니다. 예를 들면 다음과 같습니다.

    from IPython.display import Image, display
display(Image(filename="path/to/example_image.png"))
    Copy

    더 깔끔하게 표시하려면 코드 셀을 축소하여 이미지 결과만 표시할 수 있습니다.

  • 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가 올바르게 작동하지 않을 수 있습니다. 실행 컨텍스트 설정에 대한 자세한 내용은 실행 컨텍스트 설정 섹션을 참조하세요.

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

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