

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Come eseguire le interrogazioni del AWS IoT TwinMaker Knowledge Graph
<a name="tm-knowledge-graph-use"></a>

Prima di utilizzare il AWS IoT TwinMaker knowledge graph, assicurati di aver completato i seguenti prerequisiti:
+ Crea uno spazio di AWS IoT TwinMaker lavoro. [È possibile creare un'area di lavoro nella AWS IoT TwinMaker console.](https://console.aws.amazon.com/iottwinmaker/)
+ Acquisisci familiarità con AWS IoT TwinMaker il sistema entità-componente e con come creare entità. Per ulteriori informazioni, consulta [Crea la tua prima entità](twinmaker-gs-entity.md).
+ Acquisisci familiarità con i AWS IoT TwinMaker connettori dati. Per ulteriori informazioni, consulta [AWS IoT TwinMaker connettori dati](data-connector-interface.md).

**Nota**  
Per utilizzare il AWS IoT TwinMaker Knowledge Graph, è necessario utilizzare la modalità di prezzo in **bundle **standard** o a più livelli**. Per ulteriori informazioni, consulta [Cambia modalità di AWS IoT TwinMaker prezzo](tm-pricing-mode.md).

Le procedure seguenti mostrano come scrivere, eseguire, salvare e modificare le interrogazioni.

 **Aprire l'editor delle interrogazioni**   

**Per accedere all'editor di query del Knowledge Graph**

1. Apri la [AWS IoT TwinMaker console](https://console.aws.amazon.com/iottwinmaker/).

1. Apri l'area di lavoro in cui desideri utilizzare Knowledge Graph.

1. Nel menu di navigazione a sinistra, scegli **Query editor**.

1. Si apre l'editor di interrogazioni. Ora sei pronto per eseguire interrogazioni sulle risorse del tuo spazio di lavoro.

 **Esegui una query**   

**Per eseguire un'interrogazione e generare un grafico**

1. Nell'editor di query, scegliete la scheda **Editor** per aprire l'editor di sintassi.

1. Nello spazio dell'editor, scrivi la query che desideri eseguire sulle risorse del tuo spazio di lavoro.  
![\[Lo spazio dell'editor in cui è stata inserita una query.\]](http://docs.aws.amazon.com/it_it/iot-twinmaker/latest/guide/images/kg-query-updated.png)

   Nell'esempio mostrato, la richiesta cerca le entità che contengono `vav_%` nel loro nome, quindi le organizza in base alla `feed` relazione tra loro, utilizzando il codice seguente.

   ```
   SELECT ahu, vav, r FROM EntityGraph
   MATCH (vav)<-[r:feed]-(ahu)
   WHERE vav.entityName LIKE 'vav_%'
   ```
**Nota**  
La sintassi del knowledge graph utilizza [PartiQL](https://partiql.org/). Per informazioni su questa sintassi, vedere. [AWS IoT TwinMaker knowledge graph: risorse aggiuntive](tm-knowledge-graph-resources.md)

1. Scegli **Esegui query** per eseguire la richiesta che hai creato.

   Viene generato un grafico in base alla richiesta.  
![\[Un grafico che mostra i risultati dell'interrogazione dettagliata nei passaggi precedenti.\]](http://docs.aws.amazon.com/it_it/iot-twinmaker/latest/guide/images/tm-kg-graph-output.png)

   Il grafico di esempio mostrato sopra si basa sull'esempio di interrogazione riportato nel passaggio 2.

1. I risultati dell'interrogazione sono inoltre presentati in un elenco. Scegliete **i risultati** per visualizzare i risultati dell'interrogazione in un elenco.

1. Facoltativamente, scegli **Esporta come** per esportare i risultati della query in formato JSON o CSV.

Questo riguarda l'uso di base del knowledge graph nella console. Per ulteriori informazioni ed esempi che dimostrano la sintassi del knowledge graph, vedere. [AWS IoT TwinMaker knowledge graph: risorse aggiuntive](tm-knowledge-graph-resources.md)