次の方法で共有

デジタル ツイン ビルダー (プレビュー) チュートリアル パート 2: エンティティ型とマップ データの追加

チュートリアルのこの部分では、デジタル ツイン ビルダー (プレビュー) でエンティティ型を定義し、データをエンティティ インスタンスにマップします。 エンティティの種類は次のとおりです。

  • 蒸留 器
  • コンデンサー
  • 再沸器
  • 処理
  • テクニシャン
  • MaintenanceRequest

エンティティの種類ごとに、デジタル ツイン ビルダーで、プロパティや時系列データをサンプル テーブルからエンティティ インスタンスのプロパティにマップする方法を構成します。

Von Bedeutung

この機能は プレビュー段階です。

[蒸留器] エンティティの種類を追加する

このセクションでは、サンプルオントロジの最初のエンティティ型である [蒸留器]を定義します。

  1. デジタル ツイン ビルダー (プレビュー) のセマンティック キャンバスで、[ エンティティの追加] を選択します。

    [エンティティの追加] ボタンのスクリーンショット。

  2. 機器システムタイプを選択します。 システム型は、エンティティ型を定義するときに選択できる組み込みのエンティティ型で、この型のオブジェクトに共通する一連の関連プロパティに自動的に関連付けることができます。

    エンティティの種類名として 「蒸留器 」と入力し、[ エンティティの追加] を選択します。

    蒸留器の機器エンティティの種類を選択するスクリーンショット。

  3. 数分後に、 蒸留器 エンティティの種類がキャンバスに表示されるようになりました。

    キャンバス内の蒸留器エンティティタイプのスクリーンショット。

データを蒸留器にマップする

次に、一部のデータを [蒸留器 ]エンティティの種類にマップします。

デジタル ツイン ビルダー (プレビュー) のマッピング機能は、意味的に豊富なエンティティ型を持つオントロジを作成するための最初の手順です。 マッピング中に、さまざまなソース システムのデータを使用してエンティティ インスタンスをハイドレートします。

エンティティ型には、時系列プロパティと非時系列プロパティの両方を追加できます。 両方の種類のプロパティをエンティティ型にマッピングする場合は、時系列プロパティをマップする前に、少なくとも 1 つの非時系列プロパティをマップする必要があります。 次に、エンティティ型の非時系列プロパティを時系列データの列と照合して、時系列以外のデータと時系列データをリンクします。 時系列列の値は、エンティティ型プロパティにマップされているデータと 完全に 一致している必要があります。

時系列以外のプロパティをマップする

