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

Oracle Application Express (APEX)をInternet of Things (IoT)データとともに使用するには、次のステップに従ってアクセスを構成し、データを接続します。

この図は、APEXのIoTデータにアクセスするフローを示しています。

IoTデータへのアクセスの構成

CLIまたはAPIを使用して、APEXへのIoTドメインのアクセスを構成し、IoT APEXへのパスワードを変更できます。

CLIの使用

oci iot domain configure-apex-data-accessを使用して、IoTドメインのAPEXへのアクセスを構成します。<iot-domain-OCID>をIoTドメインのOCIDに置き換え、<your-initial-apex-password>をIoT環境の初期APEXパスワードに置き換えます。
oci iot domain configure-apex-data-access --db-workspace-admin-initial-password "<your-initial-apex-password>" --iot-domain-id <iot-domain-OCID>
ノート

APEXの初期パスワードは、12文字以上である必要があります。

APIの使用

操作ConfigureIotDomainDataAccessを使用して、IoTドメインのAPEXへのアクセスを構成します:
POST /20250531/iotDomains/{iotDomainId}/actions/configureDataAccess
{
    "type": "APEX",
    "dbWorkspaceAdminInitialPassword": "<your-initial-apex-password>"
}

APEXへのログイン

  1. 次のURLでAPEXコンソールに移動します:
    https://<data-host-domain-group-short-id>.data.iot.<region>.oci.oraclecloud.com/ords/apex
  2. ワークスペース名およびデータベース・ユーザー名として次のものを使用して、IoTドメインのワークスペースにログインし、次の2つのアンダースコアを確認します: __WKSP:
    <domain-short-id-from-device-host>__WKSP 
  3. 「SQLワークショップ」に移動し、「SQLコマンド」を選択してIoTデータを問い合せます。
    最初は、IoTドメインに2つのデータベース・スキーマがあり、どちらもIoTデバイスのホスト名である<domain-short-id-from-device-host>を使用します。
    • <domain-short-id-from-device-host>__IOT: デジタル・ツイン定義およびテレメトリへの読取り専用アクセス権を持つスキーマ。
    • <domain-short-id-from-device-host>__WKSP: 読取りおよび書込みアクセス権を持つスキーマ。
    ノート

    スキーマ名には、__IOTと__WKSPの2つのアンダースコアが含まれていることに注意してください。
  4. SQLコマンドを入力して実行し、IoTデータを問い合せます。問合せするデータベース表に対して正しいスキーマを選択したことを確認します。次に例を示します。
    1. <domain-short-id-from-device-host>__IOTスキーマを選択します。
    2. 次のコマンドを実行して、タイプを表示したいデータに置き換えます。
    • RAW_DATA
    • HISTORIZED_DATA
    • REJECTED_DATA
    • RAW_COMMAND_DATA
    この例では、RAWデータを問い合せる方法を示します。
    select * from RAW_DATA
  5. 管理者アカウントが作成されると、OracleデータベースとAPEXアプリケーションの2つの異なる場所にユーザーが作成されます。これらは、同じユーザー名とパスワードを持つ異なるユーザーです。パスワードは変更できます。
    1. データベース・ユーザーのパスワードを変更するには、次のSQLALTER USERおよび必要なREPLACE句を使用します。
      ALTER USER <workspace-administrator-user-name> IDENTIFIED BY "<new-password>" REPLACE "<old-password>";
    2. APEXユーザーのパスワードを変更するには:
      • APEX管理者は、パスワードを変更できます。管理者としてAPEXにログインした後、「APEXアカウント・パスワードの設定」オプションを選択します。
      • APEXユーザーとして、APEXアプリケーションにログインすると、APEXパスワードを変更するように求められます。
  6. これで、APEXでIoTデータを表示し、APEX管理サービスで新しいユーザー・アカウントを作成できるようになりました。
  7. 大きなスクリーンショットを表示するには、右クリックして新しいブラウザでイメージを開きます。

    APEXでIoTデジタル・ツイン・スキーマを表示します。