シナリオ: IoTデジタル・ツインの使用
デジタル・ツインを設定するには、デジタル・ツイン・インスタンス、アダプタ、関係およびモデルを操作できます。
これらの概念を使用して、デジタル・ツイン・リソースを操作します。
非構造化データを受信したら、デジタル・ツイン・インスタンスを作成する必要があります。デジタル・ツイン・モデルおよびアダプタは必要ありません。シナリオ: HTTPを使用した非構造化データの送信を参照してください。
構造化データを受信する場合は、デジタル・ツイン・インスタンス、モデルおよびアダプタを作成する必要があります。
- デジタル・ツイン・モデル: デジタル・ツイン・モデルは、デジタル・ツインのセマンティクスを定義し、DTDL v3仕様に基づいています。デジタル・ツインは、デジタル・ツイン・モデル識別子(DTMI)を一意の識別子として使用します。
たとえば:
dtmi:com:yourcompany:iot:example;1 - デジタル・ツイン・アダプタ: データ・スナップショット用にデータをデジタル・ツイン・モデルに変換し、構成されている場合は履歴データを取得します。デジタル・ツイン・アダプタに渡されるデータは、データとマッピングを含むJSONオブジェクトです。構造化データにはデジタル・ツイン・アダプタが必要です。
- デフォルト・アダプタ・フォーマット: 作業するフォーマットでデータを送信するようにデバイスをプログラミングできる場合は、デフォルトのデジタル・ツイン・アダプタを作成します。特定の例は、シナリオ: HTTPを使用したデフォルト形式での構造化データの送信を参照してください。
- カスタム・アダプタ・フォーマット: 操作するフォーマットでデータを送信するようにデバイスをプログラムできない場合は、カスタム・デジタル・ツイン・アダプタを作成します。具体的な例は、シナリオ: HTTPを使用したカスタム・フォーマットでの構造化データの送信を参照してください。
- デジタル・ツイン関係: 複数のデジタル・ツイン・インスタンスを接続します。デジタル・ツイン関係がデジタル・ツイン・インスタンスにリンクしている場合は、デジタル・ツインと他のデジタル・ツイン・インスタンスとの関係のグラフを作成できます。特定の例は、シナリオ: デジタル・ツイン・リレーションシップの問合せを参照してください。
ノート
ファイル内のペイロード、アダプタ・マッピング、デジタル・ツイン・モデル、属性およびプロパティを使用するインタフェースに応じて、異なるケース規則が使用されます。たとえば、APIインタフェースは
ファイル内のペイロード、アダプタ・マッピング、デジタル・ツイン・モデル、属性およびプロパティを使用するインタフェースに応じて、異なるケース規則が使用されます。たとえば、APIインタフェースは
camelCaseを使用し、CLIインタフェースはhyphenated-lowercase形式を使用します。CLIでは、デジタル・ツイン・モデルおよびデジタル・ツイン・アダプタ・ファイルのcamelCaseまたはhyphenated-lowercase形式を受け入れ、コマンドおよびパラメータにhyphenated-lowercaseを使用できます。次に例を示します。 - API:
digitalTwinInstanceId - CLI:
digital-twin-instance-id
デジタル・ツインの概念
デジタル・ツイン・リソースを使用する場合は、次の主な概念を使用します。
- デジタル・ツイン・モデルの仕様およびアダプタ用の参照JSONファイル: オペレーティング・システムによっては、引用符、スラッシュまたはファイルの場所を含む構文が多少異なる場合があります。CLIを使用してアダプタをアップロードする場合、JSONファイルを使用してデータ・マッピングを指定できます。CLIの入力および出力の管理および複雑な入力のためのJSONファイルの使用を参照してください。
- サンプル・データ: 構成を設定およびテストするには、外部キーを含めない場合にデジタル・ツイン・インスタンスを作成すると、自動的に生成されます。データを転記するには、この外部キーをデバイス・ユーザー名として使用します。
- デジタル・ツイン・モデルおよびアダプタ・オプション: デジタル・ツイン・モデルを作成してDTDL v3仕様を使用して定義し、デジタル・ツイン・アダプタを作成してデバイス・データを正規化してデジタル・ツイン・モデルに適合させます。
- 外部キーおよび認証: IoT構成をテストするには、Basic認証でボールト・シークレットを使用してサンプル・データを取り込みます。デジタル・ツイン・インスタンスを使用してデータを送信する場合は、デバイスのユーザー名を
--external-keyとして、--auth-idをデバイス・パスワードとして指定します。--auth-idは、デジタル・ツイン・インスタンスを作成するか、デジタル・ツイン・インスタンスを更新するときに、ボールト・シークレットまたはmTLS証明書のいずれか(シークレットまたは証明書のOCID)をデジタル・ツイン・インスタンスに関連付けることができます。 - 外部キーおよびmTLS証明書: ボールト・シークレットのかわりにmTLS証明書を使用する場合、外部キーは証明書共通名である必要があり、証明書の共通名を検索するには、証明書をリストして証明書の詳細に移動できます。
- リレーションシップ: デジタル・ツイン・リレーションシップ・リンク・インスタンスは通常、ソースとターゲット、およびデジタル・ツイン・モデルのリレーションシップによって定義されたコンテンツ・パス(
servedByなど)特定の
servedByの例は、「シナリオ: デジタル・ツイン・リレーションシップの問合せ」のステップ9の「デジタル・ツイン・リレーションシップを作成してデジタル・ツイン・インスタンスを接続する」を参照してください。