まず、資産メタデータをマッピングします。

  1. キャンバスまたはエンティティの種類の一覧ウィンドウでエンティティの種類を選択して、[ エンティティの構成 ] ウィンドウを開きます。

  2. ウィンドウで、[ マッピング ] タブに移動します。[ データの追加] を選択して新しいマッピングを作成します。

    マッピングの追加のスクリーンショット。

  3. [ Select lakehouse table]\(レイクハウス テーブル の選択\) を開き、マッピングのデータ ソースを選択します。 チュートリアル ワークスペースから、 GettingStartedRawData lakehouse と assetdata テーブルを選択します。

    蒸留器データ ソースのスクリーンショット。

    必要に応じて、データ プレビューが読み込まれるのを待ちます。 [ データ ソースの選択] を選択 して確定します。

  4. [ソース テーブル] の選択肢の横にある [フィルターが適用されていない] を選択して、ソース テーブルマッピングにフィルターを追加します。 列「Name」、操作Contains、および値distillerを選択します (大文字と小文字が区別されます)。 次に、[適用] を選択します。

    蒸留器データにフィルターを適用するスクリーンショット。

    ボタンのテキストに フィルターが適用されたと表示されるようになりました。

  5. 次に、マッピングするデータの プロパティの種類 を選択します。 この最初のマッピングでは 、ディスティラー エンティティの種類の資産メタデータが処理されるため、 時系列以外のプロパティを選択します。

    プロパティの種類を選択するスクリーンショット。

  6. [ 一意の ID] で、編集アイコン (鉛筆のような形) を選択して、データの一意の ID を選択します。 一意の ID は、ソース データから 1 つ以上の列から作成され、取り込まれたデータの各行を一意に識別するためにデジタル ツイン ビルダーによって使用されます。 このデータの一意の ID として [ID ] を選択し、[ OK] を 選択してモーダルを保存して閉じます。

    一意の ID オプションのスクリーンショット。

  7. [ マップされたプロパティ] で、編集アイコンを選択して、ソース テーブルのプロパティをマップします。

    [マップのプロパティ] ウィンドウでは、左側のソース データから列を選択し、右側のエンティティ型の新しいプロパティにマップできます。 既定では、左側のソース データから列名を選択すると、右側にエンティティ型プロパティと一致する名前が自動的に入力されますが、エンティティ型プロパティにソース データ内の名前とは異なる名前を付ける場合は、右側にプロパティの新しい名前を入力できます。

    次のプロパティ マッピングを定義します。

    1. DisplayName がマップするプロパティとして右側に自動的に指定される場合は、左側のソース列として [名前] を選択します。

    2. Manufacturer と SerialNumber をマップ解除したままにしておきます。

    3. [ + エンティティ プロパティの追加] を選択して、新しいプロパティを追加します。 左側のソース列として [ID ] を選択し、右側のプロパティを [DistillerId] に編集します。

    4. 新しいエンティティ型プロパティを追加します。 左側のソース列として SiteId を選択し、右側にマップするプロパティとして自動的に入力される SiteId のままにします。

    5. 新しいエンティティ型プロパティを追加します。 左側のソース列としてNumberOfTraysを選び、右側のマッピングされるプロパティとして、自動設定された状態のNumberOfTraysをそのまま使用します。

      マップされたプロパティのスクリーンショット。

  8. チェック ボックスをオンにして、これらのプロパティが適用されると、エンティティ型の名前を変更したり、エンティティ型から削除したりできないことを確認します。

  9. [ 適用] を選択してプロパティを保存します。 次に、[ 保存] を選択してマッピングを保存します。

    [マッピング] ボタンと [保存] ボタンのスクリーンショット。

  10. [ スケジュール ] タブに移動して、マッピング ジョブを実行します。 マッピング ジョブの名前で、[ 今すぐ実行] を選択します。

    [今すぐ実行] ボタンのスクリーンショット。

  11. [ 操作の管理 ] タブで、マッピング ジョブの状態を確認します。状態が [完了] と表示されるまで待ってから、次のセクションに進みます (コンテンツを数回更新する必要がある場合があります)。

    蒸留器エンティティの種類の [操作の管理] ボタンのスクリーンショット。

    [操作の管理] タブのスクリーンショット。蒸留器エンティティの種類のマッピングが表示されています。

マッピングの実行が完了すると、エンティティ インスタンスが作成され、時系列以外のデータがハイドレートされます。

時系列の属性をマッピングする

