--- title: "Data Query overview" slug: "analytics-dataquery" tags: ["Data Catalog"] updated: 2026-09-17T09:47:59Z published: 2026-09-17T09:47:59Z canonical: "api.ncloud-docs.com/analytics-dataquery" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Data Query overview Available in VPC Data Query is a NAVER Cloud Platform service that allows you to easily analyze large amounts of structured or unstructured data with serverless interactive query. The Data Query service provides APIs for query execution and inquiry features in RESTful form. ## Common Data Query settings The following describes commonly used request and response formats in Data Query APIs. ### Request The following describes the common request format. #### API URL The request API URL is as follows: ``` https://kr.dataquery.naverncp.com ``` #### Request headers The following describes the request headers. | Field | Required | Description | | --- | --- | --- | | `x-ncp-apigw-timestamp` | Required | This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC. - Request is considered invalid if the timestamp differs from the current time by more than 5 minutes. - Unix timestamp format. | | `x-ncp-iam-access-key` | Required | Access key issued on NAVER Cloud Platform - Issue and check access key: See [Create authentication key](/docs/en/common-ncpapi). - Issue and check access key for sub account: See [Create sub account](https://guide.ncloud-docs.com/docs/en/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1). | | `x-ncp-apigw-signature-v2` | Required | Base64-encoded signature that encrypts the request information with a secret key that maps to the access key issued on NAVER Cloud Platform, using the HMAC encryption algorithm (HmacSHA256) - Issue and check secret key: See [Create authentication key](/docs/en/common-ncpapi). - Create signature: See [Create signature](/docs/en/common-ncpapi). | | `Content-Type` | Optional | Request data format - `application/json` | ### Response The following describes the common response format. #### Response body The response body includes the following data: **Error** Error defines API call failure information. The following describes each error. | Field | Type | Required | Description | | --- | --- | --- | --- | | `type` | String | - | Request URL | | `title` | String | - | Error type | | `status` | Integer | - | HTTP status code | | `detail` | String | - | Error status message | | `instance` | String | - | Error instance URI | | `errorCode` | Integer | - | Error status code | #### Response status codes The following describes the response status codes. | HTTP status code | Code | Message | Description | Solution | | --- | --- | --- | --- | --- | | 400 | 400 | - Catalog 'public_data1' does not exist - Schema 'public_schema' does not exist | Query statement error | Double-check the query statement and table information. | | 400 | 10010 | Query Project Not Found | Project ID error | Check the query execution project ID. - For the Run query API, check the subscription status for the Data Query service. | | 400 | 10090 | mismatched input 'table'. Expecting: | Query syntax error | Double-check the query syntax. | | 400 | 10091 | 'DropCatalog' command is blocked. | Unavailable query statement | Change query statements after checking query syntax. | | 401 | 10002 | Authentication Failed - This account is not allowed | Authentication failed | Check the authentication information in the request header. | | 403 | 10001 | Change/executeSelectQuery | No action permissions on the sub account | Check sub account permissions. | Note For information about the HTTP status codes common to all NAVER Cloud Platform, see [Ncloud API response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C). #### Response example For response examples when a call is successful, see each API specification. The following is a sample response upon a failed call. ``` { "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 } ``` ## Data Query API The following describes the APIs provided by the Data Query service. | API | Description | | --- | --- | | [Execute query](/docs/en/analytics-dataquery-query-queries) | Run user query. | | [Run query asynchronously](/docs/en/analytics-dataquery-query-asyncqueries) | Run user query asynchronously. | | [Get query result](/docs/en/analytics-dataquery-query-getresult) | Get user query execution results. | | [Get query history](/docs/en/analytics-dataquery-query-getqueries) | Get user query execution history. | | [Cancel query](/docs/en/analytics-dataquery-query-cancel) | Cancel user query execution. | ## Data Query related resources NAVER Cloud Platform provides a variety of related resources to help users better understand Data Query APIs. - Data Query API guides - [Create signature](/docs/en/common-ncpapi): How to create a signature to add to the request header - [Sub Account user guides](https://guide.ncloud-docs.com/docs/en/subaccount-overview): How to issue the access key to be added to the request header - [Common Ncloud response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C): Information on common response status codes of NAVER Cloud Platform used by the Data QueryQuery service - Data Query service guides - [Data Query user guide](https://guide.ncloud-docs.com/docs/en/dataquery-overview): How to use Data Query in the NAVER Cloud Platform console - [Ncloud user environment guide](https://guide.ncloud-docs.com/docs/en/environment-environment-1-1): Guide for VPC and Classic environments and support availability - [Pricing and features](https://www.ncloud.com/product/analytics/dataQuery): View pricing details and key capabilities. - [Latest service news](https://www.ncloud.com/intro/news?categoryCode=ANALY&serviceCode=SV_0241): The latest news on the Data Query service - [FAQs](https://www.ncloud.com/support/faq/prod?categoryCode2=ANALY&categoryCode3=SV_0241&page=1): Get answers to common Data Query questions. - [Contact Support](https://www.ncloud.com/support/question/general): Get help if you can't find what you need in the API guide.