---
title: "CLI"
slug: "dataquery-cli-vpc"
updated: 2026-09-17T09:07:29Z
published: 2026-09-17T09:07:29Z
canonical: "guide.ncloud-docs.com/dataquery-cli-vpc"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

VPC 환경에서 이용 가능합니다.

Data Query에서 제공하는 CLI 사용 방법을 설명합니다.

          참고

          

네이버 클라우드 플랫폼의 Data Query CLI는 현재 User&Password 인증 방식 외 다른 인증 방식을 지원하지 않습니다.

- User: 사용자 AccessKey, Password: 사용자 SecretKey 입력을 통해 사용자 인증

## 준비 사항

CLI를 사용할 환경에 Java 8 이상이 설치되어 있어야 합니다.

## 사용 방법

Data Query CLI 사용 방법을 설명합니다.

### 1. 다운로드

Data Query용 CLI 실행 파일을 아래 링크를 통해 다운로드합니다.

[dataquery-cli-101-437.zip](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/dataquery-cli-101-437.zip?sv=2026-02-06&spr=https&st=2026-11-13T18%3A44%3A15Z&se=2026-11-13T19%3A44%3A15Z&sr=c&sp=r&sig=xqE8TRUfkbqfKnOpPW5UwbvDMbjd2giyceFfsCHH%2F6s%3D)

          참고

          

Data Query CLI는 오픈소스인 [trinodb/trino](https://github.com/trinodb/trino)를 기반으로 합니다. 관련 라이선스 정보는 파일 내 NOTICE 파일을 참조해 주십시오.

### 2. CLI 실행

다운로드 받은 파일을 아래 사용 방법을 참고하여 실행합니다.

#### 2.1. 기본 사용 방법

```
dataquery-cli --user $ACCESS_KEY --password --server $DATAQUERY_ENDPOINT
```

          주의

          

secretKey 정보는 명령어 실행 시 `--password` 옵션 뒤에 입력하지 않으며, 실행 후 `Password:` 프롬프트가 표시되면 입력합니다.

          주의

          

Windows 환경에서 CLI를 사용하는 경우, 아래 내용을 주의해 주십시오.

- 제공되는 cli 바이너리 파일을 java 명령을 통해 실행하거나 아래 별도의 명령어 파일을 생성하여 실행 가능합니다.
- cli 상에서 쿼리 결과를 페이징하는 pager 설정이 Windows에서는 기본 제공이 아니기 때문에 pager 옵션을 빈문자열로 실행해야 오류(경고) 메시지가 터미널 내에 발생하지 않습니다.
- 예시는 다음과 같습니다.
  - dataquery-cli.bat 파일

```
@echo off
java -jar dataquery-cli --pager="" %*
```
  - 실행

```
dataquery-cli.bat --user {ACCESS_KEY} --password --server {DATAQUERY_ENDPOINT}
```

#### 2.2. 사용 가능한 옵션

`dataquery-cli --옵션명` 형태로 사용합니다.

| 옵션명 | 데이터 타입 | 입력값 | 필수 여부 | 비고 |
| --- | --- | --- | --- | --- |
| user | String | 사용자 accessKey | Y |  |
| password | String | 사용자 secretKey | Y |  |
| server | String | Data Query Endpoint | Y | 리전별 Data Query Service Endpoint 참고 |
| reuse-query-result | Boolean | `true` 또는 `false` | N | * default : `false` |
| reuse-query-max-age | Integer | `1` ~ `10,080` | N | * default : `60` * reuse-query-result 값이 `true` 인 경우에만 사용됩니다. (단위: 분) |

**리전별 Data Query Service Endpoint** 현재 KR 리전만 사용 가능하며, 리전 확대 예정입니다.

| 리전 | Endpoint |
| --- | --- |
| KR | https://kr.dataquery.naverncp.com |

          참고

          

dataquery-cli는 trino-cli를 기반으로 제공합니다. 위 안내된 옵션 외 추가 내용은 [Trino 문서](https://trino.io/docs/437/client/cli.html)를 참조해 주십시오.

#### 2.3. 쿼리 결과 재사용 옵션을 포함한 사용 방법

<예시> 제출할 쿼리 결과로 최근 1시간 내 동일 요청쿼리를 재사용하도록 CLI 실행

```
dataquery-cli --user $ACCESS_KEY \
--password \
--server $DATAQUERY_ENDPOINT \
--reuse-query-result \
--reuse-query-max-age 60
```

### 3. 쿼리 제출 및 결과 확인

실행된 CLI 쿼리 프롬프트에서 쿼리를 제출하고 결과를 확인합니다.

```
dataquery> SELECT movieId, COUNT(*) AS ratingCount
        -> FROM public_data.the_movies_dataset.ratings_small
        -> GROUP BY movieId
        -> ORDER BY ratingCount DESC
        -> LIMIT 10;
```

```
//결과 예시
 movieId | ratingCount
---------+-------------
     356 |         341
     296 |         324
     318 |         311
     593 |         304
     260 |         291
     480 |         274
    2571 |         259
       1 |         247
     527 |         244
     589 |         237
(10 rows)

Query 20240304_152527_00139_zuari, FINISHED, 3 nodes
Splits: 30 total, 30 done (100.00%)
0.49 [100K rows, 2.33MB] [204K rows/s, 4.75MB/s]
```

          참고

          

CLI 쿼리 결과 정보가 사용자 터미널 창 크기를 넘어선다면 Pagination이 동작합니다. 아래 입력 키를 참고하여 쿼리 결과를 조회할 수 있습니다.

| 입력 키 | 설명 |
| --- | --- |
| `CTRL` + `f` | 다음 페이지 이동 |
| `CTRL` + `b` | 이전 페이지 이동 |
| `g` | 첫 페이지 이동 |
| `G` | 마지막 페이지 이동 |
| 상/하 화살표 | 1개 Row 씩 상/하 이동 |
| 좌/우 화살표 | Column 좌/우 이동 |
| `q` | 결과 조회를 중지하고 쿼리 프롬프트로 이동 |

### 4. CLI 종료

쿼리 프롬프트 상에 `quit`를 입력합니다.

```
dataquery> quit
```