次に、時系列データをマップします。 [蒸留器] エンティティの種類には、追加する必要がある時系列データ テーブルから取得される 4 つの時系列プロパティがあります。 それらが追加されたら、時系列データと非時系列データの値と正確に一致するリンク プロパティを指定して、前の手順でマップしたエンティティ インスタンスに時系列データをリンクします。

  1. セマンティック キャンバスに戻る場合は [ホーム] を選択し、[蒸留器] エンティティの種類を再選択します。 [エンティティの構成] ウィンドウで、[マッピング] タブをもう一度開きます。

  2. [ データの追加] を選択して、時系列データの新しいマッピングを作成します。

  3. [ Select lakehouse table]\(レイクハウス テーブル の選択\) を開き、マッピングのデータ ソースを選択します。 チュートリアル ワークスペースから、 GettingStartedRawData lakehouse と 時系列 テーブルを選択します。

    時系列データ ソースのスクリーンショット。

    必要に応じて、データ プレビューが読み込まれるのを待ちます。 [ データ ソースの選択] を選択 して確定します。

  4. 次に、[ フィルターを適用しない ] を選択して、ソース テーブル マッピングにフィルターを追加します (最初のマッピングではなく、新しいマッピングを編集していることを確認してください)。 列 assetId、操作 Contains、および値 D (大文字と小文字が区別されます) を選択します。 次に、[適用] を選択します。

    蒸留器の時系列データにフィルターを適用するスクリーンショット。

    ボタンのテキストに フィルターが適用されたと表示されるようになりました。

  5. [プロパティの種類] で、[時系列プロパティ] を選択します。

    時系列プロパティのスクリーンショット。

  6. [ マップされたプロパティ] で、編集アイコンを選択します。

    1. タイムスタンプがマップするプロパティとして右側に自動的に提供される場合は、左側のソース列として sourceTimestamp を選択します。

    2. 次のソース列から時系列プロパティを 4 つ追加するには、+ エンティティプロパティを使用します: リフラックス比、メインタワーの圧力、供給流量、供給トレーの温度。 右側に自動表示される既定の一致する名前をそのままにしておきます。

      マップされた時系列プロパティのスクリーンショット。

    3. チェック ボックスをオンにして、これらのプロパティが適用されると、エンティティ型の名前を変更したり、エンティティ型から削除したりできないことを確認します。

    4. を選択してを適用します。

  7. 次に、時系列データをエンティティ インスタンス データにリンクします。 [ Link with entity property]\(エンティティ プロパティを使用してリンク\) で、編集アイコンを選択します。 このプロセスでは、時系列データ テーブルからエンティティ型プロパティと一致する列を選択する必要があります。 時系列データから選択されたソース列は、エンティティ型で選択されたプロパティにマップされるデータと 正確に一致 している必要があります。 このプロセスにより、エンティティ インスタンス データと時系列データが正しくコンテキスト化されます。

    1. [ エンティティ プロパティの選択] で [ DistillerId] を選択します。 [ 時系列データから列を選択...] で、時系列データから assetId 列を選択します。

      リンク オプションのスクリーンショット。

    2. [ 適用] を選択してモーダルを保存して閉じます。

  8. [増分マッピング] が有効になっていることを確認し、[保存] を選択してマッピング ジョブを保存します。 インクリメンタル マッピングを保存するかどうかを確認するメッセージが表示されたら確認します。

  9. [ スケジュール ] タブに移動して、マッピング ジョブを実行します。 新しいマッピング ジョブ ( TimeSeries で終了) を見つけて、[ 今すぐ実行] を選択します。

次に、時系列マッピングのスケジュールを追加して、データが自動的に更新されるようにします。 ここでは、5 分ごとに実行されるスケジュールを作成します。

  1. [スケジュール] タブ に 移動します。時系列実行の名前の下で、 スケジュール フローのスイッチをオンに切り替えます。 スケジュール セレクターが表示されます。 ドロップダウン メニューを展開し、[ フローの作成] を選択します。

    フローの作成のスクリーンショット。

  2. [フロー名] に「5 分ごと」と入力します。 を選択してを作成します。

  3. 新しい [フロー スケジュールの更新 ] ボタンを選択して、スケジュールされた実行の詳細を構成します。

  4. [5 分ごと] 設定で、次のオプションを構成します。

    1. スケジュールされた実行: オン
    2. 繰り返し: 分単位
    3. 毎: 5 分
    4. 開始日時: 今日の日付と時刻を選択します。
    5. 終了日時: 10 分後の時刻を選択します。
    6. タイム ゾーン: タイム ゾーンを選択します。

    スケジュール オプションのスクリーンショット。

    [ 適用] を選択し、スケジュール構成を閉じます。

  5. [エンティティの構成] ウィンドウにスケジュールが反映されていることがわかります。

    構成された蒸留器スケジュールのスクリーンショット。

  6. これで、蒸留器のすべてのプロパティがマップされます。 確認するには、[ プロパティ ] タブを選択し、セマンティック キャンバスでエンティティの種類が次のようになっていることを確認します。

    2 つのマッピングを示す蒸留器エンティティの種類のスクリーンショット。

  7. [ 操作の管理 ] タブで、時系列マッピングの状態を確認します。状態が [完了] と表示されるまで待ってから、次のセクションに進みます (コンテンツを数回更新する必要がある場合があります)。

    蒸留器エンティティの種類の [操作の管理] ボタンのスクリーンショット。

    蒸留器の時系列マッピングを含む [操作の管理] タブのスクリーンショット。

    ヒント

    マッピング ジョブの状態が [失敗] になっている場合は、再実行してみてください。 引き続き問題が発生する場合は、 デジタル ツイン ビルダー (プレビュー) のトラブルシューティング に関するページを参照してください。

これで、蒸留器エンティティの種類とそのマッピングが完了しました。

その他のエンティティ型を追加する

