Anfang des Inhaltsbereichs

Funktionsdokumentation Methode connect Dokument im Navigationsbaum lokalisieren

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

Hinweis

Beachten Sie die Groß- und Kleinschreibung. Siehe Konzepte des Datenbanksystems, StrukturlinkKonventionen 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

Ende des Inhaltsbereichs