ファイルツールウィンドウの使用

このチュートリアルでは、ファイルツールウィンドウの操作方法を学習します。ツールウィンドウはファイルブラウザーウィンドウとして機能し、IDE プロジェクトにアタッチされたファイルやディレクトリ、プロジェクトのルートディレクトリ、IDE の特殊ファイルタイプ：クエリコンソールs、データ処理スクリプト、スクラッチファイルへのアクセスを提供します。

たとえば、新しいディレクトリを添付したり、新しいアイテム (ディレクトリとファイル) を作成したり、エディターでファイルを開いたり、SQL ファイルを実行したり、ファイルのローカル履歴を表示したり、ディレクトリを VCS に置いたりすることができます。ファイルとディレクトリをドラッグして並べ替えたり、ファイルからデータベースにデータをインポートしたりすることもできます。

ツールウィンドウの詳細については、ファイルツールウィンドウを参照してください。

導入の流れ

次のいずれかの方法でファイルツールウィンドウを開くことができます。

メインメニューで表示 | ツールウィンドウ | ファイルへ移動します。
右側のツールウィンドウバーで、ファイルをクリックします。
Alt+2 を押す。

デフォルトでは、ツールウィンドウはメインウィンドウの右側にあります。

ファイルツールウィンドウ (Alt+2)
プロジェクトディレクトリとそこに含まれるユーザーファイル
添付されたディレクトリとそこに含まれるユーザーファイル
プロジェクトにディレクトリをアタッチする方法については、 SQL ファイルを含むディレクトリを添付するを参照してください。
クエリコンソールs
クエリコンソールの作成方法については、クエリコンソールを作成するを参照してください。
データ処理スクリプト: エクストラクター、集約器、ローダー
データ抽出機能とローダーの使用方法については、データ抽出ツールおよびデータローダーのトピックを参照してください。
スクラッチファイル
スクラッチファイルの使用方法については、スクラッチファイルを参照してください。
ディレクトリをプロジェクトにアタッチヘッダーボタン
クエリコンソールにジャンプするツールバーボタン

ユーザーファイル

ファイルツールウィンドウでは、プロジェクトのルートディレクトリとアタッチディレクトリの両方に保存されているファイルにアクセスできます。

プロジェクトルートディレクトリ

DataGrip プロジェクトのルートディレクトリは常にファイルツールウィンドウの上部に表示されます。

IDE で現在のプロジェクトの特定のファイルにすばやくアクセスし、プロジェクトとともに共有したい場合は、ファイルをプロジェクトディレクトリにコピーし、ファイルツールウィンドウでアクセスすることができます。

添付ディレクトリ

DataGrip プロジェクトに任意のディレクトリをアタッチし、ファイルツールウィンドウからそのディレクトリとそのファイルにアクセスできます。アタッチされたディレクトリでは、既存の SQL ファイルを開いたり、新しいファイルを作成したりできます。 DataGrip はファイルにインデックスを付け、 IDE の検索機能を使用してファイルやそのコンテンツの検索が可能になります。

添付された SQL ファイルの場合、実行構成を使用してファイル自体を実行できるほか、ファイルに保存されている個別のクエリも実行できます。エディターツールバーの <データソース> セレクターを使用して任意の SQL ファイルをデータソースに添付できるため、個別のクエリの実行が可能です。ファイルからクエリを実行する方法の詳細については、クエリを実行するトピックを参照してください。

ディレクトリが DataGrip プロジェクトにアタッチされた後、SQL ファイルにアクセスするオプションは次のとおりです：

添付ディレクトリにすでに存在する既存のファイルを開きます。
ファイルツールウィンドウのアタッチディレクトリに新しいファイルを作成します。

ファイルツールウィンドウでファイルを開いたり、作成やコピーする方法を学ぶため、このチュートリアルでは次の例を考えます。すでに SQL ファイルを保存している my_scripts ディレクトリが存在し、IDE でそのディレクトリとそのファイルにアクセスしたいとします。次のクエリセットを query_book.sql ファイルの内容として使用します：

