Anfang des Inhaltsbereichs

 Methode connect 

Verwendung

connect ist eine Methode des Moduls sapdb.sql. Sie erzeugen damit eine Datenbankverbindung.

Definition

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

SQL-Modus

INTERNAL | ORACLE

Vorschlagswert ist INTERNAL

isolation

Isolation-Level

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
Vorschlagswert ist
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
Vorschlagswert ist
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

Ergebnis

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

Ende des Inhaltsbereichs