シナリオ: IoTデータのAnalytics Cloudへの接続

Oracle Analytics CloudでInternet of Things (IoT)データを表示するためのアクセス権を構成します。

IoTドメイン・データベース・スキーマには、IoTドメインに関連付けられたデジタル・ツイン・リソースのメタデータとデータが含まれます。

1. Internet of Thingsテナンシで、管理者としてログインします。
2. ナビゲーション・メニューを開き、「ネットワーキング」、「Virtual Cloud Networks」の順に選択します。
3. 「Virtual Cloud Networks」リスト・ページで、「Create VCN」を選択します。既存のVCNを使用する場合は、別のコンパートメントのVCNsを表示するには、コンパートメントを選択し、「適用済フィルタ」の横にあるコンパートメントを変更してコンパートメントを選択します。
4. VCNのわかりやすい名前を入力します。名前は、必ずしも一意である必要はありませんが、後でコンソールで変更することはできません(ただし、アイデンティティ・ドメインAPIまたはCLIで変更できます)。機密情報を入力しないでください。
5. VCNを作成するコンパートメントを確認し、必要に応じて別のコンパートメントを選択してください。
   ノート
   
   VCNは、IoTドメイン・グループおよび他のすべてのIoTリソースと同じリージョンにある必要があります。IoTドメインに関連付けることができるVCNsの数に対する制限は5です。
6. 「IPv4 CIDRブロック」セクションで、データベースへのアクセスを許可するIP範囲を入力します(例: 10.0.0.0/16)。
7. VCN内のDNSホスト名を使用するにはトグルをオンにし、次のフィールドにDNSラベルが入力されていることを確認します。
8. DNSドメイン名を確認または入力します。次に例を示します。

   <vcn-name>.oraclevcn.com

9. 「VCNの作成」を選択します。追加設定の完全なリストは、VCNの作成を参照してください。
10. 「Virtual Cloud Network」の詳細ページが開き、このVCNのOCIDが表示されます。「サブネット」タブを選択します。「サブネットの作成」を選択します。
11. サブネットの作成ページで、次の設定を使用します:
    1. サブネットのわかりやすい名前を入力します。必ずしも一意である必要はありませんが、後でコンソールで変更することはできません(ただし、アイデンティティ・ドメインAPIを使用して後で変更できます)。機密情報を入力しないでください。
    2. サブネットを作成するコンパートメントを確認します。必要に応じて別のコンパートメントを選択します。サブネットおよびVCNは、IoTデータベースおよびIoTドメイン・グループおよびドメイン・リソースと同じリージョンにある必要があります。
    3. サブネット・タイプ「リージョナル」を選択します。リージョナル・サブネットは、サブネットにリージョンの任意の可用性ドメイン内のリソースを含めることができることを意味します。
    4. IPv4 CIDRブロック(10.0.0.0/16など)を入力します。
    5. IPv6接頭辞の下で、IoTリソースの「ルート表コンパートメント」が選択されていることを確認します。「ルート表」で、このVCNの「デフォルト・ルート表」を選択します。
    6. 「プライベート・サブネット」アクセスを選択して、このサブネット内のインスタンスのパブリックIPアドレスを禁止します。
    7. 「DNS解決」で、「このサブネットでDNSホスト名を使用」チェック・ボックスを選択します。次のフィールドに「DNSラベル」が表示されていることを確認します。
    8. サブネットDNSラベル名を含む「DNSドメイン名」を入力します。たとえば:

       <subnet_DNS_label>.<VCN_DNS_label>.oraclevcn.com

    9. 「Dhcpオプション」コンパートメントで、IoTリソースを含むコンパートメントを確認または選択します。「Dhcpオプション」で、「VCN名のデフォルトのDhcpオプション」を確認または選択します。
    10. セキュリティ・リスト・コンパートメントについて、IoTリソースを含むコンパートメントを確認または選択します。次のフィールドに「セキュリティ・リスト」を確認または入力します。
    11. 「サブネットの作成」を選択します。

        追加設定のリストおよび詳細は、サブネットの作成およびVCNsおよびサブネットの概要を参照してください。

