IoTに関するFAQ

IoTドメイン・グループはどのように管理するのですか。

ドメイン・グループの作成、リスト、更新、移動、構成および削除に使用できるコンソール、CLIおよびAPI操作については、IoTドメイン・グループを参照してください。

IoTドメインの管理方法を教えてください。

ドメインの作成、リスト表示、更新、移動、データ・アクセスと保持の構成および削除に使用できるコンソール、CLIおよびAPI操作については、IoTドメインを参照してください。

IoTドメイン・グループの使用例はありますか。

はい。IoTドメイン・グループの操作では、ドメイン・グループの作成、ドメインの関連付けおよびデータベース・アクセスの構成方法を示します。詳細な例は、シナリオを参照してください。

IoTドメインの使用例はありますか?

はい。IoTドメインの操作では、ドメインを作成し、データベース・アクセスを構成する方法を示します。他の例については、シナリオを参照してください。

timeObservedはデータ保持にどのように影響しますか。

履歴化されたデータの保存は、timeObserved値ではなく、サンプルがデータベースに挿入されたときに計算されます。したがって、バッファリングされた遠隔測定または遅延された遠隔測定は、その観察タイムスタンプだけが示すよりも長く残る可能性があります。挿入が構成された保持期間を超えてからの経過時間が経過すると、レコードは削除に適格になります。データ保持の管理を参照してください。

作業リクエストを表示するにはどうすればよいですか。

コンソール、CLIまたはAPIを使用して、作業リクエストのリスト、ライフサイクル状態の確認、および関連するエラーとログの取得を行うには、作業リクエストを参照してください。

デジタル・ツイン・インスタンスはどのように操作するのですか。

インスタンスの作成、リスト表示、取得、更新および削除、インスタンスのコンテンツの取得、接続の構成およびコマンドの起動については、デジタル・ツイン・インスタンスを参照してください。

デジタル・ツイン・インスタンスの認証を構成するにはどうすればよいですか。

OCI Vaultシークレットを使用して基本認証を構成するか、mTLS証明書を使用して本番認証を構成します。関連するインスタンス操作については、デジタル・ツイン・インスタンスを参照してください。

デジタルツインモデルを使用するにはどうすればよいですか?

デジタル・ツイン・モデルは、デジタル・ツインのセマンティクスを定義し、デジタル・ツイン・モデル識別子(DTMI)を使用します。サポートされるDigital Twins Definition Languageの要件については、DTDL v3およびデジタル・ツイン・モデルの作成を参照してください。

デジタル・ツイン・アダプタを使用するにはどうすればよいですか。

デジタル・ツイン・アダプタは、デジタル・ツインに関連付けられたデータ・マッピングおよび参照ペイロードを定義します。使用可能な操作および例は、デジタル・ツイン・アダプタを参照してください。

デジタル・ツイン関係を操作するにはどうすればよいですか。

デジタル・ツイン関係は、別のデジタル・ツイン・インスタンスへのリンクを記述します。使用可能な操作については、デジタル・ツイン関係を参照してください。

プレーン・テキスト・シークレット値またはbase64シークレット・コンテンツはどのような場合に使用しますか。

HTTPSまたはMQTTSで認証する場合は、デコードされたプレーン・テキスト・シークレット値をデバイス・パスワードとして使用します。HTTPおよびMQTTクライアントは、必要なプロトコル・エンコーディングを実行するため、すでにbase64でエンコードされたパスワードを指定しないでください。OCI Vaultシークレットを作成またはアップロードするときに、必要に応じてシークレット・コンテンツをエンコードします。ORDSのOAuthアクセス・トークンを取得する場合は、シークレット値に対するこの手順の要件に従います。

timeObservedにはどのようなタイムスタンプ書式を使用できますか。

ダイレクトJSONPathマッピングでは、Unixエポック値(秒、ミリ秒、マイクロ秒)を含むJSON番号、またはyyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z'の形式(2025-08-20T16:07:09.888841Zなど)のUTC文字列を使用できます。「timeObservedのマッピング」を参照してください。

timeObserved: $.timestampなどの直接JSONPath割当てはサポートされていますか。

はい。選択した値がすでに受け入れられたフォームにある場合は、"timeObserved": "$.timestamp"を使用します。JSONPathは、値を変換せずに選択します。「timeObservedのマッピング」を参照してください。

マップされたタイムスタンプ・フィールドが欠落またはnullの場合どうなりますか。

