# Consultar por campo {% tabs %} {% tab title="Parâmetros" %}

| 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.

## 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.

{% endtab %} {% endtabs %} --- # Agent Instructions: 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: ``` GET https://docs.floui.io/guia/conectores/categorias/servicos-do-floui/floui-database/consultar-por-campo.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.