# 資料表關聯

本頁說明 `innerJoin()`、`leftJoin()`、`rightJoin()` 的參數形式與產生的 SQL。

## 三種 JOIN

三個方法共用同一個內部實作 `join()`（`src/MySQLPool.ts:151-174`），只差在 JOIN 類型：

| 方法 | SQL |
|---|---|
| `innerJoin(table, first, operator, second?)` | `INNER JOIN` |
| `leftJoin(table, first, operator, second?)` | `LEFT JOIN` |
| `rightJoin(table, first, operator, second?)` | `RIGHT JOIN` |

## 參數形式

| 形式 | 範例 | 產生的 SQL |
|---|---|---|
| 三參數（等值） | `innerJoin("users", "orders.user_id", "users.id")` | `` INNER JOIN `users` ON orders.user_id = users.id `` |
| 四參數（指定運算子） | `leftJoin("p", "a", "!=", "b")` | `` LEFT JOIN `p` ON `a` != `b` `` |

三參數時，第三個參數被當成 `second`，運算子固定為 `=`。

```typescript
const rows = await MySQLPool
  .table("orders")
  .select("orders.id", "users.name", "products.title")
  .innerJoin("users", "orders.user_id", "users.id")
  .leftJoin("order_items", "orders.id", "order_items.order_id")
  .leftJoin("products", "order_items.product_id", "products.id")
  .where("orders.status", "completed")
  .get();
```

## 欄位與資料表名規則

| 對象 | 規則 |
|---|---|
| 被關聯的資料表 | 一律加反引號 |
| `first`、`second` | 不含 `.` 時加反引號，含 `.` 時原樣輸出 |

多表查詢時欄位名容易重複，`select()` 與 `where()` 都使用 `資料表.欄位` 形式可避免欄位名稱不明確（ambiguous column）錯誤。

## 相關頁面

- [欄位與條件](/zh/select-and-where)
- [排序與分頁](/zh/sorting-and-pagination)