FirebirdSQL logo

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

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-х гигабайт.

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