12. サブネットがVirtual Cloud Networkに対して作成され、その詳細ページが開き、「ゲートウェイ」タブを選択します。「サービス・ゲートウェイ」で、「サービス・ゲートウェイの作成」を選択します。
13. サービス・ゲートウェイの名前を入力します。一意である必要はありません。機密情報を入力しないでください。ゲートウェイを作成するコンパートメントを選択します。必要に応じて別のコンパートメントを選択します。コンパートメントは、データベースおよび他のIoTリソースと同じリージョンにある必要があります。
14. 「サービス」で、「Oracle Services Networkのすべての<region>サービス」オプションを選択します。

    詳細は、サービス・ゲートウェイの作成ページの使用可能なサービスCIDRラベルを参照してください。

15. 「サービス・ゲートウェイの作成」を選択します。
16. 「仮想クラウド・ネットワーク」詳細ページが開き、「ルーティング」タブを選択します。
17. 「ルート表」で、「デフォルト・ルート表」を選択します。
18. 「ルート・ルール」タブを選択し、「ルート・ルールの追加」を選択して、ルート表ルールを編集してサービス・ゲートウェイに適用します。詳細は、VCNルート表のルールの更新を参照するか、サービス・ゲートウェイのルート表アソシエーションの更新を参照して後でアソシエーションを変更してください。
    • 「ターゲット・タイプ」で、「サービス・ゲートウェイ」の順に選択します。
    • 「宛先サービス」で、「Oracle Services Networkのすべての<region>サービス」を選択します。
    • ターゲット・サービス・ゲートウェイ・コンパートメントを選択します。前のステップでサービス・ゲートウェイを作成したときに選択したものと同じコンパートメントを選択します。
    • 前のステップで作成したターゲット・サービス・ゲートウェイを選択します。必要に応じて説明も入力します。
    • 「ルート・ルールの追加」を選択します。
    詳細は、ルーティング・ルールの追加を参照してください。
19. ルート・ルールが作成され、「ルート・ルール」リスト・ページに表示されます。
20. VCNのVirtual Cloud Networkの詳細ページに移動し、VCNの検索に関するヘルプが必要な場合は、VCNsのリストを参照し、作業するVCNを選択します。
21. 「セキュリティ」タブを選択します。「セキュリティ・リスト」ページが開きます。詳細は、ネットワーク・セキュリティ・グループ(NSG)の作成を参照してください。
22. 「ネットワーク・セキュリティ・グループ」セクションに移動します。「リソース」で、「ネットワーク・セキュリティ・グループ」を選択します。
23. 「ネットワーク・セキュリティ・グループの作成」を選択し、次の設定を入力します:
    • 名前を入力し、前のステップで選択したものと同じコンパートメントを選択します。
    • 「ルール」セクションで、「方向」で「エグレス」を選択します。
    • 「宛先タイプ」で、「CIDR」を選択します。
    • 「宛先CIDR」フィールドに、環境のCIDRを入力します(例: 0.0.0.0/0)。
    • 「IPプロトコル」で、「すべてのプロトコル」を選択します。
24. 「作成」を選択します。詳細は、ネットワーク・セキュリティ・グループに関する項を参照してください。
25. 「ネットワーク・セキュリティ」ページが開き、ネットワーク・セキュリティ・グループの詳細が表示されます。
26. 「仮想クラウド・ネットワーク」の詳細ページで、VCNまたはVCNsのOCIDをコピーします。次のステップで、このVCN OCIDまたはVCN OCIDsを使用します。

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

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

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-host": "<domain-group-short-id>.iot-data.<region>.oci.oraclecloud.com",
    "db-allow-listed-vcn-ids": [
      "<vcn-OCID>"
    ],
    "db-connection-string": "tcps:adb.<region>.oraclecloud.com:<port>/<unique-id>.adb.oraclecloud.com?retry_count=20&retry_delay=3",
    "db-token-scope": "urn:oracle:db::id::ocid1.<database-compartment-OCID>",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-11T19:21:24.791Z"
      }
    },
    "description": "<your-description>",
    "display-name": "<your-display-name>",
    "freeform-tags": {},
    "id": "<domain-group-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-08-11T19:21:26.411000+00:00",
    "time-updated": "2025-08-12T02:17:02.763000+00:00"
  },
  "etag": "<unique-id>"
}

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>"]'

