センサーオブジェクトタイプのセットアップ

このページでは、センサーオブジェクトタイプをセットアップして設定する方法を説明します。

あるオブジェクトタイプの一部のオブジェクトにのみ時系列データが存在すると想定される場合は、そのルートオブジェクトタイプにリンクされたセンサーオブジェクトを作成してください。一方、あるオブジェクトタイプの（ほぼ）すべてのオブジェクトに時系列データが存在すると想定される場合は、そのオブジェクトタイプに時系列プロパティ（TSP）を直接追加してください。これらのセットアップの選択肢については、時系列のドキュメントで詳しくはこちらをご覧ください。

前提条件：時系列オブジェクトタイプの元データセット

まず、新しい時系列オブジェクトタイプを作成する手順に沿って進めてください。時系列オブジェクトタイプの元データセットには、次のスキーマが必要です。

列	データ型	説明
主キー	`String`	[必須] 各行の主キーです。
系列ID	`String`	[必須] 唯一の TSP の系列IDです。センサーオブジェクトタイプが複数の時系列同期を元にしている場合は、修飾系列IDが必要です。TSP は主キーまたはタイトルプロパティにはできません。
センサー名	`String`	[必須] センサーオブジェクトの時系列データが何を表すかを識別する名前です。1個のルートオブジェクトにリンクされたすべてのセンサーオブジェクトのセンサー名は、一意である必要があります。
外部キー	`String`	[必須] センサーオブジェクトタイプをルートオブジェクトタイプにリンクするための外部キーです。主キーをこの目的に使用することもできますが、センサーオブジェクトタイプにはリンクタイプが1つ以上必要です。
カテゴリカルかどうか	`Boolean`	[TSP が数値とカテゴリカルの両方の種類の複数の同期を元にしている場合は必須] ブール値が `true` の場合、センサーオブジェクトにカテゴリカル時系列データがあることを示します。それ以外の場合、データは数値と見なされます。Measures のセットアップから移行する場合、これは以前 `is_enum` と呼ばれていました。
単位	`String`	[任意] センサーオブジェクトに表示する単位です。
内部補間	`String`	[任意] センサーオブジェクトに使用する内部補間です。

センサーオブジェクトタイプをセットアップする

Ontology Manager の機能ページで、時系列セクション内の開始を選択します。

ダイアログの最初の2つのステップに従って、TSP をセットアップします。時系列のセットアップダイアログの最後のステップで、センサーオブジェクトタイプの選択肢を選択します。

セットアップダイアログのセンサーオブジェクトタイプのセットアップ

センサーオブジェクトタイプの設定オプション

プロパティを追加すると、時系列プロパティテーブルの下に、展開されたセンサーオブジェクトタイプの設定セクションが表示されます。このセクションには次の設定オプションがあります。

センサーリンク （必須）
- このセンサーオブジェクトタイプを、時系列データの記録対象となるルートオブジェクトタイプにリンクするリンクタイプを1つ以上選択する必要があります。
- このリンクタイプのセンサー名を含むプロパティも選択する必要があります。
主センサーリンク （表示される場合は必須）
- これは、Foundry インスタンスで旧バージョンの Quiver に引き続きアクセスできる場合にのみ表示されます。
- これが表示される場合は、上記のセンサーリンクセクションで設定したエントリのいずれかと一致するリンクタイプとセンサー名を選択する必要があります。
カテゴリカルかどうか （TSP が異なる種類の複数の同期を元にしている場合は必須）
- TSP が数値同期とカテゴリカル同期の両方が混在する複数の同期を元にしている場合は、センサーオブジェクトにカテゴリカル時系列データがあるかどうかを示すブールプロパティを選択する必要があります。
単位 （任意、推奨）
- 必要に応じて、各センサーオブジェクトの時系列データの単位を含むプロパティを選択します。
内部補間 （任意）
- 必要に応じて、各センサーオブジェクトの時系列データに使用する内部補間の種類を含むプロパティを選択します。
- 有効な値は次のとおりです。
  - LINEAR：2点間を線形補間します。数値時系列にのみ適用できます。
  - NEAREST：最も近い点の値を使用します。
  - PREVIOUS：前の点の値を使用します。
  - NEXT：次の点の値を使用します。
  - NONE：補間しません。

センサーオブジェクトタイプの設定セクション。

センサーオブジェクトタイプの単位と補間は、ベースフォーマッターではなく、センサーオブジェクトタイプの設定セクションで設定してください。

センサーオブジェクトタイプのベースフォーマッターの警告。

Measure から移行する

Ontology Manager のオブジェクトタイプの [機能] ページに以下の警告が表示される場合、そのオブジェクトタイプは以前に Measure として設定されています。Measure は非推奨になります。代わりに、同様のワークフローでセンサーオブジェクトタイプを使用できます。

Measure の移行バナー

オブジェクトタイプは、すでにセンサーオブジェクトタイプへの移行がすべて、または一部完了している場合があります。Ontology Manager の [機能] ページの時系列セクションに開始ボタンが表示されている場合、Measure はまだ移行されていません。Measure をセンサーオブジェクトタイプに移行するには、以下の手順に沿って進めます。このセクションのセンサーオブジェクトタイプの部分に緑色のチェックマークとすべて完了しましたが表示されている場合、オブジェクトタイプの移行はすべて完了しています。このページの下部に例を示します。設定がこれらの説明のどちらにも当てはまらない場合、移行は一部完了しています。画面のプロンプトに従って移行を完了します。

Measure の元となる時系列同期を確実に把握していない限り、移行は推奨しません。Measure の元となる時系列同期が不明でも移行したい場合は、Palantir サポートにお問い合わせください。

Measure の元となる時系列同期を特定します。Measure の元となる時系列同期が複数ある場合は、修飾シリーズIDを生成する必要があります。修飾シリーズIDの設定について詳しくはこちら。
Measure オブジェクトタイプでは、シリーズID列が主キーとして使用されていた可能性があります。時系列プロパティは主キーとして使用できないため、センサーオブジェクトタイプではこれは許可されません。主キーとして使用する列に応じて、次の選択肢があります。
- 選択肢1： シリーズID以外の列を主キーとして使用できる場合、それ以上の操作は必要ありません。
- 選択肢2： Measure の主キーとしてシリーズID列を使用していた場合、主キーとして使用する新しい列を作成する必要があります。
  - この列を作成する最も簡単な方法は、元データセットを生成した Pipeline Builder パイプラインまたはコードリポジトリを開き、シリーズIDの複製となる列を作成することです。
  - 注記： 値が重複しない、時系列以外のプロパティは、いずれも主キーとして使用できます。ユースケースに最も適したものを使用します。
- 選択肢3： Measure の元となる時系列同期が複数あるためにシリーズID列の形式を変更する必要があった場合、以前にシリーズIDとして使用していた列が一意の識別子であれば、その列を主キーとして使用できます。
Ontology Manager で Measure を開き、[機能] ページを開きます。開始を選択し、上記の説明に従ってフローに入力します。センサーオブジェクトタイプのトグルはオンになっているはずで、多くの選択項目はすでに入力されている場合があります。

開始ダイアログの Measure 移行ステップ3。

オントロジーへの変更を忘れずに保存してください。設定が完了すると、Ontology Manager の [機能] ページの時系列セクションにあるセンサーオブジェクトタイプの部分に、緑色のチェックマークとすべて完了しましたが表示されるはずです。以下に例を示します。

センサーオブジェクトの設定完了。