> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Representa o conteúdo de uma projeção em tabelas MergeTree. Pode ser usado para introspecção.

# mergeTreeProjection

Representa o conteúdo de uma projeção em tabelas MergeTree. Pode ser usado para introspecção.

<div id="syntax">
  ## Sintaxe
</div>

```sql theme={null}
mergeTreeProjection(database, table, projection)
```

<div id="arguments">
  ## Argumentos
</div>

| Argumento    | Descrição                                              |
| ------------ | ------------------------------------------------------ |
| `database`   | O nome do banco de dados de onde a projeção será lida. |
| `table`      | O nome da tabela de onde a projeção será lida.         |
| `projection` | A projeção que será lida.                              |

<div id="returned_value">
  ## Valor retornado
</div>

Um objeto de tabela com as colunas fornecidas pela projeção indicada.

<div id="usage-example">
  ## Exemplo de uso
</div>

```sql theme={null}
CREATE TABLE test
(
    `user_id` UInt64,
    `item_id` UInt64,
    PROJECTION order_by_item_id
    (
        SELECT _part_offset
        ORDER BY item_id
    )
)
ENGINE = MergeTree
ORDER BY user_id;

INSERT INTO test SELECT number, 100 - number FROM numbers(5);
```

```sql theme={null}
SELECT *, _part_offset FROM mergeTreeProjection(currentDatabase(), test, order_by_item_id);
```

```text theme={null}
   ┌─item_id─┬─_parent_part_offset─┬─_part_offset─┐
1. │      96 │                   4 │            0 │
2. │      97 │                   3 │            1 │
3. │      98 │                   2 │            2 │
4. │      99 │                   1 │            3 │
5. │     100 │                   0 │            4 │
   └─────────┴─────────────────────┴──────────────┘
```

```sql theme={null}
DESCRIBE mergeTreeProjection(currentDatabase(), test, order_by_item_id) SETTINGS describe_compact_output = 1;
```

```text theme={null}
   ┌─name────────────────┬─type───┐
1. │ item_id             │ UInt64 │
2. │ _parent_part_offset │ UInt64 │
   └─────────────────────┴────────┘
```
