CREATE DATABASE
Пред. НаверхКоманды SQLНачало След.

CREATE DATABASE

CREATE DATABASE — создать базу данных

Синтаксис

CREATE DATABASE имя
    [ WITH ] [ OWNER [=] имя_пользователя ]
           [ TEMPLATE [=] шаблон ]
           [ ENCODING [=] кодировка ]
           [ STRATEGY [=] стратегия ]
           [ LOCALE [=] локаль ]
           [ LC_COLLATE [=] категория_сортировки ]
           [ LC_CTYPE [=] категория_типов_символов ]
           [ BUILTIN_LOCALE [=] локаль_builtin ]
           [ ICU_LOCALE [=] локаль_icu ]
           [ ICU_RULES [=] правила_icu ]
           [ LOCALE_PROVIDER [=] провайдер_локали ]
           [ COLLATION_VERSION = версия_правил_сортировки ]
           [ TABLESPACE [=] табл_пространство ]
           [ ALLOW_CONNECTIONS [=] разр_подключения ]
           [ CONNECTION LIMIT [=] предел_подключений ]
           [ IS_TEMPLATE [=] это_шаблон ]
           [ OID [=] oid ]

Описание

Команда CREATE DATABASE создаёт базу данных Postgres Pro.

Чтобы создать базу данных, необходимо быть суперпользователем или иметь специальное право CREATEDB. См. CREATE ROLE.

По умолчанию новая база данных создаётся копированием стандартной системной базы данных template1. Задать другой шаблон можно, добавив указание TEMPLATE имя. В частности, написав TEMPLATE template0, можно создать чистую базу данных (в которой никаких пользовательских объектов нет, есть только системные объекты в первозданном виде), содержащую только стандартные объекты, предопределённые установленной версией Postgres Pro. Это бывает полезно, когда копировать в новую базу любые дополнительные объекты, добавленные локально в template1, нежелательно.

Параметры

имя #

Имя создаваемой базы данных.

имя_пользователя #

Имя пользователя (роли), назначаемого владельцем новой базы данных, либо DEFAULT, чтобы владельцем стал пользователь по умолчанию (а именно, пользователь, выполняющий команду). Чтобы создать базу данных и сделать её владельцем другую роль, необходимо иметь право SET ROLE для этой роли.

шаблон #

Имя шаблона, из которого будет создаваться новая база данных, либо DEFAULT, чтобы выбрать шаблон по умолчанию (template1).

кодировка #

Кодировка символов в новой базе данных. Укажите строковую константу (например, 'SQL_ASCII') или целочисленный номер кодировки, либо DEFAULT, чтобы выбрать кодировку по умолчанию (а именно, кодировку шаблона). Наборы символов, которые поддерживает Postgres Pro, перечислены в Подразделе 22.3.1. Дополнительные ограничения описаны ниже.

стратегия #

Стратегия, которая будет использоваться при создании новой базы данных. Если используется стратегия WAL_LOG, база данных будет копироваться блок за блоком и каждый блок будет отдельно записан в журнал предзаписи. Эта стратегия наиболее эффективна в случаях, когда шаблонная база данных небольшого размера, поэтому такая стратегия используется по умолчанию. Также доступна старая стратегия FILE_COPY. Если выбрана эта стратегия, делается небольшая запись в журнал предзаписи для каждого табличного пространства, используемого целевой базой данных. Каждая такая запись является копией всего каталога в другом месте на уровне файловой системы. Хотя такая стратегия существенно уменьшает объём журнала упреждающей записи, особенно если шаблонная база данных большого размера, она требует выполнения процедуры контрольной точки как до, так и после создания новой базы данных. В некоторых ситуациях это может оказать заметное негативное влияние на общую производительность системы.

локаль #

Задаёт порядок сортировки по умолчанию и особенности классификации символов для новой базы данных. Правила сортировки определяют порядок сортировки строк, например в запросах с ORDER BY, а также порядок индексов по текстовым столбцам. Классификация символов определяет принадлежность символов категориям, например строчные, заглавные и цифры. Этот параметр также устанавливает соответствующие переменные окружения ОС, LC_COLLATE и LC_CTYPE. По умолчанию используется значение из шаблона. Подробное описание представлено в Подразделе 22.2.2.3.1 и Подразделе 22.2.2.3.2.

