CREATE SERVER — Définir un nouveau serveur distant
CREATE SERVER [ IF NOT EXISTS ]nom_serveur
[ TYPE 'type_serveur
' ] [ VERSION 'version_serveur
' ] FOREIGN DATA WRAPPERnom_fdw
[ OPTIONS (option
'valeur
' [, ... ] ) ]
CREATE SERVER
définit un nouveau serveur de données
distantes. L'utilisateur qui définit le serveur devient son propriétaire.
Un serveur distant englobe typiquement des informations de connexion qu'un wrapper de données distantes utilise pour accéder à une ressource externe de données. Des informations de connexions supplémentaires spécifiques à l'utilisateur pourraient être fournies par l'intermédiaire des correspondances d'utilisateur.
Le nom du serveur doit être unique dans la base de données.
La création d'un serveur nécessite d'avoir le droit USAGE
sur le wrapper de données distant qui est utilisé.
IF NOT EXISTS
Ne renvoie pas d'erreur si un serveur du même nom existe déjà. Une note est affichée dans ce cas. Veuillez noter qu'il n'y a aucune garantie que le serveur existant ait quoi que ce soit à voir avec celui qui aurait été créé.
nom_serveur
Nom du serveur de données distant qui sera créé.
type_serveur
Type de serveur (optionnel), potentiellement utile pour les wrappers de données distantes.
version_serveur
Version du serveur (optionnel), potentiellement utile pour les wrappers de données distantes.
nom_fdw
Nom du wrapper de données distantes qui gère le serveur.
OPTIONS ( option
'valeur
' [, ... ] )
Cette clause spécifie les options pour le serveur. Typiquement, les options définissent les détails de connexion au serveur, mais les noms et valeurs réelles dépendent du wrapper de données distantes du serveur.
Lors de l'utilisation du module dblink, le nom du serveur
distant peut être utilisé comme argument de la fonction dblink_connect pour indiquer les paramètres de connexion.
Il est nécessaire de disposer du droit USAGE
sur le
serveur distant pour être capable de l'utiliser de cette façon.
Si le serveur distant accepte d'envoyer le tri, il est essentiel que l'ordre de tri soit identique au serveur local.
Créer un serveur monserveur
qui utilise le wrapper de
données distantes postgres_fdw
:
CREATE SERVER monserver FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'truc', dbname 'trucdb', port '5432');
Voir postgres_fdw pour plus de détails.
Créer un serveur monserveur
qui utilise le wrapper de
données distantes pgsql
:
CREATE SERVER monserveur FOREIGN DATA WRAPPER pgsql OPTIONS (host 'truc', dbname 'trucdb', port '5432');
CREATE SERVER
est conforme à ISO/IEC 9075-9 (SQL/MED).