Обсуждение: SVN Commit by andreas: r4316 - in trunk/pgadmin3/docs: . de_DE de_DE/hints en_US/hints
SVN Commit by andreas: r4316 - in trunk/pgadmin3/docs: . de_DE de_DE/hints en_US/hints
От
svn@pgadmin.org
Дата:
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�nnen, mu�t zuerst die grund�tzliche +Zugangsfreigabe f�r den Client erteilt werden (Host Based Authentication). PostgreSQL pr�ft die pg_hba.conf-Datei +ob ein Muster welches der Client-Adresse/Benutzername/Datenbank entspricht vorhanden und aktiviert +ist noch bevor eventuelle SQL GRANT Zugriffsbeschr�nkungen zum Tragen kommen. +</p> +<p> +Die anf�nglichen Einstellungen in der pg_hba.conf sind recht restriktiv, um unerw�nschten Sicherheitsl�cher +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�sselten Pa�wortzugriff auf alle Datenbanken f�r alle 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 �nderungen an der Datei mu� der Server �ber pg_ctl oder Stoppen und Starten des Serverprozesses +zum Neuauswerten der Datei veranla�t 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�hren, sind zus�tzliche Vorkehrungen notwendig, +siehe die PostgreSQL Online-Hilfe. F�r den Anfang d�rfte es einfacher sein, eine andere Authentifizierungsmethode +zu verwenden. Z.B.MD5-verschl�sselte Pa�worte 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�sselten Pa�wortzugriff auf alle Datenbanken f�r alle 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 �nderungen an der Datei mu� der Server �ber pg_ctl oder Stoppen und Starten des Serverprozesses +zum Neuauswerten der Datei veranla�t 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�ft werden ob der PostgreSQL Server tat�chlich auf dem angegebenen +port l�uft. Ist Netzwerk-Connectivity von der Client-Maschine zur Servermaschine gegeben? Ist das Netzwerk/VPN/SSH-Tunnel +korrekt konfiguriert? +</p> +<p> +Aus Sicherheitsgr�nden reagiert PostgreSQL anf�nglich <B>nicht</B> auf allen verf�gbaren IP-Adressen der Servermaschine.Um den Server +�ber das Netzwerk ansprechen zu k�nnen, m�ssen die Interfaces erst aktiviert werden. +</p> +<p> +F�r PostgreSQL-Server ab Version 8.0 wird dies durch den "listen_addresses"-Parameter in the postgresql.conf-Dateigesteuert.Hier +wird die Liste aller zu bedienenden IP-Adressen eingetragen, oder einfach '*' um alle verf�gbaren Interfaces zu bedienen.F�r �ltere 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 �nderungen an der Datei mu� der Server neu gestartet werden um die �nderungen aktiv zu machen. +</p> +<p> +Wenn nach doppelter Pr�fung der Konfiguration diese Fehlermeldung immer noch kommt, ist +es trotzdem sehr unwahrscheinlich da� tats�chlich ein Fehlverhalten des PostgreSQL-Servers vorliegt. +Vermutlich gibt es ein grundlegendes Netzwerkproblem (z.B. Firewall-Konfiguration). Dies sollte eingehend gepr�ft +werden, 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�ssel abdeckende Indizes</h3> +<p> +Ein Fremdschl�ssel koppelt zwei Tabellen auf logische Weise, und beschr�nkt �nderungen die auf sie angewendet werden k�nnen. +</p> +<p> +Es f�ngt mit einer Mastertabelle an, welche die Referenzierte Tabelle wird. Sie mu� einen Prim�rschl�ssel haben +(strenggenommen m�ssen die referenzierten Spalten nur nicht-NULL sein und mit einem eindeutigen Index versehen sein, +aber es ist gute Praxis das �ber einen Prim�rschl�ssel zu implementieren). Die Slave-Tabelle h�ngt von der Mastertabelleab, +in dem Sinne da� Spalten auf die der Fremdschl�ssel definiert ist f�r jeden Wert passende Eintr�ge in der Mastertabelleerfordert. +Die Slave-Tabelle ist die referenzierende Tabelle des Fremdschl�ssels. +</p> +<p> +Der Fremdschl�ssel beschr�nkt 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�ndert wird (Update oder Delete), alle referenzierenden Tabelen gepr�ft werdenm�ssen +ob die Operation g�ltig ist, und ob weitere Aktionen ausgel�st werden m�ssen; siehe hierzu auch die PostgreSQL-Dokumentation +�ber Fremdschl�ssel (Foreign Keys). +</p> +<p> +Dies bedeutet, da� �nderungen an einer bestimmten Zeile in der referenzierten Tabelle zus�tzliche Lesezugriffe +in allen referenzierenden Tabellen ausl�st, mit den Fremdschl�ssel als Zugriffsbegriff. In der Konsequenz sollten alle Designregeln +f�r performanten Lesezugriff auch auf die Fremdschl�sselspalten angewendet werden. F�r gute Zugriffsgeschwindigkeiten +ist in der Regel ein Index empfehlenswert. PostgreSQL verlangt dies nicht unbedingt, es liegt daher in der Verantwortung +des Datenbankdesigners f�r das 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�ft wird und dieser bei Bedarf angelegt wird soweit noch nicht vorhanden. Wie bei allen Indizesgibt +es F�lle in denen Indizes die Gesamtperformance verringern k�nnen; 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�rschl�ssel</h3> +<p> +Beim Designen einer Tabelle sollte man stehts im Blick behalten, auf welche Weise sie sp�ter auf sie +zugegriffen wird. In den meisten F�llen wird ein eindeutiger Schl�sselbegriff erforderlich sein um eine +spezifische Zeile jeweils eindeutig identifizieren zu k�nnen. Dieser Schl�sselbegriff sollte als Prim�rschl�ssel +erzeugt werden. +Ein Prim�rschl�ssel mu� nicht unbedingt aus einer einzelnen Spalte bestehen; er kann soviel Spalten beinhalten wie n�tig +um eine Zeile eindeutig zu identifizieren. Wenn hierzu allerdings viele Spalten erforderlich sein sollten (Faustregel: mehrals 3) +k�nnte es eine gute Idee sein eine zus�tzliche Spalte mit einem handlichen Datentyp, z.b. serial oder bigserial, einzuf�hren, +welche den eindeutigen Schl�ssel enth�lt. +</p> +<p> +Nur in seltenen Ausnahmef�llen macht das Erzeugen eines Prim�rschl�ssels keinen Sinn. Das bedeutet, da� das Fehlen eines +Prim�rschl�ssels in einer Tabelle auf eine unvollst�ndige 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�rschl�sselaufweist, +also was soll das Ganze? Tats�chlich haben alle diese Tabellen eine oder zwei Spalten (typischerweise nur die OID), welche +jede Zeile eindeutig identifiziert, welche die zweite Regel f�r einen Prim�rschl�ssel, nicht NULL enthalten zu d�rfen, befolgt,und einen +Index f�r schnelleren Zugriff beinhaltet. Die Verwendung von OIDs hat historische Gr�nde, und ist gerade Wahl wenn es umden Design +von User-Tabellen geht. PostgreSQL benutzt diese um R�ckw�rtskompatibilit�t zu gew�hrleisten. Aus heutiger Sicht w�rde manvermutlich +Prim�rschl�ssel verwenden, eine dahingehende �nderung 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�rschl�ssel erreicht werden. Es ist allerdings sehr empfehlenswert, aus Gr�nden der Klarheit des Datenmodells +stets Prim�rschl�ssel 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�tzte Anzahl Zeilen in der Tabelle "<INFO>" weicht erheblich von der tats�chlich ermittelten ab. +VACUUM ANALYZE sollte auf dieser Tabelle ausgef�hrt werden. +</p><p> +Anstatt das Kommando VACUUM ANALYZE auf dieser Tabelle manuell auszuf�hren (dies kann �ber das +Wartungs-Men� von pgAdmin III ausgel�st werden), empfiehlt es sich VACUUM ANALYZE regelm��ig +automatisiert durchzuf�hren. Dies kann durch einen Scheduler erreicht werden. PostgreSQL bietet auch den +pg_autovacuum Daemon, der �nderung an der Datenbank verfolgt und bei Bedarf VACUUM automatisch ausl�st. +In der Regel bietet pg_autovacuum die optimale L�sung. +</p><p><br><br></p> +<b>Wozu ist VACUUM �berhaupt gut?</b> +<p> +Der PostgreSQL Queryplaner f�llt seine Entscheidung anhand von Annahmen, die er aus der gesch�tzten Anzahl Reihen +ableitet. Wenn die tats�chliche Anzahl zu sehr von der gesch�tzten 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�tigt VACUUM um Transaktion-IDs in Tabellen zu fixieren. +Weiterhin werden Zeilen, die nach Updates und Deletes nicht mehr ben�tigt werden, erst durch ein VACUUM +tats�chlich wieder freigegeben. +Weitergehende Informationen sind in der Online-Hilfe zu finden: einfach den Hilfe-Button dr�cken. +</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