지리 시계열 동기화 출력
지리 시계열 동기화는 배치 또는 스트리밍 데이터를 관측으로 변환하여 Map 같은 하위 애플리케이션에 전달합니다. 관측은 특정 시계열의 시각과 위치를 포함하며 필요하면 고도와 업무 속성을 더합니다.
플랫폼 인스턴스에서 지리 시계열 기능이 활성화되어 있어야 합니다. 출력 유형이 보이지 않으면 Palantir 담당자에게 해당 인스턴스의 기능 활성화 여부를 확인합니다.
출력과 필수 필드
오른쪽 Pipeline outputs 패널에서 Add > Geotemporal series sync > Add를 선택합니다. 상위 변환에서 다음 열을 만든 뒤 출력의 기본 필드에 매핑합니다.
| 필드 | 자료형과 의미 |
|---|---|
| Series ID | 각 트랙을 구분하는 문자열입니다. 예를 들어 비행 하나를 식별하는 ID를 사용합니다. 서로 다른 비행이 같은 시계열로 섞이지 않도록 정합니다. |
| Timestamp | 해당 관측이 발생한 시각입니다. |
| Position | 관측 당시의 위치인 GeoPoint입니다. 위도와 경도에서 Construct geopoint column 표현식으로 만들 수 있습니다. |
| Altitude | 선택적인 Double 값입니다. 지표면 기준 높이를 미터 단위로 나타냅니다. |
추가 속성
Properties > Add Property에서 상위 결과 열을 추가 속성으로 연결합니다. 이름과 live/static 여부를 지정하고 필요하면 설명을 입력합니다.
- Live 속성은 관측마다 달라집니다. 예를 들어 항공기의 진행 방향을 기록합니다.
- Static 속성은 시계열 전체에서 일정하며 검색과 필터를 위한 비정규화 정보로 사용합니다. 예를 들어 항공기 유형을 기록합니다.
일반 자료형 외에도 GeoPoint와 Geometry를 매핑할 수 있습니다. 추가 GeoPoint는 기본 Position과 다른 위치일 수 있으며, Geometry는 지도에 표시할 GeoJSON 도형을 나타냅니다.
좌표 구조와 도형 정규화는 지리 공간 자료형의 조건을 따릅니다.
고급 설정
| 설정 | 의미와 제약 |
|---|---|
| Time to live | 데이터가 오래되거나 만료된 것으로 간주될 때까지의 기간입니다. 밀리초 단위 long이며 hot storage에만 적용합니다. 오래된 관측은 하위 애플리케이션에 표시하지 않습니다. |
| Observation type | GPS ping, manual report 같은 논리 분류의 문자열입니다. 하위 애플리케이션의 필터에 사용할 수 있습니다. |
| Style configuration | 아이콘 크기, 불투명도, 회전, symbology, 제목, 도형 선 너비, 도형 색, 채우기, 도형 불투명도와 트랙 색을 설정합니다. |
| Observation schema | 기존 관측 스키마를 선택하면 관련 필드가 미리 채워집니다. 이전 소비자와의 호환성을 위해 기존 필드를 삭제하거나 변경하거나 live/static을 바꿀 수 없습니다. 선택하지 않으면 첫 성공 배포 때 새 스키마가 생성됩니다. |
| Source system | 여러 동기화를 묶는 그룹입니다. 기존 그룹을 선택하면 성공 배포 때 이 통합을 그 그룹에 upsert하고 기존의 다른 통합은 변경하지 않습니다. 선택하지 않으면 첫 성공 배포 때 새 그룹을 만듭니다. 기본적으로 같은 파이프라인의 모든 지리 시계열 출력은 해당 파이프라인의 한 source system으로 묶입니다. |
| Destination namespace | 지리 시계열 출력용 namespace에 둘 이상 접근할 수 있을 때 대상 namespace를 선택합니다. 추가 대상 구성은 Palantir 담당자와 확인합니다. |
Hot storage와 cold storage
Hot storage가 기본값입니다. 실시간 조회에 맞춰져 있으며 일정 기간이 지난 관측 데이터는 저장소에서 삭제됩니다.
Cold storage는 Foundry 데이터셋에 관측을 보관하고 데이터 보존 정책을 따릅니다. 장기적인 지리 시계열 조회가 필요할 때 사용합니다.
일부 워크플로는 cold storage의 관측 읽기를 제한적으로 지원합니다. 필요한 하위 애플리케이션에서 이 경로를 지원하는지 Palantir 지원팀과 확인해야 합니다.
보안 통제의 상속
필수 접근 통제
하위 관측은 Pipeline Builder의 지리 시계열 출력 데이터셋에 적용된 최신 출력 트랜잭션 또는 streaming view의 보안을 따릅니다. 이 자산은 입력 데이터셋에서 상속한 필수 보안 표지와 분류를 전파합니다.
입력의 보안 표지가 두 빌드 사이에 바뀌면 다음 빌드는 실패합니다. 이미 통합한 관측의 보안 표지가 의도하지 않게 바뀌는 것을 막기 위한 동작입니다. 변경된 표지를 적용해야 한다면 적절한 보안 표지를 가진 지리 시계열 출력을 삭제 후 다시 생성해야 합니다.
모든 입력에 적용된 조직은 해당 출력의 destination namespace에 접근할 수 있어야 합니다. 출력에 있는 조직 보안 표지 집합은 namespace에 접근하는 조직 집합을 포함해야 합니다. 여러 입력과 대상 namespace의 조직 범위를 함께 맞춥니다.
재량적 접근 통제
처음 배포할 때 상위 프로젝트에서 read 이상 권한을 가진 모든 그룹이 하위 지리 시계열 출력의 view 접근을 받습니다. 이후 프로젝트의 재량 권한을 바꾸어도 이미 만들어진 관측으로 자동 전파되지 않습니다.
더 세밀한 그룹별 접근 통제가 필요하면 Palantir 담당자에게 해당 지리 시계열 워크플로의 구성을 요청합니다. 프로젝트 권한 변경만으로 하위 접근이 갱신될 것으로 기대하지 않습니다.
동기화 RID 찾기
그래프에서 지리 시계열 동기화 출력 노드를 선택합니다. Metadata > Geotemporal series integration RID에서 RID를 복사할 수 있습니다.
관측이 나타나지 않을 때
파이프라인을 배포하고 빌드를 시작한 뒤 관측이 하위 애플리케이션에 나타나지 않으면 다음 경로를 확인합니다.
- 오른쪽 출력의 점 세 개 메뉴에서
View backing dataset을 열고 관측 데이터가 실제 출력에 있는지 확인합니다. - 같은 출력 메뉴에서
View errors dataset을 열어 오류 행을 확인합니다. History에서 실행 중인 파이프라인 빌드의 로그와 런타임 실패를 확인합니다.- 하위 애플리케이션의 자산에 필요한 분류, 필수 보안 표지와 재량 접근 그룹이 구성되어 있는지 확인합니다.