SQLで外部キー制約付きテーブルへのデータ挿入：ステップバイステップガイド

2024-07-02

PostgreSQLで外部キー制約を持つテーブルにデータを挿入する方法

PostgreSQLにおいて、外部キー制約は、関連する2つのテーブル間のデータ整合性を保つために重要な役割を果たします。外部キー制約は、あるテーブルの列の値が、別のテーブルの主キー列を参照することを保証します。

このチュートリアルでは、INSERTステートメントを使用して、外部キー制約を持つテーブルにデータを挿入する方法を、わかりやすく説明します。

例

以下の例では、customers と orders という2つのテーブルを使用します。

CREATE TABLE customers (
  customer_id SERIAL PRIMARY KEY,
  name VARCHAR(255) NOT NULL
);

CREATE TABLE orders (
  order_id SERIAL PRIMARY KEY,
  customer_id INT NOT NULL REFERENCES customers(customer_id),
  order_date DATE NOT NULL
);

この例では、orders テーブルの customer_id 列は、customers テーブルの customer_id 列を参照する外部キー制約を持っています。つまり、orders テーブルに挿入される customer_id の値は、customers テーブルに存在する customer_id の値と一致する必要があります。

データ挿入

以下の INSERT ステートメントを使用して、customers と orders テーブルにデータを挿入することができます。

INSERT INTO customers (name)
VALUES ('Taro Yamada');

INSERT INTO orders (customer_id, order_date)
VALUES (1, '2024-07-02');

この例では、まず customers テーブルに Taro Yamada という名前の顧客を挿入します。次に、orders テーブルに customer_id 1 (これは Taro Yamada の顧客ID) と order_date 2024-07-02 を持つ注文を挿入します。

外部キー制約違反エラー

orders テーブルに、customers テーブルに存在しない customer_id の値を挿入しようとすると、外部キー制約違反エラーが発生します。例えば、以下のステートメントはエラーになります。

INSERT INTO orders (customer_id, order_date)
VALUES (9999, '2024-07-02');

このエラーを防ぐためには、orders テーブルに挿入する前に、customers テーブルに存在する customer_id であることを確認する必要があります。

補足

INSERT ステートメント以外にも、UPDATE や DELETE ステートメントを使用して、外部キー制約を持つテーブルのデータを操作することができます。
外部キー制約には、ON DELETE RESTRICT や ON UPDATE CASCADE などのオプションを設定することができます。これらのオプションの詳細については、PostgreSQLのマニュアルを参照してください。

PostgreSQLにおける外部キー制約付きテーブルへのデータ挿入：サンプルコード

テーブル定義

CREATE TABLE customers (
  customer_id SERIAL PRIMARY KEY,
  name VARCHAR(255) NOT NULL
);

CREATE TABLE orders (
  order_id SERIAL PRIMARY KEY,
  customer_id INT NOT NULL REFERENCES customers(customer_id),
  order_date DATE NOT NULL
);

データ挿入

顧客を customers テーブルに挿入します。

INSERT INTO customers (name)
VALUES ('Taro Yamada');

Taro Yamada の顧客ID (1) を使用して注文を orders テーブルに挿入します。

INSERT INTO orders (customer_id, order_date)
VALUES (1, '2024-07-02');

存在しない顧客ID (9999) を使用して注文を挿入しようとすると、外部キー制約違反エラーが発生します。

INSERT INTO orders (customer_id, order_date)
VALUES (9999, '2024-07-02');

説明

この例では、customers テーブルに Taro Yamada という名前の顧客を挿入します。
最後のステートメントは、customers テーブルに存在しない customer_id 9999 を使用しようとしているため、エラーが発生します。

このコードは、PostgreSQL 14.0 でテストされています。
外部キー制約の詳細については、PostgreSQLのマニュアルを参照してください。

別のテーブルから参照する

SELECT ステートメントを使用して、別のテーブルからデータを抽出し、それを INSERT ステートメントで使用することができます。この方法は、複数のテーブルにまたがる複雑なデータ挿入に役立ちます。

-- 顧客ID 1 の顧客の名前を取得
SELECT name
FROM customers
WHERE customer_id = 1;

-- 取得した顧客名を使用して注文を挿入
INSERT INTO orders (customer_id, order_date, customer_name)
VALUES (1, '2024-07-02', 'Taro Yamada');

ストアドプロシージャを使用して、外部キー制約を持つテーブルへのデータ挿入をカプセル化することができます。この方法は、複雑なデータ操作を論理的にグループ化し、コードを再利用しやすくするのに役立ちます。

CREATE OR REPLACE PROCEDURE insert_order(
  _customer_id INT,
  _order_date DATE
)
AS $$
BEGIN
  INSERT INTO orders (customer_id, order_date)
  VALUES (_customer_id, _order_date);

  EXCEPTION WHEN FOREIGN_KEY_VIOLATION THEN
    RAISE ERROR '存在しない顧客ID: %', _customer_id;
END;
$$ LANGUAGE plpgsql;

-- ストアドプロシージャを使用して注文を挿入
CALL insert_order(1, '2024-07-02');

各方法の比較

方法	利点	欠点
INSERT ステートメント	シンプルでわかりやすい	複雑なデータ挿入には不向き
別のテーブルから参照	柔軟性が高い	副問合せが複雑になる可能性がある
ストアドプロシージャ	コードを再利用しやすい	開発とメンテナンスが複雑になる可能性がある

どの方法が最適かは、データ挿入の要件と開発者の好みによって異なります。シンプルでわかりやすい方法が必要な場合は、INSERT ステートメントがおすすめです。複雑なデータ挿入やコードの再利用が必要な場合は、別のテーブルからの参照やストアドプロシージャを検討してください。

これらの代替方法に加えて、PostgreSQLには、外部キー制約を持つテーブルにデータを挿入するためのより高度な機能もいくつか用意されています。詳細については、PostgreSQLのマニュアルを参照してください。

sql postgresql