Author: andreas
Date: 2005-06-17 23:07:52 +0100 (Fri, 17 Jun 2005)
New Revision: 4316
Added:
trunk/pgadmin3/docs/de_DE/
trunk/pgadmin3/docs/de_DE/hints/
trunk/pgadmin3/docs/de_DE/hints/conn-hba.html
trunk/pgadmin3/docs/de_DE/hints/conn-ident.html
trunk/pgadmin3/docs/de_DE/hints/conn-listen.html
trunk/pgadmin3/docs/de_DE/hints/fki.html
trunk/pgadmin3/docs/de_DE/hints/multiple.html
trunk/pgadmin3/docs/de_DE/hints/pk.html
trunk/pgadmin3/docs/de_DE/hints/vacuum.html
Modified:
trunk/pgadmin3/docs/en_US/hints/vacuum.html
Log:
German hints
Added: trunk/pgadmin3/docs/de_DE/hints/conn-hba.html
===================================================================
--- trunk/pgadmin3/docs/de_DE/hints/conn-hba.html 2005-06-17 21:03:09 UTC
(rev 4315)
+++ trunk/pgadmin3/docs/de_DE/hints/conn-hba.html 2005-06-17 22:07:52 UTC
(rev 4316)
@@ -0,0 +1,42 @@
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
+<link rel="STYLESHEET" type="text/css" href="../pgadmin3.css">
+<title>Guru-Hinweise</title>
+</head>
+
+<body>
+
+<h3>Zugriff auf die Datenbank verweigert</h3>
+<p>
+Der Server erlaubt keinen Zugriff auf die Datenbank. Der Server meldet
+</p>
+<p>
+<b><tt class="command"><INFO></tt></b>
+</p>
+<p>
+Um eine Datenbank auf einem PostgreSQL-Server ansprechen zu k�n, mu�
zuerst die grund�liche
+Zugangsfreigabe f� Client erteilt werden (Host Based Authentication).
PostgreSQL pr�e pg_hba.conf-Datei
+ob ein Muster welches der Client-Adresse/Benutzername/Datenbank entspricht
vorhanden und aktiviert
+ist noch bevor eventuelle SQL GRANT Zugriffsbeschr�ungen zum Tragen kommen.
+</p>
+<p>
+Die anf�lichen Einstellungen in der pg_hba.conf sind recht restriktiv, um
unerw�en Sicherheitsl�r
+vorzubeugen, wenn diese Datei nicht editiert wird. Typischerweise werden
Zugriffsregeln der folgenden Form
+erforderlich werden:
+</p>
+<p>
+<b><tt class="command">host all all 192.168.0.0/24 md5</tt></b>
+</p>
+<p>
+Dieses Beispiel erlaubt MD5-verschl�en Pa�ortzugriff auf alle
Datenbanken f�e Benutzer im
+privaten Netzwerksegment 192.1680.0/24.
+</p>
+<p>
+Zum Editieren der pg_hba.conf-Datei kann der in pgAdmin III eingebaute Editor
verwendet werden.
+Nach �derungen an der Datei mu�der Server �g_ctl oder Stoppen und
Starten des Serverprozesses
+zum Neuauswerten der Datei veranla� werden.
+</p>
+</body>
+</html>
Added: trunk/pgadmin3/docs/de_DE/hints/conn-ident.html
===================================================================
--- trunk/pgadmin3/docs/de_DE/hints/conn-ident.html 2005-06-17 21:03:09 UTC
(rev 4315)
+++ trunk/pgadmin3/docs/de_DE/hints/conn-ident.html 2005-06-17 22:07:52 UTC
(rev 4316)
@@ -0,0 +1,40 @@
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
+<link rel="STYLESHEET" type="text/css" href="../pgadmin3.css">
+<title>Guru-Hinweise</title>
+</head>
+
+<body>
+
+<h3>Ident-Authentifizierung fehlgeschlagen</h3>
+<p>
+Der Server akzeptiert den aktuellen Benutzer nicht. Der Server anwortet
+</p>
+<p>
+<b><tt class="command"><INFO></tt></b>
+</p>
+<p>
+Wenn diese Meldung erscheint, ist ein Eintrag in der pg_hba.conf-Datei
gefunden worden die der
+Kombination von Client-Adresse/Benutzer/Datenbank entpricht, gesetzt auf die
"ident" Authentikation.
+Einige Distributionen, z.B.Debian, haben dies per Default.
+Um eine Ident-basierte Authentifikation erfolgreich durchzuf� sind
zus�liche Vorkehrungen notwendig,
+siehe die PostgreSQL Online-Hilfe. F� Anfang d�es einfacher sein,
eine andere Authentifizierungsmethode
+zu verwenden. Z.B.MD5-verschl�e Pa�orte sind eine gute Wahl, ein
entsprechender Eintrag in der
+pg_hba.conf sieht so aus:
+</p>
+<p>
+<b><tt class="command">host all all 192.168.0.0/24 md5</tt></b>
+</p>
+<p>
+Dieses Beispiel erlaubt MD5-verschl�en Pa�ortzugriff auf alle
Datenbanken f�e Benutzer im
+privaten Netzwerksegment 192.1680.0/24.
+</p>
+<p>
+Zum Editieren der pg_hba.conf-Datei kann der in pgAdmin III eingebaute Editor
verwendet werden.
+Nach �derungen an der Datei mu�der Server �g_ctl oder Stoppen und
Starten des Serverprozesses
+zum Neuauswerten der Datei veranla� werden.
+</p>
+</body>
+</html>
Added: trunk/pgadmin3/docs/de_DE/hints/conn-listen.html
===================================================================
--- trunk/pgadmin3/docs/de_DE/hints/conn-listen.html 2005-06-17 21:03:09 UTC
(rev 4315)
+++ trunk/pgadmin3/docs/de_DE/hints/conn-listen.html 2005-06-17 22:07:52 UTC
(rev 4316)
@@ -0,0 +1,43 @@
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
+<link rel="STYLESHEET" type="text/css" href="../pgadmin3.css">
+<title>Guru-Hinweise</title>
+</head>
+
+<body>
+
+<h3>Der Server antwortet nicht</h3>
+<p>
+Der Server akzeptiert keine Verbindungen: Die Verbindungslibrary berichtet
+</p>
+<p>
+<b><tt class="command"><INFO></tt></b>
+</p>
+<p>
+Wenn diese Meldung auftaucht, sollte gepr�rden ob der PostgreSQL Server
tat�lich auf dem angegebenen
+port l�t. Ist Netzwerk-Connectivity von der Client-Maschine zur
Servermaschine gegeben? Ist das Netzwerk/VPN/SSH-Tunnel
+korrekt konfiguriert?
+</p>
+<p>
+Aus Sicherheitsgr�reagiert PostgreSQL anf�lich <B>nicht</B> auf allen
verf�n IP-Adressen der Servermaschine. Um den Server
+�as Netzwerk ansprechen zu k�n, m�die Interfaces erst aktiviert
werden.
+</p>
+<p>
+F�tgreSQL-Server ab Version 8.0 wird dies durch den
"listen_addresses"-Parameter in the postgresql.conf-Datei
gesteuert.Hier
+wird die Liste aller zu bedienenden IP-Adressen eingetragen, oder einfach '*'
um alle verf�n Interfaces zu bedienen. F�ere Versionen
+(Version 7.3 oder 7.4), ist der Parameter "tcpip_socket" auf 'true'
zu setzen.
+</p>
+<p>
+Zum Editieren der postgresql.conf-Datei kann der in pgAdmin III eingebaute
Editor verwendet werden.
+Nach �derungen an der Datei mu�der Server neu gestartet werden um die
�derungen aktiv zu machen.
+</p>
+<p>
+Wenn nach doppelter Pr�der Konfiguration diese Fehlermeldung immer noch
kommt, ist
+es trotzdem sehr unwahrscheinlich da�tats�lich ein Fehlverhalten des
PostgreSQL-Servers vorliegt.
+Vermutlich gibt es ein grundlegendes Netzwerkproblem (z.B.
Firewall-Konfiguration). Dies sollte eingehend gepr�erden, bevor ein vermeintlicher Bug an die PostgreSQL Community gemeldet wird.
+</p>
+</body>
+</html>
Added: trunk/pgadmin3/docs/de_DE/hints/fki.html
===================================================================
--- trunk/pgadmin3/docs/de_DE/hints/fki.html 2005-06-17 21:03:09 UTC (rev
4315)
+++ trunk/pgadmin3/docs/de_DE/hints/fki.html 2005-06-17 22:07:52 UTC (rev
4316)
@@ -0,0 +1,43 @@
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
+<link rel="STYLESHEET" type="text/css" href="../pgadmin3.css">
+<title>Guru-Hinweise</title>
+</head>
+
+<body>
+<h3>Fremdschl�abdeckende Indizes</h3>
+<p>
+Ein Fremdschl�koppelt zwei Tabellen auf logische Weise, und beschr�t
�derungen die auf sie angewendet werden k�n.
+</p>
+<p>
+Es f�t mit einer Mastertabelle an, welche die Referenzierte Tabelle wird.
Sie mu�einen Prim�chl�haben
+(strenggenommen m�die referenzierten Spalten nur nicht-NULL sein und mit
einem eindeutigen Index versehen sein,
+aber es ist gute Praxis das �inen Prim�chl�zu implementieren). Die
Slave-Tabelle h�t von der Mastertabelle ab,
+in dem Sinne da�Spalten auf die der Fremdschl�definiert ist f�en
Wert passende Eintr� in der Mastertabelle erfordert.
+Die Slave-Tabelle ist die referenzierende Tabelle des Fremdschl�.
+</p>
+<p>
+Der Fremdschl�beschr�t allerdings nicht nur die referenzierende
Tabelle, sondern auch die referenzierte. Die
+Geschmacksrichtung kann dabei zwischen RESTRICT, CASCADE und SET NULL
variieren. Dies bedeuted, da�sobale
+eine Zeile in der referenzierten Tabelle ge�ert wird (Update oder Delete),
alle referenzierenden Tabelen gepr�rden m�+ob die Operation g�ist, und ob weitere Aktionen ausgel�werden m�
siehe hierzu auch die PostgreSQL-Dokumentation
+�remdschl�(Foreign Keys).
+</p>
+<p>
+Dies bedeutet, da��derungen an einer bestimmten Zeile in der referenzierten
Tabelle zus�liche Lesezugriffe
+in allen referenzierenden Tabellen ausl� mit den Fremdschl�als
Zugriffsbegriff. In der Konsequenz sollten alle Designregeln
+f�formanten Lesezugriff auch auf die Fremdschl�palten angewendet
werden. F�e Zugriffsgeschwindigkeiten
+ist in der Regel ein Index empfehlenswert. PostgreSQL verlangt dies nicht
unbedingt, es liegt daher in der Verantwortung
+des Datenbankdesigners f� Anlegen eines passenden Index zu sorgen.
+</p>
+<p>
+Zur Steigerung des Komforts und des allgemeinen Wohlbefindens bietet pgAdmin
III eine Checkbox an, mit deren Hilfe
+auf einen passenden Index gepr�rd und dieser bei Bedarf angelegt wird
soweit noch nicht vorhanden. Wie bei allen Indizes gibt
+es F�e in denen Indizes die Gesamtperformance verringern k�n; in aller
Regel ist ein Index zu wenig jedoch wesentlich
+schlimmer als einer zuviel.
+</p>
+</body>
+
+</html>
Added: trunk/pgadmin3/docs/de_DE/hints/multiple.html
===================================================================
--- trunk/pgadmin3/docs/de_DE/hints/multiple.html 2005-06-17 21:03:09 UTC
(rev 4315)
+++ trunk/pgadmin3/docs/de_DE/hints/multiple.html 2005-06-17 22:07:52 UTC
(rev 4316)
@@ -0,0 +1,13 @@
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
+<link rel="STYLESHEET" type="text/css" href="../pgadmin3.css">
+<title>Guru-Hinweise</title>
+</head>
+<body>
+<p>
+pgAdmin III hat mehrere Hinweise zum aktuellen Objekt.
+</p>
+</body>
+</html>
Added: trunk/pgadmin3/docs/de_DE/hints/pk.html
===================================================================
--- trunk/pgadmin3/docs/de_DE/hints/pk.html 2005-06-17 21:03:09 UTC (rev
4315)
+++ trunk/pgadmin3/docs/de_DE/hints/pk.html 2005-06-17 22:07:52 UTC (rev
4316)
@@ -0,0 +1,41 @@
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
+<link rel="STYLESHEET" type="text/css" href="../pgadmin3.css">
+<title>Guru-Hinweise</title>
+</head>
+
+<body>
+
+<h3>Prim�chl�/h3>
+<p>
+Beim Designen einer Tabelle sollte man stehts im Blick behalten, auf welche
Weise sie sp�r auf sie
+zugegriffen wird. In den meisten F�en wird ein eindeutiger Schl�egriff
erforderlich sein um eine
+spezifische Zeile jeweils eindeutig identifizieren zu k�n. Dieser
Schl�egriff sollte als Prim�chl�+erzeugt werden.
+Ein Prim�chl�mu�nicht unbedingt aus einer einzelnen Spalte bestehen;
er kann soviel Spalten beinhalten wie n�
+um eine Zeile eindeutig zu identifizieren. Wenn hierzu allerdings viele
Spalten erforderlich sein sollten (Faustregel: mehr als 3)
+k�e es eine gute Idee sein eine zus�liche Spalte mit einem handlichen
Datentyp, z.b. serial oder bigserial, einzuf�
+welche den eindeutigen Schl�enth�.
+</p>
+<p>
+Nur in seltenen Ausnahmef�en macht das Erzeugen eines Prim�chl�
keinen Sinn. Das bedeutet, da�das Fehlen eines
+Prim�chl� in einer Tabelle auf eine unvollst�ige Definition hinweist;
darum kommt der Guruhinweis hoch
+wenn man eine Tabelle ohne PK anzulegen versucht.
+</p>
+<p>
+Wenn man einen Blick auf die PostgreSQL-Systemtabellen wirft, stellt man fest
da�keine von ihnen einen Prim�chl�aufweist,
+also was soll das Ganze? Tats�lich haben alle diese Tabellen eine oder zwei
Spalten (typischerweise nur die OID), welche
+jede Zeile eindeutig identifiziert, welche die zweite Regel f�en
Prim�chl� nicht NULL enthalten zu d� befolgt, und einen
+Index f�nelleren Zugriff beinhaltet. Die Verwendung von OIDs hat
historische Gr�und ist gerade Wahl wenn es um den Design
+von User-Tabellen geht. PostgreSQL benutzt diese um R�tskompatibilit�zu
gew�leisten. Aus heutiger Sicht w�an vermutlich
+Prim�chl�verwenden, eine dahingehende �derung der Systemtabellen ist
allerdings nicht zu erwarten.
+</p>
+<p>
+Wie das Beispiel der Systemtabellen zeigt, kann das Ziel der Eindeutigkeit und
des schnellen Zugriffs auch auf andere Weise
+als mit einem Prim�chl�erreicht werden. Es ist allerdings sehr
empfehlenswert, aus Gr�der Klarheit des Datenmodells
+stets Prim�chl�zu verwenden.
+</p>
+</body>
+</html>
Added: trunk/pgadmin3/docs/de_DE/hints/vacuum.html
===================================================================
--- trunk/pgadmin3/docs/de_DE/hints/vacuum.html 2005-06-17 21:03:09 UTC (rev
4315)
+++ trunk/pgadmin3/docs/de_DE/hints/vacuum.html 2005-06-17 22:07:52 UTC (rev
4316)
@@ -0,0 +1,35 @@
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
+<link rel="STYLESHEET" type="text/css" href="../pgadmin3.css">
+<title>Guru-Hinweise</title>
+</head>
+
+<body>
+
+<h3>VACUUM-Lauf empfohlen</h3>
+<p>
+Die gesch�te Anzahl Zeilen in der Tabelle "<INFO>" weicht
erheblich von der tats�lich ermittelten ab.
+VACUUM ANALYZE sollte auf dieser Tabelle ausgef�erden.
+</p><p>
+Anstatt das Kommando VACUUM ANALYZE auf dieser Tabelle manuell auszuf�
(dies kann �as
+Wartungs-Men�pgAdmin III ausgel�werden), empfiehlt es sich VACUUM
ANALYZE regelm�g
+automatisiert durchzuf� Dies kann durch einen Scheduler erreicht werden.
PostgreSQL bietet auch den
+pg_autovacuum Daemon, der �derung an der Datenbank verfolgt und bei Bedarf
VACUUM automatisch ausl�
+In der Regel bietet pg_autovacuum die optimale L�g.
+</p><p><br><br></p>
+<b>Wozu ist VACUUM �upt gut?</b>
+<p>
+Der PostgreSQL Queryplaner f�t seine Entscheidung anhand von Annahmen, die
er aus der gesch�ten Anzahl Reihen
+ableitet. Wenn die tats�liche Anzahl zu sehr von der gesch�ten Anzahl
abweicht, kann der Planer eine falsche
+Entscheidung treffen, wodurch ein nicht-optimaler Queryplan zur Anwendung
gelangt. Daraus kann eine schlechte
+Performance resultieren.
+</p><p>
+Die PostgreSQL Datenspeicherung ben�t VACUUM um Transaktion-IDs in Tabellen
zu fixieren.
+Weiterhin werden Zeilen, die nach Updates und Deletes nicht mehr ben�t
werden, erst durch ein VACUUM
+tats�lich wieder freigegeben.
+Weitergehende Informationen sind in der Online-Hilfe zu finden: einfach den
Hilfe-Button dr�
+</p>
+</body>
+</html>
Modified: trunk/pgadmin3/docs/en_US/hints/vacuum.html
===================================================================
--- trunk/pgadmin3/docs/en_US/hints/vacuum.html 2005-06-17 21:03:09 UTC (rev
4315)
+++ trunk/pgadmin3/docs/en_US/hints/vacuum.html 2005-06-17 22:07:52 UTC (rev
4316)
@@ -14,7 +14,7 @@
You should run VACUUM ANALYZE on this table.
</p><p>
Instead of issuing a manual VACUUM ANALYZE command on this table (you can use
-the pgAdminIII maintenance menu for this), running VACUUM ANALYZE on a regular
+the pgAdmin III maintenance menu for this), running VACUUM ANALYZE on a regular
or automated basis should be considered. This can be achieved using a
scheduler. PostgreSQL also supplies
the pg_autovacuum daemon, which will track changes made to the database and
issue
vacuum commands as required automatically. In most cases, pg_autovacuum will
be the
---------------------------(end of broadcast)---------------------------
TIP 5: Have you checked our extensive FAQ?
http://www.postgresql.org/docs/faq
