LINQ

[C#/LINQ] Joinメソッドの使い方 – シーケンスの結合

2025-01-18更新日: 2025-01-18

C#のLINQにおけるJoinメソッドは、2つのシーケンスを結合するために使用されます。

主に、共通のキーを持つ要素を結びつける際に利用されます。

Joinメソッドは、4つのパラメータを取ります：外部シーケンス、外部キーセレクタ、内部キーセレクタ、結果セレクタです。

これにより、外部シーケンスと内部シーケンスのキーが一致する要素を結合し、新しい結果を生成します。

SQLのINNER JOINに相当します。

目次から探す

Joinメソッドとは
Joinメソッドの基本的な使い方
Joinメソッドのパラメータ
Joinメソッドの実践例
Joinメソッドの応用
パフォーマンスと最適化
まとめ

Joinメソッドとは

C#のLINQ(Language Integrated Query)におけるJoinメソッドは、2つのシーケンスを特定のキーに基づいて結合するための機能です。

このメソッドを使用することで、異なるデータソースからの情報を組み合わせて、より意味のあるデータを生成することができます。

例えば、顧客情報と注文情報を結合することで、各顧客が行った注文の詳細を取得することが可能です。

Joinメソッドは、外部シーケンスと内部シーケンスの2つのコレクションを受け取り、指定されたキーに基づいて一致する要素を結合します。

これにより、データの整合性を保ちながら、複雑なデータ操作を簡潔に行うことができます。

LINQのJoinメソッドは、SQLのJOIN文に似た動作をするため、データベースに慣れた開発者にとっても理解しやすいものとなっています。

Joinメソッドの基本的な使い方

シンプルなJoinの例

Joinメソッドを使ったシンプルな例を見てみましょう。

以下のコードでは、顧客情報と注文情報を結合しています。

using System;
using System.Collections.Generic;
using System.Linq;

class Program
{
    static void Main()
    {
        var customers = new List<Customer>
        {
            new Customer { Id = 1, Name = "山田太郎" },
            new Customer { Id = 2, Name = "鈴木一郎" }
        };
        var orders = new List<Order>
        {
            new Order { Id = 1, CustomerId = 1, Product = "パソコン" },
            new Order { Id = 2, CustomerId = 2, Product = "スマートフォン" }
        };
        var result = customers.Join(
            orders,
            customer => customer.Id, // 外部キーセレクタ
            order => order.CustomerId, // 内部キーセレクタ
            (customer, order) => new // 結果セレクタ
            {
                CustomerName = customer.Name,
                Product = order.Product
            });
        foreach (var item in result)
        {
            Console.WriteLine($"{item.CustomerName} が購入した商品: {item.Product}");
        }
    }
}

class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
}

class Order
{
    public int Id { get; set; }
    public int CustomerId { get; set; }
    public string Product { get; set; }
}

山田太郎 が購入した商品: パソコン
鈴木一郎 が購入した商品: スマートフォン

この例では、顧客情報と注文情報を結合し、各顧客が購入した商品を表示しています。

キーセレクタの役割

Joinメソッドでは、外部シーケンスと内部シーケンスのそれぞれからキーを選択するためのセレクタを指定します。

これにより、どの要素が結合されるかを決定します。

外部キーセレクタは、外部シーケンスの要素からキーを取得し、内部キーセレクタは内部シーケンスの要素からキーを取得します。

結果セレクタの使い方

結果セレクタは、結合された要素から新しいオブジェクトを生成するために使用されます。

これにより、必要な情報だけを抽出して新しい形で出力することができます。

上記の例では、顧客名と購入した商品を含む匿名型のオブジェクトを生成しています。

複数のキーを使ったJoin

Joinメソッドは、複数のキーを使って結合することも可能です。

以下の例では、顧客のIDと地域をキーとして使用しています。

using System;
using System.Collections.Generic;
using System.Linq;

