As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Como executar consultas ao gráfico de AWS IoT TwinMaker conhecimento
<a name="tm-knowledge-graph-use"></a>

Antes de usar o gráfico de AWS IoT TwinMaker conhecimento, verifique se você preencheu os seguintes pré-requisitos:
+ Crie um AWS IoT TwinMaker espaço de trabalho. É possível criar um espaço de trabalho no [console do AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/).
+ Familiarize-se com AWS IoT TwinMaker o sistema de componentes de entidade e como criar entidades. Para obter mais informações, consulte [Crie sua primeira entidade](twinmaker-gs-entity.md).
+ Familiarize-se com os conectores AWS IoT TwinMaker de dados da. Para obter mais informações, consulte [AWS IoT TwinMaker conectores de dados](data-connector-interface.md).

**nota**  
Para usar o gráfico de AWS IoT TwinMaker conhecimento, você precisa estar nos modos de preços de **pacote **padrão** ou em camadas**. Para obter mais informações, consulte [Alterne AWS IoT TwinMaker os modos de preços](tm-pricing-mode.md).

Os procedimentos a seguir mostram como escrever, executar, salvar e editar consultas.

 **Abra o editor de consulta**   

**Para navegar até o editor de consultas do gráfico de conhecimento**

1. Abra o [console do AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/).

1. Abra o espaço de trabalho no qual você deseja usar o gráfico de conhecimento.

1. No menu de navegação esquerdo, escolha **Editor de consulta**.

1. O editor de consultas é aberto. Agora, você está pronto para executar consultas nos recursos do seu espaço de trabalho.

 **Execute uma consulta**   

**Para executar uma consulta e gerar um gráfico**

1. No editor de consulta, escolha a guia **Editor** para abrir o editor de sintaxe.

1. No espaço do editor, escreva a consulta que você deseja executar nos recursos do seu espaço de trabalho.  
![O espaço do editor com uma consulta inserida.](http://docs.aws.amazon.com/pt_br/iot-twinmaker/latest/guide/images/kg-query-updated.png)

   No exemplo mostrado, a solicitação pesquisa entidades que contêm `vav_%` em seu nome e, em seguida, organiza essas entidades pelo `feed` relacionamento entre elas, usando o código a seguir.

   ```
   SELECT ahu, vav, r FROM EntityGraph
   MATCH (vav)<-[r:feed]-(ahu)
   WHERE vav.entityName LIKE 'vav_%'
   ```
**nota**  
A sintaxe do gráfico de conhecimento usa [partiQL](https://partiql.org/). Para obter informações sobre essa sintaxe, consulte[AWS IoT TwinMaker recursos adicionais do gráfico de conhecimento](tm-knowledge-graph-resources.md).

1. Escolha **Executar consulta** para executar a solicitação que você criou.

   Um gráfico é gerado com base na sua solicitação.  
![Um gráfico mostrando os resultados da consulta detalhados nas etapas anteriores.](http://docs.aws.amazon.com/pt_br/iot-twinmaker/latest/guide/images/tm-kg-graph-output.png)

   O gráfico de exemplo mostrado acima é baseado no exemplo de consulta na etapa 2.

1. Os resultados da consulta também são apresentados em uma lista. Escolha **os resultados** para ver os resultados da consulta em uma lista.

1. Opcionalmente, escolha **Exportar como** para exportar os resultados da consulta no formato JSON ou CSV.

Isso abrange o uso básico do gráfico de conhecimento no console. Para obter mais informações e exemplos que demonstram a sintaxe do gráfico de conhecimento, consulte [AWS IoT TwinMaker recursos adicionais do gráfico de conhecimento](tm-knowledge-graph-resources.md).