createlang
Синтаксис
createlang [ параметр-подключения ...] название языка [ база_данных ]
createlang [ параметр-подключения ...] --list | -l [ база_данных ]
Описание
createlang — это утилита для добавления процедурного языка в базу данных PostgreSQL.
createlang представляет собой обёртку для SQL-команды CREATE EXTENSION.
| Предостережение |
createlang является устаревшей и может быть удалена в последующих версиях PostgreSQL. Вместо неё рекомендовано использовать 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 Параметры подключения по умолчанию
Эта утилита, как и большинство других утилит PostgreSQL, также использует переменные среды, поддерживаемые libpq (см. Раздел 31.14).
Диагностика
Большинство сообщений об ошибках говорят сами за себя. В противном случае, запустите createlang с параметром --echo, далее можно обратиться за подробностями касаемо конкретной SQL-команды. При диагностике возможных проблем стоит учитывать, что при запуске утилиты используются значения переменных окружения и параметров подключения по умолчанию libpq.
Примеры
Чтобы установить язык pltcl в базу template1:
$ createlang pltcl template1
Обратите внимание на то, что установленный в template1 язык будет автоматически добавляться во все новые базы, использующие этот шаблон.
| Пред. | Начало | След. |
| createdb | Уровень выше | createuser |