Scenario: connessione dei dati IoT a Analytics Cloud

Configurare l'accesso per visualizzare i dati di Internet of Things (IoT) in Oracle Analytics Cloud.

Lo schema di database del dominio IoT contiene i metadati e i dati delle risorse digital twin associate a un dominio IoT.

1. Nella tenancy Internet of Things, eseguire il login come amministratore.
2. Aprire il menu di navigazione, selezionare Networking e quindi Reti cloud virtuali.
3. Nella pagina della lista Reti cloud virtuali selezionare Crea VCN. Se si desidera utilizzare una VCN esistente, per visualizzare le reti VCN in un compartimento diverso selezionare un compartimento, accanto a Filtri applicati per modificare i compartimenti.
4. Immettere un nome descrittivo per la VCN. Non deve essere univoco e non può essere modificato in un secondo momento nella console, puoi modificarlo in un secondo momento con l'API o l'interfaccia CLI del dominio di Identity. Evitare di fornire informazioni riservate.
5. Verificare il compartimento in cui si desidera creare la VCN, selezionare un altro compartimento, se necessario.
   Nota
   
   La tua VCN deve trovarsi nella stessa area del tuo gruppo di domini IoT e di tutte le altre risorse IoT. Il limite al numero di VCN che è possibile associare a un dominio IoT è 5.
6. Nella sezione Blocchi IPv4 CIDR, immettere un intervallo IP consentito per accedere al database, ad esempio: 10.0.0.0/16
7. Attivare l'opzione di attivazione/disattivazione per utilizzare i nomi host DNS nella VCN, verificare che l'etichetta DNS sia immessa nel campo sottostante.
8. Confermare o immettere il nome del dominio DNS, ad esempio:

   <vcn-name>.oraclevcn.com

9. Selezionare Crea una VCN. Per un elenco completo delle impostazioni aggiuntive, vedere Creazione di una VCN.
10. Viene visualizzata la pagina dei dettagli della rete cloud virtuale con l'OCID per questa VCN. Selezionare la scheda Sottoreti. Selezionare Crea subnet.
11. Nella pagina Crea una subnet utilizzare le impostazioni riportate di seguito.
    1. Immettere un nome descrittivo per la subnet. Non deve essere univoco e non può essere modificato in un secondo momento nella console. È possibile modificarlo in un secondo momento con l'API del dominio di Identity. Evitare di fornire informazioni riservate.
    2. Verificare il compartimento in cui si desidera creare la subnet. Selezionare un altro compartimento, se necessario. La subnet e la VCN devono trovarsi nella stessa area del database IoT e del gruppo di domini IoT e delle risorse del dominio.
    3. Selezionare il tipo di subnet, Regionale. Una subnet regionale indica che la subnet può contenere risorse in qualsiasi dominio di disponibilità dell'area.
    4. Immettere un blocco IPv4 CIDR, ad esempio 10.0.0.0/16.
    5. Sotto i prefissi IPv6, confermare che il compartimento della tabella di instradamento per le risorse IoT sia selezionato. Per la tabella di instradamento, selezionare la tabella di instradamento predefinita per questa VCN.
    6. Selezionare l'accesso alla subnet privata per vietare l'indirizzo IP pubblico per le istanze in questa subnet.
    7. In Risoluzione DNS selezionare la casella di controllo Usa nomi host DNS in questa subnet. Verificare che l'etichetta DNS si trovi nel campo seguente.
    8. Immettere il nome del dominio DNS con il nome dell'etichetta DNS della subnet, ad esempio:

       <subnet_DNS_label>.<VCN_DNS_label>.oraclevcn.com

    9. Per il compartimento Opzioni DHcp confermare o selezionare il compartimento con le risorse IoT. Per le opzioni Dhcp, confermare o selezionare le Opzioni Dhcp predefinite per il nome della VCN.
    10. Per il compartimento Lista di sicurezza, confermare o selezionare il compartimento con le risorse IoT. Confermare o immettere Elenco sicurezza nel campo successivo.
    11. Selezionare Crea subnet.

        Per un elenco di impostazioni aggiuntive e ulteriori informazioni, vedere Creazione di una subnet e Panoramica delle reti VCN e subnet.

