---
title: "クエリを書く（クエリエディタ） | COMETA Docs"
slug: "query-editor-v2"
updated: 2026-03-26T09:10:03Z
published: 2026-03-26T09:10:03Z
canonical: "documents.trocco.io/query-editor-v2"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documents.trocco.io/llms.txt
> Use this file to discover all available pages before exploring further.

# クエリを書く（クエリエディタ）

## 概要

COMETAでは、クエリの記述、実行、保存機能をサポートしています。 また、クエリの実行結果をCSVファイル形式でダウンロードできます。

              必要な権限

              

**クエリの実行**および**保存されたクエリの閲覧**には、以下の権限が必要です。

- [**実データ閲覧者**](/cometa/docs/cometa-roles-v2#%E5%AE%9F%E3%83%87%E3%83%BC%E3%82%BF%E9%96%B2%E8%A6%A7%E8%80%85)ロール

なお、実データの閲覧にはロール以外の条件が存在します。 詳しくは、[実データの閲覧](/cometa/docs/catalog-glossary-v2#%E5%AE%9F%E3%83%87%E3%83%BC%E3%82%BF%E3%81%AE%E9%96%B2%E8%A6%A7)を参照ください。

              クエリエディタに関する注意事項

              

ページを更新するときは、先にクエリを保存してください。 **ブラウザ上でページを更新すると、それまで書いていたクエリは消去されます。**

## クエリエディタの使い方

画面上の**クエリを書く**をクリックすることで、クエリエディタが開かれます。 データストア名を選択したら、すぐにクエリを書き始めることができます。

              GCPプロジェクトID

              

BigQueryのデータストアをお使いの場合、**GCPプロジェクトID**にてクエリを実行するプロジェクトを選択します。

## クエリエディタの特長

### 多機能なコードエディタ

テーブル名の自動補完にも対応しており、補完時には該当テーブルの[論理名](/cometa/docs/catalog-glossary-v2#%E8%AB%96%E7%90%86%E5%90%8D)も合わせて表示されます。 FROM句を指定すると、以降カラム名の自動補完も行われます。

![query-editor-v2-2024-08-29-3-36-0](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/query-editor-v2-2024-08-29-3-36-0.png)

              BigQueryのデータストアを選択している場合

              

クエリエディタ内に以下も表示されます。

- 標準関数に関するポップヒント
- Syntax Error
- クエリを実行した場合のデータ処理量

### エディタ表示の柔軟性

クエリエディタの横幅はご自由に変更できます。 アセット情報を参照しやすいサイズに調整した上で、クエリを書くことができます。 ![query-editor-v2-2024-08-29-3-36-1](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/query-editor-v2-2024-08-29-3-36-1.gif)

### クエリ実行結果を即座にプレビュー

**クエリを実行**すると、実行結果のプレビューがクエリエディタ直下に表示されます。 [プレビュー](/cometa/docs/table-information-v2#%E3%83%97%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E3%82%BF%E3%83%96)と同様に、要約統計情報の表示やカラムのソート・フィルター機能にも対応しています。

![query-editor-v2-2024-08-29-3-36-2](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/query-editor-v2-2024-08-29-3-36-2.png)

### クエリ実行結果をCSVファイルに保存

BigQuery、Snowflake、またはRedshiftのデータストアの場合、**結果をダウンロード**をクリックすると、実行結果をCSVファイル形式でダウンロードできます。

              クエリ実行結果のダウンロードファイルサイズ制限

              

ダウンロードできるCSVファイルのファイルサイズは最大**1GB**です。 ファイルサイズ上限を超えた行は切り捨てられます。

### クエリの保存

**クエリを保存**をクリックすると、記述したクエリを保存できます。保存したクエリはデータストア単位で管理されます。 **保存したクエリ**をクリックすると、保存したクエリを開くことができます。