直接マップ・フィールドがない場合、プラットフォームはメッセージ受信時間を使用します。直接JSONPathによって選択された明示的なJSON nullは、サポートされているタイムスタンプではありません。フィールドが欠落またはnullである可能性がある場合は、「欠落またはnullのタイムスタンプの処理」でガード式を使用します。

アダプタでタイムスタンプ変換関数が必要なのはいつですか。

ペイロード・タイムスタンプがカスタム書式設定文字列などの別の形式を使用する場合は、OCI IoT JQ拡張fromdateformatを使用します。指定されたパターンで値を解析し、エポックマイクロ秒を返します。「timeObservedのマッピング」を参照してください。

アダプタの診断またはログにタイムスタンプ解析エラーはどこに表示されますか。

静的JSON、JQ構文または構成エラーは、アダプタの作成または更新時にコンソールまたはAPI検証によって報告されます。デバイス・リクエストに対するHTTP 202 Acceptedレスポンスでは、非同期処理の受入れのみが確認されます。ランタイム・タイムスタンプの変換または検証の失敗については、ドメイン・データベースのREJECTED_DATA表とそのREASON_CODE列およびREASON_MESSAGE列を確認してください。これらの障害に対するアダプタ固有のOCIロギングの場所は記載されていません。Troubleshooting timeObserved mappingを参照してください。

デバイス・ペイロード・タイムスタンプをデジタル・ツイン観測時間にマップする方法を示す参照例はありますか。

はい。マッピングtimeObservedには、JSONPathおよびfromdateformatの直接の例およびパブリックOCI IoTサンプルへのリンクが含まれています。

接続デバイスの例はありますか。

はい。デバイスの接続には、構造化テレメトリおよび非構造化テレメトリを送信したり、コマンドを受信したりするためのHTTPSおよびMQTTSの例が含まれています。

IoTプラットフォームでデータにアクセスする例はありますか?

はい。IoTデータへの接続では、APEX、ORDS、直接データベース接続、Oracle Analytics Cloud、およびその他のサポートされているデータ・アクセス・パターンについて説明します。

IoTデータについてSelect AIに尋ねるにはどうすればよいですか?

Select AIプロファイルが関連するIoT表、ビューまたはスキーマにアクセスできる場合、デバイス読取り、テレメトリ・トレンド、欠落データ、異常イベントおよび最近のデバイス・アクティビティについて確認できます。APEXでのSelect AIを使用したIoTデータの問合せを参照してください。

Select AIはSQLレビューを置き換えますか?

番号Select AIでは、自然言語プロンプトからSQLを生成して実行できますが、生成されたSQLを確認してから、運用上の意思決定、自動化またはインシデント・レスポンスに結果を使用できます。

Select AIは、使用するIoTテーブルをどのように認識しますか?

Select AIは、IoTデータベース・スキーマのデータベース・オブジェクトおよびメタデータを使用します。

Select AIは、Autonomous AI Databaseにローカルに保存されていないIoTデータをクエリできますか?

はい。データベース・リンク、クラウド・リンク、外部表またはフェデレーテッド表に対するビューなど、サポートされているデータベース・オブジェクトを介してデータが公開されます。Select AI NL2SQLでのAIデータ・ゲートウェイの使用を参照してください。

Select AIを設定する必要はありますか。

はい。IoTドメインのデータベース接続を構成してから、Select AIシナリオに従ってプロファイルを作成し、IoTデータを問い合せます。

エンドツーエンドのゲートウェイ・ワークフローについては、ゲートウェイを使用した間接接続デバイスのデジタル・ツインの作成を参照してください。詳細なルートレベルのターゲット指定およびネストされたペイロードの例は、「targetおよびcontentRootを使用した間接デバイス・データのルーティング」を参照してください。

別のデバイスがかわりにデータを送信するようにデジタル・ツイン・インスタンスを間接的に接続するように構成できますか。

はい。デバイスに独自の認証IDを指定するのではなく、INDIRECT接続タイプを使用してインスタンスを作成し、それを1つ以上のゲートウェイ・デジタル・ツイン・インスタンスに関連付けます。Working with Indirectly Connected Devices and Gatewaysを参照してください。

既存のデジタル・ツイン・インスタンスの接続タイプを変更できますか。

はい。DIRECT、INDIRECTおよびGATEWAYの間で既存のインスタンスを変更できます。宛先タイプに必要な完全なモデル、アダプタ、認証IDおよびゲートウェイ構成を含めます。エンドツーエンドのシナリオについてはデジタル・ツイン・インスタンス接続タイプの変更を、認可操作要件についてはデジタル・ツイン・インスタンスの更新を参照してください。

