## Methode connect

### Verwendung

connect ist eine Methode des Moduls sdb.sql.

Mit dieser Methode eröffnen Sie eine Datenbanksitzung.

### Voraussetzungen

Die Datenbankinstanz ist im Betriebszustand ONLINE.

### Funktionsumfang

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, Konventionen für Benutzernamen und Kennwörter
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

### Beispiel

● 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')

● Verbindung zur Datenbankinstanz herstellen und beenden