Snowpark Checkpoints 사용을 위한 IDE 설정하기¶
Snowflake Extension for Visual Studio Code 는 프레임워크 사용 환경을 개선하기 위해 Snowpark Checkpoints 라이브러리에 대한 지원을 제공합니다. 코드에 삽입된 collect 및 validate 문을 세밀하게 제어할 수 있을 뿐만 아니라 변환된 코드의 동작 동등성 어설션의 상태를 검토할 수 있습니다.
Snowpark Checkpoints 활성화하기¶
Snowpark Checkpoints를 활성화하려면 Snowflake의 확장 프로그램 설정으로 이동하여 Snowpark Checkpoints: Enabled 를 확인하십시오.
뷰¶
앞서 설명한 대로 Snowpark Checkpoints 속성을 Enabled 로 설정하면 확장 프로그램에서 SNOWPARK CHECKPOINTS 라는 새 탭이 열립니다. 작업 공간의 모든 검사점을 표시하고 전체 또는 개별적으로 활성화/비활성화, 파일에서 모두 지우기 등 여러 작업을 수행할 수 있으며, 각 검사점을 더블 클릭하면 해당 검사점이 정의된 파일과 코드 줄로 이동합니다.
모든 검사점 전환하기¶
Snowpark Checkpoints 탭의 오른쪽 상단에 위치한 이 옵션은 모든 검사점에서 활성화된 속성을 전환합니다.
활성화된 검사점:
검사점을 비활성화하면 런타임에 건너뛰게 됩니다.
모든 검사점 정리하기¶
Snowpark Checkpoints 탭의 오른쪽 상단에 위치합니다. 이렇게 하면 작업 영역의 Jupyter 노트북을 포함한 모든 Python 파일에서 검사점이 제거되지만, 계약과 패널에서는 삭제되지 않습니다. 즉, Snowflake: Restore All Checkpoints 명령을 사용하여 복원할 수 있습니다.
파일에 검사점 삽입하기¶
파일 내부를 마우스 오른쪽 버튼으로 클릭하면 Snowpark Checkpoints 옵션이 포함된 컨텍스트 메뉴가 표시되어 Collection 및 Validation 검사점을 추가할 수 있습니다.
컨텍스트 메뉴의 Snowpark Checkpoints 옵션:
수집기/검증기를 추가했습니다.
단일 검사점 실행하기¶
각 검사점 위에 표시된 코드 렌즈 옵션을 클릭하여 단일 검사점을 실행할 수 있습니다. 실행하면 진행 상황을 보여주는 출력 콘솔이 나타나고 완료되면 결과 뷰가 나타납니다. 컨트랙트 파일에서 검사점이 비활성화되어 있어도 실행 시에는 활성화됩니다.
컨트랙트 파일에 진입점이 선언되지 않은 경우 오류 메시지 Entry point not found for the checkpoint. 가 표시됩니다.
파일에서 활성화된 모든 Snowpark Checkpoints 실행하기¶
각 파일의 오른쪽 상단에 Run all checkpoints from the current file 버튼이 표시됩니다.
클릭하면 실행 진행 상황을 표시하는 출력 채널이 나타납니다.
타임라인 뷰¶
검사점 실행 결과의 타임라인을 표시합니다.
명령¶
다음 명령은 Snowpark Checkpoints에 사용할 수 있습니다. 이를 사용하려면 명령 팔레트에 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”.