> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. > Format d’entrée qui lit une FeatureCollection GeoJSON et produit une ligne par entité, avec les colonnes id, geometry et properties. # GeoJSON | Entrée | Sortie | Alias | | ------ | ------ | ----- | | ✔ | ✗ | |
## Description
Lit un document [GeoJSON](https://geojson.org/) `FeatureCollection` et produit une ligne par entité. Chaque ligne a le schéma fixe suivant : | Colonne | Type | Description | | ------------ | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `String` | Le membre `id` de l'entité (une chaîne JSON ou un nombre), stocké sous forme de texte ; une chaîne vide si `id` est absent ou `null`. | | `geometry` | `Geometry` | La géométrie de l'entité, stockée sous la forme d'un type variant `Geometry`. | | `properties` | `Nullable(JSON)` | L'objet `properties` de l'entité, stocké dans une colonne `JSON` semi-structurée. Un `"properties": null` explicite est conservé comme `NULL`. | Chaque géométrie est stockée dans le type `Geometry` de ClickHouse (un `Variant`). Les types de géométrie GeoJSON pris en charge sont `Point`, `LineString`, `MultiLineString`, `Polygon` et `MultiPolygon`. Les deux autres types de géométrie GeoJSON, `GeometryCollection` et `MultiPoint`, ne peuvent pas être représentés par le type `Geometry` ; par défaut, la lecture de l'un d'eux dans la colonne `geometry` lève une exception, mais ce comportement peut être modifié pour insérer `NULL` à la place — voir [Gestion des types de géométrie non pris en charge](#unsupported-geometry) ci-dessous. Par défaut, la colonne `geometry` vaut `NULL` uniquement lorsque la géométrie d'une entité est un `null` JSON explicite ; avec `input_format_geojson_unsupported_geometry_handling = 'null'`, elle vaut aussi `NULL` pour un type de géométrie non pris en charge. La structure du document est validée : le `type` de niveau supérieur doit être `FeatureCollection` et chaque élément de `features` doit avoir `type` égal à `Feature`. Les coordonnées doivent respecter les invariants de forme de GeoJSON — un `LineString` (et chaque ligne d'un `MultiLineString`) doit comporter au moins deux positions, et un anneau de `Polygon` (ainsi que chaque anneau d'un `MultiPolygon`) doit être fermé et comporter au moins quatre positions. Les documents mal formés sont rejetés plutôt que chargés silencieusement. Les autres clés de l'objet `FeatureCollection` (comme `name` ou `crs`) et les autres clés à l'intérieur de chaque objet `Feature` (comme `bbox`) sont ignorées. L'ordre des clés est flexible : le `type` de niveau supérieur peut apparaître avant ou après le tableau `features`, et, dans un objet de géométrie, `coordinates` peut apparaître avant ou après `type`. L'inférence de schéma renvoie le schéma fixe ci-dessus, de sorte que `DESCRIBE` et `SELECT ... FROM format(...)` fonctionnent sans définition de table.
## Exemple d’utilisation
Considérons le fichier GeoJSON `london.geojson` ci-dessous, qui contient un mélange de types de géométrie : ```json theme={null} { "type": "FeatureCollection", "features": [ { "type": "Feature", "id": "1", "geometry": {"type": "Point", "coordinates": [-0.0761, 51.5081]}, "properties": {"name": "Tower of London", "feature_type": "landmark", "year_built": 1078} }, { "type": "Feature", "id": "2", "geometry": { "type": "LineString", "coordinates": [[-0.2500, 51.4700], [-0.1800, 51.4900], [-0.1200, 51.5060], [-0.0700, 51.5050], [0.0000, 51.5100]] }, "properties": {"name": "River Thames", "feature_type": "river", "length_km": 346} }, { "type": "Feature", "id": "3", "geometry": { "type": "Polygon", "coordinates": [[[-0.1880, 51.5074], [-0.1533, 51.5074], [-0.1533, 51.5153], [-0.1880, 51.5153], [-0.1880, 51.5074]]] }, "properties": {"name": "Hyde Park", "feature_type": "park", "area_km2": 1.42} } ] } ``` Nous pouvons interroger le fichier et examiner les types de géométrie : ```sql title="Query" theme={null} SELECT id, properties.name AS name, variantType(geometry) AS geo_type FROM file('london.geojson', GeoJSON); ``` ```response title="Response" theme={null} ┌─id─┬─name────────────┬─geo_type───┐ │ 1 │ Tower of London │ Point │ │ 2 │ River Thames │ LineString │ │ 3 │ Hyde Park │ Polygon │ └────┴─────────────────┴────────────┘ ``` L’extension de fichier `.geojson` est automatiquement détectée ; l’argument de format peut donc être omis : ```sql title="Query" theme={null} SELECT id, properties.name AS name, variantType(geometry) AS geo_type FROM file('london.geojson'); ``` Nous pouvons utiliser `variantType` pour déterminer le type sous-jacent de chaque objet Geometry : ```sql title="Query" theme={null} SELECT properties.name AS name, geometry, variantType(geometry) FROM file('london.geojson', GeoJSON); ``` ```response title="Response" theme={null} Row 1: ────── name: Tower of London geometry: (-0.0761,51.5081) variantType(geometry): Point Row 2: ────── name: River Thames geometry: [(-0.25,51.47),(-0.18,51.49),(-0.12,51.506),(-0.07,51.505),(0,51.51)] variantType(geometry): LineString Row 3: ────── name: Hyde Park geometry: [[(-0.188,51.5074),(-0.1533,51.5074),(-0.1533,51.5153),(-0.188,51.5153),(-0.188,51.5074)]] variantType(geometry): Polygon ``` Et nous pouvons extraire les données sous-jacentes comme suit : ```sql title="Query" theme={null} SELECT properties.name AS name, variantType(geometry), geometry.Point, geometry.LineString, geometry.Polygon FROM file('london.geojson', GeoJSON); ``` ```response title="Response" theme={null} Row 1: ────── name: Tower of London variantType(geometry): Point geometry.Point: (-0.0761,51.5081) geometry.LineString: [] geometry.Polygon: [] Row 2: ────── name: River Thames variantType(geometry): LineString geometry.Point: (0,0) geometry.LineString: [(-0.25,51.47),(-0.18,51.49),(-0.12,51.506),(-0.07,51.505),(0,51.51)] geometry.Polygon: [] Row 3: ────── name: Hyde Park variantType(geometry): Polygon geometry.Point: (0,0) geometry.LineString: [] geometry.Polygon: [[(-0.188,51.5074),(-0.1533,51.5074),(-0.1533,51.5153),(-0.188,51.5153),(-0.188,51.5074)]] ``` L’accès à une sous-colonne `Geometry` renvoie la valeur si la ligne contient ce type, et sinon la valeur par défaut du type — `(0,0)` pour `Point` et `[]` pour les types basés sur des tableaux — ; utilisez donc `variantType(geometry)` pour déterminer lequel est présent. Nous pouvons également ingérer des données GeoJSON dans une table : ```sql title="Query" theme={null} CREATE TABLE london ( id String, geometry Geometry, properties Nullable(JSON), name String MATERIALIZED properties.name, feature_type String MATERIALIZED properties.feature_type ) ENGINE = MergeTree ORDER BY id; INSERT INTO london SELECT id, geometry, properties FROM file('london.geojson', GeoJSON); ``` Ensuite, effectuez une requête par type d’entité : ```sql title="Query" theme={null} SELECT name, feature_type, variantType(geometry) AS geo_type FROM london ORDER BY id; ``` ```response title="Response" theme={null} ┌─name────────────┬─feature_type─┬─geo_type───┐ │ Tower of London │ landmark │ Point │ │ River Thames │ river │ LineString │ │ Hyde Park │ park │ Polygon │ └─────────────────┴──────────────┴────────────┘ ``` Nous pouvons également inférer le schéma des données GeoJSON sans définir de table : ```sql title="Query" theme={null} DESCRIBE format(GeoJSON, '{"type":"FeatureCollection","features":[]}'); ``` ```response title="Response" theme={null} ┌─name───────┬─type───────────┐ │ id │ String │ │ geometry │ Geometry │ │ properties │ Nullable(JSON) │ └────────────┴────────────────┘ ```
## Gestion des types de géométrie non pris en charge
Certains types de géométrie GeoJSON valides — tels que `GeometryCollection` et `MultiPoint` — ne peuvent pas être représentés par le type `Geometry` de ClickHouse. Vous pouvez contrôler le comportement lorsqu'une telle géométrie doit être stockée dans la colonne `geometry` à l'aide du paramètre `input_format_geojson_unsupported_geometry_handling`. Les valeurs possibles sont : * `'throw'` — générer une exception (par défaut) * `'null'` — insérer une valeur `NULL` dans la colonne `geometry` et continuer l'analyse Ce comportement s'applique uniquement lorsque la colonne `geometry` est lue. Lorsque `geometry` ne fait pas partie des colonnes de sortie demandées (par exemple `SELECT id FROM ...`), une géométrie non prise en charge est tout de même validée pour vérifier qu'elle est bien formée, mais ne déclenche pas ce traitement : elle ne génère pas d'exception et n'insère pas non plus `NULL`, car aucune valeur géométrique n'est matérialisée.