Hxj.Data 聯合查詢：InnerJoin/LeftJoin/RightJoin/CrossJoin/FullJoin/Union/UnionAll 一網打盡

Join 方法對應 SQL 標準

基本 InnerJoin 範例

DbSession.Default.From()
    .InnerJoin(Customers._.CustomerID == Orders._.CustomerID)
    .ToDataTable();

SQL：SELECT * FROM [Customers] INNER JOIN [Orders] ON ([Customers].[CustomerID] = [Orders].[CustomerID])

LeftJoin + Where 篩選

DbSession.Default.From()
    .LeftJoin(Customers._.CustomerID == Orders._.CustomerID)
    .Where(Customers._.Country == "USA")
    .ToDataTable();

SQL：SELECT * FROM [Customers] LEFT OUTER JOIN [Orders] ON (...) WHERE [Customers].[Country] = @p0

三表以上串聯 Join

DbSession.Default.From()
    .InnerJoin(Customers._.CustomerID == Orders._.CustomerID)
    .InnerJoin(Order_Details._.OrderID == Orders._.OrderID)
    .Where(Customers._.Country == "USA")
    .ToDataTable();

鏈式呼叫，順序即 Join 順序，ON 條件以強型別 Field 運算式表達，編譯期檢查。

Union / UnionAll 合併結果集

var q1 = DbSession.Default.From().Select(Products._.ProductID);
var q2 = DbSession.Default.From().Select(ArchivedProducts._.ProductID);
var allIds = q1.UnionAll(q2).ToList();

要求兩查詢欄位數量、型別、順序一致，自動產生 UNION ALL SQL。

最佳實務

• 優先使用 InnerJoin，效能最佳。
• LeftJoin 僅在「主表資料必須保留」時使用。
• 避免 CrossJoin/FullJoin 除非極特殊需求（笛卡兒積/雙向保留）。
• Join 條件務必使用索引欄位（FK/PK），否則大表 Join 災難性慢。
• 只需部分欄位時，搭配 Select 投影，減少網路傳輸與記憶體。

Hxj.Data 以流暢介面封裝標準 SQL Join，型別安全、可讀性高、零字串拼接，是 ORM 層處理關聯查詢的最佳實踐。