The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

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

BASE CLASS

Quiq::Hash

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.195

AUTHOR

Frank Seitz, http://fseitz.de/

COPYRIGHT

Copyright (C) 2021 Frank Seitz

LICENSE

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