PostgreSQLLa base de données la plus sophistiquée au monde.
Documentation PostgreSQL 17.1 » Référence » Commandes SQL » CREATE SERVER
Précédent Niveau supérieur Suivant
CREATE SEQUENCE Sommaire CREATE STATISTICS

CREATE SERVER

CREATE SERVER — Définir un nouveau serveur distant

Synopsis

CREATE SERVER [ IF NOT EXISTS ] nom_serveur [ TYPE 'type_serveur' ] [ VERSION 'version_serveur' ]
    FOREIGN DATA WRAPPER nom_fdw
    [ OPTIONS ( option 'valeur' [, ... ] ) ]

Description

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é.

Paramètres

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.

Notes

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.

Exemples

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');

Compatibilité

CREATE SERVER est conforme à ISO/IEC 9075-9 (SQL/MED).