# TABLEJOIN

database · a deepcalc original · no excel equivalent · no sheets equivalent

inner-joins two ranges on a key column in each

## signature

```
TABLEJOIN(left, left_key_column, right, right_key_column)
```

returns: `array`

## arguments

- left: range — required
- left_key_column: number — required
- right: range — required
- right_key_column: number — required

## examples

formula and result, asserted in the engine test suite.

| formula | result | with |
| --- | --- | --- |
| `=TABLEJOIN(R2:S4, 1, U4:V5, 1)` | `north` | R2=north, R3=south, R4=north, S2=100, S3=200, S4=300, U4=north, U5=south, V4=cold, V5=warm |

## errors

error values observed from the engine — each with a call that produces it.

| error | produced by |
| --- | --- |
| `#VALUE!` | `=TABLEJOIN(2, 2, 2, 4)` |

## related

- [DAVERAGE](https://deepcalc.com/functions/daverage.md) — average of database values matching criteria
- [DCOUNT](https://deepcalc.com/functions/dcount.md) — counts numeric database values matching criteria
- [DCOUNTA](https://deepcalc.com/functions/dcounta.md) — counts non-empty database values matching criteria
- [DGET](https://deepcalc.com/functions/dget.md) — the single database value matching criteria
- [DMAX](https://deepcalc.com/functions/dmax.md) — largest database value matching criteria
- [DMIN](https://deepcalc.com/functions/dmin.md) — smallest database value matching criteria
- [DPRODUCT](https://deepcalc.com/functions/dproduct.md) — product of database values matching criteria
- [DSTDEV](https://deepcalc.com/functions/dstdev.md) — sample standard deviation of matching database values

## navigate

- [all database functions](https://deepcalc.com/functions/database-functions.md)
- [function index](https://deepcalc.com/functions.md) — all 600 functions
- [error values](https://deepcalc.com/errors.md) · [concepts](https://deepcalc.com/concepts.md) · [limits](https://deepcalc.com/limits.md)
- [everything in one file](https://deepcalc.com/llms-full.txt)

source: https://deepcalc.com/functions/tablejoin