シナリオ: データベース・ツールを使用したIoTデータへの接続

• 開始する前に
• ステップ1: IoTの直接データベース接続の構成
• ステップ2: データベース・ツールのプライベート・エンドポイントの作成
• ステップ3: データベース・ツール接続の作成
• ステップ4: データベース・ツール接続の検証
• ステップ5: SQLワークシートでの接続の使用
• FAQ
• トラブルシューティング
• 次の内容

次のものがあることを確認します。

• IoTドメイン・グループ・データ・アクセスの構成、IoTドメイン直接データ・アクセス、ネットワーキング・リソース、IAM動的グループ、要塞リソースおよびデータベース・ツール・リソースを構成する権限。
• ネットワーキング・リソースと同じリージョンのIoTドメイン・グループおよびIoTドメイン。
• IoTドメイン・グループOCID、IoTドメインOCID、データベース接続文字列、データベース・トークン・スコープおよびIoTドメイン短縮ID。これらの値は、ドメイン・グループおよびドメインの詳細ページで検索します。IoTドメイン・グループの詳細の取得およびIoTドメインの詳細の取得を参照してください。
• Autonomous AI Databaseデータ・ホストに到達できるサブネット。
• アイデンティティ・ドメインのユーザー・グループが直接データ・アクセスのためにIoTドメインにアクセスできるようにし、データベース・ツール・ファミリにアクセスできるようにするポリシー:

  allow group <identity-domain-name>/<group-name> to use database-tools-family in compartment <dbtools-compartment>

データベース・ツール接続を作成する前に、IoTデータベースへの直接アクセスを構成します。この設定により、プライベート・ネットワーク内の承認済リソースがIoTドメイン・データベースに接続できるようになります。

VCN、コンピュート、要塞、アイデンティティ動的グループ、SQLclの例など、プロセスまたはエンドツーエンドの設定の概要を次に示します(シナリオ: IoTデータベースへの直接接続を参照)。

1. ナビゲーション・メニューを開き、「ネットワーキング」、「Virtual Cloud Networks」、「VCNの作成」の順に選択します。IoTドメイン・グループおよびIoTドメインと同じリージョンにVCNを作成します。
2. VCNにプライベート・リージョナル・サブネットを作成します。サブネットのDNSホスト名を有効にします。
3. VCNのサービス・ゲートウェイを作成し、Oracle Services Networkトラフィックをサービス・ゲートウェイに送信するルート・ルールを追加します。
4. ネットワーク・セキュリティ・グループを作成または更新して、サブネット内のリソースがデータベース接続に必要なエグレス・トラフィックを送信できるようにします。
5. VCN OCIDをIoTドメイン・グループ許可リストに追加します。oci iot domain-group configure-data-accessコマンド、または同等のコンソールまたはAPIフローを使用します。
6. IoTドメイン・グループ詳細を取得し、db-connection-stringおよびdb-token-scope値を記録します。
7. 直接データベース・アクセス用のIoTドメインのアイデンティティ・グループまたは動的グループを許可リストします。oci iot domain configure-direct-data-accessコマンド、または同等のコンソールまたはAPIフローを使用します。

例:

oci iot domain-group configure-data-access \
  --iot-domain-group-id <iot-domain-group-OCID> \
  --db-allow-listed-vcn-ids '["<vcn-OCID>"]'

oci iot domain-group get \
  --iot-domain-group-id <iot-domain-group-OCID>

oci iot domain configure-direct-data-access \
  --iot-domain-id <iot-domain-OCID> \
  --db-allow-listed-identity-group-names '["<tenancy-OCID>:<identity-domain-name>/<identity-group-name>"]'

oci iam db-token get \
  --auth instance_principal \
  --scope urn:oracle:db::id::<database-compartment-OCID>

直接IoTデータベース接続用に構成したものと同じサブネットに、データベース・ツールのプライベート・エンドポイントを作成します。データベース・ツールは、このプライベート・エンドポイントを使用して、パブリック・データベース・パスなしでAutonomous AI Databaseにアクセスします。

1. ナビゲーション・メニューを開き、「開発者サービス」、「データベース・ツール」の順に選択します。
2. 「プライベート・エンドポイントの作成」を選択します。
3. IoT直接データベース接続を許可するコンパートメント、VCNおよびサブネットを選択します。
4. ネットワーク設計でプライベート・エンドポイントを使用する場合、プライベート・エンドポイントに必要なネットワーク・セキュリティ・グループを選択します。
5. 「作成」を選択し、プライベート・エンドポイントがアクティブになるまで待機します。

