Object Storage v1에서 v2로 이전
Object Storage v1(Phonograph)에 남아 있는 객체 유형과 조인 테이블을 사용하는 다대다 링크 유형은 Object Storage v2로 이전해야 합니다. Ontology Manager가 이전 절차를 제공합니다. 신규 온톨로지나 이미 이전을 완료한 온톨로지에서는 OSv2만 사용하므로 이전 선택지가 나타나지 않습니다.
이전 대상이 남아 있는 온톨로지는 유형을 단계적으로 옮길 수 있으며, 모든 유형을 한꺼번에 이전할 필요는 없습니다. 이전 도구는 V1과 V2 유형이 함께 있는 동안의 운영을 지원합니다. OSv1의 지정된 지원 종료일은 2026년 6월 30일이므로 남은 대상과 지원 조건은 Palantir Support와 확인해야 합니다.
시작 전 변경 동결과 편집 중단
Funnel 대체 파이프라인(Replacement pipeline)이 필요한 정의 변경은 진행 중인 이전을 중단합니다. 필요한 스키마 변경은 먼저 끝내고, 이전과 관찰 기간 전체에서 객체 유형의 스키마를 안정적으로 유지해야 합니다.
Ontology Manager에서 저장한 정의는 Phonograph 등록에 동기적으로 반영되지만 Funnel은 비동기적으로 감지합니다. 따라서 이전 시작이나 중단 같은 상태가 화면에 보이기까지 몇 초 지연될 수 있습니다.
Phonograph 편집 API를 직접 사용하는 호출은 액션으로 옮깁니다. 기존 사용자 편집이 있는 유형에서는 비호환 사용을 확인한 뒤 Datasources의 Only allow edits via actions를 켜야 이전할 수 있습니다.
이전 정의를 만든 순간부터 전체 이전과 관찰 기간이 끝날 때까지 사용자 편집은 자동으로 비활성화됩니다. 새 편집을 제출할 수 없지만 객체 읽기는 계속 사용할 수 있습니다.
이력과 Decimal 속성 확인
편집 이력과 작성자 정보(Attribution)를 보존할지 선택합니다. 보존하면 처리와 저장 비용이 추가됩니다. 선택하지 않으면 객체별 최신 편집 상태만 옮기고 전체 이력과 작성자 정보는 보존하지 않습니다. 이전 완료 뒤 원래의 전체 이력을 복구할 수 없으며, 액션 로그는 이와 별도로 남는 기록입니다.
Decimal 속성에 정밀도나 소수 자릿수가 없거나 기반 열과 맞지 않으면 다음 오류가 발생할 수 있습니다.
The current version of the object type has an invalid definition which Object Storage v2 is unable to index. ObjectsDataFunnel:DecimalPropertyTypeMissingPrecisionOrScalePrecision does not match backing column.Scale does not match backing column.
Ontology Manager의 Properties에서 해당 속성을 선택하고 Precision과 Scale을 설정합니다. Fix를 사용하면 기반 데이터에 맞는 값을 자동으로 설정합니다.
비호환 사용 분석
Incompatible usage 알림은 최근 30일의 비호환 호출을 보여 줍니다. 해당 화면에 접근할 수 없다면 Palantir 담당자에게 기능 활성화를 문의합니다.
일부 Phonograph 직접 호출은 이전 시작을 막지 않지만, 이전을 마친 후 실패합니다.
읽기 호출은 OSS, 편집은 Actions, 유형 메타데이터는 OMS로 옮깁니다. 더 이상 사용하지 않거나 실패해도 업무 영향이 없는 호출이라면 그 영향을 확인한 뒤 이전을 시작할 수 있습니다.
Only allow edits via actions를 켜지 않은 경우처럼 이전 자체를 차단하는 조건은 먼저 해소해야 합니다.
비호환 사용과 호환성을 깨는 변경이 없으면 준비 완료 표시가 나타납니다.
대상 선택과 이전 시작
객체 유형이나 조인 테이블 기반 다대다 링크 유형의 Datasources에서 Indexing Metadata를 엽니다. 이전할 수 있는 대상이면 Object Storage v2 선택지가 이전 설정 마법사를 엽니다.
이 구역이 없으면 모든 객체 유형과 조인 테이블 링크 유형에 OSv2를 강제하는 온톨로지인지 확인합니다. OMS가 기록한 비호환 사용 경고와 대상 스키마의 기능 차이를 먼저 해결해야 합니다.
전환 시간대
Transition windows에서 사용량이 적은 요일과 시간대를 선택할 수 있습니다. 이전을 시작한 뒤 첫 Funnel 파이프라인이 시작되기까지 최대 30분 걸릴 수 있습니다.
첫 OSv2 동기화가 성공한 다음 전환 시간대를 계산합니다. 그 시점에 이미 진행 중인 시간대는 선택 대상이 아닙니다. 첫 전환 시간대 안에서 전환을 마칠 수 없으면 OSS는 다음 시간대까지 기다렸다가 OSv2를 읽기 시작합니다. 시간대를 지정하지 않으면 첫 Funnel 파이프라인 성공 후 전환을 시작합니다.
관찰 기간과 되돌리기
관찰 기간(Soak period)에는 V1과 V2 인덱스를 함께 최신 상태로 유지합니다. 전환 시간대를 통과한 뒤 시작하며, 일 단위로 최대 14일까지 설정할 수 있고 시간 단위 지정도 가능합니다.
이 기간의 온톨로지 질의는 자동으로 OSv2에 전달하며 OSv1 직접 요청은 거부합니다. 실제 읽기 워크플로가 동작하는지 확인할 수 있습니다. 성능 저하나 오류가 발견되면 진행 중인 이전을 중단하여 재인덱싱 없이 OSv1로 돌아갈 수 있습니다.
이중 인덱싱에는 추가 컴퓨팅과 저장 사용량이 발생합니다. 0일로 설정하면 OSv2 인덱스가 준비되고 전환 시간대가 활성화되는 즉시 OSv1 인덱스를 삭제합니다. 관찰 기간이 끝난 뒤에는 OSv1로 롤백할 수 없습니다.
쓰기용 데이터셋을 구체화로 이전
OSv1은 사용자 편집을 위해 쓰기용 데이터셋을 요구하지만 OSv2에서는 구체화 데이터셋이 선택 사항입니다. 후속 앱이나 파이프라인이 기존 쓰기용 데이터셋을 사용한다면 구체화로 이전하는 옵션을 선택합니다.
구체화 데이터셋은 기존 열을 유지하여 후속 파이프라인과의 호환성을 보존합니다. 다만 객체 속성에 매핑하지 않은 열은 이전 중 제거됩니다.
이 옵션을 선택하지 않아도 사용자 편집은 OSv2로 이전합니다. 기존 데이터셋 자체를 삭제하지는 않지만, 마지막 빌드 시점의 데이터를 가진 정적 상태로 남아 이후 편집을 반영하지 않습니다.
동기화 실패와 일괄 이전
동기화가 실패하면 Datasources의 Indexing Metadata에 PIPELINE_FAILED 오류가 나타납니다. 실패한 Funnel 배치 파이프라인을 열어 오류 원인을 확인하고, 필요한 데이터나 설정을 수정해야 합니다.
여러 유형을 함께 옮기려면 왼쪽 탐색 메뉴의 Object types에서 여러 객체 유형을 선택합니다. 단일 유형과 같은 마법사로 공통 전환 시간대와 관찰 기간을 지정합니다. 예상하지 못한 복잡도를 줄이기 위해 한 번에 100개 미만의 엔터티를 단계적으로 이전하는 방식이 권장됩니다. 이는 일괄 이전의 강제 최대값과는 다릅니다.