IT用語: .sql（SQLファイル）とは｜データベース操作コマンドをまとめたスクリプト

.sql（SQL）ファイルとは

.sqlはSQL（Structured Query Language）文を記述したテキストファイルです。データベースのテーブル定義・データ操作・マイグレーション（スキーマ変更）などをスクリプトとしてファイルに保存し、データベースクライアントで実行します。Gitで管理することで、データベース構造の変更履歴を追跡できます。

SQLファイルの主な用途

DDL（Data Definition Language）— テーブル定義

CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  email VARCHAR(255) UNIQUE NOT NULL,
  created_at TIMESTAMP DEFAULT NOW()
);

CREATE INDEX idx_users_email ON users(email);

DML（Data Manipulation Language）— データ操作

INSERT INTO users (email) VALUES ('test@example.com');
UPDATE users SET email = 'new@example.com' WHERE id = 1;
DELETE FROM users WHERE id = 1;

マイグレーションスクリプト

-- migration: 20260409_add_phone_to_users.sql
ALTER TABLE users ADD COLUMN phone VARCHAR(20);
ALTER TABLE users ADD COLUMN verified_at TIMESTAMP;

データベースマイグレーション管理

.sqlファイルを直接管理する代わりに、Flyway・Liquibase（Java系）・Alembic（Python）・Rails Migrations・Prisma Migrateなどのマイグレーションツールで管理するのが現代的なアプローチです。実行済みのマイグレーションを記録し、未適用分のみを自動的に実行してくれます。