Use PostGIS in Hologres - Hologres - Centre de documentation Alibaba Cloud

PostGIS étend les capacités de Hologres en ajoutant des types de données, des fonctions et des opérateurs dédiés aux données spatiales. Utilisez cette extension pour stocker, interroger et analyser des données géographiques : filtres par zone englobante, recherches de proximité, vérifications d'intersection de polygones ou calculs de distance.

Hologres prend en charge la version 3.0.0 de PostGIS. À partir de la version V1.3 de Hologres, la plupart des fonctions PostGIS s'exécutent sur le moteur de requête Hologres (HQE), développé par Alibaba Cloud, qui offre de meilleures performances. Sur les versions antérieures, l'exécution repose sur le moteur de requête PostgreSQL (PQE).

Limites

Les champs de type geometry ou geography ne peuvent pas servir de clés primaires. Privilégiez une clé de substitution de type entier.
Les index spatiaux ne sont pas pris en charge. Pour les jeux de données volumineux, appliquez des préfiltres basés sur la zone englobante (par exemple ST_MakeBox2D combiné à ST_Covers) avant d'utiliser des prédicats spatiaux plus coûteux, afin de réduire la portée de l'analyse.
Sur les instances Hologres antérieures à la version V1.3, toutes les fonctions PostGIS s'exécutent via PQE. Les performances peuvent être inférieures à celles offertes par HQE.

Installer l'extension PostGIS

Exécutez l'instruction suivante en tant que superutilisateur pour installer PostGIS dans une base de données. L'installation s'effectue au niveau de chaque base de données : répétez cette opération pour chacune des bases nécessitant la prise en charge des données spatiales.

CREATE EXTENSION IF NOT EXISTS postgis;

Il est impossible d'installer PostGIS dans le schéma pg_catalog.

Pour vérifier l'installation, exécutez la commande suivante :

SELECT postgis_full_version();

En cas de succès, le système renvoie une chaîne de version telle que POSTGIS="3.0.0 ...".

Pour supprimer l'extension :

DROP EXTENSION postgis;

Important

N'utilisez pas DROP EXTENSION postgis CASCADE. L'option CASCADE supprime tous les objets dépendants, y compris les données PostGIS, les données bitmap dynamiques (roaring bitmap), les données Proxima, les journaux binaires, les données BSI ainsi que les métadonnées associées (tables, vues, données serveur). Cette action est irréversible.

Créer et interroger une table geometry

Dans Hologres, PostGIS prend en charge deux types de données spatiales : geometry (coordonnées planes/cartésiennes) et geography (coordonnées sphériques longitude/latitude). Pour plus de détails sur le type geography, consultez la documentation PostGIS sur geography.

Le type geometry est le plus couramment utilisé. Les étapes suivantes expliquent comment créer une table geometry et exécuter des requêtes spatiales.

1. Créer une table geometry

Lors de la création d'une table, vous pouvez spécifier un sous-type geometry. Sous-types pris en charge : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon.

Sans sous-type :

CREATE TABLE holo_gis_1 (
  id   INT,
  geom geometry,
  PRIMARY KEY (id)
);

Avec un sous-type et un identifiant de système de référence spatiale (SRID) :

CREATE TABLE holo_gis_2 (
  id   INT,
  geom geometry(point, 4326),
  PRIMARY KEY (id)
);

Dans cet exemple, le sous-type est Point et le SRID est 4326 (WGS 84). Si aucun SRID n'est indiqué, la valeur par défaut est 0. Pour en savoir plus sur les SRID, reportez-vous à la documentation PostGIS.

2. Insérer des données spatiales

-- Without SRID
INSERT INTO holo_gis_1 VALUES (1, ST_GeomFromText('point(116 39)'));

-- With SRID 4326
INSERT INTO holo_gis_2 VALUES (1, ST_GeomFromText('point(116 39)', 4326));

Pour plus d'informations sur les fonctions spatiales, consultez Fonctions spatiales.

3. Interroger des données spatiales

Après l'insertion des données, plusieurs types de requêtes sont possibles.

Requête par plage rectangulaire

Renvoie tous les points situés dans une zone englobante.

Sans SRID :

SELECT st_astext(geom)
FROM holo_gis_1
WHERE ST_Covers(
  ST_MakeBox2D(ST_Point(116, 39), ST_Point(117, 40)),
  geom
);

Avec SRID :

SELECT st_astext(geom)
FROM holo_gis_2
WHERE ST_Covers(
  ST_SetSRID(ST_MakeBox2D(ST_Point(116, 39), ST_Point(117, 40)), 4326),
  geom
);

Ces deux requêtes renvoient le résultat suivant :

st_astext
-------------
POINT(116 39)

Vérification d'intersection avec un polygone

Pour identifier les points situés à l'intérieur ou sur la limite d'un polygone, utilisez ST_Covers. La syntaxe est identique à celle de la requête par plage rectangulaire présentée ci-dessus : ST_MakeBox2D génère un polygone rectangulaire dont la limite est incluse dans le test de couverture.

Sans SRID :

SELECT st_astext(geom)
FROM holo_gis_1
WHERE ST_Covers(
  ST_MakeBox2D(ST_Point(116, 39), ST_Point(117, 40)),
  geom
);

Avec SRID :

SELECT st_astext(geom)
FROM holo_gis_2
WHERE ST_Covers(
  ST_SetSRID(ST_MakeBox2D(ST_Point(116, 39), ST_Point(117, 40)), 4326),
  geom
);

Ces deux requêtes renvoient le résultat suivant :

st_astext
-------------
POINT(116 39)

Fonctions spatiales

PostGIS fournit des fonctions permettant de convertir et d'analyser les valeurs geometry. La syntaxe de ces fonctions utilise les paramètres suivants :

geom : une valeur geometry ou une expression évaluée comme geometry
precision : INTEGER ; précision des coordonnées comprise entre 1 et 20 ; valeur par défaut 15
index : INTEGER ; indice basé sur 1, sauf indication contraire
srid : INTEGER ; identifiant du système de référence spatiale

La colonne Required engine indique le moteur de requête chargé d'exécuter chaque fonction :

Engine	When it applies	Performance
HQE (Hologres Query Engine)	Hologres V1.3 et versions ultérieures	Plus élevée — optimisée pour les charges de travail analytiques
PQE (PostgreSQL Query Engine)	Toutes les versions ; requis pour certaines fonctions	Moins élevée — mode de compatibilité

Pour la spécification complète des fonctions PostGIS, consultez la documentation de référence PostGIS.