Python 변환의 로컬 개발

로컬 개발에는 Palantir Visual Studio Code 확장 경로가 권장됩니다. 저장소를 clone하여 Gradle 명령으로 작업하는 경로도 지원합니다. 두 방식 모두 플랫폼에 job specification이나 아티팩트를 발행하려면 변경을 Foundry로 전달해야 합니다.

VS Code 확장

Visual Studio Code와 해당 인스턴스에서 제공하는 Palantir 확장을 설치합니다. 로컬 확장 및 Preview 허용은 플랫폼 관리자가 Control Panel에서 구성합니다. 플랫폼의 VS Code workspace에는 확장이 기본으로 활성화되어 있습니다.

확장에서는 다음 작업을 사용할 수 있습니다.

• 샘플에 한정하지 않는 전체 데이터셋 Preview를 수행합니다.
• 편집기에서 Foundry 빌드를 시작합니다.
• 코드를 디버깅하고 테스트를 실행합니다.
• Library 패널로 패키지를 추가합니다.

로컬 Preview에는 조직의 허용 설정과 모든 입력 데이터셋의 Download 권한이 필요합니다. 증분 변환은 기존 출력 데이터셋에도 같은 권한이 필요합니다. 이 권한은 전체 데이터를 로컬로 받을 수 있는 권한이므로 로컬 개발 보안 설정을 확인합니다.

인터프리터 연결

Import가 깨지거나 language server가 예상과 다르게 동작하면 인터프리터 자동 구성이 실패했는지 확인합니다. Command Palette의 Python: Select interpreter에서 저장소의 .maestro/bin/python 환경을 선택합니다.

.maestro는 Palantir: Install Python environment가 성공했을 때 만들어집니다. 다른 전역 Python을 선택하는 것과 저장소 환경을 사용하는 것은 다릅니다.

로컬 테스트 실행 파일은 다음과 같습니다.

.maestro/bin/pytest

pytest-transforms가 표준 규칙에 맞는 테스트를 발견합니다. 이 명령은 로컬 테스트이며 플랫폼 CI 발행의 성공을 대신하지 않습니다.

Clone과 Gradle 경로

먼저 저장소를 최신 템플릿으로 업그레이드합니다. 로컬 개발 터미널에는 CI, JEMMA, CA 환경 변수가 설정되어 있지 않아야 합니다.

Apple silicon Mac에서는 이 경로에 Rosetta 2가 필요합니다. 아직 없다면 다음 설치 명령으로 안내를 확인할 수 있습니다.

/usr/sbin/softwareupdate --install-rosetta

--agree-to-license를 추가하면 약관을 자동 승인하므로, 해당 약관과 조직의 설치 정책을 확인한 경우에만 그 비대화형 옵션을 사용합니다.

저장소 주소

Code Repositories 메뉴에서 Data lineage 오른쪽의 데스크톱 아이콘 또는 Work locally를 엽니다.

제공한 Git remote URL로 원하는 로컬 디렉터리에 clone한 뒤 저장소로 이동합니다. URL에는 계정에 연결된 인증 정보가 포함될 수 있으므로 다른 사람에게 공유하거나 공개 로그에 남기지 않습니다.

이 clone 토큰은 짧게 유지되며 7일마다 갱신해야 합니다. JobSpec 및 아티팩트 발행과 플랫폼 checks 및 빌드는 변경을 push한 뒤 수행합니다. 로컬 VS Code 확장에서 원격 빌드를 시작하는 기능과 로컬 Python 계산을 구분합니다.

데이터셋의 로컬 Preview는 공통 로컬 실행 안내의 입력 권한과 설정을 따릅니다.