---
sourceDocument: 호주 애플리케이션 빌드 또는 수정
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/application-development

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 애플리케이션 빌드 또는 수정

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# 쿼리 기록

# 쿼리 기록 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 1분

지정된 테이블에서 여러 기록을 조회합니다.

## 시작하기 전에

필요한 역할: sn_cli_metadata.cli_admin, sn_cli_metadata.cli_user 또는 admin

## 프로시저

시스템의 명령줄 도구를 열고 이 명령을 실행합니다.  

    $ snc record query [--displayvalue displayValue --fields fields --limit limit --offset offset --query query --table table]

이러한 인수에 대한 값을 전달합니다.  
{#query-record__id_b5x_qyf_m4b__entry__2}

| 매개변수 | 설명 |
|-|-|
| displayValue | - `-display값을` 포함하여 데이터베이스에서 참조 및 선택 필드에 대한 표시 값을 검색합니다. 실제 값을 검색하려면 이 매개변수를 포함하지 마십시오. |
| 필드 | 데이터베이스에서 반환할 필드 이름의 목록이며 쉼표로 구분됩니다. |
| 제한 | 반환할 최대 기록 수입니다. |
| 오프셋 | 기록 검색을 시작할 기록 인덱스를 시작하는 중입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. |
| 쿼리 | 필수 `--query "<column_name><operator><value>"` 형식으로 결과 세트를 필터링하는 데 사용되는 인코딩된 쿼리입니다. |
| 테이블 | 필수 기록을 쿼리할 테이블의 이름입니다. |
[ ]

{#query-record__id_b5x_qyf_m4b}

## 예

    $ snc record query --displayvalue --fields short_description,state --query '123TEXTQUERY321=email' --table incident

CLI는 쿼리와 일치하는 모든 기록을 반환합니다.  

    {
       "result": [
          {
             "short_description": "Unable to connect to email",
             "state": "Closed"
          }
       ]
    }