CREATE DATABASE
Erstellen einer neuen Datenbank
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] -- not supported in ESQL | <sec_file> | DIFFERENCE FILE 'diff_file' -- not supported in ESQL <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
|
Jede db_initial_option und db_config_option kann höchstens einmal vorkommen, außer sec_file, die null oder mehrmals vorkommen kann. |
Parameter | Beschreibung |
---|---|
filespec |
Dateispezifikation für primäre Datenbankdatei |
server_spec |
Spezifikation des Remote-Servers.Einige Protokolle erfordern die Angabe eines Hostnamens.Enthält optional eine Portnummer oder einen Dienstnamen.Erforderlich, wenn die Datenbank auf einem Remoteserver erstellt wird. |
filepath |
Vollständiger Pfad und Dateiname einschließlich seiner Erweiterung.Der Dateiname muss gemäß den Regeln des verwendeten Plattform-Dateisystems angegeben werden. |
db_alias |
Datenbankalias, der zuvor in der Datei |
host |
Hostname oder IP-Adresse des Servers, auf dem die Datenbank erstellt werden soll |
port |
Die Portnummer, auf der der Remote-Server lauscht (Parameter RemoteServicePort in der Datei |
service |
Dienstname.Muss mit dem Parameterwert von RemoteServiceName in der Datei |
username |
Benutzername des Besitzers der neuen Datenbank.Er kann aus bis zu 63 Zeichen bestehen.Der Benutzername kann wahlweise in einfache oder doppelte Anführungszeichen eingeschlossen werden.Wenn ein Benutzername in doppelte Anführungszeichen eingeschlossen ist, muss die Groß-/Kleinschreibung entsprechend den Regeln für Bezeichner in Anführungszeichen beachtet werden.Wenn es in einfache Anführungszeichen eingeschlossen ist, verhält es sich so, als ob der Wert ohne Anführungszeichen angegeben wurde.Der Benutzer muss ein Administrator sein oder die Berechtigung |
password |
Passwort des Benutzers als Datenbankbesitzer.Bei Verwendung des Authentifizierungs-Plugins |
rolename |
Der Name der Rolle, deren Rechte beim Anlegen einer Datenbank berücksichtigt werden sollen.Der Rollenname kann in einfache oder doppelte Anführungszeichen eingeschlossen werden.Wenn der Rollenname in doppelte Anführungszeichen eingeschlossen ist, muss die Groß-/Kleinschreibung entsprechend den Regeln für Bezeichner in Anführungszeichen beachtet werden.Wenn es in einfache Anführungszeichen eingeschlossen ist, verhält es sich so, als ob der Wert ohne Anführungszeichen angegeben wurde. |
size |
Seitengröße für die Datenbank in Byte.Mögliche Werte sind 4096, 8192, 16384 und 32768.Die Standardseitengröße ist 8192. |
num |
Maximale Größe der primären Datenbankdatei oder einer sekundären Datei in Seiten |
charset |
Gibt den Zeichensatz der Verbindung an, die einem Client zur Verfügung steht, nachdem die Datenbank erfolgreich erstellt wurde.Einzelne Anführungszeichen sind erforderlich. |
default_charset |
Gibt den Standardzeichensatz für Zeichenfolgendatentypen an |
collation |
Standardsortierung für den Standardzeichensatz |
sec_file |
Dateispezifikation für eine Sekundärdatei |
pagenum |
Anfangsseitennummer für eine sekundäre Datenbankdatei |
diff_file |
Dateipfad und Name für Differenzdateien (.delta-Dateien) für den Sicherungsmodus |
Die Anweisung CREATE DATABASE
erstellt eine neue Datenbank.Sie können CREATE DATABASE
oder CREATE SCHEMA
verwenden.Sie sind synonym, aber wir empfehlen immer CREATE DATABASE
zu verwenden, da sich dies in einer zukünftigen Version von Firebird ändern kann.
Eine Datenbank kann aus einer oder mehreren Dateien bestehen.Die erste (Haupt-)Datei wird als Primärdatei bezeichnet, nachfolgende Dateien werden als Sekundärdatei(en) bezeichnet.
Note
|
Mehrdatei-Datenbanken
Heutzutage gelten Multi-File-Datenbanken als Anachronismus.Es war sinnvoll, Multi-File-Datenbanken auf alten Dateisystemen zu verwenden, bei denen die Größe einer Datei begrenzt ist.Sie können beispielsweise auf FAT32 keine Datei erstellen, die größer als 4 GB ist. |
Die primäre Dateispezifikation ist der Name der Datenbankdatei und ihre Erweiterung mit dem vollständigen Pfad zu ihr gemäß den Regeln des verwendeten Dateisystems der OS-Plattform.Die Datenbankdatei darf zum Zeitpunkt der Datenbankerstellung noch nicht vorhanden sein.Wenn sie vorhanden ist, erhalten Sie eine Fehlermeldung und die Datenbank wird nicht erstellt.
Wenn kein vollständiger Pfad zur Datenbank angegeben ist, wird die Datenbank in einem der Systemverzeichnisse erstellt.Das jeweilige Verzeichnis hängt vom Betriebssystem ab.Geben Sie daher beim Erstellen einer Datenbank immer entweder den absoluten Pfad oder einen Alias an, es sei denn, Sie haben einen triftigen Grund, diese Situation zu bevorzugen.