class Program
{
    static void Main()
    {
        var customers = new List<Customer>
        {
            new Customer { Id = 1, Region = "関東", Name = "山田太郎" },
            new Customer { Id = 2, Region = "関西", Name = "鈴木一郎" }
        };
        var orders = new List<Order>
        {
            new Order { Id = 1, CustomerId = 1, Region = "関東", Product = "パソコン" },
            new Order { Id = 2, CustomerId = 2, Region = "関西", Product = "スマートフォン" }
        };

        var result = customers.Join(
            orders,
            customer => new { customer.Id, customer.Region }, // 複数のキー
            order => new { Id = order.CustomerId, order.Region }, // 複数のキー
            (customer, order) => new
            {
                CustomerName = customer.Name,
                Product = order.Product
            });

        foreach (var item in result)
        {
            Console.WriteLine($"{item.CustomerName} が購入した商品: {item.Product}");
        }
    }
}

class Customer
{
    public int Id { get; set; }
    public string Region { get; set; }
    public string Name { get; set; }
}

class Order
{
    public int Id { get; set; }
    public int CustomerId { get; set; }
    public string Region { get; set; }
    public string Product { get; set; }
}

山田太郎 が購入した商品: パソコン
鈴木一郎 が購入した商品: スマートフォン

このように、複数のキーを使うことで、より複雑なデータの結合が可能になります。

Joinメソッドのパラメータ

Joinメソッドは、複数のパラメータを受け取ることで、シーケンスの結合を行います。

以下に各パラメータの詳細を説明します。

外部シーケンスと内部シーケンス

外部シーケンス: 結合の基準となるシーケンスです。

通常、主となるデータセットを指します。

内部シーケンス: 外部シーケンスに結合されるシーケンスです。

外部シーケンスの要素と関連するデータを持っています。

例えば、顧客情報が外部シーケンスで、注文情報が内部シーケンスとなることが一般的です。

外部キーセレクタと内部キーセレクタ

外部キーセレクタ: 外部シーケンスの各要素から、結合に使用するキーを選択するための関数です。

これにより、どの要素が結合されるかを決定します。

内部キーセレクタ: 内部シーケンスの各要素から、結合に使用するキーを選択するための関数です。

外部キーセレクタと一致するキーを持つ要素を見つけるために使用されます。

以下は、外部キーセレクタと内部キーセレクタの例です。

var result = externalSequence.Join(
    internalSequence,
    externalItem => externalItem.Key, // 外部キーセレクタ
    internalItem => internalItem.Key, // 内部キーセレクタ
    (externalItem, internalItem) => new { externalItem, internalItem }
);

結果セレクタの詳細

結果セレクタは、結合された要素から新しいオブジェクトを生成するための関数です。

この関数を使用することで、必要な情報だけを抽出し、カスタマイズされた結果を得ることができます。

結果セレクタは、外部シーケンスと内部シーケンスの要素を引数として受け取り、任意の型のオブジェクトを返します。

以下は、結果セレクタの例です。

var result = externalSequence.Join(
    internalSequence,
    externalItem => externalItem.Key,
    internalItem => internalItem.Key,
    (externalItem, internalItem) => new // 結果セレクタ
    {
        ExternalData = externalItem.Data,
        InternalData = internalItem.Data
    }
);

Joinメソッドの戻り値

Joinメソッドの戻り値は、結合された要素から生成された新しいシーケンスです。

このシーケンスは、結果セレクタで指定された型のオブジェクトのコレクションとなります。

戻り値はIEnumerable<T>型であり、LINQの他のメソッドと組み合わせて使用することができます。

例えば、以下のように戻り値を利用して、さらにフィルタリングやソートを行うことができます。

var filteredResult = result.Where(item => item.ExternalData.SomeProperty == "条件");

このように、Joinメソッドはデータの結合を行い、柔軟なデータ操作を可能にします。

Joinメソッドの実践例

Joinメソッドを使った実践的な例をいくつか見ていきましょう。

これにより、実際のアプリケーションでの使用方法が理解できるようになります。

