Frank Seitz
and 1 contributors

NAME

Prty::Database::Api::Dbi::Connection - DBI Datenbank-Verbindung

BASE CLASS

Prty::Hash

DESCRIPTION

Ein Objekt der Klasse Prty::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);

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 Statement forciert. Dies kann bei Oracle PL/SQL Code notwendig sein (siehe Doku zu Prty::Database::Connection/sql).

VERSION

1.108

AUTHOR

Frank Seitz, http://fseitz.de/

COPYRIGHT

Copyright (C) 2017 Frank Seitz

LICENSE

This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.