---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 데이터 검색 API

# 데이터 검색 API {#ariaid-title1}

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

데이터 검색 API 메서드 요약 및 설명입니다.
{#r_DataRetrievalAPI__id_gsh_xqt_3xb__entry__2}

| 메서드 요약 | 설명 |
|-|-|
| [getKeys (영문)](https://servicenow-prod.fluidtopics.net/~ALIoU7s_3~KKC_NBK7Tzw "예제 값으로 대상 테이블을 쿼리하고 쉼표로 구분된 sys_id 목록을 반환합니다.") | 예제 값으로 대상 테이블을 쿼리하고 쉼표로 구분된 `sys_id` 목록을 반환합니다. |
| [getRecords (영문)](https://servicenow-prod.fluidtopics.net/UjkwC33FNbAoO6uvOU5PEg "예제 값으로 대상 테이블을 쿼리하고 일치하는 모든 기록과 해당 필드를 반환합니다.") | 예제 값으로 대상 테이블을 쿼리하고 일치하는 모든 기록과 해당 필드를 반환합니다. |
| 가져오기 | 대상 테이블에서 `단일 기록을 sys_id` 으로 쿼리하고 기록과 해당 필드를 반환합니다. |
| [집계](https://servicenow-prod.fluidtopics.net/sOELMUwQ973Cu90WUw4jyg "SUM, COUNT, MIN, MAX, LAST 및 AVG를 포함한 집계 함수를 사용하여 테이블을 쿼리합니다.") | 집계 함수 SUM, COUNT MIN, MAX, LAST 및 AVG를 사용하여 쿼리합니다. 집계 기능을 사용하려면 집계 웹 서비스 플러그인을 활성화하십시오. |
[표 1. 데이터 검색 API]

{#r_DataRetrievalAPI__id_gsh_xqt_3xb}
* **[getKeys (영문)](https://servicenow-prod.fluidtopics.net/~ALIoU7s_3~KKC_NBK7Tzw)**   
  예제 값으로 대상 테이블을 쿼리하고 쉼표로 구분된 `sys_id` 목록을 반환합니다.
* **[getRecords (영문)](https://servicenow-prod.fluidtopics.net/UjkwC33FNbAoO6uvOU5PEg)**   
  예제 값으로 대상 테이블을 쿼리하고 일치하는 모든 기록과 해당 필드를 반환합니다.
* **[가져오기](https://servicenow-prod.fluidtopics.net/T8jC93J73vSGHkb5iAQIjA)**   
  대상 테이블에서 `단일 기록을 sys_id` 으로 쿼리하고 기록과 해당 필드를 반환합니다.
* **[집계](https://servicenow-prod.fluidtopics.net/sOELMUwQ973Cu90WUw4jyg)**   
  SUM, COUNT, MIN, MAX, LAST 및 AVG를 포함한 집계 함수를 사용하여 테이블을 쿼리합니다.

**관련 참조**   

* [데이터 수정 API](https://servicenow-prod.fluidtopics.net/uBUhvR4dZbYq8faWR0Sw2Q "데이터 수정 API 메서드 요약 및 설명입니다.")