SVN Commit by andreas: r4316 - in trunk/pgadmin3/docs: . de_DE de_DE/hints en_US/hints

Поиск
Список
Период
Сортировка
От svn@pgadmin.org
Тема SVN Commit by andreas: r4316 - in trunk/pgadmin3/docs: . de_DE de_DE/hints en_US/hints
Дата
Msg-id 200506172207.j5HM7rEt009946@developer.pgadmin.org
обсуждение исходный текст
Список pgadmin-hackers
Дерево обсуждения 
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

В списке pgadmin-hackers по дате отправления:

Предыдущее
От: svn@pgadmin.org
Дата:
Сообщение: SVN Commit by andreas: r4315 - trunk/pgadmin3/src/agent
Следующее
От: OpenMacNews
Дата:
Сообщение: latest pgadmin3.app binary from svn ...