Scenario: connessione dei dati IoT ad APEX

Utilizzo dell'interfaccia CLI

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

Utilizzo dell'interfaccia API

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

1. Andare alla console APEX all'URL seguente:

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

2. Eseguire il login all'area di lavoro del dominio IoT utilizzando i seguenti caratteri come nome area di lavoro e nome utente database utilizzando solo lettere maiuscole per <domain-short-id-from-device-host> e notare due caratteri di sottolineatura: __WKSP:

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

3. Andare a SQL Workshop e selezionare SQL Commands per eseguire una query sui dati IoT.
   Inizialmente, esistono 2 schemi di database per il dominio IoT, entrambi utilizzano <domain-short-id-from-device-host>, che è il nome host del dispositivo IoT:

   • <domain-short-id-from-device-host>__IOT: schema con accesso in sola lettura alle definizioni e alla telemetria dei gemelli digitali.
   • <domain-short-id-from-device-host>__WKSP: schema con accesso in lettura e scrittura.

   Nota
   
   Si noti che i nomi degli schemi contengono due caratteri di sottolineatura: __IOT e __WKSP
4. Eseguire una query sui dati IoT immettendo ed eseguendo un comando SQL. Confermare di aver selezionato lo schema corretto per la tabella di database di cui si sta eseguendo la query, ad esempio:
   1. Selezionare lo schema <domain-short-id-from-device-host>__IOT.
   2. Eseguire il comando seguente, sostituire il tipo con i dati che si desidera visualizzare:
   • RAW_DATA
   • HISTORIZED_DATA
   • REJECTED_DATA
   • RAW_COMMAND_DATA
   In questo esempio viene illustrato come eseguire una query sui dati raw.

   select * from RAW_DATA

5. Quando viene creato l'account amministratore, un utente viene creato in due posizioni diverse, il database Oracle e l'applicazione APEX. Si tratta di utenti diversi con lo stesso nome utente e password. È possibile modificare le password.
   1. Per modificare la password dell'utente del database, utilizzare questa istruzione ALTER USER SQL e la clausola REPLACE richiesta:

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

   2. Per modificare la password dell'utente APEX:
      • Un amministratore APEX può modificare la password. Dopo aver eseguito il login ad APEX come amministratore, selezionare l'opzione Imposta password account APEX.
      • Come utente APEX, quando si esegue il login all'applicazione APEX, verrà richiesto di modificare la password APEX.
6. Ora puoi visualizzare i dati IoT in APEX e creare nuovi account utente nei servizi di amministrazione APEX.

7. Per visualizzare uno screenshot più grande, fare clic con il pulsante destro del mouse e aprire l'immagine in un nuovo browser.