addNamedProperty

Erlaubt das direkte Setzen sogenannter ConnectionProperties. Bei vielen JDBC-Treibern kann die Art und Weise, wie eine Verbindung zur Datenbank aufgebaut werden soll, über das Setzen von Key-Value-Paaren gesteuert werden. Das erste Argument stellt bei diesem Aufruf den Schlüssel dar, das zweite den Wert, der gesetzt werden soll. Beispiel: transaction level und none.
Welche Wertepaare gesetzt werden können, ist abhängig vom verwendeten JDBC-Treiber. Daher sei an dieser Stelle auf die Dokumentation des jeweiligen Treibers verwiesen.

alias

Der zu verwendende Alias.

allowGrowing

Bei true darf der Pool wachsen, wenn alle initial erstellten Verbindungen an Applikationen ausgegeben wurden und eine weitere benötigt wird. Bei false werden nicht erfüllbare Verbindungsanfragen abgelehnt.

autogenKeysPrepareSupport

true setzt die Information, dass der Treiber in der Lage ist, die Spalten für automatisch generierte IDs per Namen konfiguriert zu bekommen.

blobEncoding

Zu verwendender Zeichensatz (charset name) bei der Umwandlung von Text zu Binärdaten beim Setzen von BLOB-Parametern.

caching

Bei true werden ausgeführte SQL-Statements gecached. Alle Statements müssen vom DatabaseService überprüft und bei Bedarf angepasst werden. Bei Systemen mit ausreichenden Ressourcen macht es daher Sinn, das Ergebnis dieser Überprüfung/Veränderung für zukünftige Verwendungen zu speichern. Werden jedoch primär dynamische Statements verwendet, kann ein explizites Deaktivieren Sinn machen, um unnötiges Speichern nie wieder verwendeter SQL-Statements zu vermeiden.

catalogName

Legt den Namen des Katalogs fest, der als Default-Katalog verwendet werden soll, wenn Statements keine spezifische Angabe dazu enthalten. Wird dieser nicht angegeben, wird der Aliasname verwendet.

checkConnection

Bei true wird die Gültigkeit einer Verbindung vor jedem Herausgeben aus dem Pool an eine Applikation überprüft. Dies reduziert die Performance des Systems, stellt jedoch zu 100 Prozent sicher, dass die Applikation eine Verbindung erhält, die funktioniert und nicht seit der letzten Überprüfung ungültig geworden ist.

database

Die JDBC-URL, die die Verbindung zur Datenbank repräsentiert. Diese URL ist datenbankabhängig, z. B. jdbc:mysql://myserver:3306/db

driver

Die Klasse, die den Treiber des JDBC-Treibers darstellt. Diese Angabe ist datenbankabhängig, z. B. org.gjt.mm.mysql.Driver

idleTime

Gibt die Zeit in Millisekunden an, die eine Verbindung unbenutzt im Pool sein muss, bevor ihre weitere Gültigkeit vom DatabaseService überprüft wird. Wichtiger Hinweis: Beachten Sie bitte, dass es eine globale idleTime für den Service selbst gibt und eine lokale für den jeweiligen Alias. Ein Alias wird erst überprüft, wenn seine lokale Zeit abgelaufen ist und die globale.

isolationLevel

Zu verwendender Isolation Level (0-3). Details finden Sie in Ihrer JDBC-Dokumentation.

lowerCase

Der Name der Methode für das Umwandeln von Text in Kleinbuchstaben. Normalerweise wird diese Information vom JDBC-Treiber selbst geliefert, allerdings gibt es auch Ausnahmen, sodass eine explizite Angabe erforderlich wird.

maxSize

Anzahl (nicht negativ) der maximal im Pool vorgehaltenen Verbindungen. -1 stellt die maxSize auf das Doppelte der minSize, mindestens aber auf 1. Alle über diese Zahl hinausgehenden Verbindungen werden getrennt, sobald sie nicht mehr verwendet werden. 0 führt damit zur effektiven Deaktivierung der Pool-Funktion des Services.

maxStatementLength

