Un wrapper de données distantes (FDW) est une extension PostgreSQL qui permet d'interroger des données provenant de sources externes comme s'il s'agissait de tables locales. Dans GanosBase, l'extension FDW ajoute la prise en charge des données spatiales : elle mappe automatiquement les types de données géométriques spatiales au type Geometry, ce qui permet d'exécuter des requêtes spatiales sur des tables distantes et locales dans une même instruction.
Ce guide explique comment enregistrer un fichier shapefile OSS en tant que table distante et l'interroger depuis votre cluster PolarDB for PostgreSQL.
Fonctionnement
GanosBase FDW utilise un modèle à trois couches :
Extension — installe la fonctionnalité FDW dans votre base de données (
ganos_fdw, ainsi que ses dépendancesganos_spatialrefetganos_geometry)Serveur distant — objet de connexion nommé pointant vers la source de données externe (dans ce cas, votre compartiment Object Storage Service (OSS))
Table distante — table virtuelle mappée à un fichier ou un jeu de données spécifique sur le serveur distant ; elle ne possède aucun stockage local mais se comporte comme une table classique lors des requêtes
Prérequis
Avant de commencer, assurez-vous de disposer des éléments suivants :
Un cluster PolarDB for PostgreSQL exécutant GanosBase
Un compartiment OSS contenant un fichier shapefile ; le shapefile doit inclure au moins trois fichiers —
.shp,.shxet.dbf— téléchargés dans le même dossierLe compartiment OSS et votre cluster PolarDB situés dans la même région, connectés via l'endpoint interne
Une paire AccessKey (AccessKey ID et AccessKey secret) disposant d'un accès en lecture au compartiment OSS. Pour obtenir une paire AccessKey, consultez Obtenir une paire AccessKey
Configurer et interroger une table distante
Étape 1 : Installer l'extension Ganos_FDW
Choisissez l'une des méthodes suivantes.
Méthode 1 (recommandée) : Installation avec CASCADE
L'option CASCADE installe automatiquement les dépendances requises (ganos_spatialref et ganos_geometry) :
CREATE EXTENSION ganos_fdw WITH schema public CASCADE;
Installez l'extension dans le schéma public pour éviter les problèmes de permissions.
Méthode 2 : Installation manuelle des dépendances
Si vous devez contrôler l'ordre d'installation, exécutez les trois commandes séquentiellement :
CREATE EXTENSION ganos_spatialref;
CREATE EXTENSION ganos_geometry;
CREATE EXTENSION ganos_fdw;
Étape 2 : Enregistrer un shapefile en tant que table distante
2a. Enregistrer le shapefile
Utilisez ST_RegForeignTables pour enregistrer votre shapefile OSS en tant que table distante. Remplacez les espaces réservés par vos valeurs réelles :
SELECT ST_RegForeignTables('OSS://<access_id>:<secret_key>@[<endpoint>]/<bucket>/path/to/file');
| Espace réservé | Description |
|---|---|
<access_id> |
Votre AccessKey ID |
<secret_key> |
Votre AccessKey secret |
<endpoint> |
L'endpoint OSS interne de votre région. Pour les formats d'endpoint, consultez Noms de domaine OSS |
<bucket>/path/to/file |
Le chemin d'accès au répertoire du shapefile dans votre compartiment OSS |
Utilisez l'endpoint OSS interne pour garantir la connectivité entre votre cluster PolarDB et le compartiment OSS. Les deux doivent se trouver dans la même région.
2b. Vérifier l'enregistrement de la table distante
Interrogez la vue information_schema.foreign_tables pour confirmer l'enregistrement :
SELECT foreign_table_name FROM information_schema.foreign_tables ORDER BY foreign_table_name ASC;
Étape 3 : Interroger la table distante
Exécutez une requête spatiale sur la table distante. L'exemple suivant récupère la géométrie et les attributs d'un enregistrement spécifique :
SELECT fid, ST_AsText(geom), name, age, height FROM poly WHERE fid = 1;
Résultat attendu :
fid | ST_AsText(geom) | name | age | height
------+----------------------------------+-----------+-----+--------
1 | POLYGON((5 0,0 0,0 10,5 10,5 0)) | ZhangShan | 35 | 1.84
Étape 4 : Importer les données de la table distante dans une table locale
Choisissez la méthode adaptée à votre situation.
Si aucune table locale n'existe
Créez une table locale et remplissez-la à partir de la table distante en une seule étape :
CREATE TABLE poly_db AS SELECT * FROM poly;
Si une table locale existe déjà
Choisissez l'une des méthodes suivantes pour importer les données :
-
INSERT INTO ... SELECT — ajoutez les lignes de la table distante à la table locale existante :
INSERT INTO poly_db SELECT * FROM poly; -
IMPORT FOREIGN SCHEMA — importez l'intégralité du schéma distant dans un schéma local :
CREATE SCHEMA imp; IMPORT FOREIGN SCHEMA ganos_fdw FROM SERVER ganos_fdw_server INTO imp;
Étape 5 (Facultative) : Supprimer l'extension
Pour désinstaller Ganos_FDW et supprimer tous les objets dépendants, exécutez :
DROP EXTENSION Ganos_FDW CASCADE;
CASCADE supprime toutes les tables distantes et autres objets qui dépendent de l'extension. Assurez-vous de ne plus en avoir besoin avant d'exécuter cette commande.