PostgreSQLLa base de données la plus sophistiquée au monde.

droplang

droplang — Supprimer un langage procédural

Synopsis

droplang [option_connexion...] nom_langage [nom_bd]

droplang [option_connexion...] [--list] | [-l] nom_db

Description

droplang permet de supprimer un langage procédural. Tout langage procédural, même s'il n'est pas fourni avec la distribution de PostgreSQL™ est candidat à la suppression par droplang.

Bien que les langages de programmation du serveur puissent être supprimés directement à l'aide de quelques commandes SQL, il est recommandé d'utiliser droplang. Non seulement, il réalise quelques vérifications, mais il est aussi plus simple à utiliser. Voir DROP LANGUAGE(7) pour plus d'informations.

Options

droplang accepte les arguments en ligne de commande :

nom_langage

Le nom du langage de programmation à supprimer.

[-d] nom_bd, [--dbname] nom_bd

La base de données qui contient le langage à supprimer. Par défaut, le nom de la base est équivalent à celui du nom de l'utilisateur système qui lance la commande.

-e, --echo

Les commandes SQL exécutées sont affichées.

-l, --list

La liste des langages installés sur la base de données cible est affiché.

-V, --version

Affiche la version de droplang puis quitte.

-?, --help

Affiche l'aide sur les arguments en ligne de commande de droplang, puis quitte

droplang accepte aussi les arguments suivants sur la ligne de commande pour les paramètres de connexion :

-h hôte, --host hôte

Le nom d'hôte de la machine sur lequel le serveur fonctionne. Si la valeur commence par une barre oblique (/ ou slash), elle est utilisée comme répertoire du socket de domaine Unix.

-p port, --port port

Le port TCP ou l'extension du fichier de la socket de domaine Unix sur lequel le serveur écoute les connexions.

-U nomutilisateur, --username nomutilisateur

Le nom de l'utilisateur utilisé pour la connexion.

-w, --no-password

Ne demande jamais un mot de passe. Si le serveur en réclame un pour l'authentification et qu'un mot de passe n'est pas disponible d'une autre façon (par exemple avec le fichier .pgpass), la tentative de connexion échouera. Cette option peut être utile pour les scripts où aucun utilisateur n'est présent pour saisir un mot de passe.

-W, --password

Force droplang à demander un mot de passe avant la connexion à une base de données.

Cette option n'est jamais obligatoire car droplang demandera automatiquement un mot de passe si le serveur exige une authentification par mot de passe. Néanmoins, droplang perdra une tentative de connexion pour trouver que le serveur veut un mot de passe. Dans certains cas, il est préférable d'ajouter l'option -W pour éviter la tentative de connexion.

Environnement

PGDATABASE, PGHOST, PGPORT, PGUSER

Paramètres de connexion par défaut

Cet outil, comme la plupart des autres outils PostgreSQL™, utilise aussi les variables d'environnement supportées par la bibliothèque libpq (voir Section 31.13, « Variables d'environnement »).

Diagnostiques

La plupart des messages d'erreurs sont explicites. Dans le cas contraire, on peut utiliser droplang avec l'option --echo et regarder la commande SQL correspondante pour obtenir plus de détails. De plus, tout paramètre de connexion par défaut et toute variable d'environnement utilisé par la bibliothèque libpq s'appliqueront.

Notes

createlang(1) est utilisé pour ajouter un langage.

Exemples

Supprimer le langage pltcl :

$ droplang pltcl nomdb