IoTデータベース接続文字列、プライベート・エンドポイントおよびIAMトークン認証を使用するデータベース・ツール接続を作成します。

1. 「データベース・ツール」で「接続の作成」を選択します。
2. 「データベース情報の入力」を選択します。
3. 「接続タイプ」で、「Oracle AI Database」を選択します。
4. 「接続文字列」に、IoTドメイン・グループの詳細からデータベース接続文字列を入力します。
5. 「プライベート・ネットワークを介したデータベースへのアクセス」を選択し、ステップ2で作成したプライベート・エンドポイントを選択します。
6. 「Wallet format」を「None」に設定します。
7. 「拡張オプション」までスクロールし、「認証」を選択します。
8. 「トークン・ベース認証の使用」を有効にします。
9. 「Add connection property」を選択します。
   • 名前: iam.db.token.scope
   • 値: IoTデータベース・トークン・スコープ(urn:oracle:db::id::<database-compartment-OCID>など)。
10. 「プロキシ認証タイプ」を「単一セッション」に設定します。
11. 「プロキシ・クライアント・ユーザー名」を<domainShortId>__WKSPに設定します。
12. 「作成」を選択します。

接続文字列パターン:

tcps://adb.<region>.oraclecloud.com:1521/<database-service-name>.adb.<region>.oraclecloud.com

例:

tcps://adb.us-phoenix-1.oraclecloud.com:1521/g896eaa614b05d8_cx3garwvwsieq_low.adb.oraclecloud.com

SQLワークシートまたはサポートされている別のデータベース・ツール統合から接続を使用する前に、接続を検証してください。

1. 「データベース・ツール」で、ステップ3で作成した接続を開きます。
2. 接続の「アクション」メニューを開きます。
3. 「検証」を選択します。
4. 検証結果を確認します。
5. 検証に失敗した場合は、接続、プライベート・エンドポイント、ネットワーク、トークン・スコープ、認証またはプロキシ・ユーザー設定を編集し、再度検証します。

検証に成功すると、データベース・ツールがプライベート・エンドポイントおよびトークンベースの認証設定を使用してIoTドメイン・データベースにアクセスできることが確認されます。

SQLワークシートは、データベース・ツール接続を使用する1つの方法です。コンソールからIoTデータに対してad hoc SQL問合せを実行する場合に使用します。

1. 「データベース・ツール」で「SQLワークシート」を選択します。
2. ステップ4で検証した「接続」を選択します。
3. 単純な問合せを実行して、セッションおよびスキーマ・コンテキストを確認します。
4. 使用可能なIoTデータベース・オブジェクトを一覧表示します。
5. IoT調査またはレポート・ワークフローに必要な問合せを実行します。
6. 左側で、スキーマを選択し、ビューおよび表を開いてIoTデータを表示します。

例:

select sys_context('USERENV', 'CURRENT_USER') as current_user,
       sys_context('USERENV', 'CURRENT_SCHEMA') as current_schema
from dual;

select table_name
from user_tables
order by table_name;

select *
from <iot-schema-or-view-name>
fetch first 10 rows only;

必要なデータがどのIoTスキーマ・オブジェクトに含まれているかわからない場合は、検出問合せから開始します。次に、デバイス、デジタル・ツイン・インスタンス、メトリック、イベント・タイプまたは時間範囲で問合せを絞り込みます。

• IoTドメイン・データベース・スキーマを確認し、ワークフローに必要な表またはビューを特定します。
• SQLワークシートからのデータベース・ツール接続、データベース・ツールの管理対象MCPサーバー、サポートされているOCI AIエージェント統合、またはサポートされている別のOCIサービス統合を使用します。
• IoT MCPサーバー
• 同じIoTデータに対して自然言語問合せ生成またはブラウザベースのSQLワークフローが必要な場合は、Select AIまたはAPEXを使用します。
• 直接データベース問合せを使用してRAWレコードをカウントしたり、キューをサブスクライブしてRAWおよび正規化されたメッセージをリアルタイムでストリーミングしたりして、OCI IoTドメイン・データにアクセスするためのJavaサンプル。