connect ist eine Methode des Moduls sdb.sql.
Mit dieser Methode eröffnen Sie eine Datenbanksitzung.
Die Datenbankinstanz ist im Betriebszustand ONLINE.
connect (database_user, password, database_name , host = '' config = '')
database_user |
Name des Datenbankbenutzers |
password |
Kennwort des Datenbankbenutzers Beachten Sie die Groß- und
Kleinschreibung. Siehe Konzepte des
Datenbanksystems, |
database_name |
Name der Datenbankinstanz |
host |
Name oder IP-Adresse des Datenbankrechners |
config |
Verbindungsoptionen (siehe unten) Format: keyword=value[&keyword=value]... |
Verbindungsoptionen
Schlüsselwort |
mögliche Werte |
Vorschlagswert |
Beschreibung |
autocommit |
on | off |
off |
AUTOCOMMIT-Modus on: Das System beendet nach jeder SQL-Anweisung die Transaktion mit einem COMMIT. off: Sie steuern die Transaktion mit den Methoden commit und rollback selbst. |
cachelimit |
<value in kB> |
Vorschlagswert der Datenbankinstanz |
Cache-Limit der Datenbanksitzung in KB |
component |
odbc | cpc |
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 C++-Precompiler gültige SQL-Variante für die Bearbeitung |
genericResults |
on | off |
off |
on: Die Methoden sql und sqlX der Klasse SapDB_Session und die Methode execute der Klasse SapDB_Prepared liefern als Ergebnis ein Objekt der Klasse SapDB_Result. Das ist z. B. sinnvoll für Anwendungen, bei denen der SQL-Modus nicht bekannt ist. off: In Abhängigkeit von der ausgeführten SQL-Anweisung sind verschiedene SQL-Ergebnisse möglich. |
isolation |
0 | 1 | 2 | 3 | 10 | 15 | 20 | 30 |
Vorschlagswert der Datenbankinstanz |
Isolation-Level |
sqlmode |
internal | oracle |
internal |
SQL-Modus |
timeout |
0 | <value in seconds>
|
Vorschlagswert der Datenbankinstanz |
maximale Inaktivitätsdauer einer Datenbanksitzung (in Sekunden) |
Ergebnis:
● bei erfolgreicher Ausführung: Objekt der Klasse SapDB_Session
● bei einem Fehler: Ausnahme der Klasse CommunicationError
● Der Datenbankbenutzer MONA mit dem Kennwort RED stellt eine Verbindung zur Datenbankinstanz DEMODB auf dem lokalen Rechner her:
session=sdb.sql.connect ('MONA', 'RED', 'DEMODB')
● Der Datenbankbenutzer MONA mit dem Kennwort RED stellt eine Verbindung zur Datenbankinstanz DEMODB auf dem Rechner PARMA her:
session=sdb.sql.connect ('MONA', 'RED', 'DEMODB','PARMA')
● Der Datenbankbenutzer MONA mit dem Kennwort RED stellt eine Verbindung zur Datenbankinstanz DEMODB auf dem lokalen Rechner mit den Verbindungsoptionen SQL-Modus=ORACLE und Kommando-Timeout = 60 Sekunden her:
session=sdb.sql.connect ('MONA', 'RED', 'DEMODB','', 'sqlmode=oracle&timeout=60')