Zenn
🔰

初心者向けSQLお作法ガイド

2025/02/10に公開
SQL
駆け出しエンジニア
駆け出し
idea

SQL初心者が効率的で読みやすいコードを書くための「お作法」を解説します。本記事では、良いSQLを書くための基本的なルールや、避けるべき失敗例とその改善方法を具体的に紹介します。

1. SQLを書くときの基本ルール

1.1 キーワードは大文字で

SQLキーワード（例：SELECT, WHERE, FROM）は大文字に統一しましょう。これにより、コードの可読性が向上します。

  • 推奨例：

    SELECT name, age
FROM users
WHERE age > 18;

  • 非推奨例：

    select name, age from users where age > 18;

1.2 インデントと改行を整える

可読性を高めるため、カラムや条件ごとにインデントを入れましょう。

  • 推奨例：

    SELECT
    name,
    age
FROM
    users
WHERE
    age > 18;

  • 非推奨例：

    SELECT name, age FROM users WHERE age > 18;

1.3 意味のある命名規則を守る

テーブル名やカラム名は、短すぎたり曖昧すぎる名前を避け、データの内容が明確にわかる名前を付けましょう。

  • 推奨例：

    SELECT user_id, created_at FROM users;

  • 非推奨例：

    SELECT id, ca FROM tb;

2. 初心者が陥りやすい問題と改善方法

2.1 SELECT * を避ける

SELECT *は便利ですが、必要なカラムを明示しないため、後々のメンテナンスが難しくなります。また、パフォーマンスにも悪影響を与える可能性があります。

  • 非推奨例：

    SELECT * FROM orders;

  • 推奨例：

    SELECT order_id, customer_id, total_amount FROM orders;

2.2 NULL値の扱いに注意

NULLを直接比較しようとすると、期待通りに動作しません。IS NULLやIS NOT NULLを使いましょう。

  • 非推奨例：

    SELECT * FROM users WHERE age = NULL;

  • 推奨例：

    SELECT * FROM users WHERE age IS NULL;

2.3 冗長なサブクエリを避ける

簡潔で分かりやすいクエリを書くことが重要です。サブクエリを多用しすぎるとパフォーマンスが低下し、読みづらくなります。

  • 非推奨例：

    SELECT *
FROM (
    SELECT *
    FROM users
    WHERE age > 18
) AS subquery;

  • 推奨例：

    SELECT *
FROM users
WHERE age > 18;

3. 効率的なSQLを書くためのコツ

3.1 インデックスを活用する

検索条件に指定するカラム（例：WHERE age > 18 のage）にインデックスを設定することで、クエリの実行速度を大幅に向上できます。

  • 例：
    CREATE INDEX idx_users_age ON users(age);

3.2 集約関数を正しく使う

データ集計にはGROUP BYやHAVINGを組み合わせて使いましょう。

  • 例：
    SELECT region, SUM(sales_amount) AS total_sales
FROM sales
GROUP BY region
HAVING total_sales > 1000;

3.3 LIMITで取得件数を制限する

大量のデータを取得しないよう、LIMITを使って必要な件数だけを取得します。

  • 例：
    SELECT * FROM users LIMIT 10;

4. SQLを書く際に役立つツール

4.1 自動フォーマッタ

  • おすすめツール：SQL Formatter, Prettier Plugin for SQL

4.2 クエリパフォーマンス分析ツール

  • 例：MySQLのEXPLAINコマンドを使ってクエリの実行計画を確認。
    EXPLAIN SELECT * FROM users WHERE age > 18;

4.3 SQLエディタ

  • おすすめエディタ：DBeaver, SQL Workbench, DataGrip

5. チェックリスト：SQLを書く前に確認すること

  1. キーワードは大文字に統一されているか？
  2. インデントや改行で可読性を保っているか？
  3. 必要なカラムだけを取得しているか？
  4. NULL値の扱いに注意しているか？
  5. インデックスを有効活用しているか？

まとめ

SQLは簡単に学べる一方で、適切に書くためにはルールやベストプラクティスを守ることが重要です。本記事で紹介したお作法を意識しながら実践を積み重ね、効率的で読みやすいSQLを書けるようになりましょう！

Discussion