Verbindungsparameter DatabaseFile (DBF)

Gibt an, welche Datenbankdatei Sie laden und mit welcher Datenbankdatei Sie sich verbinden wollen, wenn eine Datenbank gestartet wird, die nicht läuft.

Syntax

{ DatabaseFile | DBF }=filename

Zulässige Werte

filename Diese Zeichenfolge gibt den Pfad und den Dateinamen einer Datenbank an, die gestartet werden soll.
Wenn der Dateiname keine Erweiterung enthält, suchen SQL Anywhere-Programme nach einer Datei mit der Erweiterung .db.

Der Suchpfad der Datei ist relativ zum Arbeitsverzeichnis des Datenbankservers. Wenn Sie den Datenbankserver von einer Eingabeaufforderung aus starten, ist das Arbeitsverzeichnis das Verzeichnis, in dem Sie sich beim Ausführen des Befehls befinden. Wenn Sie den Datenbankserver über ein Symbol oder eine Verknüpfung starten, ist es das vom Symbol oder der Verknüpfung festgelegte Arbeitsverzeichnis. Es wird empfohlen, dass Sie einen kompletten Pfad mit dem Dateinamen angeben.

UNC-Dateinamen werden unterstützt. Weitere Hinweise zur Verwendung von UNC-Dateinamen finden Sie unter Syntax des SQL Anywhere-Datenbankservers.

Bemerkungen

Wenn Sie nicht sicher sind, ob die Datenbank läuft, können Sie den DatabaseFile-Verbindungsparameter (DBF) verwenden, um die Datenbank zu starten und eine Verbindung mit ihr herzustellen.

Wenn Sie die Verbindungsparameter DatabaseFile (DBF) und DatabaseName (DBN) angeben, wird versucht, eine Verbindung mit einer laufenden Datenbank mit dem angegebenen Datenbanknamen herzustellen. (Der DatabaseFile-Verbindungsparameter wird ignoriert.) Wenn das fehlschlägt, wird versucht, die Datenbank unter Verwendung des durch den DatabaseFile-Verbindungsparameter angegebenen Pfads automatisch zu starten und ihr den durch den DatabaseName-Verbindungsparameter angegebenen Namen zuzuordnen.

Wenn Sie den DatabaseFile-Verbindungsparameter (DBF) angeben, jedoch nicht den DatabaseName-Verbindungsparameter (DBN), wird versucht, eine Verbindung mit einer laufenden Datenbank mit demselben Namen wie die angegebene Datei herzustellen (wobei Pfad und Erweiterung entfernt werden). Wenn das fehlschlägt, wird versucht, die Datenbank unter Verwendung des durch den DatabaseFile-Verbindungsparameter angegebenen Pfads automatisch zu starten.

Eine Datenbank kann nicht auf einem Netzwerkserver automatisch gestartet werden, es sei denn, dieses Verhalten wird durch die Datenbankserveroption -gd explizit zugelassen.

Wenn ein laufender Datenbankserver nicht gefunden werden kann, wird standardmäßig ein Personal Datenbankserver automatisch gestartet.

Für bereitgestellte Anwendungen sollten Sie einen Datenbankservernamen mit dem ServerName-Parameter (Server) angeben, wenn Sie versuchen, eine nicht ausgeführte Datenbankdatei automatisch zu starten. Andernfalls stellt die Anwendung möglicherweise eine Verbindung zu einem anderen als dem gewünschten Datenbankserver her. Der Datenbankserver könnte sich z.B. mit einer anderen Version des SQL Anywhere-Servers verbinden, der Teil einer eingebetteten Anwendung ist und bereits ausgeführt wird.

Vorsicht

Die Datenbankdatei muss sich auf demselben Computer wie der Datenbankserver befinden. Der Start einer Datenbankdatei, die auf einem Netzlaufwerk liegt, kann zu einer Beschädigung der Datei führen.

Siehe auch

Beispiel

Mit dem Verbindungsparameter DatabaseFile (DBF) im folgenden Beispiel wird die Beispieldatenbank demo.db geladen und eine Verbindung zu ihr hergestellt:

"DBF=%SQLANYSAMP16%\demo.db"

Die nachstehenden zwei Beispiele gehen davon aus, dass Sie die Datenbankdatei cities.db gestartet und die Datenbank "Kitchener" wie folgt umbenannt haben:

dbeng16 cities.db -n Kitchener

Um erfolgreich eine Datenbank zu starten, eine Verbindung mit ihr herzustellen und ihr den Namen "Kitchener" zuzuordnen, müssen Sie die folgenden Werte für die Verbindungsparameter DBN und DBF angeben:

DBN=Kitchener;DBF=cities.db

Durch Angabe von DBF=cities.db wird mit der laufenden Datenbank namens "Kitchener" keine Verbindung hergestellt.

Kommentieren Sie diese Seite in DocCommentXchange.