Snowpark Checkpoints 사용을 위한 IDE 설정하기¶
Visual Studio Code용 Snowflake 확장 프로그램</user-guide/vscode-ext>`은 프레임워크 사용 환경을 개선하기 위해 Snowpark Checkpoints 라이브러리를 지원합니다. 코드에 삽입된 :code:`collect 및 validate
문을 세밀하게 제어할 수 있으며, 변환된 코드의 동작 동등성 어설션 상태도 검토합니다.
Snowpark Checkpoints 활성화하기¶
Snowpark Checkpoints를 활성화하려면 Snowflake 확장 프로그램 설정에서 :ui:`Snowpark Checkpoints: Enabled`를 선택합니다.

뷰¶
Snowpark Checkpoints 속성을 :ui:`Enabled`로 설정하면 :ui:`SNOWPARK CHECKPOINTS`라는 확장 프로그램에서 새 탭이 열립니다. 여기에서 작업 공간의 모든 검사점을 표시하고, 전체 또는 개별 검사점을 활성화/비활성화하거나 파일에서 모든 검사점을 지우는 등의 여러 작업을 수행할 수 있습니다. 각 검사점을 두 번 클릭하면 검사점이 정의된 파일과 코드 줄로 이동합니다.
모든 검사점 전환하기¶
모든 검사점을 활성화하거나 비활성화하려면 Snowpark Checkpoints 탭의 오른쪽 상단에서 이 컨트롤을 선택합니다.

활성화된 검사점:

런타임 시 비활성화된 검사점은 건너뜁니다.

모든 검사점 제거하기¶
작업 영역에서 Jupyter 노트북을 포함한 모든 Python 파일의 검사점을 제거하려면 Snowpark Checkpoints 탭의 오른쪽 상단에서 이 컨트롤을 선택합니다.

컨트롤은 컨트랙트 및 패널에서 검사점을 제거하지 않습니다. Snowflake: Restore All Checkpoints
명령을 사용하여 복원할 수 있습니다.
파일에 검사점 삽입하기¶
파일에 검사점을 삽입하려면 마우스 오른쪽 버튼으로 파일 내부를 클릭하고 Snowpark Checkpoints 메뉴에서 Add Collection Checkpoint 또는 :ui:`Add Validation Checkpoint`를 선택합니다.
Snowpark Checkpoints 메뉴 및 옵션:

수집기/검증기를 추가했습니다.

단일 검사점 실행하기¶
단일 검사점을 실행하려면 검사점 위에 표시된 코드 렌즈 옵션을 선택합니다.

검사점을 실행하면 진행 상황과 결과 뷰를 표시하는 출력 콘솔이 열립니다. 컨트랙트 파일에서 검사점이 비활성화되어 있더라도 실행할 경우 활성화됩니다.
컨트랙트 파일에 진입점이 선언되지 않은 경우 Entry point not found for the checkpoint. 오류 메시지가 표시됩니다.

파일에서 활성화된 모든 Snowpark Checkpoints 실행하기¶
파일에서 활성화된 모든 검사점을 실행하려면 파일의 오른쪽 상단에서 :ui:`Run all checkpoints from the current file`을 선택합니다.

출력 채널에 진행 상황이 표시됩니다.

타임라인 뷰¶
검사점 실행 결과의 타임라인을 표시합니다.

명령¶
Snowpark Checkpoints에 사용할 수 있는 명령은 다음과 같습니다. 사용하려면 명령 팔레트에 :code:`Snowflake: [command name]`를 입력하세요.
명령 |
설명 |
---|---|
Snowflake: 검사점 전환 |
모든 검사점의 활성화 속성을 전환합니다. |
Snowflake: Snowpark Checkpoints 프로젝트 초기화 |
프로젝트 초기화를 트리거하고, 컨트랙트 파일이 없으면 만듭니다. 파일이 있으면 검사점을 컨트랙트 파일에 로드할지 여부를 묻는 메시지가 표시됩니다. |
Snowflake: 모든 검사점 지우기 |
작업 공간의 모든 파일에서 모든 검사점을 삭제합니다. |
Snowflake: 모든 검사점 복원 |
컨트랙트 파일에 여전히 존재하는 파일에서 이전에 삭제한 검사점을 복원합니다. |
Snowflake: 검증/수집 검사점 추가 |
커서 위치에 필수 매개 변수가 있는 검증기 또는 수집기를 추가합니다. |
Snowflake: Snowpark Checkpoints 뷰에 집중하기 |
패널 SNOWPARK CHECKPOINTS 로 초점을 이동합니다. |
Snowflake: 검사점 타임라인 열기 |
검사점 실행 타임라인을 표시합니다. |
Snowflake: 현재 파일에서 모든 검사점 실행 |
현재 파일에서 활성화된 모든 검사점을 실행합니다. |
Snowflake: 작업 공간의 모든 검사점 실행 |
작업 영역에서 활성화된 모든 검사점을 실행합니다. |
Snowflake: Snowpark Checkpoints 결과 모두 보기 |
모든 검사점 결과가 포함된 탭을 표시합니다. |
경고¶
중복: 컬렉션 프로젝트에서 두 검사점의 이름이 같으면 *”Another checkpoint with an identical name has been detected and will be overwritten.”*이라는 경고가 표시됩니다.
유효성 검사 프로젝트에는 이름이 같은 검사점이 여러 개 있을 수 있으므로 경고가 표시되지 않습니다.
잘못된 타입: 프로젝트 타입과 다른 타입의 검사점을 추가하면 밑줄이 그어진 다음의 오류 메시지가 표시됩니다. “Please make sure you are using the correct Snowpark-Checkpoints statement. This particular checkpoint statement is different from the others used in this project, statements that don’t match the project type will be ignored when executed.”
유효하지 않은 검사점 이름: 검사점 이름 매개 변수를 추가하는 방법이 잘못되었습니다. 이 경우, *”Invalid checkpoint name. Checkpoint names must start with a letter and can only contain letters, numbers, hyphens, and underscores”*라는 경고가 표시됩니다.