archived-doc-de/reference/pgsql/reference.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.10 $ -->
<!-- EN-Revision: 1.29 Maintainer: conni Status: ready -->

<reference id='ref.pgsql'>
 <title>PostgreSQL Funktionen</title>
 <titleabbrev>PostgreSQL</titleabbrev>

 <partintro>
  <section id="pgsql.intro">
   &reftitle.intro;
   <para>
    PostgreSQL ist ein kostenloses Open Source Datenbanksystem. Es
    wurde ursprünglich im UC Berkeley Computer Science
    Department entwickelt und hat Pionierarbeit bei objektrelationalen
    Datenbankkonzepten geleistet, die jetzt Einzug in einige
    kommerzielle Datenbanken halten. PostgreSQL bietet SQL92/SQL99
    Sprachunterstützung, Transaktionen, referentielle Integrität,
    benutzerdefinierte Funktionen und ein erweiterbares Typkonzept.
    PostgreSQL ist eine  Weiterentwicklung des ursprünglichen Berkeley-Codes.
   </para>
  </section>

  <section id="pgsql.requirements">
   &reftitle.required; 
   <para>
    Um PostgreSQL benutzen zu können, brauchen Sie mindestens eine
    Version 6.5 oder später. Um alle Leistungsmerkmale des
    PostgreSQL-Moduls nutzen zu können, müssen Sie eine Version ab
    8.0 haben. PostgreSQL unterstützt viele Zeichencodierungen,
    einschließlich multibyte character encoding. Die aktuelle Version
    sowie weitere Informationen über PostgreSQL sind auf den Seiten
    <ulink url="&url.pgsql;">&url.pgsql;</ulink> erhältlich und die
    ausführliche Dokumentation finden Sie unter	 
     <ulink url="&url.pgsql.manual;">PostgreSQL Documentation</ulink>.
   </para>
  </section>

  &reference.pgsql.configure;

  &reference.pgsql.ini;

  <section id="pgsql.resources">
   &reftitle.resources;
   <para>
    Im PostgreSQL-Modul werden zwei Ressource-Typen verwendet:
    Der erste ist die Verbindungskennung für Datenbankverbindungen, 
    die zweite Ressource ist die Ergebniskennung, die ein
    Abfrageergebnis enthält.
   </para>
  </section>

  &reference.pgsql.constants;

  <section id="pgsql.notes">
  &reftitle.notes;
   <note>
    <para>
     Nicht alle Funktionen sind in allen Versionen verfügbar. Es hängt
     davon ab, welche libpq Version (das PostgreSQL C Client Interface)
     auf Ihrem Rechner verfügbar ist und wie libpq kompiliert wurde. 
     Falls eine Funktion nicht verfügbar ist, liegt es daran, dass libpq
     die nötigen Routinen nicht unterstützt, die die Funktion braucht.
   </para>    
   </note>  
   <note>
    <para>
     Die meisten PostgreSQL Funktionen nehmen den Parameter <parameter>connection</parameter>
     als ersten optionalen Parameter entgegen. Falls er nicht angegeben
     wurde, wird die zuletzt geöffnete Verbindung benutzt. Wenn keine
     geöffnete Verbindung existiert, geben diese Funktionen &false; zurück. 
    </para>
   </note>
   <note>
    <para>
     PostgreSQL wandelt automatisch alle Bezeichner in Kleinbuchstaben um
     (beispielsweise Tabellennamen oder Spaltennamen) und zwar sowohl bei
     der Erzeugung der Objekte als auch in Abfragen. Um Namen in Gross- und
     Kleinschreibung oder in Grossbuchstaben zu erzwingen, müssen diese in
     Anführungszeichen ("") eingeschlossen werden.
    </para>
   </note>
   <note>
    <para>
     PostgreSQL stellt keine speziellen Kommandos zur Verfügung, um
     Informationen über ein Datenbank-Schema (z. B. alle Tabellen in der
     aktuellen Datenbank) zu erhalten. Stattdessen gibt es ab der Version
     7.4 und höher ein Standard-Schma, das <literal>information_schema</literal>,
     in dem alle notwendigen Informationen in System-Views enthalten sind
     und die einfach abzufragen sind. Ausführliche Informationen darüber
     gibt es in der <ulink url="&url.pgsql.manual;">PostgreSQL Documentation</ulink>.
    </para>
   </note>
  </section>

  <section id="pgsql.examples">
   &reftitle.examples;
    <para>
     Dieses einfache Beispiel zeigt den Verbindungsaufbau, die Ausführung
     einer einfachen Abfrage, die Ausgabe der Abfrageergebnisse und, wie
     eine Verbindung wieder geschlossen wird.
     <example>
      <title>PostgreSQL extension overview example</title>
      <programlisting role="php">
<![CDATA[
<?php
// Verbindungsaufbau und Auswahl der Datenbank
$dbconn = pg_connect("host=localhost dbname=publishing user=www password=foo")
    or die('Verbindungsaufbau fehlgeschlagen: ' . pg_last_error());

// Eine SQL-Abfrge ausführen
$query = 'SELECT * FROM authors';
$result = pg_query($query) or die('Abfrage fehlgeschlagen: ' . pg_last_error());

// Ergebnisse in HTML ausgeben
echo "<table>\n";
while ($line = pg_fetch_array($result, null, PGSQL_ASSOC)) {
    echo "\t<tr>\n";
    foreach ($line as $col_value) {
        echo "\t\t<td>$col_value</td>\n";
    }
    echo "\t</tr>\n";
}
echo "</table>\n";

// Speicher freigeben
pg_free_result($result);

// Verbindung schliessen
pg_close($dbconn);
?>
]]>
      </programlisting>
     </example>
    </para>
   </section>
 </partintro>

&reference.pgsql.functions;

</reference>

<!-- Keep this comment at the end of the file
Local variables: 
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->