オブジェクトのリストを結合する

以下の例では、顧客情報と注文情報のリストを結合し、各顧客が購入した商品を表示します。

using System;
using System.Collections.Generic;
using System.Linq;

class Program
{
    static void Main()
    {
        var customers = new List<Customer>
        {
            new Customer { Id = 1, Name = "山田太郎" },
            new Customer { Id = 2, Name = "鈴木一郎" }
        };
        var orders = new List<Order>
        {
            new Order { Id = 1, CustomerId = 1, Product = "パソコン" },
            new Order { Id = 2, CustomerId = 2, Product = "スマートフォン" }
        };
        var result = customers.Join(
            orders,
            customer => customer.Id,
            order => order.CustomerId,
            (customer, order) => new
            {
                CustomerName = customer.Name,
                Product = order.Product
            });
        foreach (var item in result)
        {
            Console.WriteLine($"{item.CustomerName} が購入した商品: {item.Product}");
        }
    }
}

class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
}

class Order
{
    public int Id { get; set; }
    public int CustomerId { get; set; }
    public string Product { get; set; }
}

山田太郎 が購入した商品: パソコン
鈴木一郎 が購入した商品: スマートフォン

複数のプロパティを使った結合

複数のプロパティをキーとして使用することで、より複雑なデータの結合が可能です。

以下の例では、顧客のIDと地域をキーとして使用しています。

using System;
using System.Collections.Generic;
using System.Linq;

class Program
{
    static void Main()
    {
        var customers = new List<Customer>
        {
            new Customer { Id = 1, Region = "関東", Name = "山田太郎" },
            new Customer { Id = 2, Region = "関西", Name = "鈴木一郎" }
        };
        var orders = new List<Order>
        {
            new Order { Id = 1, CustomerId = 1, Region = "関東", Product = "パソコン" },
            new Order { Id = 2, CustomerId = 2, Region = "関西", Product = "スマートフォン" }
        };

        // 顧客IDをキーとして結合
        var result = customers.Join(
            orders,
            customer => customer.Id, // 顧客のIDをキーに
            order => order.CustomerId, // 注文の顧客IDをキーに
            (customer, order) => new
            {
                CustomerName = customer.Name,
                Product = order.Product
            });

        foreach (var item in result)
        {
            Console.WriteLine($"{item.CustomerName} が購入した商品: {item.Product}");
        }
    }
}

class Customer
{
    public int Id { get; set; }
    public string Region { get; set; }
    public string Name { get; set; }
}

class Order
{
    public int Id { get; set; }
    public int CustomerId { get; set; }
    public string Region { get; set; }
    public string Product { get; set; }
}

山田太郎 が購入した商品: パソコン
鈴木一郎 が購入した商品: スマートフォン

匿名型を使った結果の生成

Joinメソッドを使用する際、結果セレクタで匿名型を使うことで、必要な情報だけを持つ新しいオブジェクトを生成できます。

以下の例では、顧客名と購入した商品を含む匿名型を生成しています。

using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
    static void Main()
    {
        var customers = new List<Customer>
        {
            new Customer { Id = 1, Name = "山田太郎" },
            new Customer { Id = 2, Name = "鈴木一郎" }
        };
        var orders = new List<Order>
        {
            new Order { Id = 1, CustomerId = 1, Product = "パソコン" },
            new Order { Id = 2, CustomerId = 2, Product = "スマートフォン" }
        };
        var result = customers.Join(
            orders,
            customer => customer.Id,
            order => order.CustomerId,
            (customer, order) => new // 匿名型を使用
            {
                CustomerName = customer.Name,
                Product = order.Product
            });
        foreach (var item in result)
        {
            Console.WriteLine($"{item.CustomerName} が購入した商品: {item.Product}");
        }
    }
}

class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
}

class Order
{
    public int Id { get; set; }
    public int CustomerId { get; set; }
    public string Product { get; set; }
}