Параметр можно переопределить, задав один из следующих параметров: категория_сортировки, категория_типов_символов, локаль_builtin или локаль_icu.

При значении builtin у провайдер_локали необходимо указать локаль или локаль_builtin и задать для них значение C или C.UTF-8.

Подсказка

Другие параметры локали lc_messages, lc_monetary, lc_numeric и lc_time задаются не на уровне базы данных и этой командой не устанавливаются. Чтобы изменить их значения по умолчанию для конкретной базы, воспользуйтесь командой ALTER DATABASE ... SET.

категория_сортировки #

Устанавливает значение LC_COLLATE в окружении ОС сервера баз данных. По умолчанию используется значение локаль (если оно указано), в противном случае — значение из шаблона. Дополнительные ограничения описаны ниже.

Если для провайдер_локали задано значение libc, этот параметр также задаёт порядок сортировки по умолчанию для новой базы данных, переопределяя значение локаль.

категория_типов_символов #

Устанавливает значение LC_CTYPE в окружении ОС сервера баз данных. По умолчанию используется значение локаль (если оно указано), в противном случае — значение из шаблона. Дополнительные ограничения описаны ниже.

Если для провайдер_локали задано значение libc, этот параметр также задаёт классификацию символов по умолчанию для новой базы данных, переопределяя значение локаль.

локаль_builtin #

Задаёт локаль провайдера builtin для установки порядка сортировки по умолчанию и особенностей классификации символов, переопределяя значение локаль. При этом должно быть задано значение builtin для провайдера локалей. По умолчанию используется значение из локаль (если оно указано), в противном случае — значение из базы-шаблона.

Локали, доступные для провайдера builtin: C и C.UTF-8.

локаль_icu #

Задаёт локаль ICU (см. Подраздел 22.2.2.3.2) для установки порядка сортировки по умолчанию и особенностей классификации символов, переопределяя значение локаль. При этом должен быть задан провайдер локалей ICU. По умолчанию используется значение параметра локаль, если оно указано, в противном случае — значение параметра локаль из базы-шаблона, если оно указано. Если же и оно не указано — значение lc_collate.

правила_icu #

Указывает дополнительные правила для настройки поведения сортировки по умолчанию. Параметр поддерживается только для ICU. За дополнительной информацией обратитесь к https://unicode-org.github.io/icu/userguide/collation/customization/.

провайдер_локали #

Задаёт провайдера, который будет использоваться для основного правила сортировки в этой базе данных. Возможные значения: builtin, icu (если сервер собран с поддержкой ICU) или libc. По умолчанию выбирается провайдер, указанный в шаблон. За подробностями обратитесь к Подразделу 22.1.4.

версия_правил_сортировки #

Задаёт строку версии правила сортировки, которая будет записана с объектом базы данных. Обычно её не следует задавать — тогда эта строка будет получена из фактической версии правила сортировки БД, предоставляемого операционной системой. Это указание предназначено для того, чтобы утилита pg_upgrade могла скопировать версию из существующей инсталляции.

Что делать в случае несовпадения версий правил сортировки, описано в ALTER DATABASE.

табл_пространство #

Имя табличного пространства, связываемого с новой базой данных, или DEFAULT для использования табличного пространства шаблона. Это табличное пространство будет использоваться по умолчанию для объектов, создаваемых в этой базе. За подробностями обратитесь к CREATE TABLESPACE.

разр_подключения #

Если false, никто не сможет подключаться к этой базе данных. По умолчанию имеет значение true, то есть подключения принимаются (если не ограничиваются другими механизмами, например, GRANT/REVOKE CONNECT).

предел_подключений #

Максимальное количество одновременных подключений к этой базе данных. Значение -1 (по умолчанию) снимает ограничение.

это_шаблон #

Если true, базу данных сможет клонировать любой пользователь с правами CREATEDB; в противном случае (по умолчанию), клонировать эту базу смогут только суперпользователи и её владелец.

oid #

