NAME
Quiq::Database::Api::Dbi::Connection - DBI Datenbank-Verbindung
BASE CLASS
DESCRIPTION
Ein Objekt der Klasse Quiq::Database::Api::Dbi::Connection repräsentiert eine Verbindung zu einer Relationalen Datenbank über den DBI-Layer.
ATTRIBUTES
- dbh => $dbh
-
DBI Database Handle.
- dbms => $dbms
-
Name des DBMS, für DBMS-spezifische Fallunterscheidungen.
METHODS
Konstruktor/Destruktor
new() - Öffne Datenbankverbindung
Synopsis
$db = $class->new($udlObj,@opt);Options
- -autoCommit => $bool (Default: 0)
-
Öffne die Verbindung im Autocommit-Modus.
- -handle => $handle
- utf8 => $bool (Default: 0)
Description
Instantiiere eine Datenbankverbindung und liefere eine Referenz auf dieses Objekt zurück.
destroy() - Schließe Datenbankverbindung
Synopsis
$db->destroy;Description
Schließe die Datenbankverbindung. Die Methode liefert keinen Wert zurück.
Objektmethoden
strict() - Schalte Datenbankverbindung in den Strict-Modus
Synopsis
$bool = $db->strict;
$bool = $db->strict($bool);Description
Ist der Strict-Modus eingeschaltet, führen alle Datenbank-Fehler zu einer Exception. Diese Methode schaltet den Strict-Modus ein oder stellt den ursprüngliche Modus wieder her.
maxBlobSize() - Liefere/Setze maximale Größe eines BLOB/TEXT-Werts (Oracle)
Synopsis
$n = $db->maxBlobSize;
$n = $db->maxBlobSize($n);Description
Liefere/Setze die maximale Größe eines BLOB/TEXT-Werts auf $n Bytes. Defaulteinstellung ist 1024*1024 Bytes (1MB).
Dieser Wert ist nur für Oracle relevant und wird bei der Selektion von BLOB/TEXT-Kolumnen benötigt. Ist der Wert einer BLOB/TEXT-Kolumne größer als die angegebene Anzahl an Bytes wird eine Exception ausgelöst.
Bei anderen DBMSen als Oracle hat das Setzen keinen Effekt und der Returnwert ist immer 0.
sql() - Führe SQL-Statement aus
Synopsis
$cur = $db->sql($stmt,$forceExec);Description
Führe SQL-Statement $stmt auf der Datenbank $db aus, instantiiere ein Resultat-Objekt $cur und liefere eine Referenz auf dieses Objekt zurück.
Ist Parameter $forceExec angegeben und wahr, wird die Ausführung des Statements forciert. Dies kann bei Oracle PL/SQL Code notwendig sein (siehe Doku zu Quiq::Database::Connection/sql).
VERSION
1.222
AUTHOR
Frank Seitz, http://fseitz.de/
COPYRIGHT
Copyright (C) 2024 Frank Seitz
LICENSE
This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.