postgres/de: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		=Übersicht= Sie können mit Free Pascal / Lazarus auf einen PostgreSQL-Datenbank-Server zugreifen.\
2	2
3	3		Vorteile von PostgreSQL:
4	4
5	5		- PostgreSQL ist weit verbreitet
6	6		- PostgreSQL ist sehr stabil
7	7		- PostgreSQL hat eine komplettes Feature-Set
8	8		- PostgreSQL ist kostenfrei erhältlich
9	9
10	10		Besonderheiten bei 64 Bit Windows: Sie finden [[Windows Programming Tips\|hier]] Hinweise für die Zusammenarbeit von bestimmten Free Pascal / Lazarus Versionen mit 64 Bit Windows Versionen.\
11	11
12	12		=Zeos= Die Bibliothek Zeos unterstützt neben anderen Datenbanken auch PostgreSQL.\
13	13		Die Bibliothek Zeos finden Sie unter [[ZeosDBO]]\
14	14
15	15		=Bibliotheken für den Zugriff auf PostgreSQL=\
16	16		Lazarus unterstüzt PostgreSQL mit einer eigenen PostgreSQL Verbindungskomponente/Klasse.\
17	17		![](/wiki-images/c/c5/Sqldbcomponents.png%E2%80%8E)\
18	18
19	19		Wenn Sie ausliesslich mit Free Pascal arbeiten, dann fügen Sie die Unit pqconnection in Ihrer uses Anweisung hinzu.\
20	20
21	21		Hinweis: Wenn der Client libpq C geladen/entladen wird, dann erstellt der Client libpq C einige Speicherlecks (zumindest bis Version 9.3 von Postgres). Die SQLdb lädt den Client libpq C, wenn die erste Verbindung zur Datenbank erstellt wird und Sie entlädt den Client libpq C, wenn die letzte Verbindung zur Datenbank geschlossen wird. Das heisst, wann immer die letzte Verbindung zur Datenbank geschlossen wird, wird ein kleines Speicherleck erstellt. Um dem vorzubeugen (und um die Anwendung zu beschleunigen) können Sie den Client libpq C einmal beim starten Ihres Programmes mit dem Aufruf InitialisePostgres3 in den Speicher laden.\
22	22
23	23		Die Eigenschaft CharSet erwartet einen String, der die Nummer des von Ihrem Betriebsystem verwendeten Zeichensatzes enthält.
24	24
25	25		``` pascal
26	26		// statt '...' seht an der Stelle natürlich die Nummer des von Ihrem Betriebsystem verwendeten Zeichensatzes.
27	27		PQConnection.CharSet := '...';
28	28		```
29	29
30	30		Die Komponente TPQConnection unterstützt nicht direkt die Eigenschaft Port, aber man kann den Port in der Komponente über den Parameter Params übergeben:
31	31
32	32		``` pascal
33	33		PQConnection.Params.Add('port=' + VariableContainingPort);
34	34		```
35	35
36	36		Auch andere PostgreSQL spezifische Verbindungsparameter können mit der Eigenschaft Params angegeben werden:
37	37
38	38		``` pascal
39	39		PQConnection.Params.Add('application_name=''yourappname''');
40	40		```
41	41
42	42		==Beispiel== Siehe auch das Tutorial [[SQLdb Tutorial1]] zur Erstellung eines GUI-fähigen Datenbank-Programms, das für PostgreSQL, SQLite, Firebird und im Grunde für jedes RDBMS (Relational Database Management System = relationales Datenbankmanagementsystem) das von SQLdb unterstützt wird geschrieben ist.\
43	43
44	44		==Event monitoring (Ereignisüberwachung)== Wenn Sie FPC (Free Pascal Compiler) 2.6.2 oder höher und eine aktuelle Version von Lazarus haben, dann können Sie die Komponente TPQTEventMonitor zur Überwachung der Ereignisse von PostgreSQL verwenden.\
45	45
46	46		PQEventMonitor ist ein einfacher wrapper für FPC.\
47	47		Für Details beachten Sie bitte das FPC Beispielprogramm pqeventstest.pp.\
48	48
49	49		==Installation und Fehler== Wie bei allen SQLdb Komponenten, so müssen Sie auch hier die Treiber Bibliotheken (libraries) des Datenbankherstellers hinzufügen.\
50	50		Zum Beispiel können Sie diese Treiber Bibliotheken unter Windows in folgenden Pfaden finden:
51	51
52	52		- Im Installationsverzeichnis der PostgreSQL Treiber Bibliotheken
53	53		- Im Suchpfad Ihres Betriebssystems (z. B. bei Windows: c:\windows\system32, usw.)
54	54		- Im Ausgabeverzeichnis Ihres Programms
55	55		- usw.
56	56
57	57		===Windows 64 Bit Treiber=== Wenn Sie 64 Bit Anwendungen entwickeln, dann benötigen Sie eine 64 Bit PostgreSQL Treiber Bibliothek und ein 64 Bit Betriebssystem.\
58	58
59	59		> Note: FPC 2.6.0 (ebenso Lazarus 1.0.4 oder früher) unterstützen unter Windows 64 Bit kein PostgreSQL (es sei den, Sie Patchen und recompilieren FPC und Lazarus).
60	60
61	61		Ein Windows-64-Bit-Treiber ist nicht leicht zu finden, aber er kann hier heruntergeladen werden: [PostgreSQL](http://www.enterprisedb.com/products-services-training/pgdownload#windows%7CDownload).\
62	62		Die 64 Bit Treiber Bibliothek kann in C:\Windows\system32 oder unter C:\Windows\syswow64 installiert werden.\
63	63
64	64		===Error: "Can not load PostgreSQL client library "libpq.dll""=== Ihr Programm kann die PostgreSQL Treiber Bibliothek nicht finden.\
65	65		Siehe oben, wie die PostgreSQL Treiber Bibliothek zu installieren ist.\
66	66		Ein gutes Beispiel wie man Treiber Bibliotheken unter Windows für die Verbindung zur PostgreSQL Datenbank einfügt findet man unter [easyDB](http://paginas.fe.up.pt/~asousa/wiki/doku.php?id=proj:lazarus_projects#easy_db).\
67	67
68	68		Unter Linux/Unix/OSX stellen Sie bitte sicher, dass die PostgreSQL Treiber Bibliothek zum Beispiel in einem dieser Pfade zu finden ist:
69	69
70	70		- Unter Linux fügen Sie den Pfad zur Datei libpq.so in den Abschnitt libraries in der Datei /etc/fpc.cfg file hinzu. Beispiel Eintrag: -Fl/usr/local/pgsql/lib
71	71		- Manchmal ist es nötig einen symbolischen Link von einer speziellen Versinon der Bibliothek zu einem allgemeinen Bibliotheksnamen zu erstellen:
72	72		``` bash
73	73		ln -s /usr/lib/pqsql.so.5 /usr/lib/pqsql.so
74	74		```
75	75		- Besser ist es, Sie installieren den PostgreSQL Client mit dem Paketmanager Ihrer Linux/Unix/OSX Distribution
76	76
77	77		=PostgreSQL package: die low level units= So wie bei allen Datenbanken, so hängt auch der SQLDB-Code von einer unteren Programmierebene ab, nämlich von der PostgreSQL-Treiberbibliothek. Diese Treiberbibliothek besteht je nach Betriebssystem aus Bibliothekdateien mit der Erweiterung .so .dll oder .dylib. Normalerweise können Sie SQLDB Code einer höheren Programmierebene verwenden, die es Ihnen erlaubt schneller zu programmieren und einfacher Datenbanken zu wechseln usw.\
78	78
79	79		Mit diesem Beispiel ist es sehr einfach, alles was Sie tun müssen, ist das kompilieren einiger Units und diese Units können Sie dann in Ihrem Programm verwenden. Sie müssen diese Units Anstelle der PostgreSQL-Client-Bibliothek (libpq) bei der Erstellung Ihres Programms angeben.\
80	80
81	81		Die Haupt-Unit heisst postgres, normalerweise ist dies die einzige Unit, die Sie in Ihrem uses Abschnitt einfügen müssen.\
82	82
83	83		==Anforderungen== Sie benötigen mindestens Free Pascal in der Version 0.99.5. Die Header müssen mindestens von PostgreSQL Version 6.3.1 sein.\
84	84
85	85		==Installation== Die Postgres Unit wird mit den Free Pascal packages geliefert (/usr/share/fpcsrc/\[Versionsnummer\]/packages/postgres). Das Package enthält ein Verzeichnis postgres mit den Units, ein Testprogramm und eine Datei Makefile.\
86	86		Wechsle in das Verzeichnis und editiere die Datei makefile. In der Datei Makefile werden die Variablen für Ihr Betriebsystem gesetzt. Sie müssen nur eine Sache in die Datei Makefile einfügen:\
87		-	~~Das Verzeichnis, in dem sich die libpq Bibliotheken befinden. Möglicherweise sind diese im Verzeichnis /usr/local/pgsql/lib geben Sie jetzt\~~
88		-	~~make ein. Dies sollte zum kompillieren der units und des Programms führen. Nach einer erfolgreichen Kompillation können Sie das Ergebnis mit\~~
89		-	~~make install installieren. (Denken Sie daran das Verzeichnis mit den installierten Units zu setzen.)\~~
	87	+
	88	+	```text
	89	+	Das Verzeichnis, in dem sich die libpq Bibliotheken befinden. Möglicherweise sind diese im Verzeichnis /usr/local/pgsql/lib
	90	+	```
	91	+
	92	+	geben Sie jetzt\
	93	+
	94	+	```text
	95	+	make
	96	+	```
	97	+
	98	+	ein. Dies sollte zum kompillieren der units und des Programms führen. Nach einer erfolgreichen Kompillation können Sie das Ergebnis mit\
	99	+
	100	+	```text
	101	+	make install
	102	+	```
	103	+
	104	+	installieren. (Denken Sie daran das Verzeichnis mit den installierten Units zu setzen.)\
90	105		Jetzt können Sie das Testprogramm ausführen:\
91		-	~~make test Sie werden eine viele Meldungen die Ihnen Rückmeldungen und Ergebnisse auf Ihrem Bildschirm sehen. Wenn etwas schief läuft wird das Programm make Sie darüber informieren.\~~
	106	+
	107	+	```text
	108	+	make test
	109	+	```
	110	+
	111	+	Sie werden eine viele Meldungen die Ihnen Rückmeldungen und Ergebnisse auf Ihrem Bildschirm sehen. Wenn etwas schief läuft wird das Programm make Sie darüber informieren.\
92	112
93	113		# Siehe auch
94	114
95	115		- [[Lazarus DB Faq/de\|Lazarus DB Faq]] - More about database programming
96	116
97	117		---
98	118		From the Free Pascal wiki, page "postgres/de", as it stood on 2020-02-23 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history