Oracle Cloud Infrastructureドキュメント

デジタル・ツイン・アダプタの作成

デジタル・ツイン・アダプタを作成して、物理デバイスまたは外部システムとの間のRAWデータ・ペイロードを、デジタル・ツイン・モデルに基づく正規化されたテレメトリ・データに変換します。

データは、データおよびマッピングを含むJSONオブジェクトとしてデジタル・ツイン・アダプタに渡されます。

構造化データを操作する場合は、デジタルツインアダプタが必要です。デジタル・ツイン・アダプタを使用するには、次の2つの方法があります。使用しているデバイスをプログラムしてデータを送信できるかどうかによって異なります。

  • デフォルト・アダプタ・フォーマット: 操作するフォーマットでデータを送信するようにデバイスをプログラミングできる場合は、inbound-envelopeまたはinbound-routesを指定せずにデジタル・ツイン・アダプタを作成します。その結果、データはデバイスのデフォルト形式で送信されます。エンベロープ・マッピングが指定されておらず、timeObservedが含まれている場合は、receivedTimeがtimeObserved値として使用されます。特定の例は、シナリオ: HTTPを使用したデフォルト形式での構造化データの送信を参照してください。
  • カスタム・アダプタ・フォーマット: データを送信するようにプログラムできないデバイスの場合、カスタム・デジタル・ツイン・アダプタを作成するには、ペイロードおよびメタデータを変換して作業する出力を取得するカスタムinbound-envelopeおよびenvelope-mappingを定義します。具体的な例は、シナリオ: HTTPを使用したカスタム・フォーマットでの構造化データの送信を参照してください。
ノート

制限: インバウンド・ルートの最大数は128です。

デバイス・ペイロードJSONの例:

{ "time": "<timestamp>", "temp": 65, "hum": 55 }

アダプタ・ペイロードJSONマッピングを作成するには、JQ式またはJsonPathを使用します。

この例では、JQを使用します。 
{ "temperature": .temp, "humidity": .hum, "timeObserved": .time }
変換された出力結果:
{ "temperature": 65, "humidity": 55, "timeObserved": "<timestamp>" }

JQ Playgroundでアダプタ・マッピングを試行するには、ペイロードを問合せ入力として貼り付け、JSONセクションにJSONマッピングを追加して、出力結果を表示します。

  • 次の例では、DTMI URIパラメータを使用して、アダプタをデジタルツインモデルに関連付けます。または、デジタル・ツイン・アダプタに関連付けるデジタル・ツイン・モデルの--digital-twin-model-idパラメータを<digital-twin-model-OCID>とともに使用できます。

    構造化データのデジタル・ツイン・アダプタをデフォルト形式で作成するには:

    デジタル・ツイン・アダプタを作成するには、oci iot digital-twin-adapter createコマンドと必要なパラメータを使用します。<digital-twin-model-spec-uri>を、関連付けられたデジタル・ツイン・モデルのDTMI URIに置き換えます。構造化データの場合は、デバイスをプログラムできる場合は、inbound-envelopeまたはenvelope-mappingを指定せずにデジタル・ツイン・アダプタを作成し、レスポンスでデバイスから取得したデータを受け入れます。 
    oci iot digital-twin-adapter create --iot-domain-id <iot-domain-OCID> --digital-twin-model-spec-uri '<digital-twin-model-spec-uri>'

    構造化データのデジタル・ツイン・アダプタをカスタム・フォーマットで作成するには:

    oci iot digital-twin-adapter createコマンドおよび必須パラメータを使用して、カスタム・デジタル・ツイン・アダプタを作成して特定のinbound-envelopeまたはinbound-routes値を定義し、操作する出力を取得します。JQ式を使用して、<file://inbound-envelope.json>ファイルおよび<file://inbound-routes.json>ファイルを使用して、デジタル・ツインのカスタム・ペイロード・マッピングを定義します。

    <digital-twin-model-spec-uri>を、関連付けられたデジタル・ツイン・モデルのDTMI URIに置き換え、<iot-domain-OCID>を、このデジタル・ツイン・アダプタに関連付けるIoTドメインOCIDに置き換えます:

    oci iot digital-twin-adapter create --iot-domain-id <iot-domain-OCID> --digital-twin-model-spec-uri '<digital-twin-model-spec-uri>' --inbound-envelope <file://inbound-envelope.json> --inbound-routes <file://inbound-routes.json>

    ファイルの参照の詳細は、複合入力へのJSONファイルの使用を参照してください。

    CLIコマンドのパラメータおよび値の完全なリストは、CLIコマンド・リファレンスを参照してください。

  • CreateDigitalTwinAdapter操作を実行して、指定されたIoTドメインにデジタル・ツイン・アダプタを作成します。