これで、蒸留器エンティティの種類が作成されたので、ソース データの残りのエンティティ型 (コンデンサー、リボイラー、プロセス、技術者、MaintenanceRequest) をオントロジに設定します。 エンティティ型の作成手順は 、ディスティラー エンティティ型の手順と似ていますが、プロパティの詳細はエンティティの種類ごとに異なります。

コンデンサー

コンデンサー エンティティ型を作成するには:

  1. セマンティック キャンバスで、リボンから [ エンティティの追加] を選択します。 Equipment システムタイプを使用して、コンデンサーという名前のエンティティ型を作成します。

    コンデンサーの Equipment エンティティの種類を選択するスクリーンショット。

  2. 新しいエンティティの種類の [ マッピング ] タブで、[ データの追加] を選択します。 このエンティティ型には、1 つの非時系列マッピングと 1 つの時系列マッピングの 2 つのマッピングがあります。

  3. 次のマッピングを作成します。 すべてのソース テーブルは、チュートリアル ワークスペースと GettingStartedRawData lakehouse にあります。

    ソース テーブル フィルター (大文字と小文字が区別されます) プロパティの種類 リンク／一意のID マップされたプロパティ メモを保存して実行する
    assetdata 名前に凝縮器が含まれている場所 時系列以外のプロパティ 一意の ID: ID - 名 を表示名としてマップする
    - 製造元 と SerialNumber をマップ解除したままにしておく
    - ID をCondenserId としてマップする
    - SiteId を SiteId としてマップ する
    - CoolingMedium をCoolingMedium としてマップする
    - InstallationDate を InstallationDate としてマップする    		 マッピングが作成されて保存されたら、[ スケジュール ] タブに移動して実行し、[ 操作の管理 ] タブでその完了を確認します。

    次の時系列マッピングを作成する前に、この時系列以外のマッピングを実行する必要があります。
    timeseries assetId に C が含まれている場所 時系列特性 リンク エンティティ プロパティ: CondenserId

    リンク時系列列: assetId    		 - sourceTimestamp をタイムスタンプとしてマップする (必須、大文字と小文字が区別されます)
    - 圧力を圧力としてマップする
    - 電力を電力としてマップする
    - InletTemperature を温度としてマップする    		 増分マッピングが有効になっていることを確認し、マッピングを保存します。 [ スケジュール ] タブに移動して実行します。

  4. コンデンサーのマッピングが完了すると、次のようになります。

    [コンデンサー] エンティティ型のスクリーンショット。

再沸器

Reboiler エンティティ型を作成するには:

  1. セマンティック キャンバスで、リボンから [ エンティティの追加] を選択します。 Equipment システムタイプを使用して、Reboiler という名前のエンティティ型を作成します。

  2. 新しいエンティティの種類の [ マッピング ] タブで、[ データの追加] を選択します。 このエンティティ型には、1 つの非時系列マッピングと 1 つの時系列マッピングの 2 つのマッピングがあります。

  3. 次のマッピングを作成します。

    ソース テーブル フィルター (大文字と小文字が区別されます) プロパティの種類 リンク／一意のID マップされたプロパティ メモを保存して実行する
    assetdata 名前に「reboiler」を含む場合 時系列以外のプロパティ 一意の ID: ID - 名 を表示名としてマップする
    - 製造元 と SerialNumber をマップ解除したままにしておく
    - ID をReboilerId としてマップする
    - SiteId を SiteId としてマップ する    		 マッピングが作成されて保存されたら、[ スケジュール ] タブに移動して実行し、[ 操作の管理 ] タブでその完了を確認します。

    次の時系列マッピングを作成する前に、この時系列以外のマッピングを実行する必要があります。
    timeseries assetId に R が含まれている場所 時系列特性 リンク エンティティ プロパティ: ReboilerId

    リンク時系列列: assetId    		 - sourceTimestamp をタイムスタンプとしてマップする (必須、大文字と小文字が区別されます)
    - 圧力を圧力としてマップする
    - InletTemperature を InletTemperature としてマップする
    - OutletTemperature を OutletTemperature としてマップする    		 増分マッピングが有効になっていることを確認し、マッピングを保存します。 [ スケジュール ] タブに移動して実行します。

  4. Reboiler のマッピングが完了すると、次のようになります。

    Reboiler エンティティ型のスクリーンショット。

プロセス