Идентификатор объекта, который будет назначен новой базе данных. Если этот параметр не указан, Postgres Pro автоматически выберет подходящий OID. Этот параметр в первую очередь предназначен для внутреннего использования в pg_upgrade, и только pg_upgrade может указывать значение меньше 16384.

Дополнительные параметры могут записываться в любом порядке, не обязательно так, как показано выше.

Примечания

CREATE DATABASE нельзя выполнять внутри блока транзакции.

Ошибки, содержащие сообщение «не удалось инициализировать каталог базы данных», чаще всего связаны с нехваткой прав в каталоге данных, заполнением диска или другими проблемами в файловой системе.

Для удаления базы данных применяется DROP DATABASE.

Программа createdb представляет собой оболочку этой команды, созданную ради удобства.

Конфигурационные параметры уровня базы данных (устанавливаемые командой ALTER DATABASE) и разрешения уровня базы (устанавливаемые командой GRANT) из шаблона не копируются.

Хотя с помощью этой команды можно скопировать любую базу данных, а не только template1, указав её имя в качестве имени шаблона, она не предназначена (пока) для использования в качестве универсального средства вроде «COPY DATABASE». Принципиальным ограничением является невозможность копирования базы данных шаблона, если установлены другие подключения к ней. CREATE DATABASE выдаёт ошибку, если при запуске команды есть другие подключения к этой базе; в противном случае новые подключения к базе блокируются до завершения команды CREATE DATABASE. За дополнительными сведениями обратитесь к Разделу 21.3.

Кодировка символов, указанная для новой базы данных, должна быть совместима с выбранными параметрами локали (LC_COLLATE и LC_CTYPE). Если выбрана локаль C (или равнозначная ей POSIX), допускаются все кодировки, но для других локалей правильно будет работать только одна кодировка. (В Windows, однако, кодировку UTF-8 можно использовать с любой локалью.) CREATE DATABASE позволяет суперпользователям указать кодировку SQL_ASCII вне зависимости от локали, но этот вариант считается устаревшим и может привести к ошибочному поведению строковых функций, если в базе хранятся данные в кодировке, несовместимой с заданной локалью.

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

В настоящее время использовать для базы данных локаль с недетерминированными сравнениями нельзя (объяснение этому можно найти в описании CREATE COLLATION). Если нужны такие сравнения, требуемые правила сортировки следует устанавливать на уровне столбцов.

Ограничение CONNECTION LIMIT действует только приблизительно; если одновременно запускаются два сеанса, тогда как в базе остаётся только одно «свободное место», может так случиться, что будут отклонены оба подключения. Кроме того, это ограничение не распространяется на суперпользователей и фоновые рабочие процессы.

Примеры

Создание базы данных: 

CREATE DATABASE lusiadas;

Создание базы данных sales, принадлежащей пользователю salesapp, с табличным пространством по умолчанию salesspace: 

CREATE DATABASE sales OWNER salesapp TABLESPACE salesspace;

Создание базы данных music с другой локалью: 

CREATE DATABASE music
    LOCALE 'sv_SE.utf8'
    TEMPLATE template0;

В этом примере предложение TEMPLATE template0 необходимо, только если указанная локаль отличается от локали в template1. (В противном случае явное указание локали является избыточным.)

Создание базы данных music2 с другой локалью и другой кодировкой символов: 

CREATE DATABASE music2
    LOCALE 'sv_SE.iso885915'
    ENCODING LATIN9
    TEMPLATE template0;

Свойства кодировки должны соответствовать локали, иначе возникнет ошибка.

Заметьте, что имена локалей зависят от операционной системы, так что показанные выше команды могут не везде работать одинаково.

Совместимость

Оператор CREATE DATABASE отсутствует в стандарте SQL. Базы данных равнозначны каталогам, а их создание в стандарте определяется реализацией.

См. также

ALTER DATABASE, DROP DATABASE
Пред. Наверх След.
CREATE CONVERSION Начало CREATE DOMAIN

Чтобы сделать работу с сайтом удобнее, мы используем cookie и аналитический сервис «Яндекс.Метрика». Продолжая пользоваться сайтом, вы соглашаетесь с их использованием.