> For the complete documentation index, see [llms.txt](https://docs.floui.io/guia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.floui.io/guia/conectores/categorias/manipulacao-de-dados/mysql/mysql-query.md).

# MySQL Query

Executa uma query em um banco de dados MySQL.

{% tabs %}
{% tab title="Parâmetros" %}
![Parâmetros de configuração](https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FHKIqWOjpTmb5ozyHyTCr%2F15.png?alt=media)

<table><thead><tr><th width="198.66666666666666">Campo</th><th width="124">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>Descrição</td><td>Campo de texto</td><td>Descrição visual do conector na construção do fluxo.</td></tr><tr><td>Conta de serviço</td><td>Seletor</td><td>Permite selecionar a conta de serviço do tipo DataURI para realizar a conexão com o banco de dados MySQL.</td></tr><tr><td>Query SQL </td><td>Campo de texto</td><td>Campo para construção da query a ser executada em banco de dados MySQL.</td></tr><tr><td>Output Path</td><td>Campo de texto</td><td>Refere-se ao caminho do resultado da consulta na saída do conector no contexto de execução do fluxo</td></tr></tbody></table>
{% endtab %}

{% tab title="Payload" %}

## Sucesso

Ao realizar com sucesso a consulta no banco de dados externo, os resultados estarão disponibilizados em formato de lista de objetos, como o exemplo abaixo.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe1aZmkp88F1V0wTA61wM0THIpZ2JysL3Z-RCWiGDRVH72D0XfLWg3-Hu-GzDXNJ08bYPYXKWiSGNHDzRLmhXCVCKyF3mV9U0d6X3TXQIb6cliq9Co7TzWT_2H5SaMIqq_ob_zR4Q?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Consulta em registros do banco de dados.</p></figcaption></figure>

## Erro

Os erros na execução do conector podem variar de erros na parametrização, erros no banco de dados externo ou erros na conexão com o banco de dados. Todos estes erros serão informados no conector caso ocorram. Abaixo há erros de sintaxe na consulta e na conexão com banco de dados.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfBUkAxPktM0Av9sV17M8PDmPkwd5kwkI3SYldCtSjFfAePTZ1qMPH5lj-2VArVxj9cI0Om_phF3uJprvROYElIaAQkOo8pknv4EAN2r65UehaKFoSnlEdMn5RlaXHUVopL79tj?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Erro ao encontrar tabela em banco de dados.</p></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcCUBW29bVfU09GAIj4pTTvabCFUWcwAaQUn-ONX6ogbR5_ySRDB4mesXLR0coEOtDZZOkzeF3TjejIeDPWtFXTZQR5uI5i8twkkYy0-MaT6LkoGajY6vr-9LtUJLEdHdmVP8Cx?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Erro na conexão com banco de dados externo.</p></figcaption></figure>

<br>
{% endtab %}
{% endtabs %}


---

# 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://docs.floui.io/guia/conectores/categorias/manipulacao-de-dados/mysql/mysql-query.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.
