Scénario : Connexion des données IoT à APEX

Utilisation de l'interface de ligne de commande

oci iot domain configure-apex-data-access --db-workspace-admin-initial-password "<your-initial-apex-password>" --iot-domain-id <iot-domain-OCID>

Utilisation de l'API

POST /20250531/iotDomains/{iotDomainId}/actions/configureDataAccess
{
    "type": "APEX",
    "dbWorkspaceAdminInitialPassword": "<your-initial-apex-password>"
}

1. Allez à la console APEX à l'URL suivante :

   https://<data-host-domain-group-short-id>.data.iot.<region>.oci.oraclecloud.com/ords/apex

2. Connectez-vous à l'espace de travail du domaine IoT en utilisant les caractères suivants comme nom de l'espace de travail et nom d'utilisateur de la base de données en majuscules seulement pour <domain-short-id-from-device-host> et notez deux traits de soulignement : __WKSP :

   <domain-short-id-from-device-host>__WKSP 

3. Allez à Atelier SQL et sélectionnez Commandes SQL pour interroger les données IoT.
   Au départ, il existe 2 schémas de base de données pour le domaine IoT, les deux utilisent <domain-short-id-from-device-host>, qui est le nom d'hôte de l'appareil IoT :

   • <domain-short-id-from-device-host>__IOT : Schéma avec accès en lecture seule à vos définitions de jumeau numérique et à la télémétrie.
   • <domain-short-id-from-device-host>__WKSP : Schéma avec accès en lecture et en écriture.

   Note
   
   Notez que les noms de schéma contiennent deux traits de soulignement : __IOT et __WKSP
4. Interrogez les données IoT en entrant et en exécutant une commande SQL. Vérifiez que vous avez sélectionné le schéma approprié pour la table de base de données que vous interrogez, par exemple :
   1. Sélectionnez le schéma <domain-short-id-from-device-host>__IOT.
   2. Exécutez la commande suivante, remplacez le type par les données que vous voulez voir :
   • RAW_DATA
   • HISTORIZED_DATA
   • REJECTED_DATA
   • RAW_COMMAND_DATA
   Cet exemple montre comment interroger des données brutes :

   select * from RAW_DATA

5. Lorsque le compte d'administrateur est créé, un utilisateur est créé à deux endroits différents : la base de données Oracle et l'application APEX. Il s'agit d'utilisateurs différents avec le même nom d'utilisateur et le même mot de passe. Vous pouvez modifier les mots de passe.
   1. Pour modifier le mot de passe de l'utilisateur de base de données, utilisez cet énoncé ALTER USER SQL et la clause REPLACE requise :

      ALTER USER <workspace-administrator-user-name> IDENTIFIED BY "<new-password>" REPLACE "<old-password>";

   2. Pour modifier le mot de passe de votre utilisateur APEX :
      • En tant qu'administrateur APEX, vous pouvez modifier le mot de passe. Après vous être connecté à APEX en tant qu'administrateur, sélectionnez l'option Définir le mot de passe du compte APEX.
      • En tant qu'utilisateur APEX, lorsque vous serez connecté à l'application APEX, vous serez invité à modifier votre mot de passe APEX.
6. Désormais, vous pouvez voir vos données IoT dans APEX et créer de nouveaux comptes d'utilisateur dans les services d'administration APEX.

7. Pour afficher une capture d'écran plus grande, cliquez avec le bouton droit de la souris et ouvrez l'image dans un nouveau navigateur.