| ... |
... |
@@ -1,12
+1,51 @@ |
| 1 |
|
-{{figure image="driver_not_found.png"}} |
|
1 |
+{{figure image="database_driver_de.png"}} |
| 2 |
2 |
Dieser Fehlermeldung erscheint, wenn kein Treiber für die Datenbank installiert ist. Es muss zuerst der entsprechende Treiber für das Datenbankverwaltungssystem installiert werden. |
| 3 |
3 |
{{/figure}} |
| 4 |
4 |
|
| 5 |
|
-Seit Version 5.0.13 liefert {{formcycle/}} keine Datenbanktreiber mehr mit aus. Es ist hierdruch möglich eigene Treiber zu nutzen welche unabhängig von {{formcycle/}} aktualisiert werden können. Die Treiber müssen jedoch nun für das/die verwendeten Datenbanksystem/e entsprechend installiert werden. Die zugehörigen Downloads finden Sie hier: |
|
5 |
+Von {{formcycle case="dat"/}} werden keine Datenbanktreiber mehr mit ausgeliefert. Es ist hierdruch möglich, eigene Treiber zu nutzen, welche unabhängig von {{formcycle/}} aktualisiert werden können. Die Treiber müssen jedoch nun für das verwendete Datenbanksystem separat installiert werden. Die Treiber können von der offiziellen Seite des jeweiligen Datenbanksystems heruntergeladen werden: |
| 6 |
6 |
|
| 7 |
|
-* [[MySQL>>https://dev.mysql.com/downloads/connector/j/||target="_blank"]] |
| 8 |
|
-* [[OracleDB>>http://www.oracle.com/technetwork/database/application-development/jdbc/downloads/index.html||target="_blank"]] |
| 9 |
|
-* [[PostgreSQL>>https://jdbc.postgresql.org/download.html||target="_blank"]] |
| 10 |
|
-* [[SQLServer>>https://docs.microsoft.com/en-us/sql/connect/jdbc/microsoft-jdbc-driver-for-sql-server?view=sql-server-2017||target="_blank"]] |
|
7 |
+* [[Oracle MySQL>>https://dev.mysql.com/downloads/connector/j/||rel="noopener noreferrer" target="_blank"]] |
|
8 |
+* [[OracleDB>>http://www.oracle.com/technetwork/database/application-development/jdbc/downloads/index.html||rel="noopener noreferrer" target="_blank"]] |
|
9 |
+* [[PostgreSQL>>https://jdbc.postgresql.org/download.html||rel="noopener noreferrer" target="_blank"]] |
|
10 |
+* [[SQLServer>>https://docs.microsoft.com/en-us/sql/connect/jdbc/microsoft-jdbc-driver-for-sql-server?view=sql-server-2017||rel="noopener noreferrer" target="_blank"]] |
| 11 |
11 |
|
| 12 |
|
-Das genaue Vorgehen zur Installation hängt vom verwendeten Server ab. Für Tomcat finden Sie [[hier>>doc:Main.InstallDbDriverTomcat]] die Einrichtung beispielhaft beschrieben. |
|
12 |
+Das genaue Vorgehen zur Installation hängt vom verwendeten Server ab. Für den Apache Tomcat wird [[hier>>doc:Formcycle.SystemSettings.TomcatSettings.InstallDBDriver]] die Einrichtung beispielhaft beschrieben. |
|
13 |
+ |
|
14 |
+== Zeichensatz |
|
15 |
+ |
|
16 |
+In einer Datenbank lässt sich der zu nutzende Zeichensatz einstellen. Für {{formcycle/}} wird empfohlen, einen UTF-8-Zeichensatz zu wählen, der zwischen Groß- und Kleinschreibung unterscheidet, und zwar: |
|
17 |
+ |
|
18 |
+{{code}}utf8_bin{{/code}} |
|
19 |
+ |
|
20 |
+Bei Verwendung eines Zeichensatzen wie //utf8_general_ci// (utf8, case insensitive) kann es zu Problemen kommen, da hier nicht zwischen Groß- und Kleinschreibung unterschieden wird. |
|
21 |
+ |
|
22 |
+== Hinweise zu Oracle MySQL == |
|
23 |
+ |
|
24 |
+{{figure image="database_mysql_unicode_de.png"}} |
|
25 |
+Konfiguration des Datenbanksystems //Oracle MySQL// mit Unicode. Hier wird die Zeichenkodierung explizit in der {{smallcaps}}Jdbc{{/smallcaps}}-{{smallcaps}}Url{{/smallcaps}} mitgegeben. Im Normalfall ist dies nicht notwendig, die Zeichenkodierung wird automatisch erkannt. |
|
26 |
+{{/figure}} |
|
27 |
+ |
|
28 |
+Ab Version 8 von Oracle MySQL wird der Zeitzonenname {{smallcaps}}Cest{{/smallcaps}} nicht mehr unterstützt. Standardmäßig übermittelt das Betriebssystem die Zeitzone an die Datenbank. Wird hier dieser Zeitzonenname an Oracle MySQL übertragen, kann keine Verbindung zur Datenbank hergestellt werden. In dem Fall ist es möglich, eine Zeitzone explizit in der {{smallcaps}}Jdbc{{/smallcaps}}-{{smallcaps}}Url{{/smallcaps}} zu übergeben: |
|
29 |
+ |
|
30 |
+{{code language="text"}} |
|
31 |
+jdbc:mysql://localhost/db?serverTimezone=Europe/Berlin |
|
32 |
+{{/code}} |
|
33 |
+ |
|
34 |
+Weiterhin kann es in einigen Fällen vorkommen, dass die Zeichenkodierung nicht richtig erkannt wird. Auch hier kann die Zeichenkodierung in der {{smallcaps}}Jdbc{{/smallcaps}}-{{smallcaps}}Url{{/smallcaps}} übergeben werden. Für Unicode zum Beispiel, wenn in der Datenbank die Einstellung //connection collation// auf //utf8_general_ci// gesetzt ist: |
|
35 |
+ |
|
36 |
+{{code language="text"}} |
|
37 |
+jdbc:mysql://localhost/db?useUnicode=true&characterEncoding=UTF-8 |
|
38 |
+{{/code}} |
|
39 |
+ |
|
40 |
+== Andere Datenbanksysteme == |
|
41 |
+ |
|
42 |
+Es ist auch möglich, eine anderes Datenbanksytem wie etwa HSQLDB, Derby oder Informix zu verwenden. Auch hier muss der Datenbanktreiber installiert werden. Hier eine Übersicht über die {{smallcaps}}Jdbc{{/smallcaps}}-{{smallcaps}}Url{{/smallcaps}} und die dazugehörigen Treiberklassen einiger Datenbanksysteme: |
|
43 |
+ |
|
44 |
+{{table dataTypeAlpha="0-2" preSort="0-asc"}} |
|
45 |
+|=Name|=JDBC-URL|=JDBC-Treiber Klasse |
|
46 |
+| Maria DB| jdbc:mariadb:~/~/<dbhost>/<dbname>|org.mariadb.jdbc.Driver |
|
47 |
+| SAP HANA| jdbc:sap:~/~/<dbhost>:30015/|com.sap.db.jdbc.Driver |
|
48 |
+| Informix| jdbc:informix-sqli:~/~/<dbhost>:9088/sysuser:INFORMIXSERVER=hpjp|com.informix.jdbc.IfxDriver |
|
49 |
+| HSQLDB| jdbc:hsqldb:mem:<dbname>| org.hsqldb.jdbc.JDBCDriver |
|
50 |
+| Derby| jdbc:derby:target/tmp/derby/hpjp;databaseName=<dbname>;create=true| org.apache.derby.jdbc.EmbeddedDriver |
|
51 |
+{{/table}} |