-- Retrieve all actors SELECT actor_id, first_name, last_name, last_update FROM actor; -- Find the number of films each actor has appeared in SELECT a.actor_id, a.first_name, a.last_name, COUNT(fa.film_id) AS film_count FROM actor a JOIN film_actor fa ON a.actor_id = fa.actor_id GROUP BY a.actor_id, a.first_name, a.last_name ORDER BY film_count DESC; -- List all movies by category SELECT c.name AS category, f.title AS film FROM film_category fc JOIN film f ON fc.film_id = f.film_id JOIN category c ON fc.category_id = c.category_id ORDER BY c.name, f.title; -- PostgreSQL -- Delete actors with ID greater than 200 DELETE FROM guest.public.actor WHERE actor_id > 200; -- MySQL -- Delete actors with ID greater than 200 DELETE FROM sakila.actor WHERE actor_id > 200; -- PostgreSQL -- Insert a new actor with the current timestamp INSERT INTO guest.public.actor (first_name, last_name, last_update) VALUES (?, ?, CURRENT_TIMESTAMP); -- MySQL -- Insert a new actor with the current timestamp INSERT INTO sakila.actor (first_name, last_name, last_update) VALUES (?, ?, CURRENT_TIMESTAMP);

DataGrip でファイルを含むディレクトリにアクセスするには、まずそのディレクトリをプロジェクトにアタッチする必要があります。

既存のファイルを開く

ファイルツールウィンドウで、ツールバーのディレクトリをプロジェクトに追加… ボタン () をクリックします。
または、ファイルツールウィンドウの領域を右クリックし、ディレクトリをプロジェクトに追加… を選択します。
ファイルブラウザーで、添付するディレクトリに移動します。この場合は、 my_scripts ディレクトリです。
開くをクリックしてください。
ディレクトリはファイルツールウィンドウで利用可能になります。 SQL ファイルをエディターで開くには、アタッチされたディレクトリノードを展開し、ファイル名をダブルクリックしてください。

任意の拡張子を持つ

また、アタッチディレクトリに新しいファイルを作成することもできます。たとえば、クエリが特定の query_book.sql ファイルまたはさまざまな場所に保存されていて、ローカルマシン上の専用の my_scripts ディレクトリに保存したい場合などです。そのディレクトリを DataGrip プロジェクトにアタッチし、その中に新しい SQL ファイルを作成し、そのファイルに SQL クエリセットをコピーできます。

ファイルツールウィンドウで、ツールバーのディレクトリをプロジェクトに追加… ボタン () をクリックします。
または、ファイルツールウィンドウの領域を右クリックし、ディレクトリをプロジェクトに追加… を選択します。
ファイルブラウザーで、添付するディレクトリに移動します。この場合は、 my_scripts ディレクトリです。
開くをクリックしてください。
添付ディレクトリを右クリックし、新規 | SQL ファイルを選択します。
表示される新規ファイルポップアップウィンドウにファイル名を入力します。例: query_book.sql 。
新しい SQL ファイルは、ファイルツールウィンドウのファイルツリーのアタッチディレクトリノードに表示されます。 DataGrip は、そのファイルをコードエディタのタブでも開きます。
エディターでクエリを入力するか、クエリセットをファイルに貼り付けます。

ファイルの実行

ファイルツールウィンドウから SQL ファイルを実行することも可能です。ファイルのコンテキストメニューを開き、実行対象のデータベースまたはスキーマを選択してください。 DataGrip は、ファイルを実行するための実行 / デバッグ構成を作成します。

各構成は、実行する内容と使用するパラメーターおよび環境を定義する、名前付きの起動プロパティのセットです。実行構成の詳細については、実行 / デバッグ構成を参照してください。

例: identifier.sqlite データベースに対して sqlite-sakila-schema.sql ファイルを実行する必要があります。

