Cenário: Conectando Dados IoT ao APEX

Usando a CLI

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

Usando a API

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

1. Vá para a Console do APEX no seguinte URL:

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

2. Faça log-in no Espaço de Trabalho do domínio IoT usando o seguinte como nome do espaço de trabalho e nome do usuário do banco de dados, observe dois sublinhados: __WKSP:

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

3. Vá para SQL Workshop e selecione SQL Commands para consultar os dados IoT.
   Inicialmente, há 2 esquemas de banco de dados para o domínio IoT, ambos usam o <domain-short-id-from-device-host>, que é o nome do host do dispositivo IoT:

   • <domain-short-id-from-device-host>__IOT: Esquema com acesso somente leitura às suas definições de gêmeos digitais e telemetria.
   • <domain-short-id-from-device-host>__WKSP: Esquema com acesso de leitura e gravação.

   Observação
   
   Observe que os nomes dos esquemas contêm dois sublinhados: __IOT e __WKSP
4. Consulte os dados IoT informando e executando um comando SQL. Confirme se você selecionou o esquema correto para a tabela de banco de dados que está consultando, por exemplo:
   1. Selecione o esquema <domain-short-id-from-device-host>__IOT.
   2. Execute o seguinte comando, substitua o tipo pelos dados que deseja exibir:
   • RAW_DATA
   • HISTORIZED_DATA
   • REJECTED_DATA
   • RAW_COMMAND_DATA
   Este exemplo mostra como consultar dados brutos:

   select * from <domain-short-id-from-device-host>__IOT.RAW_DATA where digital_twin_instance_id = '<iot-digital-twin-OCID>'

5. Quando a conta de administrador é criada, um usuário é criado em dois locais diferentes, o banco de dados Oracle e o aplicativo APEX. São usuários diferentes com o mesmo nome de usuário e senha. Você pode alterar as senhas.
   1. Para alterar a senha do usuário do banco de dados, use esta instrução ALTER USER SQL e a cláusula REPLACE necessária:

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

   2. Para alterar a senha do usuário do APEX:
      • Como Administrador do APEX, você pode alterar a senha. Após fazer log-in no APEX como administrador, selecione a opção Definir Senha da Conta do APEX.
      • Como usuário do APEX, ao fazer log-in no aplicativo do APEX, você será solicitado a alterar sua senha do APEX.
6. Agora, você pode ver seus dados IoT no APEX e criar novas contas de usuário nos serviços de administração do APEX.

7. Para ver uma captura de tela maior, clique com o botão direito do mouse e abra a imagem em um novo navegador.