Data Query 개요
- 인쇄
- PDF
Data Query 개요
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
VPC 환경에서 이용 가능합니다.
개요
Data Query 이용을 신청하면 Data Catalog 데이터 소스가 자동 생성되어, Data Catalog에서 관리하는 Data Schema를 기반으로 Query를 수행할 수 있습니다. Query Editor 메뉴에서 Query 실행, Query 실행 결과 상세 정보, 데이터 소스 추가, 삭제, 관리 등의 기능을 실행할 수 있습니다.
공통 설정
API URL
https://kr.dataquery.naverncp.com/api/v2/
요청 헤더
| 헤더명 | 설명 |
|---|---|
| Content-Type | 요청 Body Content Type을 application/json으로 지정 (POST) |
| x-ncp-apigw-timestamp | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 |
| x-ncp-iam-access-key | NAVER Cloud Platform에서 발급받은 API Key 또는 IAM에서 발급받은 AccessKey |
| x-ncp-apigw-signature-v2 | 위 예제의 Body를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명 HMAC 암호화 알고리즘은 HmacSHA256 사용 |
참고
자세한 내용은 NAVER Cloud Platform API 가이드를 참고해 주십시오.
오퍼레이션
Query
| API명 | 설명 |
|---|---|
| queries | 사용자의 Query 실행 |
에러 응답 형식
API 요청이 잘못되었거나 처리 도중 오류가 발생하면 HTTP 상태 코드로 성공, 실패를 반환하고 JSON 형식으로 상세 메시지를 반환합니다.
응답 예시
{
"type":"http://kr.dataquery.naverncp.com/api/v2/queries",
"title":"query.error.BAD_REQUEST",
"status":400,
"detail":"[query] must not be null",
"instance":"/api/v2/queries",
"errorCode":400
}
에러 응답
| HTTP 상태 | 에러 코드 | 메세지 | 설명 | 해결방안 |
|---|---|---|---|---|
| 400 | 400 | Catalog 'public_data1' does not exist Schema 'public_schema' does not exist | Query에 오류가 있음 | 사용자의 Query, Table 정보 재확인 |
| 403 | 10001 | Change/executeSelectQuery | Sub Account Action 권한 없음 | Sub Account Action 권한 재확인 |
| 401 | 10002 | Authentication Failed - This account is not allowed | 인증 실패 | 헤더값 인증 정보 재확인 |
| 400 | 10010 | Query Project Not Found | projectId가 잘못 설정되었음 | 사용자의 Data Query projectId 재확인 Query 실행 API일 경우 Data Query 상품 이용 신청 |
| 400 | 10090 | mismatched input 'table'. Expecting: <identifier> | Query 문법 오류 | 사용자의 Query 문법 재확인 |
| 400 | 10091 | 'DropCatalog' command is blocked. | 사용할 수 없는 쿼리문 사용 | 사용할 수 없는 쿼리문이므로 쿼리 변경 |
이 문서가 도움이 되었습니까?