PostgreSQLLa base de données la plus sophistiquée au monde.
Documentation PostgreSQL 16.5 » Référence » Commandes SQL » ALTER FOREIGN DATA WRAPPER
Précédent Niveau supérieur Suivant
ALTER EXTENSION Sommaire ALTER FOREIGN TABLE

ALTER FOREIGN DATA WRAPPER

ALTER FOREIGN DATA WRAPPER — modifier la définition d'un wrapper de données distantes

Synopsis

ALTER FOREIGN DATA WRAPPER nom
    [ HANDLER fonction_handler | NO HANDLER ]
    [ VALIDATOR fonction_validation | NO VALIDATOR ]
    [ OPTIONS ( [ ADD | SET | DROP ] option ['valeur'] [, ... ]) ]
ALTER FOREIGN DATA WRAPPER nom OWNER TO { nouveau_propriétaire | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER FOREIGN DATA WRAPPER nom RENAME TO nouveau_nom

Description

ALTER FOREIGN DATA WRAPPER modifie la définition d'un wrapper de données distantes. La première forme de la commande modifie les fonctions de support ou les options génériques du wrapper de données distantes (au moins une clause est nécessaire). La seconde forme modifie le propriétaire du wrapper de données distantes.

Seuls les superutilisateurs peuvent modifier les wrappers de données distantes. De plus, seuls les superutilisateurs peuvent être propriétaires de wrappers de données distantes.

Paramètres

nom

Le nom d'un wrapper de données distantes existant.

HANDLER fonction_handler

Spécifie une nouvelle fonction de gestion pour le wrapper de données distantes.

NO HANDLER

Cette clause est utilisée pour spécifier que le wrapper de données distantes ne doit plus avoir de fonction de gestion.

Notez que les tables distantes qui utilisent un wrapper de données distantes, sans fonction de gestion, ne peuvent pas être utilisées.

VALIDATOR fonction_validation

Indique une fonction de validation pour le wrapper de données distantes.

Notez qu'il est possible que des options pré-existantes du wrapper de données distantes, ou de ses serveurs, correspondances d'utilisateurs ou tables distantes, soient invalides d'après le nouveau validateur. PostgreSQL ne vérifie pas ça. C'est à l'utilisateur de s'assurer que ces options sont correctes avant d'utiliser le wrapper de données distantes modifié. Néanmoins, toute option précisée dans cette commande ALTER FOREIGN DATA WRAPPER sera vérifiée en utilisant le nouveau validateur.

NO VALIDATOR

Cette option est utilisée pour spécifier que le wrapper de données distantes n'aura plus de fonction de validation.

OPTIONS ( [ ADD | SET | DROP ] option ['valeur'] [, ... ] )

Modifie les options du wrapper de données distantes. ADD, SET et DROP spécifient l'action à réaliser. ADD est pris par défaut si aucune opération n'est explicitement spécifiée. Les noms des options doivent être uniques ; les noms et valeurs sont validés en utilisant la fonction de validation du wrapper de données distantes.

nouveau_propriétaire

Le nom du nouveau propriétaire du wrapper de données distantes.

nouveau_nom

Le nouveau nom du wrapper de données distantes.

Exemples

Modifier le wrapper de données distantes dbi, ajouter l'option foo, supprimer bar : 

ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP bar);

Modifier la fonction de validation du wrapper de données distantes dbi en bob.myvalidator : 

ALTER FOREIGN DATA WRAPPER dbi VALIDATOR bob.myvalidator;

Compatibilité

ALTER FOREIGN DATA WRAPPER se conforme à ISO/IEC 9075-9 (SQL/MED). Néanmoins, les clauses HANDLER, VALIDATOR, OWNER TO et RENAME sont des extensions.