queries
- 인쇄
- PDF
queries
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
VPC 환경에서 이용 가능합니다.
사용자의 Query를 실행합니다.
요청
요청 URL
POST {DATA_QUERY API_URL}/queries
요청 파라미터
| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
|---|---|---|---|---|
| query | Yes | String | 실행할 쿼리문 | |
| projectId | No | Integer | Query를 실행할 Project의 ID | |
| timeout | No | int | 최대값: 60 | 쿼리 최대 수행 시간(단위: 초) 기본값: 20초 |
| isReuse | No | boolean | 쿼리 결과 재사용 여부 기본값: false | |
| reuseMaxAge | No | int | 최대값: 10080 | 쿼리 결과를 재사용할 최대 수명(단위: 분) "60분"을 입력하면 쿼리 실행 시점으로부터 60분 전에 반환할 수 있는 유효한 결과가 있는 경우 결과를 재사용 기본값: 60분(1시간) |
| dataSource | No | String | 쿼리를 실행할 기본 Data Source | |
| database | No | String | 쿼리를 실행할 기본 Database |
요청 헤더
요청 예시
curl -X POST "https://kr.dataquery.naverncp.com/api/v2/queries \
-H "Content-Type:application/json" \
-H "x-ncp-apigw-timestamp: {x-ncp-apigw-timestamp}" \
-H "x-ncp-iam-access-key: {x-ncp-iam-access-key}" \
-H "x-ncp-apigw-signature-v2: {x-ncp-apigw-signature-v2}"
-d \
'{
"query": "SELECT * FROM public_data.korea_trade_insurance.exchange_rate LIMIT 2",
"timeout": 20,
"isReuse": true,
"reuseMaxAge": 60
}'
응답
응답 바디
| 항목 | 타입 | 설명 |
|---|---|---|
| id | String | Query ID |
| columns | Column | Column 정보 |
| data | List<List<Object>> | Query 응답값 |
| offset | long | 쿼리 offset, 다음 응답값 조회 시 offset 전달 필요 |
| isFinished | boolean | 쿼리 결과가 모두 응답되었는지 여부 |
Column
| 항목 | 타입 | 설명 |
|---|---|---|
| name | String | Column 이름 |
| type | String | Column 타입 |
| typeSignature | ClientTypeSignature |
ClientTypeSignature
| 항목 | 타입 | 설명 |
|---|---|---|
| rawType | String | |
| arguments | List<ClientTypeSignatureParameter> |
ClientTypeSignatureParameter
| 항목 | 타입 | 설명 |
|---|---|---|
| kind | String | ENUM 값: TYPE, NAMED_TYPE, LONG, VARIABLE |
| value | Object |
응답 예시
HTTP
| HTTP Status | Description |
|---|---|
| 200 | OK |
JSON
{
"id":"75b1b1bf-e808-456d-aa45-f74aaff0b0a4",
"columns":[
{
"name":"currency_code",
"type":"varchar",
"typeSignature":{
"rawType":"varchar",
"arguments":[
{
"kind":"LONG",
"value":2147483647
}]
}
},
{
"name":"date",
"type":"varchar",
"typeSignature":{
"rawType":"varchar",
"arguments":[
{
"kind":"LONG",
"value":2147483647
}]
}
},
{
"name":"trade_rate",
"type":"varchar",
"typeSignature":{
"rawType":"varchar",
"arguments":[
{
"kind":"LONG",
"value":2147483647
}]
}
},
{
"name":"us_conversion_rate",
"type":"varchar",
"typeSignature":{
"rawType":"varchar",
"arguments":[
{
"kind":"LONG",
"value":2147483647
}]
}
}],
"data":[
[
"CNY",
"1995.10.25",
"92.13",
"0.1203"],
[
"CNY",
"1995.10.24",
"92.13",
"0.1203"]],
"offset":121,
"isFinished":true
}
이 문서가 도움이 되었습니까?