> ## 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.

> Documentação para o formato TabSeparatedWithNames

# TabSeparatedWithNames

| Entrada | Saída | Alias                          |
| ------- | ----- | ------------------------------ |
| ✔       | ✔     | `TSVWithNames`, `RawWithNames` |

<div id="description">
  ## Descrição
</div>

Difere do formato [`TabSeparated`](/pt-BR/reference/formats/TabSeparated/TabSeparated) pelo fato de os nomes das colunas serem gravados na primeira linha.

Durante o parsing, espera-se que a primeira linha contenha os nomes das colunas. Você pode usar os nomes das colunas para determinar a posição de cada uma e verificar se estão corretas.

<Note>
  Se a configuração [`input_format_with_names_use_header`](/pt-BR/reference/settings/formats#input_format_with_names_use_header) estiver definida como `1`,
  as colunas dos dados de entrada serão mapeadas para as colunas da tabela com base em seus nomes, e colunas com nomes desconhecidos serão ignoradas se a configuração [`input_format_skip_unknown_fields`](/pt-BR/reference/settings/formats#input_format_skip_unknown_fields) estiver definida como `1`.
  Caso contrário, a primeira linha será ignorada.
</Note>

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

<div id="inserting-data">
  ### Inserção de dados
</div>

Use o arquivo TSV a seguir, chamado `football.tsv`:

```tsv theme={null}
date    season  home_team       away_team       home_team_goals away_team_goals
2022-04-30      2021    Sutton United   Bradford City   1       4
2022-04-30      2021    Swindon Town    Barrow  2       1
2022-04-30      2021    Tranmere Rovers Oldham Athletic 2       0
2022-05-02      2021    Port Vale       Newport County  1       2
2022-05-02      2021    Salford City    Mansfield Town  2       2
2022-05-07      2021    Barrow  Northampton Town        1       3
2022-05-07      2021    Bradford City   Carlisle United 2       0
2022-05-07      2021    Bristol Rovers  Scunthorpe United       7       0
2022-05-07      2021    Exeter City     Port Vale       0       1
2022-05-07      2021    Harrogate Town A.F.C.   Sutton United   0       2
2022-05-07      2021    Hartlepool United       Colchester United       0       2
2022-05-07      2021    Leyton Orient   Tranmere Rovers 0       1
2022-05-07      2021    Mansfield Town  Forest Green Rovers     2       2
2022-05-07      2021    Newport County  Rochdale        0       2
2022-05-07      2021    Oldham Athletic Crawley Town    3       3
2022-05-07      2021    Stevenage Borough       Salford City    4       2
2022-05-07      2021    Walsall Swindon Town    0       3
```

Insira os dados:

```sql theme={null}
INSERT INTO football FROM INFILE 'football.tsv' FORMAT TabSeparatedWithNames;
```

<div id="reading-data">
  ### Leitura de dados
</div>

Leia os dados usando o formato `TabSeparatedWithNames`:

```sql theme={null}
SELECT *
FROM football
FORMAT TabSeparatedWithNames
```

A saída estará em formato separado por tabulações:

```tsv theme={null}
date    season  home_team       away_team       home_team_goals away_team_goals
2022-04-30      2021    Sutton United   Bradford City   1       4
2022-04-30      2021    Swindon Town    Barrow  2       1
2022-04-30      2021    Tranmere Rovers Oldham Athletic 2       0
2022-05-02      2021    Port Vale       Newport County  1       2
2022-05-02      2021    Salford City    Mansfield Town  2       2
2022-05-07      2021    Barrow  Northampton Town        1       3
2022-05-07      2021    Bradford City   Carlisle United 2       0
2022-05-07      2021    Bristol Rovers  Scunthorpe United       7       0
2022-05-07      2021    Exeter City     Port Vale       0       1
2022-05-07      2021    Harrogate Town A.F.C.   Sutton United   0       2
2022-05-07      2021    Hartlepool United       Colchester United       0       2
2022-05-07      2021    Leyton Orient   Tranmere Rovers 0       1
2022-05-07      2021    Mansfield Town  Forest Green Rovers     2       2
2022-05-07      2021    Newport County  Rochdale        0       2
2022-05-07      2021    Oldham Athletic Crawley Town    3       3
2022-05-07      2021    Stevenage Borough       Salford City    4       2
2022-05-07      2021    Walsall Swindon Town    0       3
```

<div id="format-settings">
  ## Configurações de formato
</div>