DATABASE

Операторы определения данных (DDL)SHADOW

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

`CREATE DATABASE`

Назначение

Создание новой базы данных.

Доступно в

DSQL, ESQL

Синтаксис

CREATE {DATABASE | SCHEMA} <filespec>
  [<db_initial_option> [<db_initial_option> ...]]
  [<db_config_option> [<db_config_option> ...]]

<db_initial_option> ::=
    USER username
  | PASSWORD 'password'
  | ROLE rolename
  | PAGE_SIZE [=] size
  | LENGTH [=] num [PAGE[S]]
  | SET NAMES 'charset'

<db_config_option> ::=
    DEFAULT CHARACTER SET default_charset
      [COLLATION collation]
  | <sec_file>
  | DIFFERENCE FILE 'diff_file'


<filespec> ::= '[<server_spec>]{filepath | db_alias}'

<server_spec> ::=
    host[/ {port | service}]:
  | \\host\
  | <protocol>://[host[:{port | service}]/]

<protocol> ::= inet | inet4 | inet6 | wnet | xnet

<sec_file> ::=
  FILE 'filepath'
  [LENGTH [=] num [PAGE[S]]
  [STARTING [AT [PAGE]] pagenum]

Note	Каждый db_initial_option и db_config_option может встречаться не более одного раза, за исключением sec_file, который может встречаться ноль или более раз.

Table 1. Параметры оператора `CREATE DATABASE`
Параметр	Описание
filespec	Спецификация первичного файла базы данных.
server_spec	Спецификация удалённого сервера.Включает в себя имя сервера и протокол.Необходима, если база данных создаётся на удалённом сервере.
filepath	Полный путь и имя файла, включая расширение.Имя файла должно быть задано в соответствии со спецификой используемой платформы.
db_alias	Псевдоним (alias) базы данных, присутствующий в файле databases.conf
host	Имя сервера или IP адрес, на котором создаётся база данных.
port	Номер порта, который слушает удалённый сервер (параметр `RemoteServicePort` файла firebird.conf).
service	Имя сервиса.Должно совпадать со значением параметра `RemoteServiceName` файла firebird.conf.
protocol	Наименование протокола.
username	Имя пользователя-владельца базы данных.Может быть заключено в одинарные или двойные кавычки.Если имя пользователя заключено в двойные кавычки, то оно чувствительно к регистру.
password	Пароль пользователя-владельца базы данных.Чувствительно к регистру.
role	Имя роли, права которой могут учитываться при создании базы данных.Может быть заключено в одинарные или двойные кавычки.Если имя роли заключено в двойные кавычки, то оно чувствительно к регистру.
size	Размер страницы для базы данных.Допустимые значения 4096, 8192, 16384, 32768.Размер страницы по умолчанию 8192.
num	Максимальный размер первичного или вторичного файла в страницах.
charset	Задаёт набор символов подключения, доступного после успешного создания базы данных.
default_charset	Задаёт набор символов по умолчанию для строковых типов данных.
collation	Сортировка для набора символов по умолчанию.
sec_file	Спецификация вторичного файла.
pagenum	Номер страницы, с которой начинается вторичный файл базы данных.
diff_file	Путь и имя дельта файла.

Оператор CREATE DATABASE создаёт новую базу данных.Вы можете использовать CREATE DATABASE или CREATE SCHEMA.Это синонимы.

База данных может состоять из одного или нескольких файлов.Первый, основной, файл называется первичным, остальные файлы — вторичными.

Note	В настоящее время многофайловые базы данных являются атавизмом.Многофайловые базы данных имеет смысл использовать на старых файловых системах, в которых существует ограничение на размер любого файла.Например, в FAT32 нельзя создать файл больше 4-х гигабайт.

Спецификация первичного файла — имя файла базы данных и его расширение с указанием к нему полного пути в соответствии с правилами используемой операционной системы.При создании базы данных файл базы данных должен отсутствовать.В противном случае будет выдано сообщение об ошибке и база данных не будет создана.Если полный путь к базе данных не указан, то база данных будет создана в одном из системных каталогов.В каком именно зависит от операционной системы.