---
title: "Data Queryの概要"
slug: "analytics-dataquery"
updated: 2026-09-17T09:57:35Z
published: 2026-09-17T09:57:35Z
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の概要

VPC環境で利用できます。

Data Queryは、大規模な定型または非定型データを簡単に分析できる NAVERクラウドプラットフォームのサーバーレス会話型クエリサービスです。Data Queryサービスは、クエリの実行および照会機能関連の APIを RESTfulの形式で提供します。

## Data Queryの共通設定

Data Query APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

### リクエスト

共通リクエスト形式を説明します。

#### API URL

リクエスト API URLは次の通りです。

```
https://kr.dataquery.naverncp.com
```

#### リクエストヘッダ

リクエストヘッダの説明は次の通りです。

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒) - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす - Unix Timestamp形式 |
| `x-ncp-iam-access-key` | Required | NAVERクラウドプラットフォームから発行された Access Key - Access Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - サブアカウントの Access Key発行と確認: [サブアカウントの作成](https://guide.ncloud-docs.com/docs/ja/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 | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名 - Secret Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - 署名の作成: [シグネチャーの作成](/docs/ja/common-ncpapi)を参照 |
| `Content-Type` | Optional | リクエストデータの形式 - `application/json` |

### レスポンス

共通レスポンス形式を説明します。

#### レスポンスボディ

レスポンスボディの説明は次の通りです。

**Error** Errorは API呼び出し失敗情報を定義します。Errorの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `type` | String | - | リクエスト URL |
| `title` | String | - | エラータイプ |
| `status` | Integer | - | HTTPステータスコード |
| `detail` | String | - | エラー状態メッセージ |
| `instance` | String | - | エラーインスタンス URI |
| `errorCode` | Integer | - | エラー状態コード |

#### レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

| HTTPステータスコード | コード | メッセージ | 説明 | 解決策 |
| --- | --- | --- | --- | --- |
| 400 | 400 | - Catalog 'public_data1' does not exist - Schema 'public_schema' does not exist | クエリ文エラー | クエリ文とテーブル情報を再度確認 |
| 400 | 10010 | Query Project Not Found | プロジェクト IDエラー | クエリ実行プロジェクト IDを確認 - クエリ実行 APIの場合、Data Queryサービスの申し込み状況を確認 |
| 400 | 10090 | mismatched input 'table'. Expecting: <identifier> | クエリ構文エラー | クエリ構文を再度確認 |
| 400 | 10091 | 'DropCatalog' command is blocked. | 使用できないクエリ文 | クエリ構文を確認し、クエリ文を変更 |
| 401 | 10002 | Authentication Failed - This account is not allowed | 認証失敗 | リクエストヘッダの認証情報を確認 |
| 403 | 10001 | Change/executeSelectQuery | サブアカウントにアクション権限がない | サブアカウントの権限を確認 |

              参考

              

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

#### レスポンス例

呼び出しが成功した場合のレスポンス例は、API仕様書を確認してください。呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

```
{
    "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

Data Queryサービスが提供する APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [クエリの実行](/docs/ja/analytics-dataquery-query-queries) | ユーザークエリを実行 |
| [クエリの非同期実行](/docs/ja/analytics-dataquery-query-asyncqueries) | ユーザークエリを非同期で実行 |
| [クエリ結果の照会](/docs/ja/analytics-dataquery-query-getresult) | ユーザークエリ実行結果を照会 |
| [クエリ履歴の照会](/docs/ja/analytics-dataquery-query-getqueries) | ユーザークエリ実行履歴を照会 |
| [クエリのキャンセル](/docs/ja/analytics-dataquery-query-cancel) | ユーザークエリの実行をキャンセル |

## Data Query関連リソース

Data Query APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。

- Data Query APIの使用方法
  - [署名(シグネチャー)の作成](/docs/ja/common-ncpapi): リクエストヘッダに追加する署名の作成方法
  - [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): リクエストヘッダに追加する Access Keyの発行方法
  - [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C): Data Queryサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
- Data Queryサービスの使用方法
  - [Data Queryご利用ガイド](https://guide.ncloud-docs.com/docs/ja/dataquery-overview): NAVERクラウドプラットフォームコンソールで Data Queryを使用する方法
  - [Ncloud使用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境とサポート有無に関するガイド
  - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/analytics/dataQuery): Data Queryの料金の紹介、特徴、詳細機能のサマリー
  - [サービスのお知らせ](https://www.ncloud.com/intro/news?categoryCode=ANALY&amp;serviceCode=SV_0241): Data Queryサービスに関するお知らせ
  - [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=ANALY&amp;categoryCode3=SV_0241&amp;page=1): Data Queryサービスに関するよくあるご質問
  - [お問い合わせ](https://www.ncloud.com/support/question/general): APIガイドだけでは不明な点が解消されない場合、直接問い合わせ