既存のデジタル・ツイン・インスタンスを「未接続」またはNONEに変更できますか。

番号「未接続」は、CLIおよびAPI値NONEのコンソール・ラベルですが、サポートされている更新の宛先ではありません。かわりに、その接続タイプを使用して新しいデジタル・ツイン・インスタンスを作成します。

接続の変更中に別のモデルを選択することはできますか。

モデルに互換性がある場合のみ。現在のモデルと同じDTMIパスとメジャー・バージョン、およびマイナー・バージョン以上が必要です。同じ更新で無関係なモデルに切り替えることはできません。

ゲートウェイを別の接続タイプに変更できないのはなぜですか。

アクティブな間接接続インスタンスは依然としてそれに依存します。これらのダウンストリーム・インスタンスを別のゲートウェイに再割当てするか、サポートされている接続タイプに変更してから、ゲートウェイの更新を再試行してください。

特定のゲートウェイを介して接続されているデバイスを判別し、そのゲートウェイを失うことによる影響を理解するにはどうすればよいですか。

ゲートウェイの詳細ページを使用して、メンテナンス、移行または削除操作の前に、関連するデバイス数および依存するデジタル・ツイン・インスタンスを確認します。「IoTドメイン」ページで「ゲートウェイ詳細」を検索し、「ゲートウェイ」タブを選択してゲートウェイ・リストを表示し、「ゲートウェイ」詳細ページに移動するゲートウェイを選択します。IoTドメインのリストを参照してください。

どのデジタル・ツイン・インスタンスが直接接続されているか、間接的に接続されているか、ゲートウェイを認識するにはどうすればよいですか。

各デジタル・ツイン・インスタンスの接続タイプを確認し、デジタル・ツイン・インスタンスまたはゲートウェイ・リスト・ページを使用してゲートウェイの関連付けを識別し、ドメイン・トポロジを理解します。

受信テレメトリが正しいターゲット・デバイスにルーティングされるようにゲートウェイ・アダプタを構成するにはどうすればよいですか。

転送メッセージで一貫したデバイス識別とペイロード規則が1つ使用されている場合は、インバウンド・エンベロープでtargetを解決します。デバイス・ファミリで異なるターゲット式、コンテンツ・ルート、エンドポイント条件またはペイロード・マッピングが必要な場合に、インバウンド・ルートで解決します。Create Digital Twin AdaptersおよびRoute Indirect Device Data Using target and contentRootを参照してください。

ルート・レベルのターゲティングではなくエンベロープ・レベルのターゲティングを使用する必要があるのはどのような場合ですか。

転送されたデバイス・メッセージが1つの一貫性のあるデバイス識別およびペイロード規則に従っている場合は、エンベロープ・レベルのターゲティングを使用します。デバイス・ファミリで異なるターゲット式、コンテンツ・ルート、エンドポイント条件またはペイロード・マッピングが必要な場合、ルート・レベルのターゲット指定を使用します。ゲートウェイ・アダプタ・パターンの選択を参照してください。

ゲートウェイのインバウンド・ルートはいつ評価されますか。

サービスがインバウンド・ルートを評価するのは、ゲートウェイ・エンベロープのtarget式がないか、nullに解決された場合のみです。エンベロープ・レベルのターゲットがnull以外の値に解決された場合、メッセージは即時に委任され、インバウンド・ルートは評価されません。

ルート・レベルのtargetは何を識別しますか。

これは、ゲートウェイに関連付けられたデジタル・ツイン・インスタンスの外部キーに解決される必要があるJQ式です。コンテンツ・ルート・シナリオでは、${endpoint(2)}はhvac1またはcompressor1に解決されます。

targetは受信エンドポイントを変更しますか。

番号target式は、間接的に接続されたデジタル・ツインとそのアダプタを解決しますが、エンドポイントはリライトしません。ターゲット・アダプタは元のエンドポイントを受信し、独自のインバウンド・ルートを評価します。

ターゲット・アダプタに複数のインバウンド・ルートを設定できますか。

はい。ターゲット・アダプタでは、ワイルドカード・ルートを含む条件ベースのルートを使用できます。元のエンドポイントは保持されるため、アダプタが直接および間接的に接続されたデバイスによって共有される場合は、ルート条件を慎重に設計してください。

ルート・レベルのcontentRootはいつ使用されますか。

このルートのtargetがnull以外の値に解決される場合にのみ使用されます。サービスは、選択したオブジェクトをターゲットデバイスのアダプタに委任します。ターゲットおよびcontentRootによるルーティングを参照してください。