ファイルツールウィンドウ（Alt+2 ）で、 sqlite-sakila-schema.sql ファイルに移動し、右クリックして実行 'sqlite-sakila-schema.sql' を選択します。または、選択して Alt+Shift+R を押します。
実行構成の設定を選択します。
- ターゲットデータソース / スキーマで、追加ボタン () をクリックし、 identifier.sqlite データベースを選択します。
- スクリプトファイルでは、SQL ファイルが自動的に追加されます。
実行をクリックしてください。

SQL ファイルの実行の詳細については、ファイルの実行トピックを参照してください。

ファイルからデータベーステーブルにデータをインポートする

ファイルをデータベースエクスプローラーにドラッグし、インポート設定を構成することで、ファイルからデータベーステーブルにデータをインポートできます。例: countries.xlsx ファイルを含む myFiles ディレクトリがあります。ファイルのデータを PostgreSQL データソースの guest.public スキーマにインポートする必要があります。

ディレクトリを IDE プロジェクトにアタッチします。この場合は、 myFiles ディレクトリです。
myFiles ツリーノードで、 countries.xlsx ファイルに移動します。
countries.xlsx ファイルを、データをインポートしたいデータベースエクスプローラーのデータベースにドラッグします。この場合、 PostgreSQL データソースの guest.public スキーマです。

GitHub のディレクトリを共有する

ローカルリポジトリを作成し、それをリモートリポジトリにリンクすることで、GitHub 上の添付ディレクトリを共有できます。例: https://github.com/JetBrainsUser/MyScripts.git GitHub リポジトリにリンクする必要がある MyScripts ディレクトリがあります。

ディレクトリを IDE プロジェクトにアタッチします。この場合は、 MyScripts ディレクトリです。
メインメニューで Git | Git リポジトリの作成に移動し、共有するディレクトリを選択して、添付ディレクトリにローカル Git リポジトリを作成します。
Git | リモートの管理に移動し、GitHub リポジトリへのリンクを新しいリモートとして追加して、ローカルリポジトリとリモートリポジトリをリンクします。

クエリコンソール

クエリコンソールsは、SQLとJSファイルがデータソース用に自動的に作成され、常にデータソースに関連付けられ、IDEプロジェクトの外部に保存されます。クエリコンソールs では、ターミナルと同じように SQL ステートメントを記述および実行できます。クエリコンソールsはプロジェクトコンテキストに含まれません。詳細については、クエリコンソールs に関してクエリコンソールを参照してください。

DataGrip でデータソースを作成すると、クエリコンソールが自動的に作成されます。デフォルトでは、クエリコンソールs はスクラッチとコンソール | データベースコンソール内部ディレクトリに配置されます。

たとえば、 PostgreSQL データソースがあり、すでにそのためのコンソールクエリコンソールを作成して利用しているとします。クエリコンソールはファイルツールウィンドウで開くことができます。クエリコンソールs の作成方法については、クエリコンソールを作成するを参照してください。

既存のクエリコンソールを開く

ファイルツールウィンドウで、スクラッチとコンソール | データベースコンソールに移動します。
PostgreSQL データソースノードを展開します。
コンソール [PostgreSQL] クエリコンソールをダブルクリックします。

DataGrip はエディターでコンソール [PostgreSQL] クエリコンソールを開きます。

新しいクエリコンソールを作成する

ファイルツールウィンドウで、スクラッチとコンソール | データベースコンソールに移動します。
PostgreSQL データソースを右クリックし、新規 | クエリコンソールを選択します。
または、 Ctrl+Shift+Q を押します。

DataGrip は新しいコンソール _1 [PostgreSQL] クエリコンソールを作成し、エディターで開きます。

クエリコンソールの名前を変更する

ファイルツールウィンドウで、スクラッチとコンソール | データベースコンソールに移動します。
PostgreSQL データソースノードを展開します。
名前を変更するクエリコンソールを右クリックし、リファクタリング | 名前の変更を選択します。
または、 Shift+F6 を押します。
名前変更ダイアログで、クエリコンソールの新しい名前を入力します。例: shiny_new_console.sql。