Process エンティティ型を作成するには:

  1. セマンティック キャンバスで、リボンから [ エンティティの追加] を選択します。 プロセス システム型を使用して、Process という名前のエンティティ型を作成します。

  2. 新しいエンティティ の [マッピング ] タブで、[ データの追加] を選択します。 このエンティティ型には、時系列以外のマッピングが 1 つあります。

  3. 次のマッピングを作成します。

    ソース テーブル フィルター (大文字と小文字が区別されます) プロパティの種類 リンク／一意のID マップされたプロパティ メモを保存して実行する
    processdata 無し 時系列以外のプロパティ 一意の ID: processId - DisplayName と Type をマップ解除したままにしておきます
    - siteName を siteName としてマップする
    - processId を processId としてマップする
    - siteId を SiteId としてマップ する    		 マッピングが作成されて保存されたら、[ スケジュール ] タブに移動して実行します。

  4. プロセスのマッピングが完了すると、次のようになります。

    Process エンティティ型のスクリーンショット。

技術者

技術者エンティティ型を作成するには:

  1. セマンティック キャンバスで、リボンから [ エンティティの追加] を選択します。 汎用システム型を使用して、Technician という名前のエンティティ型を作成します。

  2. 新しいエンティティ の [マッピング ] タブで、[ データの追加] を選択します。 このエンティティ型には、時系列以外のマッピングが 1 つあります。

  3. 次のマッピングを作成します。

    ソース テーブル フィルター (大文字と小文字が区別されます) プロパティの種類 リンク／一意のID マップされたプロパティ メモを保存して実行する
    技術者 無し 時系列以外のプロパティ 一意の ID: ID - name を DisplayName としてマッピングする
    - メールを電子メール としてマップ する
    - Id をTechnicianId としてマップする    		 マッピングが作成されて保存されたら、[ スケジュール ] タブに移動して実行します。

  4. 技術者のマッピングが完了すると、次のようになります。

    技術者エンティティタイプのスクリーンショット。

保守リクエスト

MaintenanceRequest エンティティ型を作成するには:

  1. セマンティック キャンバスで、リボンから [ エンティティの追加] を選択します。 汎用システム型を使用して、MaintenanceRequest という名前のエンティティ型を作成します。

  2. 新しいエンティティ の [マッピング ] タブで、[ データの追加] を選択します。 このエンティティ型には、時系列以外のマッピングが 1 つあります。

  3. 次のマッピングを作成します。

    ソース テーブル フィルター (大文字と小文字が区別されます) プロパティの種類 リンク／一意のID マップされたプロパティ メモを保存して実行する
    メンテナンスリクエスト 無し 時系列以外のプロパティ 一意の ID: 作業指示識別子 - DisplayName プロパティはマップ解除したままにしておきます。
    - EquipmentId を EquipmentId としてマップする
    - サイトを SiteId としてマップする
    - 状態を状態としてマッピングする
    - TechnicianId を TechnicianId としてマップ する
    - WorkorderId をWorkOrderId としてマップする    		 マッピングが作成されて保存されたら、[ スケジュール ] タブに移動して実行します。

  4. MaintenanceRequest のマッピングが完了すると、次のようになります。

    メンテナンス要求エンティティの種類のスクリーンショット。

これで、すべてのエンティティ型が作成されます。 セマンティック キャンバスには、次の 6 種類のエンティティが含まれている必要があります: 蒸留器、 凝縮器、 Reboiler、 Process、 Technician、 MaintenanceRequest。

マッピングの状態を確認する

すべてのエンティティ型マッピングが追加されたので、マッピング操作の状態を確認して、正常に完了したことを確認します。

[ 操作の管理 ] ボタンを選択します。

[操作の管理] ボタンのスクリーンショット。

[ 操作の管理 ] タブには、操作の一覧とその状態が表示されます。 このページを使用して、すべてのマッピング操作が正常に完了したことを確認できます。

[操作の管理] タブのスクリーンショット。

チュートリアルの次の部分に進む前に、すべてのマッピングが完了するまで待ちます。

ヒント

マッピング ジョブの状態が [失敗] になっている場合は、再実行してみてください。 引き続き問題が発生する場合は、 デジタル ツイン ビルダー (プレビュー) のトラブルシューティング に関するページを参照してください。

次のステップ

チュートリアル パート 3: リレーションシップの種類を定義する