Maximale Länge eines Statements inklusive Parametern. wird vom JDOService für die Entscheidung genutzt, ob beim Speichern von Daten "Stripping" genutzt werden soll. 0 deaktiviert diese Prüfung.

minSize

Anzahl (nicht negativ) der initial herzustellenden Verbindungen beim Start. Ist die aktuell eingestellte maxSize kleiner als der neu gesetzte Minimalwert, wird der Maximalwert automatisch angepasst. Daher sollte man maxSize erst nach dem Setzen von minSize ausführen, um unerwünschte Nebeneffekte zu vermeiden.

nullKeyword

Text (nicht leer), der in Parameterwerten als Repräsentanz von NULL verwendet werden soll.

password

Das für die Authentifizierung bei der Datenbank zu verwendende Passwort. Obfuskation ist erlaubt, z. B. OBF:1wtm1xtz1w8v1xtj1wus

readOnly

Mit true wird dem Treiber mitgeteilt, dass der Zugriff auf die Datenbank im Read-Only-Modus erfolgen soll und erlaubt im Clusterbetrieb die Nutzung von Schattendatenbanken statt den Hauptsystems.

rollback

true besagt, dass die zu verbindende Datenbank transaktionsbasiertes Arbeiten unterstützt. Eine Angabe von false hat dabei zur Folge, dass nicht versucht wird, eine Transaktion zu beginnen, was bei manchen Datenbanken zu einer Fehlermeldung führen würde.

Achtung: Wird bei einer transaktionsfähigen Datenbank der Wert false angegeben, wird auch hier der Versuch ignoriert, eine Transaktion zu starten. Commit und Rollback haben auch keinerlei Effekt, obwohl die Datenbank eigentlich dazu in der Lage wäre.

selectNullKeyWord

Text (nicht leer), der in Ergebnissen als Repräsentanz von NULL verwendet werden soll.

simulateAccess

true unterbindet die Ausführung von datenverändernden Statements wie UPDATE oder DELETE.

skipTrimResultValues

Bei MSSQL- und Informix-Datenbanken werden die Ergebniswerte von SQL-Aufrufen um voranstehende und nachfolgende Leerzeichen bereinigt (trimmed). Will man das nicht, kann man diesen Parameter hier einfügen und auf true setzen. Wichtiger Hinweis: Man sollte diese Einstellungen aber nicht beim Alias für die Repository-Datenbank ("hub") vornehmen, da dies zu funktionalen Problem führen würde (Partnerverwaltung findet dann Kanäle nicht, etc.). Dann lieber einen zweiten Alias auf die gleiche Datenbank mit dieser Einstellung erzeugen.

slowLogMilliSeconds

Ausführzeit in Millisekunden ab der Statements geloggt werden sollen.

sqlCommand

Der für die Überprüfung der Gültigkeit einer Datenbankverbindung zu verwendende SQL-Befehl. Wird kein Befehl angegeben, wird die Liste der verfügbaren Tabellen abgerufen. Allerdings wird diese Information von manchen JDBC-Treibern gecached, sodass eine Verbindung als gültig angesehen werden kann, obwohl sie das nicht mehr ist.

strictSchema

Bei true werden Metadaten der Datenbank auf Einträge gefiltert, die zum eingestellten Katalog gehören.

supportsStream

Legt fest, ob die verbundene Datenbank sogenannte Character-Streams als Parameter für das Schreiben in und das Lesen aus einer Datenbank unterstützt. Diese Information wird z. B. beim JDO-Service genutzt, der entscheiden muss, ob ein zu schreibendes Objekt "gestripped" werden soll oder nicht.

synchronousStartupInit

Bei false erfolgt die Initialisierung des Pools zeitverzögert und nicht im Rahmen des Startvorgangs.

user

Der für die Authentifizierung bei der Datenbank zu verwendende Benutzername.

HSQLCheckPointDefragHandler

Eine spezielle Ausführung des DBReorgHandlers, der gegen die Datenbank hinter dem jeweiligen Alias das Statement checkpoint defrag ausführt.

DBReorgHandler

Erlaubt das Setzen von SQL-Statements, die beim Rollover ausgeführt werden sollen.