|Documentation

La base de votre instance

La base incluse dans chaque instance

Chaque instance a sa propre base PostgreSQL avec l'extension PostGIS. Nous l'installons avec l'instance et la faisons tourner pour vous ; elle n'est partagée avec aucune autre instance. Vos projets publiés y lisent leurs couches, et ce que l'on modifie depuis le portail y est écrit directement.

Sur la fiche de l'instance (Instances, puis Gérer), la carte PostgreSQL / PostGIS indique la place occupée par la base. La même mesure s'affiche dans le compteur Base de données de l'onglet Aperçu, et compte dans les limites de votre plan : voir les quotas.

Les paramètres de connexion, à partir du plan Pro

Pour ouvrir la base depuis QGIS ou un autre outil, il vous faut ses paramètres de connexion. Ils figurent sous Informations de connexion, dans la carte PostgreSQL / PostGIS, et sont réservés au plan Pro et au-delà. Sur les autres plans, la section porte la mention PRO et propose Passer en Pro, qui mène aux plans LizPack.

La carte de la base, dépliée : la place occupée et les cinq informations de connexion, masquées et copiables.

Sans ces paramètres, vos cartes fonctionnent normalement : les projets que vous publiez utilisent la base sans que vous ayez à vous y connecter. Le droit suit le plan du propriétaire du compte. Un membre de l'équipe à qui l'on a retiré Voir les bases de données ne reçoit ni l'utilisateur ni le mot de passe.

Se connecter depuis QGIS

La connexion se fait avec les cinq valeurs de Informations de connexion : Base de données, Utilisateur, Mot de passe, Hôte et Port. Le mot de passe est masqué : l'œil l'affiche, l'icône voisine copie la valeur.

  1. Ouvrez la fiche de l'instance depuis Instances, onglet Composants, et dépliez la carte PostgreSQL / PostGIS.
  2. Dans QGIS, créez une nouvelle connexion PostgreSQL depuis le gestionnaire des sources de données.
  3. Recopiez l'hôte, le port et le nom de la base. Saisissez l'utilisateur et le mot de passe dans l'authentification de base.
  4. Testez la connexion, puis enregistrez-la. Vos tables apparaissent sous cette connexion dans l'explorateur de QGIS.

L'hôte et le port

L'hôte n'est pas l'adresse de votre portail. C'est l'adresse des bases du serveur qui héberge votre instance, commune à toutes les bases de ce serveur ; c'est le port qui désigne la vôtre. Ce port n'est pas le 5432 habituel de PostgreSQL : remplacez la valeur que QGIS propose par celle de la fiche.

La connexion est chiffrée. Le mode SSL proposé par défaut par QGIS convient, de même que require ; les modes qui vérifient le certificat (verify-ca, verify-full) échouent. Si la connexion échoue avec les bonnes valeurs, vérifiez que votre réseau laisse sortir les connexions vers ce port : certains réseaux d'entreprise les bloquent.

Publier un projet qui utilise la base

Déposez le projet tel que QGIS l'a enregistré, avec cette connexion. Au dépôt, nous faisons passer ses couches par l'intérieur du serveur : le portail n'utilise pas l'adresse publique de la base. L'extension LizPack Publisher sait aussi lister vos tables et les ajouter à QGIS : voir les couches PostGIS.

Le dépôt refuse un projet dont une couche PostgreSQL pointe vers une autre base que celle de l'instance : autre hôte, autre base, autre port ou autre utilisateur. Le message de refus rappelle les valeurs attendues.

Travailler dans la base

Avec les mêmes paramètres, tout client PostgreSQL convient : pgAdmin, DBeaver, psql. Vous y travaillez comme dans n'importe quelle base PostGIS : importer des couches, écrire des requêtes, construire des vues, créer des index, exporter vos données.

Où vont vos tables

Votre utilisateur crée ses tables dans le schéma qui porte le nom de votre instance ; c'est son schéma par défaut. Le schéma public, où vit PostGIS, sert à utiliser ses fonctions : vous ne pouvez pas y créer de tables. Vous ne pouvez pas non plus créer d'autres schémas.

Une table que vous créez à la main n'a pas d'index spatial. Sur une grande couche, en créer un change beaucoup le temps d'affichage de vos cartes.

Envoyer un GeoPackage dans la base

Un fichier GeoPackage déposé dans Fichiers s'envoie dans la base sans passer par un client PostgreSQL. Faites un clic droit sur le fichier .gpkg et choisissez Transférer vers la BD. Ce choix n'apparaît qu'à partir du plan Pro.

La fenêtre Transférer vers la base de données demande un Schéma de destination, puis liste les couches du fichier : les nouvelles seront créées, celles qui existent déjà sont ignorées. Le traitement continue sur le serveur : vous pouvez fermer la fenêtre sans l'interrompre.

Cocher Tronquer et remplacer sur une couche déjà présente efface les données actuelles de la table avant d'y verser celles du fichier.