.. highlightlang:: us

.. _pq_connectdb:

pq_connectdb
============

.. index:: pq_connectdb

.. us.tag  pq_connectdb NOTREADYGERMAN New550 postgres

:ref:`pq_connectdb` erzeugt eine neue Verbindung zu einem PostgreSQL-Server.

.. function::  db = pq_connectdb(ssConninfo)

.. us.return

**Returnwert**

*db* ist der Connection-Pointer. Die Verbindung kann mit der Funktion 
:ref:`pq_finish` wieder gelöst werden. Falls :ref:`pq_finish` nicht aufgerufen wird, 
wird die Verbindung vom Garbage Collector (siehe :ref:`gc`) gelöst.

.. us.params

**Parameter**

.. uparam:: ssConninfo

   *ssConninfo* ist eine Zeichenkette mit whitespace separierten 
   Keyword/Value-Paaren. Die wichtigsten Schlüsselwörter sind:

   .. list-table::
      :header-rows: 0

      * - host
        - Name des Hosts auf dem der Datenbank-Server läuft, z. B. localhost.
      * - port
        - TCP/IP Port Nummer.
      * - dbname
        - Datenbankname.
      * - user
        - PostgreSQL Benutzer-Name.
      * - password
        - Password.

.. us.example

**Beispiel**

::

   def test_pq_connectdb()
   {
       loadlib("rs_pq.dll")
       ssConnect = "host=p3200server port=5432 dbname=postgres user=postgres password=postgres";
       conn = pq_connectdb(ssConnect);
       stat = pq_status(conn);
       if (stat != PQ_CONNECTION_OK) {
           MessageBoxError(pq_error_message(conn));
           error();
       }
       return conn;
   }

.. us.comment

**Kommentar**

Weitere Informationen finden Sie in der Dokumentation der Funktion PQconnectdb
in der PostgreSQL Dokumentation (http://www.postgresql.org).

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - 5.5.0
     - Neu.

.. seealso::
   :ref:`uberblick-postgresql`,
   :ref:`pq_finish`

:sub:`id-657453`