CSVWithNamesAndTypes

Documentation sur le format CSVWithNamesAndTypes

Entrée	Sortie	Alias
✔	✔

​

Description

Affiche également deux lignes d’en-tête avec les noms de colonnes et les types, comme TabSeparatedWithNamesAndTypes.

​

Exemple d’utilisation

​

Insertion de données

À partir de la version 23.1, ClickHouse détecte automatiquement les en-têtes dans les fichiers CSV lors de l’utilisation du format CSV ; il n’est donc pas nécessaire d’utiliser CSVWithNames ou CSVWithNamesAndTypes.

À l’aide du fichier CSV suivant, nommé football_types.csv :

date,season,home_team,away_team,home_team_goals,away_team_goals
Date,Int16,LowCardinality(String),LowCardinality(String),Int8,Int8
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,Salford City,Mansfield Town,2,2
2022-05-02,2021,Port Vale,Newport County,1,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

Créez une table :

CREATE TABLE football
(
    `date` Date,
    `season` Int16,
    `home_team` LowCardinality(String),
    `away_team` LowCardinality(String),
    `home_team_goals` Int8,
    `away_team_goals` Int8
)
ENGINE = MergeTree
ORDER BY (date, home_team);

Insérez des données au format CSVWithNamesAndTypes :

INSERT INTO football FROM INFILE 'football_types.csv' FORMAT CSVWithNamesAndTypes;

​

Lecture des données

Lisez les données au format CSVWithNamesAndTypes :

SELECT *
FROM football
FORMAT CSVWithNamesAndTypes

Le résultat sera un fichier CSV comportant deux lignes d’en-tête pour les noms et les types des colonnes :

"date","season","home_team","away_team","home_team_goals","away_team_goals"
"Date","Int16","LowCardinality(String)","LowCardinality(String)","Int8","Int8"
"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

​

Paramètres de format

Si le paramètre input_format_with_names_use_header est défini sur 1, les colonnes des données d’entrée seront associées aux colonnes de la table en fonction de leur nom, et les colonnes dont le nom est inconnu seront ignorées si le paramètre input_format_skip_unknown_fields est défini sur 1. Sinon, la première ligne sera ignorée.

Si le paramètre input_format_with_types_use_header est défini sur 1, les types des données d’entrée seront comparés à ceux des colonnes correspondantes de la table. Sinon, la deuxième ligne sera ignorée.