NoSQL/MongoDB Practical Guide with Claude Code

MongoDB開発をClaude Codeで効率化する

MongoDBはドキュメント指向のNoSQLデータベースで、柔軟なスキーマ設計が特徴です。Claude Codeを使えば、適切なスキーマ設計やAggregation Pipelineの構築を効率よく進められます。

スキーマ設計

埋め込み vs 参照の判断

> ECサイトのスキーマを設計して。
> ユーザー、商品、注文の3コレクション。
> パフォーマンスを考慮した設計で。

// Mongooseスキーマ定義
import { Schema, model } from 'mongoose';

// 注文スキーマ：商品情報を埋め込み（非正規化）
const orderSchema = new Schema({
  userId: { type: Schema.Types.ObjectId, ref: 'User', required: true },
  items: [{
    productId: { type: Schema.Types.ObjectId, ref: 'Product' },
    name: String,        // 非正規化：注文時点の商品名を保持
    price: Number,       // 非正規化：注文時点の価格を保持
    quantity: { type: Number, min: 1 },
  }],
  totalAmount: { type: Number, required: true },
  status: {
    type: String,
    enum: ['pending', 'confirmed', 'shipped', 'delivered', 'cancelled'],
    default: 'pending',
  },
  shippingAddress: {
    postalCode: String,
    prefecture: String,
    city: String,
    line1: String,
    line2: String,
  },
}, { timestamps: true });

// インデックス設定
orderSchema.index({ userId: 1, createdAt: -1 });
orderSchema.index({ status: 1, createdAt: -1 });

export const Order = model('Order', orderSchema);

Claude Codeは「頻繁に一緒に読まれるデータは埋め込み、独立して更新されるデータは参照」という設計原則を踏まえて提案してくれます。

Aggregation Pipeline

売上分析クエリ

> 月別・カテゴリ別の売上集計Aggregation Pipelineを作成して。

const salesReport = await Order.aggregate([
  {
    $match: {
      status: { $in: ['confirmed', 'shipped', 'delivered'] },
      createdAt: {
        $gte: new Date('2026-01-01'),
        $lt: new Date('2026-04-01'),
      },
    },
  },
  { $unwind: '$items' },
  {
    $lookup: {
      from: 'products',
      localField: 'items.productId',
      foreignField: '_id',
      as: 'product',
    },
  },
  { $unwind: '$product' },
  {
    $group: {
      _id: {
        month: { $month: '$createdAt' },
        category: '$product.category',
      },
      totalRevenue: { $sum: { $multiply: ['$items.price', '$items.quantity'] } },
      orderCount: { $sum: 1 },
    },
  },
  { $sort: { '_id.month': 1, totalRevenue: -1 } },
]);

インデックス最適化

> このコレクションの検索パターンに最適なインデックスを提案して。

Claude Codeはクエリパターンを分析し、複合インデックスやテキストインデックスの設計を提案してくれます。explain() の結果を見せれば、インデックスが効いているかの確認も手伝ってくれます。

バリデーションとミドルウェア

Mongooseのミドルウェア（pre/post フック）やカスタムバリデーションの実装もClaude Codeが得意とする領域です。

orderSchema.pre('save', function(next) {
  this.totalAmount = this.items.reduce(
    (sum, item) => sum + item.price * item.quantity, 0
  );
  next();
});

Summary

Claude Codeを使えば、MongoDBのスキーマ設計からAggregation Pipeline構築、パフォーマンス最適化まで効率的に進められます。SQLクエリ最適化やデータベースマイグレーションも合わせて参考にしてください。

MongoDBの詳細はMongoDB公式ドキュメントを参照してください。