Documentation
ドキュメントの検索
karat

+

K

APIリファレンス ↗
オントロジーの構築Object and link typesオブジェクトタイプType Mappingを通じたGotham統合の有効化

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

タイプマッピングで Gotham 統合を有効にする

Map Rendering Service を備えたエンロールメントではタイプマッピングを省略できます

エンロールメントに Map Rendering Service（MRS）が含まれている場合、Gotham 統合を有効にするためにタイプマッピングのプロセスを完了する必要はありません。追加の設定なしで、Gotham から新しいオントロジーオブジェクトを作成することも、Gotham に既存のオブジェクトを追加することもできます。エンロールメントに MRS が含まれているかどうかを確認するには、以下の手順に従ってください。

MRS の利用可否、インストール、または Gotham にある追加のドキュメントについてご質問がある場合は、Palantir サポートにお問い合わせください。

エンロールメントに MRS が含まれているかどうかを確認する方法

  1. Quicksearch を起動し、Gaia Home を検索して選択します。
  2. 既存の Gaia マップを開くか、新しい Gaia マップを作成します。
  3. 左側のパネルでデータソースを選択します。
  4. 探す… 検索バーで「オブジェクト検索」を検索します。

オブジェクト検索を見つけて選択できる場合、エンロールメントには MRS が含まれています。

Gaia の左側のパネルにあるデータソースタブには、MRS がインストールされていることを示すオブジェクト検索が表示されます。

タイプマッピングを使用してオントロジーの統一された表現を作成する

タイプマッピングを使用すると、Foundry の Ontology Manager アプリケーション内で管理するオントロジーを、Foundry と Gotham にわたって統一された形で表現できます。既存の Foundry のオブジェクトタイプ、プロパティタイプ、共通プロパティタイプに基づいて新しい Gotham のタイプを作成でき、オントロジーが時間とともに変化しても同期が維持されます。タイプマッピングのプロセスが完了すると、Gotham は Object Set Service を通じて Foundry のオブジェクトタイプとそのメタデータをクエリできるようになります。Object Set Service は、オブジェクトデータの検索、絞り込み、集計、読み込みをサポートする Foundry のバックエンドサービスです。

タイプマッピングは、Foundry と Gotham の両方を使用するエンロールメントでのみ利用可能で、使用前にプラットフォーム管理者が有効にする必要があります。Foundry のオントロジーで一度有効にすると、タイプマッピングを無効にすることはできません。Gotham のインストールごとに、タイプマッピングを有効にできる Foundry のオントロジーは1つだけです。タイプマッピングの有効化について支援が必要な場合は、Palantir サポートにお問い合わせください。

オントロジーのオブジェクトタイプをタイプマッピングするタイミング

エンロールメントに MRS が含まれていない場合で、以下のいずれかの条件を満たすときは、以下の手順に従って、Ontology Manager でオブジェクトタイプをタイプマッピングします。

Foundry の Ontology Manager でタイプマッピングをオンにする

Foundry のオントロジー内のデータを Gotham と統合するには、まず以下の手順に従い、Foundry の Ontology Manager 内で対象のオブジェクトタイプのタイプマッピングをオンにする必要があります。

  1. ホーム画面から Ontology Manager を起動します。
  2. タイプマッピングするオブジェクトタイプを見つけて選択します。
  3. オブジェクトタイプの左側のパネルで機能を選択します。
  4. Gotham 統合パネルまで下にスクロールし、このタイプのオブジェクトに Gotham アプリケーションからのアクセスを許可する設定をオンにします。

Foundry の Ontology Manager アプリケーションから、オブジェクトタイプの Gotham 統合をオンにできます。

タイプマッピングされたオブジェクトを Gaia マップに表示するには、そのオブジェクトに geopoint プロパティが含まれている必要があります。このプロパティは、オブジェクトタイプの元データセットに元から存在するものでも、Pipeline Builder の Ontology Geopoint を作成トランスフォーム機能を使用して緯度と経度のペアまたは geopoint から派生させたものでもかまいません。

オブジェクトタイプの親カテゴリーと Gotham のプロパティタイプを設定する