1. アナリティクス・クラウド・インスタンスの詳細ページの「アクセス情報」で、OACの「アクセスURL」を選択してOracle Analytics Cloudに移動します。「作成」、「接続」の順に選択します。
2. 「Oracle Autonomous Transaction Processing」データベースを選択して、特定のIoTドメイン・グループに関する次の情報を入力します。oci iot domain-group getコマンドを使用して、前のステップで説明したIoTドメイン・グループの特定の値を検索します。
   • 接続名: この接続の名前を入力します。
   • 摘要: (オプション)摘要を入力します。
   • 暗号化タイプ: TLS
   • 接続文字列: 次の接続文字列を使用して、特定のIoTドメイン・グループの値を置き換えます。たとえば:

     • <database-service-name>を、IoTドメイン・グループのdb-connection-stringのデータベースに置き換えます。

       <unique-id>.adb.oraclecloud.com

     • <user-tenancy-OCID>を、IoTドメインを作成し、Oracle Analytics Cloudが配置されているテナンシOCIDに置き換えます。
     • db-token-scopeの<database-compartment-OCID>を置き換えます。
     • <region>を、<database-hostname>と同じリージョンに存在する必要があるリージョン名に置き換えます。例: us-phoenix-1
     接続文字列:

     (description=
       (retry_count=20)
       (retry_delay=3)
       (address=
         (protocol=tcps)
         (port=1521)
         (host=<database-host-name>)
       )
       (connect_data=(service_name=<database-service-name>))
       (security=
         (ssl_server_dn_match=yes)
         (password_auth=OCI_TOKEN)
         (oci_iam_url=https://auth.<region>.oraclecloud.com/v1/actions/generateScopedAccessBearerToken)
         (oci_tenancy=<user-tenancy-OCID>)
         (oci_compartment=<database-compartment-OCID>)
       )
     )

   • ユーザー名: 前のステップで設定したアイデンティティ・ドメイン・ユーザーおよびグループを入力します。
     • <identity-group-name>は、ユーザーのアイデンティティ・グループまたはアイデンティティ動的グループのいずれかです。
     • デフォルトのアイデンティティ・ドメインに存在しない場合は、アイデンティティ・ドメインとグループ名を指定します: <identity-domain-name>/<identity-group-name>
   • パスワード: アイデンティティ・ドメイン・ユーザーまたはグループのデータベース・パスワードを入力します。データベース・パスワードを変更するには:
     1. ナビゲーション・メニューを開き、「アイデンティティと管理」に移動して「ドメイン」を選択します。
     2. ドメイン・リスト・ページで、操作するアイデンティティ・ドメインを選択し、IoTドメインに接続します。
     3. 「ユーザー管理」タブを選択し、パスワードを更新するユーザーを選択します。「データベース・パスワード」タブを選択して、パスワードを更新し、現在のIAMデータベース・パスワードを削除して新しいIAMデータベース・パスワードを作成します。
3. 「保存」を選択します。

4. これで、Oracle Analytics CloudでIoTデータを表示できます。

   Analytics Cloudのホーム・ページで、「作成」をクリックし、「データセット」をクリックしてから、作成した接続を選択して、Analytics CloudでIoTデータを表示および分析します。

   右クリックして新しいブラウザで開くを選択すると、より大きなスクリーンショットが表示されます。