---
title: Query Component
slug: low-code/query-component
description: Learn how to create and use Query Components, automated resources that simplify data abstraction from databases. Easily access this functionality through the menu and enter required information like name, description, project, and database connection. Tak
docTags: 
createdAt: 2023-08-24T12:59:21.290Z
---

**Query Components** são recursos automatizados, que também fazem abstração de dados através de consultas no Banco de Dados. Servem para ser utilizados também como objeto de lookup (Select) nos formulários.

## Passo a passo

::::WorkflowBlock
:::WorkflowBlockItem
Acesse a funcionalidade através da navegação no menu **`Gerenciamento > Query Component`**.
:::

:::WorkflowBlockItem
Para cadastrar um novo recurso Query Component, clique no botão "**Criar**";
:::

:::WorkflowBlockItem
Informe o **Nome, Descrição, Projeto **e a **Conexão de Banco de Dados;**

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/4TCiljPpbM9pqsqyFQ2iu_image.png)
:::

:::WorkflowBlockItem
Clique em **“Adicionar”** para incluir campos da tabela.
:::

:::WorkflowBlockItem
Informe o nome da coluno do BD, o tipo de dado, o Nome para o atributo de objeto, Descrição, Máscara (se houver), Largura % e Filtro Angular, Tooltip e HTML.

| **Item**       | **Descrição**                                                                                                                                                                                |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Máscara        | Um *input mask*. Ao usar uma máscara, o campo precisa de uma validadação ou organização do que é inserido. No caso do CPF, a máscara só permitiria que fossem inseridos CPFs reais no campo. |
| Largura        | Tamanho da largura da coluna que está sendo configurada.                                                                                                                                     |
| Filtro Angular | É usado para o caso em que se precisa filtrar alguma informação. Como por exemplo caso seja preciso filtrar a informação da consulta SQL pela idade dos alunos.                              |
| Tooltip        | Uma dica do que significa o objeto ao passar o mouse por cima do objeto.                                                                                                                     |
| Coluna         | Se refere à mesma coluna presente no banco de dados.                                                                                                                                         |
| Expressão      |                                                                                                                                                                                              |
| Tipo           |                                                                                                                                                                                              |

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/z5rIrV9l4VAzOpb_cBkXv_image.png)
:::

:::WorkflowBlockItem
Por tratar-se de SQL é necessário incluir **FROM /  WHERE / ORDER BY \***

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/78TCh139VqAN5oBa7pvtZ_image.png)

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/62e5YJp97sY6FUwVhU6Ao_image.png)
:::
::::



****