Escenario: conexión de datos de IoT a APEX

Uso de la CLI

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

Uso de la API

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

1. Vaya a la consola de APEX en la siguiente URL:

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

2. Inicie sesión en el espacio de trabajo del dominio IoT utilizando lo siguiente como nombre de espacio de trabajo y nombre de usuario de base de datos con solo mayúsculas para <domain-short-id-from-device-host> y observe dos caracteres de subrayado: __WKSP:

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

3. Vaya a SQL Workshop y seleccione SQL Commands para consultar los datos IoT.
   Inicialmente, hay 2 esquemas de base de datos para el dominio IoT, ambos utilizan <domain-short-id-from-device-host>, que es el nombre de host del dispositivo IoT:

   • <domain-short-id-from-device-host>__IOT: esquema con acceso de solo lectura a sus definiciones de gemelos digitales y telemetría.
   • <domain-short-id-from-device-host>__WKSP: esquema con acceso de lectura y escritura.

   Nota
   
   Tenga en cuenta que los nombres de esquema contienen dos caracteres de subrayado: __IOT y __WKSP
4. Consulte los datos IoT introduciendo y ejecutando un comando SQL. Confirme que ha seleccionado el esquema correcto para la tabla de base de datos que está consultando, por ejemplo:
   1. Seleccione el esquema <domain-short-id-from-device-host>__IOT.
   2. Ejecute el siguiente comando, sustituya el tipo por los datos que desea ver:
   • RAW_DATA
   • HISTORIZED_DATA
   • REJECTED_DATA
   • RAW_COMMAND_DATA
   En este ejemplo, se muestra cómo consultar datos no procesados:

   select * from RAW_DATA

5. Cuando se crea la cuenta de administrador, se crea un usuario en dos lugares diferentes: la base de datos Oracle y la aplicación APEX. Son usuarios diferentes con el mismo nombre de usuario y contraseña. Puede cambiar las contraseñas.
   1. Para cambiar la contraseña del usuario de la base de datos, utilice esta sentencia ALTER USER de SQL y la cláusula REPLACE necesaria:

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

   2. Para cambiar la contraseña del usuario de APEX:
      • Como administrador de APEX, puede cambiar la contraseña. Después de conectarse a APEX como administrador, seleccione la opción Definir contraseña de cuenta de APEX.
      • Como usuario de APEX, cuando se conecte a la aplicación APEX, se le pedirá que cambie la contraseña de APEX.
6. Ahora, puede ver los datos de IoT en APEX y crear nuevas cuentas de usuario en los servicios de administración de APEX.

7. Para ver una captura de pantalla más grande, haga clic con el botón derecho y abra la imagen en un nuevo explorador.