PostgreSQL：テーブル作成を安全に行うためのベストプラクティス

2024-04-03

PostgreSQLでテーブルが存在しない場合のみ作成する方法

IF NOT EXISTS オプションを使う

CREATE TABLE ステートメントに IF NOT EXISTS オプションを追加することで、テーブルが存在しない場合のみ作成できます。

CREATE TABLE IF NOT EXISTS テーブル名 (
  カラム名 型,
  ...
);

例

CREATE TABLE IF NOT EXISTS users (
  id INT PRIMARY KEY,
  name VARCHAR(255),
  email VARCHAR(255)
);

EXISTS サブクエリを使って、テーブルが存在するかどうかを確認してから作成することもできます。

DO $$
BEGIN
  IF NOT EXISTS (
    SELECT *
    FROM information_schema.tables
    WHERE table_name = 'テーブル名'
  ) THEN
    CREATE TABLE テーブル名 (
      カラム名 型,
      ...
    );
  END IF;
END $$;

DO $$
BEGIN
  IF NOT EXISTS (
    SELECT *
    FROM information_schema.tables
    WHERE table_name = 'users'
  ) THEN
    CREATE TABLE users (
      id INT PRIMARY KEY,
      name VARCHAR(255),
      email VARCHAR(255)
    );
  END IF;
END $$;

CREATE OR REPLACE オプションを使う

CREATE OR REPLACE TABLE テーブル名 (
  カラム名 型,
  ...
);

CREATE OR REPLACE TABLE users (
  id INT PRIMARY KEY,
  name VARCHAR(255),
  email VARCHAR(255)
);

注意事項

IF NOT EXISTS オプションと EXISTS サブクエリは、テーブルが存在しないかどうかを確認するだけです。テーブルのスキーマが異なる場合でも、エラーが発生せずに作成されます。
CREATE OR REPLACE オプションは、同名のテーブルが存在する場合は置き換えます。テーブルにデータが入力されている場合は、データが失われます。

PostgreSQLでテーブルが存在しない場合のみ作成するには、IF NOT EXISTS オプション、EXISTS サブクエリ、CREATE OR REPLACE オプションのいずれかを使用できます。それぞれの方法のメリットとデメリットを理解して、目的に合った方法を選択してください。

IF NOT EXISTS オプションを使う

-- テーブルが存在しない場合のみ作成
CREATE TABLE IF NOT EXISTS users (
  id INT PRIMARY KEY,
  name VARCHAR(255),
  email VARCHAR(255)
);

-- テーブルが存在する場合はエラーが発生
CREATE TABLE IF NOT EXISTS users (
  id INT PRIMARY KEY,
  name VARCHAR(255),
  age INT
);

EXISTS サブクエリを使う

-- テーブルが存在しない場合のみ作成
DO $$
BEGIN
  IF NOT EXISTS (
    SELECT *
    FROM information_schema.tables
    WHERE table_name = 'users'
  ) THEN
    CREATE TABLE users (
      id INT PRIMARY KEY,
      name VARCHAR(255),
      email VARCHAR(255)
    );
  END IF;
END $$;

-- テーブルが存在する場合はエラーが発生
DO $$
BEGIN
  IF NOT EXISTS (
    SELECT *
    FROM information_schema.tables
    WHERE table_name = 'users'
  ) THEN
    CREATE TABLE users (
      id INT PRIMARY KEY,
      name VARCHAR(255),
      age INT
    );
  END IF;
END $$;

CREATE OR REPLACE オプションを使う

-- テーブルが存在する場合は置き換えて作成
CREATE OR REPLACE TABLE users (
  id INT PRIMARY KEY,
  name VARCHAR(255),
  email VARCHAR(255)
);

-- テーブルが存在する場合はデータが失われます
CREATE OR REPLACE TABLE users (
  id INT PRIMARY KEY,
  name VARCHAR(255),
  age INT
);

実行方法

その後、PostgreSQLクライアントでファイルを 실행합니다。

PostgreSQLでテーブルが存在しない場合のみ作成する他の方法

pg_catalog.pg_class テーブルには、データベース内のすべてのテーブルの情報が格納されています。このテーブルを使って、テーブルが存在するかどうかを確認してから作成できます。

-- テーブルが存在しない場合のみ作成
DO $$
BEGIN
  IF NOT EXISTS (
    SELECT *
    FROM pg_catalog.pg_class
    WHERE relname = 'テーブル名'
  ) THEN
    CREATE TABLE テーブル名 (
      カラム名 型,
      ...
    );
  END IF;
END $$;

トランザクションを使って、テーブルの作成と存在確認をまとめて実行できます。

-- テーブルが存在しない場合のみ作成
BEGIN;

  IF NOT EXISTS (
    SELECT *
    FROM information_schema.tables
    WHERE table_name = 'テーブル名'
  ) THEN
    CREATE TABLE テーブル名 (
      カラム名 型,
      ...
    );
  END IF;

COMMIT;

PL/pgSQL 関数を使って、テーブルの存在確認と作成をまとめて実行できます。

CREATE FUNCTION テーブル作成(テーブル名 TEXT) RETURNS VOID AS $$
DECLARE
  存在フラグ BOOLEAN;
BEGIN
  SELECT EXISTS (
    SELECT *
    FROM information_schema.tables
    WHERE table_name = テーブル名
  ) INTO 存在フラグ;

  IF NOT 存在フラグ THEN
    CREATE TABLE テーブル名 (
      カラム名 型,
      ...
    );
  END IF;
END;
$$ LANGUAGE plpgsql;

-- テーブルが存在しない場合のみ作成
SELECT テーブル作成('テーブル名');