connect ist eine Methode des Moduls sapdb.sql. Sie erzeugen damit eine Datenbankverbindung.
connect(database_user, password, database_name [, host [, config]])
Parameter |
Beschreibung |
|
database_user |
Name des Datenbankbenutzers (Groß- und Kleinschreibung beachten) |
|
password |
Benutzerkennwort |
|
database_name |
Name der Datenbankinstanz |
|
host |
Name des Datenbankrechners |
|
config |
String mit zusätzlichen Verbindungsoptionen im Format keyword=value[&keyword=value]... Folgende Verbindungsoptionen sind möglich: |
|
Schlüsselwort (keyword) |
Wert (value) |
|
sqlmode |
INTERNAL | ORACLE Vorschlagswert ist INTERNAL |
|
isolation |
||
timeout |
Maximale Inaktivitätsdauer einer Datenbanksitzung in Sekunden (Siehe auch: Timeout-Wert) |
|
cachelimit |
Das Cache-Limit der Datenbanksitzung in KB |
|
autocommit |
Autocommit-Modus ON |
OFF ON: Nach jeder SQL-Anweisung wird die Transaktion mit einem COMMIT beendet. OFF: Der Anwender muss die Transaktion mit den Methoden rollback und commit selbst steuern. |
|
genericResults |
ON |
OFF ON: Die Methoden sql und sqlX der Klasse SapDB_Session sowie die Methode execute der Klasse SapDB_Prepared liefern als Ergebnis ein Objekt der Klasse SapDB_Result. Dies ist z. B. sinnvoll für Anwendungen, bei denen die Art des ausgeführten SQL unbekannt ist. OFF: In Abhängigkeit von der ausgeführten SQL-Anweisung sind verschiedene SQL-Ergebnisse möglich. |
|
component |
ODBC | CPC ODBC: die Datenbank wählt die für ODBC gültige SQL-Variante für die Bearbeitung CPC: die Datenbank wählt die für den Precompiler gültige SQL-Variante für die Bearbeitung |
Ergebniswert ist ein Objekt der Klasse SapDB_Session.
Der Datenbankbenutzer TESTUSER mit dem Kennwort TEST erzeugt eine Verbindung zur Datenbank TST auf dem aktuellen Rechner:
session=sapdb.sql.connect ('TESTUSER', 'TEST', 'TST')
Der Datenbankbenutzer TESTUSER mit dem Kennwort TEST erzeugt eine Verbindung zur Datenbank TST auf dem Rechner mit dem Namen remoteserver:
session=sapdb.sql.connect ('TESTUSER', 'TEST', 'TST','remoteserver')
Der Datenbankbenutzer TESTUSER mit dem Kennwort TEST erzeugt eine Verbindung zur Datenbank TST auf dem Rechner mit der IP-Adresse 127.0.0.1:
session=sapdb.sql.connect ('TESTUSER', 'TEST', 'TST','127.0.0.1')
Der Datenbankbenutzer TESTUSER mit dem Kennwort TEST erzeugt eine Verbindung zur Datenbank TST auf dem aktuellen Rechner im SQL-Modus ORACLE mit einem Kommando-Timeout von 60 Sekunden:
session=sapdb.sql.connect ('TESTUSER', 'TEST', 'TST','', 'sqlmode=oracle&timeout=60')