> For the complete documentation index, see [llms.txt](https://help.smallbuilder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smallbuilder.com/ko/smallbuilder-lists/undefined-1-1/datatable-setup/query.md).

# QUERY

**리스트 데이터를 조회할 때, SOQL을 작성하여 미리 필터링 및 정렬된 데이터를 가져올 수 있습니다.** 필터는 SOQL의 WHERE 절에 해당하며, 정렬은 ORDER BY 절에 해당합니다. 직접 SOQL을 작성할 수도 있지만, 쿼리 마법사(Query Wizard)를 활용하면 SOQL에 대한 지식 없이도 손쉽게 필터를 적용할 수 있습니다.

{% hint style="info" %}
**Query에서 WHERE 절은 데이터 테이블에 나타날 레코드 목록의 조건을 설정**하는 구문입니다. 직접 WHERE 절을 입력할 수 있으며, 쿼리 마법사(Query Wizard)를 클릭하여 설정할 수도 있습니다.
{% endhint %}

{% hint style="info" %}
**Query에서 ORDER BY 절은 데이터 테이블에 나타날 레코드 목록을 특정 필드로 정렬**하는 구문입니다. 직접 ORDER BY 절을 입력할 수 있으며, 필드 API명(Field API Name Finder)을 클릭하여 설정할 수도 있습니다.
{% endhint %}

***

### :small\_orange\_diamond: 설정 방법

1\. WHERE 절 오른쪽 하단의 쿼리 마법사(Query Wizard)를 클릭합니다.

<div><figure><img src="/files/mh5xGxPHuttgHPi9nm3H" alt="" width="308"><figcaption><p>데이터 테이블 설정 화면</p></figcaption></figure> <figure><img src="/files/I4YmBM0fQxvKUzA0C3nY" alt=""><figcaption><p>쿼리 마법사 화면</p></figcaption></figure></div>

2\. 조건을 걸고 싶은 필드와 값을 설정하고 적용(Apply) 버튼을 클릭합니다.

3\. 데이터 테이블 설정 화면의 ORDER BY 절에서 오른쪽 하단의 필드 API 명(Field API Name Finder)을 클릭합니다.

<figure><img src="/files/Jnyl0ELxuXY0iELHVll9" alt=""><figcaption><p>필드 API명 화면</p></figcaption></figure>

4\. 정렬하고 싶은 필드를 선택합니다.

5\. 결과(Result) 창에 입력된 필드 API 명 뒤에 ASC(오름차순), DESC(내림차순)를 입력하고 저장(Save) 버튼을 클릭합니다.