SQL ‘Table ‘db.table’ doesn’t exist’ の原因と解決方法

Table ‘db.table’ doesn’t exist (MySQL) / relation “table” does not exist (PostgreSQL) とは

このエラーは、データベース内で存在しないテーブルにアクセスしようとした際に発生します。データの取得、挿入、更新、削除など、あらゆるテーブル操作で遭遇する可能性があります。データベースの接続設定やクエリの内容を確認することが重要です。

エラーの発生パターン

このエラーは主に以下のようなケースで発生します。

パターン1: テーブル名のスペルミス

SELECT * FROM Userss; -- 存在するテーブル名は 'Users'

クエリ内のテーブル名Userssが、データベースに実際に存在するテーブル名Usersと異なっているため、エラーが発生します。テーブル名のスペルミスは最も一般的な原因です。

SELECT * FROM Users;

パターン2: データベースまたはスキーマのコンテキストが不正

USE another_db; -- 'my_table'が存在しないデータベースを選択
SELECT * FROM my_table; -- 'my_table'は'current_db'に存在する

現在のデータベースがanother_dbに設定されているにもかかわらず、current_dbに存在するmy_tableにアクセスしようとしているためエラーになります。正しいデータベースまたはスキーマが選択されているか確認が必要です。

USE current_db; -- 'my_table'が存在するデータベースを選択
SELECT * FROM my_table;

-- または、完全修飾名を使用
-- SELECT * FROM current_db.my_table;

パターン3: テーブルがまだ作成されていないか、削除されている

-- CREATE TABLE MyTable (id INT); -- この行が実行されていない、またはコメントアウトされている
SELECT * FROM MyTable;

クエリを実行する前に、MyTableがまだ作成されていないか、以前に削除されている可能性があります。テーブルの存在を確認してからクエリを実行する必要があります。

CREATE TABLE MyTable (id INT); -- テーブルを先に作成
SELECT * FROM MyTable;

根本原因の特定方法

まず、データベースクライアント（MySQL Workbench, pgAdminなど）で接続しているデータベース内に、クエリで使用しているテーブルが実際に存在するかを確認してください。テーブル名を正確に確認し、大文字・小文字の区別も考慮します。

-- MySQLでテーブル一覧を表示
SHOW TABLES;

-- PostgreSQLでテーブル一覧を表示
SELECT tablename FROM pg_tables WHERE schemaname = 'public';

防止策とベストプラクティス

クエリを作成する際は、データベースのスキーマ定義を常に参照し、テーブル名やカラム名に間違いがないか確認する習慣をつけましょう。また、ORM (Object-Relational Mapping) ツールを使用することも有効です。

-- 特定のテーブルが存在するか確認するクエリ
SELECT table_name 
FROM information_schema.tables 
WHERE table_schema = 'your_database_name' AND table_name = 'your_table_name';

よくある質問（FAQ）