山田太郎 が購入した商品: パソコン
鈴木一郎 が購入した商品: スマートフォン

コレクションの結合とフィルタリング

Joinメソッドを使用して結合した後、さらにフィルタリングを行うことも可能です。

以下の例では、特定の条件に基づいて結果をフィルタリングしています。

using System;
using System.Collections.Generic;
using System.Linq;
class Program
{
    static void Main()
    {
        var customers = new List<Customer>
        {
            new Customer { Id = 1, Name = "山田太郎" },
            new Customer { Id = 2, Name = "鈴木一郎" }
        };
        var orders = new List<Order>
        {
            new Order { Id = 1, CustomerId = 1, Product = "パソコン" },
            new Order { Id = 2, CustomerId = 2, Product = "スマートフォン" },
            new Order { Id = 3, CustomerId = 1, Product = "タブレット" }
        };
        var result = customers.Join(
            orders,
            customer => customer.Id,
            order => order.CustomerId,
            (customer, order) => new
            {
                CustomerName = customer.Name,
                Product = order.Product
            })
            .Where(item => item.Product.Contains("パソコン")); // フィルタリング
        foreach (var item in result)
        {
            Console.WriteLine($"{item.CustomerName} が購入した商品: {item.Product}");
        }
    }
}

class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
}

class Order
{
    public int Id { get; set; }
    public int CustomerId { get; set; }
    public string Product { get; set; }
}

山田太郎 が購入した商品: パソコン

このように、Joinメソッドを使うことで、オブジェクトのリストを結合し、必要な情報を抽出したり、フィルタリングしたりすることができます。

Joinメソッドの応用

Joinメソッドは、さまざまなデータ操作に応用できる強力な機能です。

ここでは、複雑な結合や他のLINQメソッドとの組み合わせについて説明します。

複数のJoinを使った複雑な結合

複数のJoinを使用することで、異なるデータソースからの情報を組み合わせることができます。

以下の例では、顧客情報、注文情報、そして製品情報を結合しています。

using System;
using System.Collections.Generic;
using System.Linq;

class Program
{
    static void Main()
    {
        var customers = new List<Customer>
        {
            new Customer { Id = 1, Name = "山田太郎" },
            new Customer { Id = 2, Name = "鈴木一郎" }
        };
        var orders = new List<Order>
        {
            new Order { Id = 1, CustomerId = 1, ProductId = 1 },
            new Order { Id = 2, CustomerId = 2, ProductId = 2 }
        };
        var products = new List<Product>
        {
            new Product { Id = 1, Name = "パソコン" },
            new Product { Id = 2, Name = "スマートフォン" }
        };
        var result = customers.Join(
                orders,
                customer => customer.Id,
                order => order.CustomerId,
                (customer, order) => new { customer, order })
            .Join(
                products,
                combined => combined.order.ProductId,
                product => product.Id,
                (combined, product) => new
                {
                    CustomerName = combined.customer.Name,
                    ProductName = product.Name
                });
        foreach (var item in result)
        {
            Console.WriteLine($"{item.CustomerName} が購入した商品: {item.ProductName}");
        }
    }
}

class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
}

class Order
{
    public int Id { get; set; }
    public int CustomerId { get; set; }
    public int ProductId { get; set; }
}

class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
}

山田太郎 が購入した商品: パソコン
鈴木一郎 が購入した商品: スマートフォン

GroupJoinとの違いと使い分け

Joinメソッドは、1対1の結合を行いますが、GroupJoinメソッドは、1対多の結合を行います。

GroupJoinを使用すると、外部シーケンスの各要素に対して、内部シーケンスの要素をグループ化して取得できます。

以下は、GroupJoinの例です。

var result = customers.GroupJoin(
    orders,
    customer => customer.Id,
    order => order.CustomerId,
    (customer, orderGroup) => new
    {
        CustomerName = customer.Name,
        Orders = orderGroup
    });
