지리 시계열을 온톨로지에 연결
Pipeline Builder에서 관측을 색인하는 지리 시계열 동기화(geotemporal series sync)와 대상을 표현하는 객체 유형을 만들고 지리 시계열 참조(GTSR) 속성으로 연결합니다. 객체에는 현재 위치나 호출 부호 등 업무 메타데이터도 둘 수 있습니다.
이 절차는 Gaia에서 시공간 경로를 사용하는 구성입니다. Foundry Map만 사용한다면 일반 시계열 기반 위치 모델을 먼저 검토합니다. Gaia는 Gotham이 있는 플랫폼 인스턴스에서 사용할 수 있습니다.
입력과 파이프라인
관측 모델에 맞는 series ID, 이벤트 Timestamp와 위치를 준비합니다. Series ID는 동기화와 객체 유형에서 같은 String 값을 사용해야 합니다. 숫자형 식별자를 복사한다면 두 경로에 같은 문자열 변환을 적용합니다.
- Pipeline Builder에서 New pipeline을 선택합니다.
- 이름과 저장 프로젝트를 정합니다.
- 실시간 갱신이 필요하면 Streaming pipeline을 선택하고 Create pipeline으로 생성합니다. 배치 파이프라인도 지리 시계열을 지원합니다.
- Add Foundry data에서 이미 수집한 데이터셋을 검색하고 +로 추가한 뒤 Add data를 선택합니다.
필요하면 Cast로 자료형을 맞추고 Create GeoPoint 또는 Construct GeoPoint column으로 위도 및 경도를 GeoPoint 열로 구성합니다.
시계열 동기화 출력
입력 또는 변환 노드를 선택하고 +에서 New geotemporal series sync를 추가합니다. 출력 목록의 Add > Geotemporal series sync > Add 경로도 사용할 수 있습니다. 이 항목이 보이지 않으면 플랫폼 인스턴스에 기능이 활성화되어 있는지 담당자에게 확인합니다.
Name and icon에서 이름과 아이콘을 정하고 Destination namespace를 선택합니다. Primary fields에는 다음 열을 매핑합니다.
| 필드 | 매핑 |
|---|---|
| Series ID | 관측을 같은 시계열로 묶는 String 열 |
| Timestamp | 위치를 기록한 이벤트 시각 열 |
| Position | GeoPoint 열 |
| Altitude | 선택적인 Double 미터 단위 높이 |
Properties에는 속도와 방향 등 추가 관측값을 매핑합니다. 이름, Live 또는 Static 여부와 필요한 설명을 정합니다. 추가 GeoPoint나 Geometry 속성도 사용할 수 있으며 기본 Position과 다른 위치를 나타낼 수 있습니다.
관측 스키마와 Live 설정
기존 Observation schema가 있으면 선택하여 필드를 불러옵니다. 호환성을 위해 기존 스키마 필드를 삭제하거나 변경하고 Live와 Static 사이에서 바꿀 수 없습니다. 기존 스키마를 선택하지 않으면 첫 배포 성공 시 매핑한 속성으로 새 스키마를 만듭니다.
관측마다 변하는 값은 Live로 둡니다. Static은 최신 값을 시계열의 모든 관측에 적용하는 성격이며 입력마다 값을 제공해야 합니다.
스타일과 저장
Styles에서 아이콘 크기, 불투명도, 회전, 기호, 제목과 도형의 폭, 색, 채움 및 경로 색 등을 설정할 수 있습니다. 배포 후 객체 유형의 기본 경로 스타일은 Ontology Manager의 Geometry styles에서도 편집할 수 있습니다.
저장 방식은 다음과 같습니다.
| 방식 | 역할 |
|---|---|
| Hot storage | 기본값. 실시간 접근용이며 일정 기간이 지나면 관측을 저장소에서 제거 |
| Cold storage | 보존 정책을 따르는 Foundry 데이터셋에 관측을 저장하여 장기 시공간 조회에 사용 |
Cold storage 읽기는 일부 업무 경로에서 지원이 제한되므로 필요한 조회 기능을 Palantir Support에 확인합니다. Time to live는 Hot storage에 적용되는 long형 밀리초 값입니다. 만료되거나 오래된 관측으로 간주한 데이터는 하위 앱에 표시하지 않습니다. 이 설정과 데이터셋 보존 정책은 구분합니다.
Observation type에는 GPS ping 또는 manual report 같은 논리적 분류 문자열을 지정할 수 있습니다. Source system은 여러 동기화를 묶는 단위입니다. 기존 Source system에 배포해도 그 안의 다른 통합을 바꾸지 않으며, 지정하지 않으면 파이프라인에 대응하는 그룹을 만듭니다.
인터페이스 참조
Reference interface에서 객체 유형이 사용할 속성을 나타내는 인터페이스를 선택하고 동기화 속성을 매핑합니다. 대부분의 사용 사례에는 Core Ontology의 Geotemporal Series 인터페이스를 사용할 수 있습니다. Ontology Manager에서 찾을 수 없으면 설치 여부를 Palantir Support에 문의합니다.
Save로 동기화 구성을 저장합니다.
시계열 객체 유형
정리한 관측 입력에서 새 변환을 만들고 Apply expression으로 대상을 고유하게 식별하는 값을 Series_ID 열에 복사합니다. 예를 들어 선박의 mmsi를 사용할 수 있습니다. 동기화의 Series ID와 값 및 자료형을 일치시킵니다.
Apply 후 저장하고 데이터를 미리 봅니다.
변환 노드의 +에서 New object type 출력을 추가합니다.
객체 유형 이름과 아이콘을 정하고 속성 옆의 ... 메뉴에서 기본 키와 제목 속성을 지정합니다.
Series_ID 옆 링크 아이콘에서 Geotemporal series > From this pipeline을 선택하여 동기화를 연결합니다. 다른 파이프라인의 동기화는 From Foundry...에서 고를 수 있습니다.
객체 유형에는 GTSR 속성을 최대 하나만 둘 수 있으며 GTSR 배열은 지원하지 않습니다.
Implement interface에서 동기화가 참조한 같은 인터페이스를 선택합니다. Next에서 필수 속성을 매핑한 뒤 Confirm and implement를 선택하고 저장합니다.
배포와 접근 통제
변경을 모두 저장한 뒤 Deploy를 선택합니다.
Replay on deploy를 선택하면 지정한 시점부터 다시 처리할 수 있습니다. 스트림 규모에 따라 배포 시간이 늘어날 수 있습니다. 설정을 검토한 뒤 Deploy pipeline을 선택합니다.
배포 전에는 다음 접근 조건을 확인합니다.
- 하위 관측의 강제적 접근 조건은 출력 데이터셋의 최신 트랜잭션 또는 스트리밍 뷰를 기준으로 하며, 입력에서 상속한 보안 표지와 보안 분류 표지를 전파합니다.
- 출력 빌드 사이에 상위 보안 표지가 바뀌면 과거 관측의 접근 조건을 의도하지 않게 바꾸지 않도록 다음 빌드가 실패합니다. 필요한 표지에 맞추어 출력을 삭제하고 다시 만드는 절차가 필요합니다.
- 모든 입력의 조직 보안 표지는 대상 namespace에 접근할 수 있는 조직이어야 하며, 출력의 조직 보안 표지 집합은 namespace 접근 조직을 포함해야 합니다.
- 처음 배포할 때 부모 프로젝트에 읽기 이상 권한이 있는 그룹에 하위 출력 보기 권한을 부여합니다. 이후 프로젝트의 재량적 권한 변경은 관측에 자동으로 전파되지 않습니다. 더 세밀한 권한 구성이 필요하면 담당자와 조정합니다.
배포한 동기화의 RID는 출력 노드 Metadata의 Geotemporal series integration RID에서 복사합니다. 관측이 보이지 않으면 Outputs의 View backing dataset과 View errors dataset, History의 실행 오류 및 하위 앱의 보안 표지와 그룹 권한을 확인합니다.
Gaia 표시와 유형 매핑
일반 객체는 MRS가 있을 때 유형 매핑 없이 Gaia에서 사용할 수 있지만, 고급 지리 시계열 기능과 추적에는 MRS가 있어도 객체 유형 매핑이 필요합니다. Gotham 연결과 유형 매핑의 설치 및 권한 조건을 갖추고 객체 유형을 매핑합니다.
온톨로지에 연결된 geotime 레이어의 객체를 선택한 뒤 지도 오른쪽 아래 버튼으로 관측 로그를 엽니다. 로그는 기반 통합의 Live 속성을 보여 줍니다. Rolling window 선택기로 조회 기간을 정하고 행의 Zoom to로 위치를 봅니다. 관측을 선택하면 지도상의 객체를 해당 과거 위치에서 볼 수 있으며 새 관측이 도착하면 새로 고침 버튼이 나타납니다.
데이터셋을 거쳐 Ontology Manager에서 연결
직접 객체 유형 출력을 만들지 않고 GTSR 열을 가진 데이터셋을 먼저 만들 수도 있습니다.
- 사용할 동기화를 배포하고 RID를 확인합니다.
- 동일한 관측 데이터 또는 같은 series ID를 가진 입력에서 새 변환을 추가합니다.
- Create geotemporal series reference 표현식을 선택합니다.
- Series ID에는 동기화에 매핑한 같은 열을, Geotemporal series integration RID에는 배포된 동기화 RID를 지정합니다.
- Apply 후 저장하고 미리 봅니다.
- New dataset 출력을 추가하고 배포합니다.
- Ontology Manager에서 이 데이터셋을 기반으로 객체 유형을 만듭니다.
Geotemporal Series Reference 속성이 자동으로 설정되지 않으면 해당 유형으로 추가하거나 수정하고 정확한 동기화 RID를 지정합니다. 이 경로에서도 지리 시계열 인터페이스를 구현하며 GTSR은 객체 유형당 하나, 비배열이라는 제한을 따릅니다.