開発運用

Sequelize テーブル結合ガイド

最終更新： 2月 21, 2025
1 分の読み

Sequelizeを使用してデータベース内のテーブルやクエリを結合する方法について、完全かつ包括的に説明します。Sequelizeは、Node.jsで使用されるORM（Object-Relational Mapping）ライブラリで、リレーショナルデータベースを操作する際に、SQLを直接書くことなくデータベースとやり取りができる便利なツールです。ここでは、Sequelizeを用いたテーブルの結合方法（JOIN操作）と、共通クエリ（サブクエリ）を使用したデータ取得方法を詳しく説明します。

1. Sequelizeでの基本的なテーブルの結合（JOIN）

Sequelizeでは、リレーション（関連）を設定したモデル間で、テーブルを結合することができます。例えば、UserテーブルとProfileテーブルが関連付けられている場合、SequelizeはUserのインスタンスを取得する際に、関連するProfileのデータも同時に取得できます。

関連記事

モデルの定義

まず、UserとProfileという2つのテーブルがあると仮定します。それぞれのテーブルは、以下のように定義されているとします。

javascript
// Userモデル
const User = sequelize.define('User', {
  name: {
    type: Sequelize.STRING,
    allowNull: false
  },
  email: {
    type: Sequelize.STRING,
    allowNull: false
  }
});

// Profileモデル
const Profile = sequelize.define('Profile', {
  userId: {
    type: Sequelize.INTEGER,
    references: {
      model: User,
      key: 'id'
    }
  },
  bio: {
    type: Sequelize.STRING
  }
});

// 関連付け
User.hasOne(Profile, { foreignKey: 'userId' });
Profile.belongsTo(User, { foreignKey: 'userId' });

このように、UserとProfileモデルは1対1の関係（User.hasOne(Profile)）にあります。この関係を利用して、クエリ内でこれらのテーブルを結合できます。

テーブルの結合（JOIN）

次に、Userとその関連するProfileデータを結合して取得する方法を説明します。includeオプションを使用して、関連するテーブルをJOINすることができます。

javascript
User.findAll({
  include: [{
    model: Profile,
    required: true // inner joinと同じ
  }]
}).then(users => {
  console.log(users);
});

ここでは、findAllメソッドでUserテーブルを検索し、Profileテーブルを結合しています。required: trueを設定することで、INNER JOINのように動作します。この設定により、Userと関連するProfileが必ず存在するデータのみが取得されます。

LEFT JOINの使用

LEFT JOINを使用する場合、required: falseを設定します。これにより、Userが存在するがProfileが存在しない場合でも、Userのデータが取得されます。

javascript
User.findAll({
  include: [{
    model: Profile,
    required: false // left join
  }]
}).then(users => {
  console.log(users);
});

この方法で、Profileデータがないユーザーも結果に含めることができます。

2. 複数のテーブルを結合する

Sequelizeでは、複数のテーブルを同時に結合することも可能です。例えば、Userテーブル、Profileテーブル、Postテーブルが関連付けられている場合、次のように3つのテーブルを結合してデータを取得できます。

javascript
User.findAll({
  include: [
    {
      model: Profile,
      required: true
    },
    {
      model: Post,
      required: false
    }
  ]
}).then(users => {
  console.log(users);
});

このコードは、Userテーブル、Profileテーブル、Postテーブルの3つを結合しています。required: trueを使うことでProfileが必須になり、PostはLEFT JOINとしてオプションです。

3. サブクエリを使用した共通クエリ

Sequelizeではサブクエリを使用して、より複雑なクエリを作成することができます。たとえば、特定の条件に基づいてユーザーを取得し、その中でさらにPostのデータをフィルタリングする場合です。

javascript
User.findAll({
  include: [{
    model: Post,
    where: {
      createdAt: {
        [Sequelize.Op.gt]: new Date('2024-01-01')
      }
    },
    required: false
  }]
}).then(users => {
  console.log(users);
});

この例では、PostテーブルをUserに結合し、createdAtが2024年1月1日以降のPostだけを取得しています。where句を使用して、結合されたテーブルのデータに対してフィルタリングを行っています。

4. 集約関数を使ったJOIN

集約関数（COUNT、SUM、AVGなど）を使用してJOINの結果を集計することもできます。例えば、各ユーザーが持つPostの数をカウントする場合です。

javascript
User.findAll({
  include: [{
    model: Post,
    required: false,
    attributes: []
  }],
  attributes: {
    include: [
      [Sequelize.fn('COUNT', Sequelize.col('Posts.id')), 'postCount']
    ]
  },
  group: ['User.id']
}).then(users => {
  console.log(users);
});

ここでは、Postのidの数をカウントし、postCountというカスタムカラムとして結果に含めています。groupを使って、ユーザーごとに集計を行っています。

5. 複雑な条件を持つJOIN

さらに、JOINに複雑な条件を加えることも可能です。たとえば、特定の条件でUserとProfileを結合し、その結果に対して追加の条件を加えたい場合です。

javascript
User.findAll({
  include: [{
    model: Profile,
    where: {
      bio: {
        [Sequelize.Op.like]: '%developer%' // プロフィールに"developer"が含まれるユーザー
      }
    }
  }]
}).then(users => {
  console.log(users);
});

この例では、Profileのbioフィールドに”developer”という文字列が含まれるユーザーのみを取得しています。

6. 注意点とパフォーマンス

Sequelizeを使って複雑なJOINを行う際は、パフォーマンスに注意が必要です。特に、テーブルが大きくなるとJOINのパフォーマンスが低下する可能性があります。インデックスの作成や、適切なデータのキャッシュを活用することがパフォーマンス向上に役立ちます。

また、includeオプションを使って結合する際は、関連するテーブルにインデックスが適切に設定されていることを確認しましょう。インデックスが不足していると、結合の際にパフォーマンスが大幅に低下します。

まとめ

Sequelizeを使用してテーブルを結合する方法について解説しました。基本的なJOINから、複雑な条件や集約関数を使ったJOIN、サブクエリまで幅広くカバーしました。Sequelizeを活用すれば、SQLの詳細な記述を避けつつ、リレーショナルデータベースとの連携を簡潔に行うことができます。性能面や設計に関する注意点を意識しながら、効率的なクエリを構築していきましょう。

最終更新： 2月 21, 2025
1 分の読み
Back to top button