createdb
Создает новую базу данных.
Синтаксис
createdb [ <connection-option> ... ]
[ <option> ... ]
[ <dbname> [ <description> ] ]
createdb -? | --help
createdb -V | --versionОписание
createdb создает новую базу данных в кластере Greengage DB.
По умолчанию пользователь, выполняющий команду, становится владельцем новой базы данных. Однако можно указать другого владельца с помощью параметра -O, если у выполняющего пользователя есть соответствующие права.
createdb является оберткой для SQL-команды CREATE DATABASE.
Параметры
- <dbname>
-
Имя создаваемой базы данных. Имя должно быть уникальным среди всех баз данных в кластере Greengage DB. Если параметр не указан, значение берется из переменной окружения
PGDATABASE, затем изPGUSER, а при их отсутствии используется имя текущего системного пользователя. - <description>
-
Комментарий, связанный с новой базой данных. Если описание содержит пробелы, его необходимо заключить в кавычки.
- -D <tablespace> | --tablespace=<tablespace>
-
Указывает табличное пространство по умолчанию для базы данных. Имя обрабатывается как идентификатор в двойных кавычках.
- -e | --echo
-
Выводит команды, которые
createdbформирует и отправляет на сервер. - -E <encoding> | --encoding <encoding>
-
Кодировка символов для новой базы данных. Можно указать строковую константу (например,
UTF8), числовой код кодировки илиDEFAULTдля использования кодировки по умолчанию. - -l <locale> | --locale <locale>
-
Указывает локаль для базы данных. Эквивалентно одновременному указанию
--lc-collateи--lc-ctype. - --lc-collate <locale>
-
Задает значение
LC_COLLATEдля базы данных. - --lc-ctype <locale>
-
Задает значение
LC_CTYPEдля базы данных. - -O <owner> | --owner=<owner>
-
Имя пользователя, который станет владельцем новой базы данных. По умолчанию используется пользователь, выполняющий команду. Имя обрабатывается как идентификатор в двойных кавычках.
- -T <template> | --template=<template>
-
Имя шаблона, на основе которого создается новая база данных. По умолчанию используется
template1. Имя обрабатывается как идентификатор в двойных кавычках. - -V | --version
-
Выводит версию
createdbи завершает работу. - -? | --help
-
Отображает справку по аргументам командной строки
createdbи завершает работу.
Параметры -D, -l, -E, -O и -T соответствуют параметрам базовой SQL-команды CREATE DATABASE.
Параметры подключения
- -h <host> | --host=<host>
-
Имя хоста, на котором запущен экземпляр мастера. Если параметр не указан, читается из переменной окружения
PGHOSTили используется значение по умолчаниюlocalhost. - -p <port> | --port=<port>
-
TCP-порт, на котором мастер принимает подключения. Если параметр не указан, читается из переменной окружения
PGPORTили используется значение по умолчанию5432. - -U <username> | --username=<username>
-
Имя роли для подключения. Если параметр не указан, читается из переменной окружения
PGUSERили используется имя пользователя операционной системы. - -w | --no-password
-
Не запрашивает пароль. Если сервер требует пароль и он недоступен другими способами (например, через файл .pgpass), подключение завершится неудачей. Этот параметр удобен для пакетных заданий и скриптов, где невозможен интерактивный ввод пароля.
- -W | --password
-
Принудительно запрашивает пароль.
- --maintenance-db=<dbname>
-
Указывает имя базы данных для подключения при создании новой базы данных. Если параметр не указан, будет использована база данных
postgres; если она не существует (или если это имя создаваемой новой базы данных), будет использованаtemplate1.
Примеры
Создать базу данных test с параметрами по умолчанию:
$ createdb testСоздать базу данных demo, подключаясь к мастеру Greengage DB на хосте mdw (порт 54321) и используя кодировку LATIN1:
$ createdb -p 54321 -h mdw -E LATIN1 demo