> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentation sur le format CustomSeparated

# CustomSeparated

| Entrée | Sortie | Alias |
| - | - | - |
| ✔ | ✔ | |

## Description

Similaire à [Template](/docs/fr/reference/formats/Template/Template.md), mais il affiche ou lit tous les noms et types de colonnes, et utilise la règle d’échappement définie par le paramètre [format\_custom\_escaping\_rule](/docs/fr/reference/settings/formats/format-custom.md#format_custom_escaping_rule) ainsi que les délimiteurs des paramètres suivants :

* [format\_custom\_field\_delimiter](/docs/fr/reference/settings/formats/format-custom.md#format_custom_field_delimiter)
* [format\_custom\_row\_before\_delimiter](/docs/fr/reference/settings/formats/format-custom.md#format_custom_row_before_delimiter)
* [format\_custom\_row\_after\_delimiter](/docs/fr/reference/settings/formats/format-custom.md#format_custom_row_after_delimiter)
* [format\_custom\_row\_between\_delimiter](/docs/fr/reference/settings/formats/format-custom.md#format_custom_row_between_delimiter)
* [format\_custom\_result\_before\_delimiter](/docs/fr/reference/settings/formats/format-custom.md#format_custom_result_before_delimiter)
* [format\_custom\_result\_after\_delimiter](/docs/fr/reference/settings/formats/format-custom.md#format_custom_result_after_delimiter)

> [!NOTE]
>
> Il n’utilise ni les paramètres de règles d’échappement ni les délimiteurs des chaînes de format.

Il existe également le format [`CustomSeparatedIgnoreSpaces`](/docs/fr/reference/formats/CustomSeparated/CustomSeparatedIgnoreSpaces), similaire à [TemplateIgnoreSpaces](/docs/fr/reference/formats/Template/TemplateIgnoreSpaces.md).

## Exemple d’utilisation

### Insertion de données

À l’aide du fichier texte suivant, nommé `football.txt` :

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

Configurez les paramètres de délimitation personnalisés :

```sql theme={null}
SET format_custom_row_before_delimiter = 'row(';
SET format_custom_row_after_delimiter = ')';
SET format_custom_field_delimiter = ';';
SET format_custom_row_between_delimiter = ',';
SET format_custom_escaping_rule = 'Quoted';
```

Insérez les données :

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

### Lecture des données

Configurez les paramètres de délimitation personnalisés :

```sql theme={null}
SET format_custom_row_before_delimiter = 'row(';
SET format_custom_row_after_delimiter = ')';
SET format_custom_field_delimiter = ';';
SET format_custom_row_between_delimiter = ',';
SET format_custom_escaping_rule = 'Quoted';
```

Lisez les données au format `CustomSeparated` :

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

La sortie sera au format personnalisé configuré :

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

## Paramètres du format

Paramètres supplémentaires :

| Paramètre | Description | Par défaut |
| - | - | - |
| [input\_format\_custom\_detect\_header](/docs/fr/reference/settings/formats/input-format.md#input_format_custom_detect_header) | active la détection automatique de l’en-tête avec les noms et les types, s’il y en a un. | `true` |
| [input\_format\_custom\_skip\_trailing\_empty\_lines](/docs/fr/reference/settings/formats/input-format.md#input_format_custom_skip_trailing_empty_lines) | ignore les lignes vides finales à la fin du fichier. | `false` |
| [input\_format\_custom\_allow\_variable\_number\_of\_columns](/docs/fr/reference/settings/formats/input-format.md#input_format_custom_allow_variable_number_of_columns) | autorise un nombre variable de colonnes au format CustomSeparated, ignore les colonnes supplémentaires et utilise les valeurs par défaut pour les colonnes manquantes. | `false` |