DbBasicClient

Bedienung
DbBasicClient
Basis Client
für Datenbanken
Discom GmbH, Göttingen
Stand: 02.06.2005
Inhalt
Einführung
1
Was ist der „DbBasicClient“?..............................................................................................1
Grundsätzliches....................................................................................................................1
Bedeutung der Symbole in der Baumansicht.......................................................................1
Installationshinweise............................................................................................................1
Grundeinstellungen
3
Verbindung zum Datenbankserver ......................................................................................3
Einstellungen des Moduls Basic Client ...............................................................................5
Deaktivieren des Connection Pooling ...................................................................6
Liste der nicht anzuzeigenden Datenbanken .........................................................6
Liste der Pfade zu den auszuführenden SQL Scripten...........................................6
Funktionen von DbBasicClient
7
Vorweg ................................................................................................................................7
Datenbank anbinden ............................................................................................................7
Datenbankauswahl...............................................................................................................8
Datenbank trennen, Datenbank komprimieren ....................................................................8
Datenbankdateien kopieren..................................................................................................8
Datenbankserver stoppen und starten ..................................................................................9
Bedienung von DbBasicClient
Inhalt • i
Einführung
Was ist der „DbBasicClient“?
Mit dem Datenbank Basis Client können Datenbanken angebunden, getrennt,
komprimiert und physikalisch kopiert werden. Außerdem kann der
Datenbankserver gestoppt und wieder gestartet werden.
Diese Funktionen sind insbesondere dann nützlich, wenn als DBMS
(‚Datenbank Management System’, synonym ‚Datenbankserver’) lediglich die
MSDE installiert ist.
Grundsätzliches
Dieses Tool zeigt in der Benutzeransicht zwei Module. Mit dem ersten wird die
Verbindung zum Danenbankserver eingestellt, das zweite Modul ist der
eigentliche Basis Client.
Bedeutung der Symbole in der Baumansicht
Modul für die Einstellung der Verbindung zum Datenbankserver. Klasse
Discom.DbUtils.DbConnection
Basis Client. Klasse Discom.DbUtils.DbBasicClient
Installationshinweise
Die für die CisPass-Applikation DbBasicClient notwendigen Dateien wie
ApplicationSea.xml, die Konfigurationsdatei DbBasicClientConf.xml, die
notwendigen Sql Scripte und ein
Shortcut-Link für den Desktop:
Bedienung von DbBasicClient
Inhalt • 1
befinden sich im VSS im Ordner C:\DsProjects\DbBasicClient.
Nachdem diese Dateien aus dem Source Safe auf die lokale Platte kopiert
wurden, muss man C:\DsProjects\ unReadOnly.bat ausführen, um den
Schreibschutz aufzuheben.
Wird der DbBasicClient auf einem Kundenrechner installiert, so entfernt
C:\DsProjects\ DeploymentDeleteSourceSafeFiles.bat alle Source Safe-Dateien
in den Verzeichnissen Dsharp und DsProjects.
Für eine Distribution auf einen Kundenrechner wird das genze Verzeichnis
DbBasicClient inklusive Unterordner in das jeweilige RotasData- bzw.
MesamData-Verzeichnis kopiert und zwar in das jeweilige ProjektUnterverzeichnis (AquraMot, MQ350 o.ä.). Nun kann das Icon für den Shortcut
angepasst werden auf das Icon (*.ico), das sich im DbBasicClient-Ordner
befindet. Außerdem muss in den Einstellungen des Shortcuts das
Arbeitsverzeichnis im Eingabefeld ‚Start in:’ angegeben werden, das ist z.B.:
C:\MesamData\AquraMot\ oder C:\RotasData\MQ350\. Ebenso muss der
Übergabeparameter für das ‚Ziel’ angepasst werden, z.B.:
C:\ldisc\DSharp\Bin\CisPass.exe C:\MesamData\AquraMot\DbBasicClient\Con
fig.xml.
DbBasicClient verwendet Klassen der Bibliotheken lModule, lModBasics und
GtrProdUtils.
Bedienung von DbBasicClient
Inhalt • 2
Grundeinstellungen
Verbindung zum Datenbankserver
Zunächst muss eine Verbindung zum Datenbankserver hergestellt werden. Diese
Verbindung muss sich auf die master Datenbank hängen, denn nur von dort
kann die Liste der User-Datenbanken eingelesen werden.
Beim Start von DbBasicClient versucht dieser, eine Verbindung zum
Datenbankserver herzustellen. Dafür werden die Einträge in ApplicationSea
verwendet. Bei einem Fehlschlag öffnet sich folgender Dialog:
Nach Klicken auf OK öffnet sich der Einstelldialog des Moduls
SQL Server Connection, wo dann die korrekten Verbindungsparameter
eingtragen werden müssen.
Bedienung von DbBasicClient
Inhalt • 3
Unter der Rubrik Data sind hier einzugeben:
–
DatabaseName:
Name der Datenbank, die zur Verbindung genutzt wird
–
Server:
Name der Datenbankserver-Instanz, auf der die
Verbindungsdatenbank läuft. (Dies kann ‚localhost’
sein, wenn der SQL-Server lokal installiert ist.
Insbesondere bei einem Netzwerkzugriff auf eine
andere Serverinstanz muss hier aber deren Namen
eingetragen werden)
–
UserName:
Login für die Verbindungsdatenbank
(i.d.R. ‚sa’)
–
UserPassword:
Passwort für Login
Dieser Dialog kann auch bei geöffnetem Programm durch Doppelklick auf das
Modul SQL Server Connection erreicht werden, um die Einstellungen an die
Erfordernisse anzupassen.
Die Verbindungsparameter können mit [Testen] überprüft werden. Kann die
Datenbank konnektiert werden wird dies mit einer Meldung angezeigt.
Im Eingabefeld ‚Sekunden max.’ kann die Zeit aingestellt werden, die höchstens
verstreichen darf, bis der Verbindungsversuch abgebrochen wird.
Bedienung von DbBasicClient
Inhalt • 4
Einstellungen des Moduls Basic Client
Durch Rechsklick auf das Modul Basic Client im Modulbaum öffnet sich dessen
Einstellungsdialog.
Liste der Pfade zu den auszuführenden DOSBefehldateien
Durch Klick auf den [...]-Knopf des CmdFilesPathDict öffnet sich der
Collection Editor. Hier werden die Pfade der auszuführenden DOS-Befehle
(*.bat-Dateien) eingetragen. Eine Ergänzung ist nur dann erforderlich, wenn die
Funktionen des DbBasicClient programmatisch erweitert werden. Der unter
‚First’ einzugebende Wert entspricht dabei einem Wert der
enum Discom.GtrProdUtils.DosCommandType. In ‚Second’ wird der
Pfad eingegeben. Dabei spielt es keine Rolle, ob er absolut oder relativ
eingetragen wird, denn beim Zurückschreiben in den ApplikationsSee wird er
vom Programm auf den relativen Pfad zum Arbeitsverzeichnis gesetzt.
Bedienung von DbBasicClient
Inhalt • 5
Größe einer Datenbank, ab deren Überschreitung eine
Komprimierung bestätigt werden muss
Bei der Funktion ‚Datenbank komprimieren’ wird bei Überschreitung einer
einstellbaren physikalischen Größe der Datenbankdatei (*.mdf) eine Meldung
ausgegeben, dass die Ausführung der Komprimierung einige Zeit beanspruchen
kann. Unter ConfirmShrinkLimit kann diese Größe verändert werden. Default
sind 3 GB.
Deaktivieren des Connection Pooling
Da DbBasicClient den Datenbankserver stoppen und starten kann, muss das
Connection Pooling des .NET Framework Data Provider deaktiviert werden, um
in bestimmten Situationen einen unspezifischen „General Network Error“ zu
vermeiden. EnableConnetionPooling muss deshalb auf ‚False’ eingestellt sein.
Dies ist bereits voreingestellt.
Liste der nicht anzuzeigenden Datenbanken
Die ExcludeDatabaseList kann mit [Add] bzw. [Remove] den lokalen
Verhältnissen angepasst werden.
Liste der Pfade zu den auszuführenden SQL Scripten
Im SqlSciptPathDict werden die Pfade der auszuführenden SQL Scripte
eingetragen. Der unter ‚First’ einzugebende Wert entspricht dabei einem Wert
der enum Discom.GtrProdUtils.SqlCommandType.
Bedienung von DbBasicClient
Inhalt • 6
Funktionen von
DbBasicClient
Vorweg
Physikalisch besteht eine Standarddatenbank im SQL Server 2000-Format aus
zwei Dateien:
-
der eigentliche Datenbankdatei (*.mdf) und
der Logdatei (*.ldf)
Durch Doppelklick auf das Modul Basic Client im Modulbaum öffnet sich
dessen Dialog.
Datenbank anbinden
Eine physikalisch auf dem Dateisystem existierende Datenbank kann mit dieser
Funktion im Datenbankserver angebunden werden. Dies ist Voraussetzung um
Abfragen an die Datenbank zu senden.
Zuerst wird der Pfad zu den Datenbankdateien durch Klicken auf den
Knopf
eingestellt und anschließend werden sie mit
[Datenbank anbinden] vom Datenbankserver zur Verfügung gestellt.
Bedienung von DbBasicClient
Inhalt • 7
Datenbankauswahl
Mit dieser Auswahlliste wird die Datenbank für die Funktionen
‚Datenbank trennen’, ‚Datenbank komprimieren’und
‚Datenbankdateien kopieren’ ausgewählt.
Datenbank trennen, Datenbank komprimieren
Mit der Funktion [Datenbank trennen] wird eine Datenbank vom
Datenbankserver abgekoppelt. Dies ist Vorausetzung, um z.B. die
physikalischen Datenbankdateien zu kopieren oder an eine andere Stelle im
Dateisystem zu verschieben.
[Datenbank komprimieren] ruft den internen Komprimierungsbefehl des
Datenbankservers auf, wodurch die physikalischen Datenbankdateien in vielen
Fällen kleiner werden.
Wird eine einstellbare physikalischen Größe der Datenbankdatei (*.mdf)
überschritten, so wird eine Meldung ausgegeben, dass die Ausführung der
Komprimierung einige Zeit beanspruchen kann. [Nein] bricht die Ausführung
ab. Die Einstellung dieser Größe wird unter den Grundeinstellungen im
Kapitel Größe einer Datenbank, ab deren Überschreitung eine
Komprimierung bestätigt werden muss beschrieben.
Datenbankdateien kopieren
Auch hier wird zuerst der Pfad zu den Datenbankdateien durch Klicken auf
den Knopf
eingestellt und anschließend werden sie mit
[Datenbank kopieren] vom Datenbankserver zur Verfügung gestellt.
Hier wird immer eine Meldung ausgegeben, dass die Ausführung des
Kopiervorgangs einige Zeit beanspruchen kann.
Bedienung von DbBasicClient
Inhalt • 8
Datenbankserver stoppen und starten
Mit [Starten] und [Stoppen] kann der Datenbankserver angehalten und wieder
gestartet werden.
Wird der Datenbankserver gestoppt und anschließend der Dialog geschlossen,
sollte man dabei allerdings bedenken, dass der Dialog beim Öffnen bei
gestopptem Datenbankserver auf das Verbindungstimeout warten muss, bevor er
angezeigt werden kann. [Starten] hat in diesem Fall bereits den Fokus.
Wurde nicht nur der Dialog, sondern das Tool bei gestopptem Datanbankserver
geschlossen, so wird es bei einem Neustart melden, dass keine Verbindung zum
Datenbankserver besteht. Diese Meldung wird in diesem Fall mit [OK] bestätigt.
Das sich anschließend öffnende Fenster für die Verbindungsparameter ebenfalls
mit [OK] schließen.
Daraufhin öffnet sich der Modulbaum und der Basic Client-Dialog kann wieder
(mit Zeitverzögerung, siehe oben) geöffnet werden.
Bedienung von DbBasicClient
Inhalt • 9