ルートのtargetがnullに解決されるとどうなりますか。

ルートのcontentRootは無視されます。ルートにpayloadMappingも含まれている場合、マッピングは現在のデジタル・ツイン・インスタンスに適用されます。

ゲートウェイは、独自のテレメトリをどのように処理できますか。

targetが存在しないゲートウェイ・ルートまたはnullに解決されるゲートウェイ・ルートを定義し、payloadMappingを使用してデータをゲートウェイのデジタル・ツインにマップします。ゲートウェイテレメトリおよび間接的に接続されたデバイステレメトリでは、個別のエンドポイントを使用して、各ルートが明確な状態になるようにできます。

ターゲット外部キーはエンドポイントではなくメッセージから取得できますか。

はい。ターゲット式は、受信JSONメッセージの最上位レベルのデバイス・キーなど、共有エンベロープ・フィールドから外部キーを解決できます。これは、クライアントが各デバイス・キーをエンドポイントに配置するのではなく、安定したトピックを使用する場合に役立ちます。

1つのデジタル・ツイン・モデルに複数のアダプタを使用できますか。

はい。デバイスで異なるデータ構造を使用する場合は、同じモデルに対して複数のアダプタを作成できます。各デジタル・ツイン・インスタンスは、その受信データと一致するアダプタに関連付けられます。

直接および間接的に接続されたデバイスはアダプタを共有できますか。

はい。ペイロード構造とエンドポイント・ルーティング要件に互換性がある場合です。アダプタは通常、接続トポロジではなく、受信データの構造を表します。

アダプタは、エンベロープ・マッピング・セクションをいくつ定義できますか。

アダプタには、1つのenvelopeMappingセクションがあります。アダプタが間接的に接続された複数のデバイス・タイプまたはペイロード構造をルーティングする必要がある場合は、ルート・レベルのtargetおよびcontentRoot値を使用します。

timeObservedは委任後にどのように処理されますか。

ターゲット・アダプタは、ゲートウェイ・エンベロープによって解決されたnull以外のtimeObserved値を継承します。ターゲット・アダプタが独自の非NULL値を解決すると、その値は継承されたタイムスタンプをオーバーライドします。

なぜcontent-rootテスト・メッセージが拒否されるのですか。

HVACルートは$.dataを委任するため、$.telemetryのみを含むペイロードは、予期されるHVACデータを提供しません。コンプレッサー・ルートは$.telemetryを委任するため、$.dataのみを含むペイロードは、予期されるコンプレッサー・データを提供しません。Send Telemetry Dataを参照してください。

定義を重複させずに、直接的および間接的に接続されたデバイス間で1つのゲートウェイを再利用できますか。

はい。ゲートウェイを再使用可能なアセットとして処理し、一致するアダプタを1回作成して、アダプタ・ルート条件を使用する間接的に接続された各デバイスにゲートウェイを関連付けます。

間接的に接続されたデバイスから非構造化テレメトリを送信できますか。

はい。ターゲット・デバイスの構造化ペイロード・マッピングが不要な場合は、ゲートウェイを介してRAWペイロードを送信し、デバイス固有のアダプタを省略します。

間接的に接続されているデバイスとゲートウェイ自体で非構造化コマンドを呼び出すことはできますか。

はい。両方のパターンにrawコマンドエンドポイントを使用します。ゲートウェイがターゲット・デバイスのアプリケーション・レベルの確認をパブリッシュする必要がある場合は、レスポンス・エンドポイントを追加します。Invoke Unstructured Commandsを参照してください。

たとえば、boilers/boiler1/actions/resetをリクエスト・エンドポイントとして使用し、boilers/boiler1/actions/responseをレスポンス・エンドポイントとして使用します。

1つのデバイスを複数のゲートウェイに関連付けて、ローミングできるようにすることはできますか。

はい。間接的に接続されたデバイスは、1つ以上のゲートウェイに関連付けることができるため、使用可能なゲートウェイ間を移動しながら、同じデジタル・ツインIDを保持できます。

ゲートウェイのデジタル・ツイン・インスタンスOCIDsの配列で--gatewaysオプションを使用します:

oci iot digital-twin-instance create \
  --iot-domain-id <iot-domain-OCID> \
  --connectivity-type INDIRECT \
  --display-name "Roaming Wireless Device 1" \
  --gateways '["<gateway-instance-1-OCID>","<gateway-instance-2-OCID>"]' \
  --external-key roaming-device1

本番でマルチゲートウェイ・ローミングを使用する前に、テスト環境でゲートウェイのハンドオフ動作を検証してください。