Using Query Workbench

원문 보기 위키 갱신 2026.10.14

출처: 문서

본문

Query Workbench 사용하기

OpenSearch Dashboards에서 Query Workbench를 사용하여 요청 시 SQL 및 PPL 쿼리를 실행하고, 쿼리를 동등한 REST API 호출로 변환하며, 다양한 응답 형식으로 결과를 보고 저장할 수 있습니다.

Query Workbench는 SQL 또는 PPL을 통한 삭제나 업데이트 작업을 지원하지 않습니다. 데이터에 대한 접근은 읽기 전용입니다. {: .important}

사전 조건

이 튜토리얼을 시작하기 전에 다음 Bulk API 요청을 보내 샘플 문서를 인덱싱하세요:

PUT accounts/_bulk?refresh
{"index":{"_id":"1"}}
{"account_number":1,"balance":39225,"firstname":"Amber","lastname":"Duke","age":32,"gender":"M","address":"880 Holmes Lane","employer":"Pyrami","email":"[email protected]","city":"Brogan","state":"IL"}
{"index":{"_id":"6"}}
{"account_number":6,"balance":5686,"firstname":"Hattie","lastname":"Bond","age":36,"gender":"M","address":"671 Bristol Street","employer":"Netagy","email":"[email protected]","city":"Dante","state":"TN"}
{"index":{"_id":"13"}}
{"account_number":13,"balance":32838,"firstname":"Nanette","lastname":"Bates","age":28,"gender":"F","address":"789 Madison Street","employer":"Quility","email":"[email protected]","city":"Nogal","state":"VA"}
{"index":{"_id":"18"}}
{"account_number":18,"balance":4180,"firstname":"Dale","lastname":"Adams","age":33,"gender":"M","address":"467 Hutchinson Court","email":"[email protected]","city":"Orick","state":"MD"}

{% include copy-curl.html %}

자체 데이터 인덱싱에 대해 알아보려면 인덱스 관리를 참조하세요.

Query Workbench에서 SQL 쿼리 실행하기

다음 단계는 OpenSearch 데이터에 대해 SQL 쿼리를 실행하는 방법을 안내합니다.

Query Workbench에 접근하세요.
- Query Workbench에 접근하려면 OpenSearch Dashboards로 이동하여 메인 메뉴에서 OpenSearch Plugins > Query Workbench를 선택하세요.
쿼리를 실행하세요.
- SQL 버튼을 선택하세요. 쿼리 편집기에 SQL 표현식을 입력한 다음 Run 버튼을 선택하여 쿼리를 실행하세요.
다음 예제 쿼리는 잔액이 10,000보다 큰 계좌에 대해 accounts 인덱스에서 이름, 성, 잔액을 검색하고 잔액 기준 내림차순으로 정렬합니다:
```
SELECT
  firstname,
  lastname,
  balance
FROM
  accounts
WHERE
  balance > 10000
ORDER BY
  balance DESC;
```
{% include copy.html %}
결과를 확인하세요.
- Results 창에서 결과를 확인하세요. 이 창은 쿼리 출력을 표 형식으로 표시합니다. 필요에 따라 결과를 필터링하고 다운로드할 수 있습니다.
쿼리 편집기를 지우세요.
- Clear 버튼을 선택하여 쿼리 편집기를 지우고 새 쿼리를 실행하세요.
쿼리가 처리되는 방식을 살펴보세요.
- Explain 버튼을 선택하여 OpenSearch가 쿼리를 처리하는 방식(단계 및 작업 순서 포함)을 살펴보세요.

Query Workbench에서 PPL 쿼리 실행하기

다음 단계에 따라 OpenSearch 데이터에 대해 PPL 쿼리를 실행하는 방법을 알아보세요.

Query Workbench에 접근하세요.
- Query Workbench에 접근하려면 OpenSearch Dashboards로 이동하여 메인 메뉴에서 OpenSearch Plugins > Query Workbench를 선택하세요.
쿼리를 실행하세요.
- PPL 버튼을 선택하세요. 쿼리 편집기에 PPL 쿼리를 입력한 다음 Run 버튼을 선택하여 쿼리를 실행하세요.
다음은 accounts 인덱스에서 나이가 18보다 큰 문서의 firstname 및 lastname 필드를 검색하는 예제 쿼리입니다:
```
search source=accounts
| where age > 18
| fields firstname, lastname
```
{% include copy.html %}
결과를 확인하세요.
- Results 창에서 결과를 확인하세요. 이 창은 쿼리 출력을 표 형식으로 표시합니다.
쿼리 편집기를 지우세요.
- Clear 버튼을 선택하여 쿼리 편집기를 지우고 새 쿼리를 실행하세요.
쿼리가 처리되는 방식을 살펴보세요.
- Explain 버튼을 선택하여 OpenSearch가 쿼리를 처리하는 방식(단계 및 작업 순서 포함)을 살펴보세요.

더 알아보기 (Learn more)

원문 전체: https://docs.opensearch.org/latest/dashboards/query-workbench/