12. La subnet viene creata per la rete cloud virtuale e viene visualizzata la pagina dei dettagli, quindi selezionare la scheda Gateway. In Gateway di servizi selezionare Crea gateway di servizi.
13. Immettere un nome per il gateway del servizio. Non deve essere unico. Evitare di fornire informazioni riservate. Selezionare il compartimento in cui si desidera creare il gateway. Selezionare un altro compartimento, se necessario. Il compartimento deve trovarsi nella stessa area del database e di altre risorse IoT.
14. Per Servizi, selezionare l'opzione Tutti i servizi <region> in Oracle Services Network.

    Per ulteriori informazioni, vedere Etichette CIDR del servizio disponibili nella pagina Creazione di un gateway del servizio.

15. Selezionare Crea gateway del servizio.
16. Viene visualizzata la pagina dei dettagli delle reti cloud virtuali, quindi selezionare la scheda Ciclo.
17. In Tabelle instradamento, selezionare la Tabella di instradamento predefinita.
18. Selezionare la scheda Regole instradamento e selezionare Aggiungi regole di instradamento per modificare e applicare le regole della tabella di instradamento al gateway del servizio. Per ulteriori informazioni, vedere Aggiornamento delle regole di una tabella di instradamento VCN oppure vedere Aggiornamento dell'associazione della tabella di instradamento di un gateway di servizi per modificare l'associazione in un secondo momento.
    • Per Tipo di destinazione, selezionare Gateway di servizi.
    • Per Servizio di destinazione, selezionare Tutti i servizi <region> in Oracle Services Network.
    • Selezionare il compartimento Gateway del servizio di destinazione. Selezionare lo stesso compartimento selezionato quando è stato creato il gateway del servizio nel passo precedente.
    • Selezionare il Gateway del servizio di destinazione creato nel passo precedente. Facoltativamente, immettere una descrizione.
    • Selezionare Aggiungi regole di instradamento.
    Per ulteriori informazioni, vedere Aggiungere una regola di instradamento.
19. La regola di instradamento viene creata e visualizzata nella pagina Elenco regole di instradamento.
20. Vai alla pagina dei dettagli della rete cloud virtuale per la VCN, se hai bisogno di assistenza per trovare la VCN, consulta la sezione relativa all'elenco delle VCN, quindi seleziona la VCN che desideri utilizzare.
21. Selezionare la scheda Protezione. Viene visualizzata la pagina Lista di sicurezza. Per ulteriori informazioni, vedere Creazione di una rete di gruppo di sicurezza (NSG).
22. Andare alla sezione Gruppi di sicurezza di rete. In Risorse selezionare Gruppi di sicurezza di rete.
23. Selezionare Crea gruppo di sicurezza di rete, immettere le impostazioni riportate di seguito.
    • Immettere un nome, selezionare lo stesso compartimento selezionato nel passo precedente.
    • Nella sezione Regola, per la direzione, selezionare Escludi.
    • Per Tipo di destinazione, selezionare CIDR.
    • Nel campo CIDR destinazione immettere il CIDR per l'ambiente, ad esempio: 0.0.0.0/0
    • Per Protocolli IP selezionare Tutti i protocolli.
24. Selezionare Crea. Per ulteriori informazioni, vedere Gruppo di sicurezza di rete.
25. Viene visualizzata la pagina Sicurezza di rete, in cui è possibile visualizzare i dettagli del gruppo di sicurezza di rete.
26. Nella pagina dei dettagli della rete cloud virtuale copiare l'OCID per la VCN o le VCN. Usare questo OCID VCN o OCID VCN nel passo successivo.

oci iot domain-group configure-data-access --db-allow-listed-vcn-ids '["vcn-OCID-1","vcn-OCID-2"]' --iot-domain-group-id <domain-group-OCID>

