> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/pt-br/iot-query/getting-started.md).

# Como começar

Ative o IoT Query no Painel de Administração, configure sua conexão com o banco de dados, explore o esquema de dados e execute consultas telemáticas iniciais

## Primeiros passos

{% hint style="warning" %}
Antes de usar os dados para análises abrangentes e integração, você precisa primeiro ativar o **IoT Query**. Se ainda não tiver acesso, entre em contato conosco para saber como ativá-lo:  <iotquery@navixy.com>
{% endhint %}

Depois que tudo estiver configurado, você receberá um e-mail de boas-vindas com informações detalhadas. Para começar a trabalhar com seus dados, você precisará de:

* Host e porta do banco de dados
* Nome do banco de dados
* Nome de usuário e senha
* Configurações do modo SSL

{% hint style="info" %}
Se você não administra as contas da sua plataforma, entre em contato com seu [Provedor de serviços de GPS/telemática](https://navixy.com/docs/user/pt-br/guide/quick-start/about-service-providers.md) para acessar **IoT Query**.
{% endhint %}

A partir daí, o caminho a seguir é simples:

1. [Configurar sua conexão](https://navixy.com/docs/analytics/pt-br/iot-query/connection-setup.md)\
   Configurar seu cliente SQL ou ferramenta de análise
2. [Explorar esquemas de dados](https://navixy.com/docs/analytics/pt-br/iot-query/schema-overview.md)\
   Descobrir as tabelas e relações dos seus dados
3. [Conferir consultas SQL de exemplo](https://navixy.com/docs/analytics/pt-br/example-queries.md)\
   Usar consultas prontas da nossa ampla coleção de receitas

Também recomendamos que você se familiarize com [Tipos de dados e padrões de campos](#data-types-and-field-standards) e [Considerações importantes](#important-considerations) antes de continuar.

## Tipos de dados e padrões de campos

**IoT Query** usa convenções consistentes de tipos de dados que podem ser diferentes das dos sistemas de origem:

* **Campos de data e hora** usam o `TIMESTAMP` formato
* **Campos de texto** usam `CHARACTER VARYING` ou `TEXT` tipos
* **Campos de ID** seguem um padrão de nomenclatura consistente com o prefixo da tabela (por exemplo, \`user\_id\`, \`device\_id\`)
* **Campos booleanos** use prefixos como `is_`, `has_`, ou `can_` (por exemplo, `is_active`, `has_passport`)

## Considerações importantes

Ao trabalhar com o **IoT Query**, esteja ciente destas limitações atuais:

* **Mensagens de erro** são mínimas para problemas em consultas SQL
* **Camadas de transformação e de insights** ainda estão em desenvolvimento e não estão disponíveis
* **Dados históricos** a disponibilidade depende do plano de assinatura da sua plataforma

Para obter informações detalhadas sobre a estrutura e os recursos, consulte [Visão geral do esquema](https://navixy.com/docs/analytics/pt-br/iot-query/schema-overview.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/analytics/pt-br/iot-query/getting-started.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