DataGrip はコンソール _1 [PostgreSQL] クエリコンソールの名前を shiny_new_console に変更します。

データ処理スクリプト

コードを記述し、ファイルを対応するディレクトリに配置することで、カスタムデータエクストラクター、アグリゲータ、ローダを作成できます。

例: 選択したデータ内で最長の共通部分文字列を見つけるデータアグリゲータスクリプトの次の Groovy コードがあるとします。

/* * Available context bindings: * COLUMNS List<DataColumn> * ROWS Iterable<DataRow> * OUT { append() } * FORMATTER { format(row, col); formatValue(Object, col); getTypeName(Object, col); isStringLiteral(Object, col); } * TRANSPOSED Boolean * plus ALL_COLUMNS, TABLE, DIALECT * * where: * DataRow { rowNumber(); first(); last(); data(): List<Object>; value(column): Object } * DataColumn { columnNumber(), name() } */ def lcs(X, Y) { int m = X.length() int n = Y.length() int result = 0 int end = 0 int[][] length = new int[2][n+1] int currRow = 0 for (int i = 0; i <= m; i++) { for (int j = 0; j <= n; j++) { if (i == 0 || j == 0) { length[currRow][j] = 0 } else if (X[i - 1] == Y[j - 1]) { length[currRow][j] = length[1 - currRow][j - 1] + 1 if (length[currRow][j] > result) { result = length[currRow][j] end = i - 1 } } else { length[currRow][j] = 0 } } currRow = 1 - currRow } if (result == 0) return "No Common Substring" return X.substring(end - result + 1, end + 1) } ArrayList<String> values = [] ROWS.each { row -> COLUMNS.each { column -> def value = row.value(column) if(value instanceof String) { values.add(value) } } } def result = values[0] values.each { value -> result = lcs(result, value) } OUT.append(result)

カスタムデータアグリゲータを追加する

ファイルツールウィンドウで、 Scratches and Consoles｜Extensions｜データベースツールおよび SQL｜data｜aggregators に移動します。
集約ノードを右クリックし、新規 | ファイルを選択します。
新規ファイルポップアップで、新しいファイル名を入力します。例: longest_common_substring.groovy 。
新しいデータアグリゲータスクリプトをファイルに貼り付けます。
(オプション) 貼り付けたコードを変換するダイアログが表示されたら、キャンセルを押します。このチュートリアルでは、生成されたスクリプト自体を保存します。

新しいデータアグリゲータがデータエディターのステータスバーのアグリゲータリストに表示され、データで使用できるようになります。

スクラッチファイル

スクラッチファイルには、コードの下書き、一時的なメモ、プロジェクトコンテキストに含めるべきではない、または含める必要のないその他のコンテンツを保存できます。

クエリコンソールs とスクラッチの主な違いは、各コンソールが 1 つのデータソースのみにアタッチされるのに対し、スクラッチはコードを保存するためにデータソースにアタッチする必要がない点です。ただし、必要に応じて、スクラッチファイルを任意のデータソースにアタッチできます。

スクラッチファイルは一般に、SQL 以外の種類のファイルに役立ちますが、SQL ファイルにも使用できます。

例: 次の 削除 ステートメントをどこかにすぐに保存する必要があります。

            DELETE FROM address ;
            DELETE FROM city ;
            DELETE FROM country ;
            DELETE FROM language ;
        
  

新しい SQL スクラッチファイルを作成する

ツールウィンドウ内の任意の要素を右クリックし、新規 | スクラッチファイルを選択します。
または、 Ctrl+Alt+Shift+Insert を押します。
新規スクラッチファイル ポップアップで、汎用 SQL を選択します。
新しい SQL スクラッチファイルはスクラッチディレクトリに表示されます。 IDE はそれをエディターで自動的に開きます。
エディターで、ステートメントをスクラッチファイルに貼り付けます。

2026 年 5 月 22 日