oci iot domain-group get --iot-domain-group-id <iot-domain-group-OCID>

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-host": "<domain-group-short-id>.iot-data.<region>.oci.oraclecloud.com",
    "db-allow-listed-vcn-ids": [
      "<vcn-OCID>"
    ],
    "db-connection-string": "tcps:adb.<region>.oraclecloud.com:<port>/<unique-id>.adb.oraclecloud.com?retry_count=20&retry_delay=3",
    "db-token-scope": "urn:oracle:db::id::ocid1.<database-compartment-OCID>",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-11T19:21:24.791Z"
      }
    },
    "description": "<your-description>",
    "display-name": "<your-display-name>",
    "freeform-tags": {},
    "id": "<domain-group-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-08-11T19:21:26.411000+00:00",
    "time-updated": "2025-08-12T02:17:02.763000+00:00"
  },
  "etag": "<unique-id>"
}

oci iot domain configure-direct-data-access --iot-domain-id <iot-domain-OCID> --db-allow-listed-identity-group-names '["<tenancy-OCID:<identity-domain-name>/<identity-group-name>"]'

1. Nella pagina Dettagli istanza di Analytics Cloud, in Informazioni di accesso selezionare l'URL di accesso OAC per passare a Oracle Analytics Cloud. Selezionare Crea, quindi Connessione.
2. Selezionare il database Oracle Autonomous Transaction Processing per immettere le seguenti informazioni per il gruppo di domini IoT specifico. Utilizzare il comando oci iot domain-group get per trovare i valori specifici per il gruppo di domini IoT, descritti nel passo precedente:
   • Nome connessione: immettere un nome per la connessione.
   • Descrizione: (facoltativo) immettere una descrizione.
   • Tipo di cifratura: TLS
   • Stringa di connessione: utilizzare la stringa di connessione seguente e sostituire i valori del gruppo di domini IoT specifico. Ad esempio:

     • Sostituire <database-service-name> con il database del gruppo di domini IoT db-connection-string.

       <unique-id>.adb.oraclecloud.com

     • Sostituire <user-tenancy-OCID> con l'OCID tenancy in cui è stato creato il dominio IoT e si trova Oracle Analytics Cloud.
     • Sostituire <database-compartment-OCID> da db-token-scope
     • Sostituire <region> con il nome dell'area che deve trovarsi nella stessa area di <database-hostname>. Ad esempio: us-phoenix-1
     Stringa di connessione:

     (description=
       (retry_count=20)
       (retry_delay=3)
       (address=
         (protocol=tcps)
         (port=1521)
         (host=<database-host-name>)
       )
       (connect_data=(service_name=<database-service-name>))
       (security=
         (ssl_server_dn_match=yes)
         (password_auth=OCI_TOKEN)
         (oci_iam_url=https://auth.<region>.oraclecloud.com/v1/actions/generateScopedAccessBearerToken)
         (oci_tenancy=<user-tenancy-OCID>)
         (oci_compartment=<database-compartment-OCID>)
       )
     )

   • Nome utente: immettere l'utente e il gruppo del dominio di Identity impostati nel passo precedente.
     • Un valore <identity-group-name> è il gruppo di utenti Identity o un gruppo dinamico Identity.
     • Se non si trova nel dominio di Identity predefinito, specificare il dominio di Identity e il nome del gruppo: <identity-domain-name>/<identity-group-name>
   • Password: immettere la password del database per l'utente o il gruppo del dominio di Identity. Per modificare la password del database:
     1. Aprire il menu di navigazione, andare a Identity & Management, selezionare domini.
     2. Nella pagina dell'elenco dei domini, selezionare il dominio di identità da utilizzare e connettersi a un dominio IoT.
     3. Selezionare la scheda Gestione utenti, quindi selezionare l'utente per il quale si desidera aggiornare la password. Selezionare la scheda Password database per aggiornare la password eliminare la password del database IAM corrente e creare una nuova password del database IAM.
3. Selezionare Salva.

4. Ora puoi visualizzare i tuoi dati IoT in Oracle Analytics Cloud.

   Nella home page di Analytics Cloud fare clic su Crea, quindi su Set di dati, quindi selezionare la connessione appena creata per visualizzare e analizzare i dati IoT in Analytics Cloud.

   Fare clic con il pulsante destro del mouse e selezionare Apri in un nuovo browser per visualizzare uno screenshot più grande.