Migrate fbodbc205-de.xml to AsciiDoc

src/docs/asciidoc/de/refdocs/fbodbc20/_fbodbc-configure-de.adoc

@@ -0,0 +1,311 @@
+[[fbodbc205-configure-de]]
+= Firebird ODBC-Konfiguration
+
+Die Konfigurationseinstellungen, die Sie in einer ODBC-Datenquellenbeschreibung ("`DSN`") vornehmen, definieren die Attribute für die Verbindung mit einer bestimmten Datenbank.
+Unter Windows erfasst ein Dialogfeld Parameter, die den Verbindungsattributen entsprechen.
+Unter Linux werden die Parameter manuell in Textdateien (`.ini`) konfiguriert.
+
+[[fbodbc205-config-windows-de]]
+== DSN unter Windows konfigurieren
+
+Suchen Sie zuerst die Applets im Abschnitt Verwaltung des Computers, auf dem Sie einen "`Kanal`" einrichten möchten, über den sich Ihr Anwendungsprogramm mit einer Firebird-Datenbank verbindet, entweder auf demselben Computer oder an einem anderen Ort im lokalen oder Wide-Area-Netzwerk.
+
+Auf einem 64-Bit-Computer finden Sie zwei solche Applets:
+
+[[fbodbc205-systemdsn-001-de]]
+.Auswählen eines DSN-Setup-Applets unter Windows
+image::{docimagepath}/fb_odbc_system_dsn_001.png[scaledwidth=496px]
+
+Für unser Beispiel wollen wir den Punkt [term]_ODBC-Datenquellen (32-Bit)_ auswählen.
+Wenn wir den 64-Bit-Treiber mit der Absicht installiert haben, ihn für eine 64-Bit-Anwendung zu verwenden, würden wir stattdessen das 64-Bit-Element aus diesem Menü auswählen.
+
+.Als Administrator ausführen!
+[IMPORTANT]
+====
+Klicken Sie nicht mit der linken Maustaste auf das Objekt: Klicken Sie mit der rechten Maustaste und wählen Sie im Kontextmenü menu:Als{sp}Administrator{sp}ausführen[].
+Dies ist erforderlich, da Sie gerade einen `System-DSN` einrichten.
+====
+
+Klicken Sie auf den Tab menu:System{sp}DSN[], wo Sie mit der Einrichtung Ihres DSN beginnen.
+
+[[fbodbc205-systemdsn-002-de]]
+.Auswählen des Firebird-Treibers für den DSN
+image::{docimagepath}/fb_odbc_system_dsn_002.png[scaledwidth=498px]
+
+Klicken Sie im ersten Bildschirm auf btn:[Hinzufügen...], um die Liste der Treiber auf der nächsten anzuzeigen.
+Wählen Sie den ``Firebird / InterBase (r)``-Treiber und klicken Sie auf Finish.
+
+[[fbodbc205-config-windows-settings-de]]
+=== Die DSN-Einstellungen
+
+Nachdem Sie auf dem vorherigen Bildschirm auf btn:[Fertigstellen] geklickt haben, wird ein Formular angezeigt, in das Sie die Parameter für eine Verbindung eingeben und testen können, ob alle Parameter funktionieren.
+
+[[fbodbc205-systemdsn-003-de]]
+.Festlegen der DSN-Parameter
+image::{docimagepath}/fb_odbc_system_dsn_003.png[scaledwidth=397px]
+
+[[fbodbc205-config-dsn-de]]
+.Parameter der DSN-Konfiguration
+[cols="1,2", options="header", stripes="none]
+|===
+^| Parameter
+^| Eintrag
+
+|Data Source Name (DSN)
+|ERFORDERLICH.
+Ein eindeutiger, aussagekräftiger Name, der den Verbindungstyp oder seine Verwendung angibt.
+Machen Sie es kurz, da Sie die Beschreibung an anderer Stelle erweitern können.
+Beispielsweise "Verbindung von FbEmbed" oder "ConnectFbServer"
+
+|Description
+|Optional.
+Kann verwendet werden, um weitere Details zur Datenquelle anzugeben.
+
+|Database
+|ERFORDERLICH.
+Vollständige Adresse der Datenbank, die für eine eingebettete oder Netzwerkverbindung erforderlich ist.
+Wenn die Verbindung entfernt ist, kann sie im TCP / IP- oder WNET-Format sein. TCP / IP wird empfohlen.
+Firebird-Datenbank-Aliase werden unterstützt. Siehe auch <<fbodbc205-examples-connection-de,Verbindungsbeispiele>>.
+
+|Client
+|Möglicherweise benötigt.
+Lokaler Pfad zur Firebird Client-Bibliothek.
+Bei eingebetteten Verbindungen zu einem Windows-Server unter der Version V.3 kann er auf die Kopie von `fbembed.dll` im Anwendungsverzeichnis verweisen.
+Andernfalls verweisen Sie auf den Pfad zur Bit-kompatiblen Firebird Remote-Client-Bibliothek, es sei denn, Sie sind sicher, dass die richtige Bibliothek automatisch an einem Systemstandort gefunden wird.
+
+|Database Account
+|Optional, da Anmeldeinformationen während der Verbindung mit einer Firebird-Datenbank erfasst werden können.
+Wenn es nicht konfiguriert ist, fragt die ODBC-Schnittstelle zur Verbindungszeit nach einer Benutzer-ID (UID oder USER).
+
+|Password
+|Optional, da Anmeldeinformationen während der Verbindung mit einer Firebird-Datenbank erfasst werden können.
+Wenn es konfiguriert ist, sollte es das Passwort für die angegebene Benutzer-ID sein.
+Andernfalls fordert die ODBC-Schnittstelle zur Verbindungszeit ein Kennwort (PWD oder PASSWORD) an.
+Jedes konfigurierte Passwort wird automatisch verschlüsselt und in `odbc.ini` gespeichert.
+Das Speichern des Passworts sollte somit kein Sicherheitsrisiko darstellen.
+
+|Role
+|Optional.
+Wenn die Rolle definiert ist und die Anmeldung von SYSDBA erfolgt, wird die Rolle ignoriert.
+Andernfalls müssen die Anmeldeinformationen, unabhängig davon, ob sie bei der Verbindung gespeichert oder erfasst wurden, vor dem Anmeldeversuch diese Rolle erhalten haben.
+
+|Character Set
+|Kann leer sein.
+Legt den Standardzeichensatz des Clients fest.
+
+2+^h|Optionen (hier in DSN festlegen oder dynamisch angeben)
+
+2+<h|Transaktionsparameter
+
+|Read (default write)
+|Transaktionen werden standardmäßig gelesen / geschrieben.
+Aktivieren Sie diese Option, um Transaktionen schreibgeschützt zu machen.
+
+|Nowait (default wait)
+|Die Transaktion wartet, wenn ein Sperrkonflikt auftritt.
+Überprüfen Sie, ob die Transaktion sofort einen Fehler zurückgibt, wenn ein Sperrkonflikt auftritt.
+
+|Lock timeout
+|Wenn eine Transaktion für die WAIT-Konfliktlösung festgelegt ist, geben Sie die Länge der Zeit in Sekunden an, bis die Sperre abgelaufen ist und ein Sperrkonfliktfehler zurückgegeben wird (`isc_lock_timeout`).
+
+2+<h|Andere optionale Parameter
+
+|Dialect
+|SQL-Dialekt für den Client zum Zugriff auf die Datenbank.
+Die einzigen gültigen Optionen für Firebird sind 1 oder 3.
+Beachten Sie, dass Dialekt 1 nicht mit Zitatzeichen kompatibel ist.
+Dialekt 3 akzeptiert keine durch doppelte Anführungszeichen begrenzten Zeichenketten.
+
+|Quoted Identifier
+|Bewirkt, dass Paare von doppelten Anführungszeichen nur als Trennzeichen für die Bezeichner von Groß- und Kleinschreibung verwendet werden.
+Versuche, doppelte Anführungszeichen als Trennzeichen für Zeichenketten zu übergeben, werden in beiden Dialekten als Fehler behandelt.
+Beachten Sie, dass Strings in doppelten Anführungszeichen in Dialekt 3 immer unzulässig waren.
+
+|Sensitive Identifier
+|Diese Option beeinflusst die Art und Weise, wie der Client die Eigenschaft `SQL_IDENTIFIER_CASE` behandelt.
+`SQL_IC_UPPER` (Wert = 1) ist der Standardwert und behandelt alle Bezeichner so, dass sie in Großbuchstaben gespeichert werden.
+Aktivieren Sie diese Option, um `SQL_IC_SENSITIVE` (Wert = 3) auszuwählen, damit die Schnittstelle alle Bezeichner behandelt, die nicht in Großbuchstaben stehen, als ob sie die Groß- / Kleinschreibung beachten würden.
+Dies wird nicht empfohlen!
+Für eine Erklärung, siehe <<#fbodbc20-note-sensitive-identifier-de,Anmerkung (1)>> unten.
+
+|Autoquoted Identifier
+|Standard ist `NEIN`.
+Wenn Sie dies überprüfen, ändern Sie die Einstellung auf `JA`.
+In diesem Fall wird jeder Bezeichner in jeder Anweisung automatisch doppelt zitiert.
+Die Notwendigkeit, dies zu tun, wäre höchst ungewöhnlich und müsste gut verstanden werden, um ständige Fehler zu vermeiden.
+
+|SCHEMA options
+|Dropdown-Liste mit drei Optionen zur Behandlung von SQL-Schemas, die Firebird nicht unterstützt.
+Normalerweise belassen Sie dies bei der Standardeinstellung menu:Set{sp}null{sp}field{sp}SCHEMA[].
+Für einige Details siehe <<#fbodbc20-note-schema-setting-de,Anmerkung (2)>> unten.
+|===
+
+[[fbodbc20-note-sensitive-identifier-de]]
+.Anmerkung (1) zu "`Sensitive identifier`"
+[NOTE]
+====
+Wenn diese Einstellung aktiviert ist, würde dieses Statement
+
+[source]
+----
+SELECT A.Test_Field FROM Mixed_Caps_Table A
+ORDER BY A.Test_Field
+----
+
+zu dieser Anweisung konvertiert:
+
+[source]
+----
+SELECT A."Test_Field" FROM "Mixed_Caps_Table" A
+ORDER BY A."Test_Field"
+----
+
+Das folgende Statement würd in einer falschen Konvertierung münden:
+
+[source]
+----
+Select A.Test_Field From Mixed_Caps_Table A
+Order By A.Test_Field
+----
+
+wird zu folgender Anweisung konvertiert:
+
+[source]
+----
+"Select" A."Test_Field" "From" "Mixed_Caps_Table" A
+"Order" "By" A."Test_Field"
+----
+====
+
+[[fbodbc20-note-schema-setting-de]]
+.Anmerkung (2) bezüglich SCHEMA settings
+[NOTE]
+====
+Einige Anwendungen generieren SQL-Anweisungen basierend auf Benutzeranfragen automatisch unter der Annahme, dass die Zieldatenbank Namespaces und SQL-Schemas unterstützt.
+Zum Beispiel
+
+[source]
+----
+select SYSDBA.COUNTRY,SYSDBA.CURRENCY from SYSDBA.COUNTRY
+----
+
+oder
+
+[source]
+----
+select * from SYSDBA.COUNTRY
+----
+
+Diese Auswahl von Schemaeinstellungen versucht, Konflikte mit Anwendungen zu verhindern, die diese Art von Vorgang ausführen.
+Die Dropdown-Liste bietet die drei folgenden Varianten:
+
+. Set null field SCHEMA
+. Remove SCHEMA from SQL query
+. Use full SCHEMA
+
+menu:Set{sp}null{sp}field{sp}SCHEMA[] ist der Standard.
+Dadurch wird das SCHEMA-Element immer dann auf `NULL` gesetzt, wenn es als Teil einer Abfrage angegeben wird.
+Das Ergebnis ist eine Abfrage, die Firebird verarbeiten kann.
+
+menu:Remove{sp}SCHEMA{sp}from{sp}SQL{sp}query[] filtert die Namespaceverweise aus der Anweisung, wenn der Befehl SQLExecDirect eine Anforderung wie
+
+[source]
+----
+select SYSDBA.COUNTRY,SYSDBA.CURRENCY from SYSDBA.COUNTRY
+----
+
+transformiert, bevor diese an die API in Form von
+
+[source]
+----
+select COUNTRY,CURRENCY from COUNTRY
+----
+
+weitergegeben wird.
+
+menu:Use{sp}full{sp}SCHEMA[] ist für die Zukunft reserviert, in der Firebird die Möglichkeit hat, diese Konzepte selbst zu verarbeiten -- vielleicht in Firebird 4.
+In diesem Fall muss der Treiber diese Konstruktionen nicht aussortieren.
+====
+
+Klicken Sie auf die Schaltfläche btn:[Test connection], um sicherzustellen, dass Ihre Konfiguration korrekt ist:
+
+[[fbodbc205-systemdsn-004-de]]
+.Testen der Konfiguration
+image::{docimagepath}/fb_odbc_system_dsn_004.png[scaledwidth=397px]
+
+Wenn alles in Ordnung ist, klicken Sie auf btn:[OK], kehren Sie zum Hauptformular zurück und speichern Sie die  Konfiguration, indem Sie dort auch auf btn:[OK] klicken.
+
+[[fbodbc205-services-button-de]]
+=== Die Services-Schltfläche
+
+Die Schaltfläche Services startet eine Reihe von Dienstprogrammen zur Serververwaltung über eine  GUI-Verwaltungskonsole.
+Es wird später in beschrieben <<fbodbc205-services-de,Die Dienstschnittstelle>>. 
+
+[[fbodbc205-linux-config-de]]
+== Konfigurieren eines DSN unter Linux
+Pavel Cisar
+
+Die Konfiguration hängt von der Linux-Distribution ab, sollte jedoch irgendwo in `/etc` oder `/etc/unixODBC` zu finden sein.
+Dort liegen zwei Dateien namens `odbc.ini` und `odbcinst.ini`.
+
+Fügen Sie der odbcinst.ini folgende Daten hinzu:
+
+[source]
+----
+[Firebird]
+Description     = InterBase/Firebird ODBC Driver
+Driver          = /usr/local/lib64/libOdbcFb.so
+Setup           = /usr/local/lib64/libOdbcFb.so
+Threading       = 1
+FileUsage       = 1
+CPTimeout       =
+CPReuse         =
+----
+
+Fügen Sie der odbc.ini folgende Daten hinzu:
+
+[source]
+----
+[employee]
+Description     = Firebird
+Driver          = Firebird
+Dbname          = localhost:/opt/firebird/examples/empbuild/employee.fdb
+User            = SYSDBA
+Password        = masterkey
+Role            =
+CharacterSet    =
+ReadOnly        = No
+NoWait          = No
+----
+
+[[fbodbc205-linux-config-test-de]]
+=== Testen der Konfiguration
+
+UnixODBC hat ein Werkzeug namens `ISQL` (nicht zu verwechseln mit dem gleichnamigen Tool von Firebird!), mit dem Sie die Verbindung wie folgt testen können:
+
+[source]
+----
+isql -v employee
+----
+
+Stellen Sie bei Verbindungsproblemen sicher, dass sich das Verzeichnis, in dem Sie die gemeinsam genutzte Firebird ODBC-Bibliothek gespeichert haben, z.B. `/usr/local/lib64/libOdbcFb.so`, im ladbaren Bibliothekspfad des Systems befindet.
+Wenn nicht, können Sie dies festlegen:
+
+[source]
+----
+export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib/odbc
+----
+
+oder einfacher:
+
+[source]
+----
+export LD_LIBRARY_PATH=/usr/lib/odbc
+----
+
+Wenn Sie noch immer Probleme haben, können Sie als nächstes versuchen diese mittels `strace` zu identifizieren:
+
+[source]
+----
+strace -o output.txt isql -v employee
+----