droplang

droplang — удалить процедурный язык Postgres Pro

Синтаксис

droplang [параметр-подключения...] имя_языка [имя_бд]

droplang [параметр-подключения...] --list | -l [имя_бд]

Описание

droplang служит для удаления ранее установленного процедурного языка из базы данных Postgres Pro.

droplang это обёртка над SQL-командой DROP EXTENSION.

Внимание

droplang является устаревшей и может быть удалена в последующих версиях Postgres Pro. Вместо неё рекомендовано использовать DROP EXTENSION.

Параметры

droplang принимает в качестве аргументов:

имя_языка

Указывает название удаляемого процедурного языка. Имя должно быть в нижнем регистре.

[-d] имя_бд
[--dbname=]имя_бд

Указывает имя базы данных, из которой удаляется процедурный язык. По умолчанию имя целевой базы совпадает с именем текущего системного пользователя.

-e
--echo

Отобразить выполняемые SQL-команды.

-l
--list

Отобразить список установленных языков в целевой базе данных.

-V
--version

Выводит версию droplang.

-?
--help

Вывести справку по команде droplang.

droplang также принимает из командной строки параметры подключения:

-h сервер
--host=сервер

Указывает имя компьютера, на котором работает сервер. Если значение начинается с косой черты, оно определяет каталог Unix-сокета.

-p порт
--port=порт

Указывает TCP-порт или расширение файла локального Unix-сокета, через который сервер принимает подключения.

-U имя_пользователя
--username=имя_пользователя

Имя пользователя, под которым производится подключение.

-w
--no-password

Не выдавать запрос на ввод пароля. Если сервер требует аутентификацию по паролю и пароль не доступен с помощью других средств, таких как файл .pgpass, попытка соединения не удастся. Этот параметр может быть полезен в пакетных заданиях и скриптах, где нет пользователя, который вводит пароль.

-W
--password

Принудительно запрашивать пароль перед подключением к базе данных.

Это несущественный параметр, так как droplang запрашивает пароль автоматически, если сервер проверяет подлинность по паролю. Однако, чтобы понять это, droplang лишний раз подключается к серверу. Поэтому иногда имеет смысл ввести -W, чтобы исключить эту ненужную попытку подключения.

Переменные окружения

PGDATABASE
PGHOST
PGPORT
PGUSER

Параметры подключения по умолчанию

Эта утилита, как и большинство других утилит Postgres Pro, также использует переменные среды, поддерживаемые libpq (см. Раздел 31.14).

Диагностика

Большинство сообщений об ошибках говорят сами за себя. Если же какие-то непонятны, запустите droplang с параметром --echo, чтобы получить более подробную информацию для каждой конкретной SQL-команды. При диагностике возможных проблем стоит учитывать, что при запуске утилиты используются значения переменных окружения и параметров подключения по умолчанию libpq.

Замечания

Используйте createlang для добавления языков.

Примеры

Чтобы удалить язык pltcl:

$ droplang pltcl dbname