createlang

Документация к Postgres Pro 9.5.7.1
Пред.	Уровень выше		След.

Описание

createlang — это утилита для добавления процедурного языка в базу данных Postgres Pro.

createlang представляет собой обёртку для SQL-команды CREATE EXTENSION.

Предостережение

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

Параметры

createlang принимает следующие аргументы:

название языка: Указывает название устанавливаемого процедурного языка. Имя должно быть в нижнем регистре.
[-d] база_данных [--dbname=]база_данных: Указывает имя базы данных, для которой устанавливается процедурный язык. По умолчанию имя целевой базы совпадает с именем текущего системного пользователя.
-e --echo: Отобразить выполняемые SQL-команды.
-l --list: Отобразить список установленных языков в целевой базе данных.
-V --version: Вывести версию createlang и прервать дальнейшее исполнение.
-? --help: Вывести справку по аргументам createlang.

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

-h host --host=host

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

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

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

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

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

-w --no-password

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

-W --password

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

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

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

PGDATABASE PGHOST PGPORT PGUSER: Параметры подключения по умолчанию

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

Диагностика

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

Замечания

Для удаления ранее установленного языка используйте droplang .

Примеры

Чтобы установить язык pltcl в базу template1:

$ createlang pltcl template1

Обратите внимание на то, что установленный в template1 язык будет автоматически добавляться во все новые базы, использующие этот шаблон.

См. также

droplang , CREATE EXTENSION, CREATE LANGUAGE