droplang [option_connexion...] nom_langage [nom_bd]
droplang [option_connexion...] [--list] |
[-l] nom_db
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 pour plus d'informations.
droplang accepte les arguments en ligne de commande :
Le nom du langage de programmation à supprimer.
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.
Les commandes SQL exécutées sont affichées.
La liste des langages installés sur la base de données cible est affiché.
droplang accepte aussi les arguments suivants sur la ligne de commande pour les paramètres de connexion :
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.
Le port TCP ou l'extension du fichier de la socket de domaine Unix sur lequel le serveur écoute les connexions.
Le nom de l'utilisateur utilisé pour la connexion.
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.
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.
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 30.13, « Variables d'environnement »).
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.
dropdb