> 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/servicos-do-floui/floui-database/consultar-por-campo.md).
# Consultar por campo
{% tabs %}
{% tab title="Parâmetros" %}
Parâmetros de configuração
| Campo | Tipo | Descrição |
| ----------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Descrição | Campo de texto | Descrição visual do conector na construção do fluxo. |
| Tabela de dados | Seletor | Permite selecionar a tabela de dados em que o registro será consultado. |
| Selecionar campo na tabela | Seletor |
Define a forma de seleção do campo da tabela.
Caso optado em Sim, irá disponibilizar um campo do tipo seletor que irá listar todos os campos da tabela.
Caso optado por Não, irá disponibilizar um campo de texto para digitar o campo da tabela.
|
| Nome do campo | Campo de texto |
Campo disponível quando Selecionar campo na tabela estiver com opção Não.
Permite digitar o nome do campo a ser consultado, possibilitando a inserção do nome do campo dinamicamente pela notação Mustache {{msg}}.
|
| Campo na tabela para consulta | Seletor |
Campo disponível quando Selecionar campo na tabela estiver com opção Sim e foi selecionada uma Tabela de dados.
Permite selecionar o campo através de uma lista contendo todos os campos da tabela.
|
| Valor do campo | Campo de texto | Define o valor, preferencialmente único em toda a tabela, a ser usado como parâmetro de consulta. |
| Output Path | Campo de texto | Refere-se ao caminho de saída onde o resultado da consulta será disponibilizado no contexto de execução do conector. |
| {% endtab %} | | |
{% tab title="Payload" %}
## Sucesso
O conector Consultar por Campo é voltado para capturar um registro através de um campo com valor único em relação a todos os outros registros presentes na Floui Database, como um identificador daquele registro. Logo a saída deste conector será limitada a apenas um registro. Caso haja mais de um registro correspondente ao filtro aplicado nas configurações do conector, somente o primeiro será retornado.
Em caso de sucesso na captura do registro único, serão retornadas as seguintes informações do registro.
* payload: Refere-se a carga de dados retornada pelo conector, contendo os dados da consulta.
* \_id: Identificador único do registro no banco de dados NoSQL.
* table: Identificador único da tabela no banco de dados NoSQL.
* data: Objeto com os dados e campos do registro consultado.
* updated\_at: Data de atualização do registro no formato ISO 8601.
* created\_at: Data de criação do registro no formato ISO 8601.
Sucesso na consulta de registro
## Erro
Em casos de erro na captura do registro, será retornado um valor `null` na saída do conector, significado que o registro não existe, ou, houve erro durante a parametrização do conector.
Erro na consulta de registro
{% 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.floui.io/guia/conectores/categorias/servicos-do-floui/floui-database/consultar-por-campo.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