Gotham 統合をオンにすると、以下の手順に従って、既存の Foundry オブジェクトタイプから派生した新しい Gotham オブジェクトタイプを作成し、オブジェクトタイプの親カテゴリーを指定して、プロパティタイプを設定できます。

  1. Gotham 統合のオブジェクトタイプセクションで新しいオブジェクトタイプを作成するを選択し、既存の Foundry オブジェクトタイプから Gotham に新しいオブジェクトタイプを作成します。

  2. ユースケースに応じて、エンティティ（人、組織、車両など）、イベント（フライト、会議、コンサートなど）、ドキュメント（PDF ファイル、テキスト文書、レポートなど）から選択して、Gotham の新しいオブジェクトタイプの親カテゴリーを指定します。

  3. プロパティタイプセクションを使用して、Foundry のオブジェクトタイプのプロパティを Gotham にマッピングします。プロパティは、Gotham のオントロジーで共有するか、クローンを作成できます。プロパティの設定を完了すると、そのプロパティ名の横に青いマッピング済みタグが表示されます。

    • プロパティを Gotham にマッピングしないがデフォルトの選択肢です。マッピングしない Foundry のプロパティは、Gotham のオントロジーに伝播しません。
    • 共通プロパティに割り当てを選択すると、マッピング先として既存の共通プロパティを選択できます。
    • 共通プロパティに昇格を選択すると、ほかのオブジェクトで使用するための新しい共通プロパティが作成されます。
    • Gotham にプロパティのローカルクローンを作成を選択すると、Gotham のアプリケーションに対応した、選択したプロパティの複製が Gotham に作成されます。

    Foundry はすべての共通プロパティを自動的にタイプマッピングし、Gotham で利用可能にします。

  4. 画面上部のリボンの右側にある緑色の保存ボタンを選択し、確認します。

  5. オブジェクトタイプに加えた変更を確認し、オントロジーに保存を選択します。

Foundry と Gotham のオントロジーを統合する際に、オブジェクトタイプの親カテゴリーを選択できる条件パネルを使用して、新しいオブジェクトタイプを作成するか、既存のオブジェクトタイプを引き継ぐことができます。

オントロジーへの変更を保存したら、上にスクロールして、オブジェクトタイプの機能ページのGotham 統合セクションに戻ります。オブジェクトタイプに割り当てられた Gotham URI が表示され、Gotham から報告されるインストールステータスを確認できるようになります。

Foundry の Ontology Manager には、以下のいずれかのインストールステータスが表示されます。

  • 統合準備完了：Gotham 統合を有効にするためのタイプマッピングを行う準備が、オブジェクトタイプで整っています。
  • インストール進行中：オブジェクトタイプのインストールプロセスが進行中です。
  • インストール完了：インストールプロセスが完了し、オブジェクトタイプを Gotham で使用できます。
  • Installation failed: {failureMessage}：オブジェクトタイプのインストールに少なくとも1回失敗しており、次回のインストール実行時に再試行されます。{failureMessage} は、失敗の理由を示します。一般的なインストール失敗の原因は以下のとおりです。
    • ライブ再インデックス：Gotham でライブ再インデックスが実行されている場合、オントロジーは更新できません。この間は変更をステージングせず、インストールに失敗し、ライブ再インデックスが終了すると自動的に再実行されます。
    • 必要なタイプがインストールされていない：オブジェクトタイプのインストールを成功させるには、共通プロパティタイプを含む、関連するすべてのプロパティのインストールまたはマッピングが完了している必要があります。
    • ほかのオントロジー更新：オントロジーの更新が同時に実行されている場合、タイプマッパーはオントロジーを更新できず、自動的に再実行されます。

オブジェクトタイプのインストールステータスがインストール完了になると、Gotham のアプリケーションでオブジェクトタイプを検索して使用できるようになります。

Gotham でタイプマッピングされたオブジェクトタイプを非推奨にするには、Foundry の Ontology Manager でそのオブジェクトタイプを削除できます。Foundry で削除すると、対応するオブジェクトタイプとそのプロパティタイプは Gotham でアクセスできなくなり、Gotham のアプリケーションでも利用できなくなります。

Gotham は Foundry データセットのセキュリティとマーキングをモデル化するため、タイプマッピングを通じて Gotham で利用可能になった Foundry データには、同じアクセス制御と機密情報区分が引き継がれます。