foreach (var item in result)
{
    Console.WriteLine($"{item.CustomerName} の注文:");
    foreach (var order in item.Orders)
    {
        Console.WriteLine($" - {order.ProductId}");
    }
}

このように、GroupJoinは、顧客ごとのすべての注文を取得するのに適しています。

Left Joinを実現する方法

C#のLINQには直接的なLeft Joinの機能はありませんが、GroupJoinとSelectManyを組み合わせることで実現できます。

以下の例では、顧客情報と注文情報をLeft Joinしています。

var result = customers.GroupJoin(
    orders,
    customer => customer.Id,
    order => order.CustomerId,
    (customer, orderGroup) => new
    {
        CustomerName = customer.Name,
        Orders = orderGroup.DefaultIfEmpty() // Left Joinを実現
    })
    .SelectMany(
        x => x.Orders,
        (x, order) => new
        {
            CustomerName = x.CustomerName,
            ProductId = order?.ProductId // nullチェック
        });
foreach (var item in result)
{
    Console.WriteLine($"{item.CustomerName} の注文: {item.ProductId ?? "なし"}");
}

山田太郎 の注文: 1
鈴木一郎 の注文: 2

JoinとSelectManyの組み合わせ

JoinメソッドとSelectManyメソッドを組み合わせることで、結合されたデータをフラットな形式で取得することができます。

以下の例では、顧客とその注文を結合し、すべての注文をフラットに表示しています。

var result = customers.Join(
    orders,
    customer => customer.Id,
    order => order.CustomerId,
    (customer, order) => new
    {
        CustomerName = customer.Name,
        ProductId = order.ProductId
    });
foreach (var item in result)
{
    Console.WriteLine($"{item.CustomerName} の注文: {item.ProductId}");
}

山田太郎 の注文: 1
鈴木一郎 の注文: 2

JoinとWhereの併用

JoinメソッドとWhereメソッドを併用することで、結合後に特定の条件でフィルタリングすることができます。

以下の例では、特定の製品を購入した顧客のみを表示しています。

var result = customers.Join(
    orders,
    customer => customer.Id,
    order => order.CustomerId,
    (customer, order) => new
    {
        CustomerName = customer.Name,
        ProductId = order.ProductId
    })
    .Where(item => item.ProductId == 1); // 特定の条件でフィルタリング
foreach (var item in result)
{
    Console.WriteLine($"{item.CustomerName} の注文: {item.ProductId}");
}

山田太郎 の注文: 1

このように、JoinメソッドはさまざまなLINQメソッドと組み合わせることで、柔軟なデータ操作を実現できます。

パフォーマンスと最適化

Joinメソッドは非常に便利ですが、パフォーマンスに影響を与える要因がいくつかあります。

ここでは、Joinメソッドのパフォーマンスに関する注意点や最適化の方法について説明します。

Joinメソッドのパフォーマンスに関する注意点

Joinメソッドを使用する際には、以下の点に注意が必要です。

データのサイズ: 大規模なデータセットを結合する場合、パフォーマンスが低下する可能性があります。

特に、外部シーケンスと内部シーケンスの両方が大きい場合、計算コストが増加します。

キーの選択: 適切なキーを選択しないと、結合の効率が悪化します。

キーがユニークであることが望ましいです。

インデックスの利用: データベースからデータを取得する場合、インデックスが適切に設定されていると、Joinのパフォーマンスが向上します。

大規模データセットでのJoinの最適化

大規模データセットでJoinを行う場合、以下の最適化手法を考慮することが重要です。

データのフィルタリング: Joinを行う前に、Whereメソッドを使用してデータをフィルタリングすることで、結合するデータの量を減らし、パフォーマンスを向上させることができます。
必要なデータのみを取得: すべての列を取得するのではなく、必要な列だけを選択することで、メモリ使用量を削減し、パフォーマンスを向上させることができます。
並列処理の利用: PLINQ(Parallel LINQ)を使用して、Join処理を並列化することで、パフォーマンスを向上させることができます。