X-Original-To: pgsql-docs@postgresql.org
Received: from localhost (postgresql.org [64.49.215.8])
	by postgresql.org (Postfix) with ESMTP id A4016475F85
	for <pgsql-docs@postgresql.org>; Fri, 14 Feb 2003 16:50:13 -0500 (EST)
Received: from post.webmailer.de (natsmtp00.webmailer.de [192.67.198.74])
	by postgresql.org (Postfix) with ESMTP id 076B8476561
	for <pgsql-docs@postgresql.org>; Fri, 14 Feb 2003 16:32:40 -0500 (EST)
Received: from ianb.local (pD9EB1C82.dip.t-dialin.net [217.235.28.130])
	by post.webmailer.de (8.9.3/8.8.7) with ESMTP id WAA01435
	for <pgsql-docs@postgresql.org>; Fri, 14 Feb 2003 22:32:12 +0100 (MET)
From: Ian Barwick <barwick@gmx.net>
To: pgsql-docs@postgresql.org
Subject: FAQ patches
Date: Fri, 14 Feb 2003 22:32:07 +0100
X-Mailer: KMail [version 1.4]
MIME-Version: 1.0
Content-Type: Multipart/Mixed;
	boundary="------------Boundary-00=_JHIBPU4OEL0JRHGCSUBI"
Message-Id: <200302142232.07509.barwick@gmx.net>
X-Virus-Scanned: by AMaViS new-20020517
X-Archive-Number: 200302/17
X-Sequence-Number: 1651

--------------Boundary-00=_JHIBPU4OEL0JRHGCSUBI
Content-Type: text/plain;
  charset="us-ascii"
Content-Transfer-Encoding: quoted-printable


Attached:

1. Minor corrections for the English FAQ
   (also added a line to "Does PostgreSQL have a graphical user interface?"
    mentioning the  http://techdocs.postgresql.org/guides/GUITools ).

2. Update for the German FAQ.


Ian Barwick
barwick@gmx.net


--------------Boundary-00=_JHIBPU4OEL0JRHGCSUBI
Content-Type: text/x-diff;
  charset="us-ascii";
  name="FAQ.html.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="FAQ.html.diff"

Index: FAQ.html
===================================================================
RCS file: /projects/cvsroot/pgsql-server/doc/src/FAQ/FAQ.html,v
retrieving revision 1.167
diff -c -r1.167 FAQ.html
*** FAQ.html	2003/02/14 14:03:10	1.167
--- FAQ.html	2003/02/14 21:25:02
***************
*** 245,252 ****
      <P>The database server can run on Windows NT and Win2k using
      Cygwin, the Cygnus Unix/NT porting library. See
      <I>pgsql/doc/FAQ_MSWIN</I> in the distribution or the MS Windows FAQ
!     at <A href="http://www.PostgreSQL.org/docs/faq-mswin.html">
!     http://www.PostgreSQL.org/docs/faq-mswin.html</A>.</P>
  
      <p>A native port to MS Win NT/2000/XP is currently being worked
      on.</p>
--- 245,252 ----
      <P>The database server can run on Windows NT and Win2k using
      Cygwin, the Cygnus Unix/NT porting library. See
      <I>pgsql/doc/FAQ_MSWIN</I> in the distribution or the MS Windows FAQ
!     at <A href="http://www.ca.PostgreSQL.org/docs/faq-mswin.html">
!     http://www.ca.PostgreSQL.org/docs/faq-mswin.html</A>.</P>
  
      <p>A native port to MS Win NT/2000/XP is currently being worked
      on.</p>
***************
*** 535,541 ****
      <H4><A name="2.3">2.3</A>) Does PostgreSQL have a graphical user
      interface?</H4>
  
!     Yes, there are several graphical interfaces to PostgreSQL available.
      These include PgAccess <a href="http://www.pgaccess.org">
      http://www.pgaccess.org</a>), PgAdmin II (<a
      href="http://www.pgadmin.org">http://www.pgadmin.org</a>,
--- 535,541 ----
      <H4><A name="2.3">2.3</A>) Does PostgreSQL have a graphical user
      interface?</H4>
  
!     <P>Yes, there are several graphical interfaces to PostgreSQL available.
      These include PgAccess <a href="http://www.pgaccess.org">
      http://www.pgaccess.org</a>), PgAdmin II (<a
      href="http://www.pgadmin.org">http://www.pgadmin.org</a>,
***************
*** 545,552 ****
      http://www.thekompany.com/products/rekall/</a>, proprietary). There is 
      also PHPPgAdmin (<a href="http://phppgadmin.sourceforge.net/">
      http://phppgadmin.sourceforge.net/ </a>), a web-based interface to 
!     PostgreSQL.
  
      <H4><A name="2.4">2.4</A>) What languages are able to communicate with 
      PostgreSQL?</H4>
  
--- 545,554 ----
      http://www.thekompany.com/products/rekall/</a>, proprietary). There is 
      also PHPPgAdmin (<a href="http://phppgadmin.sourceforge.net/">
      http://phppgadmin.sourceforge.net/ </a>), a web-based interface to 
!     PostgreSQL.</P>
  
+     <P>See <a href="http://techdocs.postgresql.org/guides/GUITools">http://techdocs.postgresql.org/guides/GUITools</a> for a more detailed list.</P>
+ 
      <H4><A name="2.4">2.4</A>) What languages are able to communicate with 
      PostgreSQL?</H4>
  
***************
*** 1037,1050 ****
  VARCHAR(n)      varchar         size specifies maximum length, no padding
  CHAR(n)         bpchar          blank padded to the specified fixed length
  TEXT            text            no specific upper limit on length
- "char"          char            one character
  BYTEA           bytea           variable-length byte array (null-byte safe)
  </PRE>
  
      <P>You will see the internal name when examining system catalogs
      and in some error messages.</P>
  
!     <P>The last four types above are "varlena" types (i.e., the first
      four bytes on disk are the length, followed by the data). Thus the
      actual space used is slightly greater than the declared size.
      However, these data types are also subject to compression or being
--- 1039,1052 ----
  VARCHAR(n)      varchar         size specifies maximum length, no padding
  CHAR(n)         bpchar          blank padded to the specified fixed length
  TEXT            text            no specific upper limit on length
  BYTEA           bytea           variable-length byte array (null-byte safe)
+ "char"          char            one character
  </PRE>
  
      <P>You will see the internal name when examining system catalogs
      and in some error messages.</P>
  
!     <P>The first four types above are "varlena" types (i.e., the first
      four bytes on disk are the length, followed by the data). Thus the
      actual space used is slightly greater than the declared size.
      However, these data types are also subject to compression or being
***************
*** 1058,1065 ****
      same length. <SMALL>CHAR(n)</SMALL> pads with blanks to the specified
      length, while <SMALL>VARCHAR(n)</SMALL> only stores the characters
      supplied.  <SMALL>BYTEA</SMALL> is for storing binary data,
!     particularly values that include <SMALL>NULL</SMALL> bytes. These
!     types have similar performance characteristics.</P>
  
      <H4><A name="4.15.1">4.15.1</A>) How do I create a
      serial/auto-incrementing field?</H4>
--- 1060,1067 ----
      same length. <SMALL>CHAR(n)</SMALL> pads with blanks to the specified
      length, while <SMALL>VARCHAR(n)</SMALL> only stores the characters
      supplied.  <SMALL>BYTEA</SMALL> is for storing binary data,
!     particularly values that include <SMALL>NULL</SMALL> bytes. All the
!     types described here have similar performance characteristics.</P>
  
      <H4><A name="4.15.1">4.15.1</A>) How do I create a
      serial/auto-incrementing field?</H4>

--------------Boundary-00=_JHIBPU4OEL0JRHGCSUBI
Content-Type: text/x-diff; charset="us-ascii"; name="FAQ_german.html.diff"
Content-Disposition: attachment; filename="FAQ_german.html.diff"
Content-Transfer-Encoding: quoted-printable

Index: FAQ_german.html
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /projects/cvsroot/pgsql-server/doc/src/FAQ/FAQ_german.html,v
retrieving revision 1.6
diff -c -r1.6 FAQ_german.html
*** FAQ_german.html	2002/12/18 04:46:17	1.6
--- FAQ_german.html	2003/02/14 21:25:21
***************
*** 14,29 ****
=20=20
      <p>Deutsche =DCbersetzung von Ian Barwick (<a href=3D"mailto:barwick@=
gmx.net">barwick@gmx.net</a>).</p>
=20=20
!     <p>Letzte Aktualisierung der deutschen =DCbersetzung: So., den 15.12.=
2002, 18:00 CET</p>
=20=20
      <p>Die aktuellste Version dieses Dokuments liegt auf der PostgreSQL W=
ebsite:</p>
      <ul>
!       <li><a href=3D"http://www.PostgreSQL.org/docs/faq-english.html">htt=
p://www.PostgreSQL.org/docs/faq-english.html</a> (engl.)</li>
!       <li><a href=3D"http://www.PostgreSQL.org/docs/faq-german.html">http=
://www.PostgreSQL.org/docs/faq-german.html</a> (dt.)</li>
      </ul>
      <p>=DCbersetzungen dieses Dokuments in andere Sprachen sowie plattfor=
m-
      spezifische FAQs k=F6nnen unter
!     <a href=3D"http://www.PostgreSQL.org/users-lounge/docs/faq.html">http=
://www.PostgreSQL.org/users-lounge/docs/faq.html</a>
      eingesehen werden.</p>
=20=20
  <hr />
--- 14,29 ----
=20=20
      <p>Deutsche =DCbersetzung von Ian Barwick (<a href=3D"mailto:barwick@=
gmx.net">barwick@gmx.net</a>).</p>
=20=20
!     <p>Letzte Aktualisierung der deutschen =DCbersetzung: Fr., den 14.02.=
2003, 22:30 CET</p>
=20=20
      <p>Die aktuellste Version dieses Dokuments liegt auf der PostgreSQL W=
ebsite:</p>
      <ul>
!       <li><a href=3D"http://www.ca.PostgreSQL.org/docs/faq-english.html">=
http://www.ca.PostgreSQL.org/docs/faq-english.html</a> (engl.)</li>
!       <li><a href=3D"http://www.ca.PostgreSQL.org/docs/faq-german.html">h=
ttp://www.ca.PostgreSQL.org/docs/faq-german.html</a> (dt.)</li>
      </ul>
      <p>=DCbersetzungen dieses Dokuments in andere Sprachen sowie plattfor=
m-
      spezifische FAQs k=F6nnen unter
!     <a href=3D"http://www.ca.PostgreSQL.org/users-lounge/docs/faq.html">h=
ttp://www.ca.PostgreSQL.org/users-lounge/docs/faq.html</a>
      eingesehen werden.</p>
=20=20
  <hr />
***************
*** 213,219 ****
      (Unix/NT-Portierungsbibliotheken) auf Windows NT/2000 zum Laufen
      gebracht werden. Hierzu bitte lesen Sie die in der Distribution
      enthaltene Datei <em>pgsql/doc/FAQ_MSWIN</em> oder die MS-Windows-FAQ=
 unter
!     <a href=3D"http://www.PostgreSQL.org/docs/faq-mswin.html">http://www.=
PostgreSQL.org/docs/faq-mswin.html</a>.</p>
=20=20
      <p>Eine eigenst=E4ndige Portierung auf MS Win NT/2000/XP befindet sich
      in Vorbereitung.</p>
--- 213,219 ----
      (Unix/NT-Portierungsbibliotheken) auf Windows NT/2000 zum Laufen
      gebracht werden. Hierzu bitte lesen Sie die in der Distribution
      enthaltene Datei <em>pgsql/doc/FAQ_MSWIN</em> oder die MS-Windows-FAQ=
 unter
!     <a href=3D"http://www.ca.PostgreSQL.org/docs/faq-mswin.html">http://w=
ww.ca.PostgreSQL.org/docs/faq-mswin.html</a>.</p>
=20=20
      <p>Eine eigenst=E4ndige Portierung auf MS Win NT/2000/XP befindet sich
      in Vorbereitung.</p>
***************
*** 270,281 ****
=20=20
      <p>Eine Liste von Unternehmen, die Support f=FCr PostgreSQL auf komme=
rzieller
      Basis leisten, kann unter
!       <a href=3D"http://www.PostgreSQL.org/users-lounge/commercial-suppor=
t.html">http://www.PostgreSQL.org/users-lounge/commercial-support.html</a>
      eingesehen werden.</p>
=20=20
      <h4><a name=3D"1.7">1.7</a>) Was ist die neueste Version von PostgreS=
QL?</h4>
=20=20
!     <p>Die neueste Version von PostgreSQL ist 7.3.</p>
=20=20
      <p>Wir planen alle 4 Monate eine neue Version herauszugeben.</p>
=20=20
--- 270,281 ----
=20=20
      <p>Eine Liste von Unternehmen, die Support f=FCr PostgreSQL auf komme=
rzieller
      Basis leisten, kann unter
!       <a href=3D"http://www.ca.PostgreSQL.org/users-lounge/commercial-sup=
port.html">http://www.ca.PostgreSQL.org/users-lounge/commercial-support.htm=
l</a>
      eingesehen werden.</p>
=20=20
      <h4><a name=3D"1.7">1.7</a>) Was ist die neueste Version von PostgreS=
QL?</h4>
=20=20
!     <p>Die neueste Version von PostgreSQL ist 7.3.2 .</p>
=20=20
      <p>Wir planen alle 4 Monate eine neue Version herauszugeben.</p>
=20=20
***************
*** 665,675 ****
      erlaubter Backend-Prozesse wird verhindert, dass System-Ressourcen
      durch PostgreSQL aufgebraucht werden.</p>
=20=20
-     <p>In den PostgreSQL-Versionen vor 6.5 war die maximale Anzahl von Ba=
ckends
-     auf 64 festgelegt und eine =C4nderung setzte eine erneute Kompilierung
-     voraus, bei der die Konstante <em>MaxBackendId</em> in <em>include/st=
orage/sinvaladt.h</em>
-     entsprechend angepasst werden mu=DFte.
-=20
      <h4><a name=3D"3.9">3.9</a>) Was befindet sich im Verzeichnis <em>pgs=
ql_tmp/</em>?</h4>
=20=20
      <p>Dieses Verzeichnis enth=E4lt tempor=E4re Dateien, die durch den <e=
m>query executor</em>
--- 665,670 ----
***************
*** 861,866 ****
--- 856,865 ----
  </pre>
      <p>(Die Aggregatfunktionen MIN() und MAX() verwenden keine Indizes). =
</p>
=20=20
+     <p>Sollte es danach aussehen, also ob der Optimierer irrt=FCmlich ein=
en sequentiellen=20
+     Scan ausf=FChrt, f=FChren Sie <small>SET enable_seqscan TO 'off'</sma=
ll> aus und pr=FCfen
+     Sie, ob die Indexabfrage dadurch scheller geworden ist.</p>
+=20
      <p>Bei der Nutzung von Wildcard-Operatoren wie <small>LIKE</small> od=
er <small>~</small>, k=F6nnen
      Indizes nur unter bestimmten Umst=E4nden verwendet werden:</p>
    <ul>
***************
*** 946,975 ****
      <h4><a name=3D"4.14">4.14</a>) Was ist der Unterschied zwischen den v=
erschiedenen <small>CHAR</small>-Typen?</h4><pre>
  Typ           interner Name   Bemerkungen
  -------------------------------------------------
- "char"        char            1 Zeichen
- CHAR(n)       bpchar          mit Leerzeichen gef=FCllt bis zur angegeben=
en L=E4nge
  VARCHAR(n)    varchar         die Gr=F6=DFe legt die Maximall=E4nge fest;=
 kein
                                 Ausf=FCllen mit Leerzeichen
  TEXT          text            Die L=E4nge wird nur durch die maximale Zei=
lenl=E4nge
                                 beschr=E4nkt
  BYTEA         bytea           Bytearray mit variabler L=E4nge
  </pre>
      <p>Der <em>interne Name</em> kommt vor allem in den Systemkatalogen u=
nd in manchen
      Fehlermeldungen vor.</p>
=20=20
!     <p>Die letzten vier Typen sind "<em>varlena</em>"-Typen (d.h. die ers=
ten vier
      Bytes geben die L=E4nge an, gefolgt von den Daten). Daher ist der tat=
s=E4chlich
      belegte Platz immer etwas mehr als die deklarierte Feldgr=F6=DFe. All=
erdings
      wird unter Umst=E4nden auf diese Datentypen Datenkompression durch da=
s <small>TOAST</small>-
      Verfahren angewendet, womit der tats=E4chlich belegte Platz auch geri=
nger
      als erwartet ausfallen kann.</p>
=20=20
!     <p><small>CHAR(n)</small> ist geeignet f=FCr die Speicherung von Zeic=
henketten =E4hnlicher L=E4nge.
!     VARCHAR(n) ist geeignet f=FCr Zeichenketten abweichender L=E4ngen, se=
tzt jedoch
!     eine maximale L=E4nge. <small>TEXT</small> setzt keine L=E4ngengrenze=
, allerdings gibt es
!     eine systembedingte Obergrenze von 1 GB. <small>BYTEA</small> ist f=
=FCr bin=E4re Daten,
!     besonders f=FCr Werte, die <small>NULL</small>-Bytes haben. Die erw=
=E4hnten Typen weisen
!     =E4hnliche Performanzeigenschaften auf.</p>
=20=20
      <h4><a name=3D"4.15.1">4.15.1</a>) Wie erzeuge ich ein serielles Feld=
 mit automatischer Erh=F6hung des
      Werts?</h4>
--- 945,980 ----
      <h4><a name=3D"4.14">4.14</a>) Was ist der Unterschied zwischen den v=
erschiedenen <small>CHAR</small>-Typen?</h4><pre>
  Typ           interner Name   Bemerkungen
  -------------------------------------------------
  VARCHAR(n)    varchar         die Gr=F6=DFe legt die Maximall=E4nge fest;=
 kein
                                 Ausf=FCllen mit Leerzeichen
+ CHAR(n)       bpchar          mit Leerzeichen gef=FCllt bis zur angegeben=
en L=E4nge
  TEXT          text            Die L=E4nge wird nur durch die maximale Zei=
lenl=E4nge
                                 beschr=E4nkt
  BYTEA         bytea           Bytearray mit variabler L=E4nge
+ "char"        char            1 Zeichen
  </pre>
      <p>Der <em>interne Name</em> kommt vor allem in den Systemkatalogen u=
nd in manchen
      Fehlermeldungen vor.</p>
=20=20
!     <p>Die ersten vier Typen sind "<em>varlena</em>"-Typen (d.h. die erst=
en vier
      Bytes geben die L=E4nge an, gefolgt von den Daten). Daher ist der tat=
s=E4chlich
      belegte Platz immer etwas mehr als die deklarierte Feldgr=F6=DFe. All=
erdings
      wird unter Umst=E4nden auf diese Datentypen Datenkompression durch da=
s <small>TOAST</small>-
      Verfahren angewendet, womit der tats=E4chlich belegte Platz auch geri=
nger
      als erwartet ausfallen kann.</p>
+=20
+     <p>F=FCr die Speicherung von Zeichenketten variabler L=E4nge empfiehl=
t sich <small>VARCHAR(n)</small>.=20
+     Die maximale L=E4nge eines <small>VARCHAR(n)</small>-Felds wird bei d=
er Tabellendefinition
+     festgelegt. <small>TEXT</small> setzt keine L=E4ngengrenze, allerding=
s gibt es
+     eine systembedingte Obergrenze von 1 GB.=20
+=20
+     <p><small>CHAR(n)</small> ist geeignet f=FCr die Speicherung von Zeic=
henketten, die alle=20
+     die gleiche L=E4nge haben. Bitte beachten Sie, dass <small>CHAR(n)</s=
mall> automatisch Zeichenketten
+     bis zur definierten Feldl=E4nge mit Leerzeichen ausf=FCllt, w=E4hrend=
 bei <small>VARCHAR(n)</small> nur
+     die tats=E4chlich eingegebene Zeichenkette gespeichert wird.</p>
=20=20
!     <p><small>BYTEA</small> ist f=FCr bin=E4re Daten, besonders f=FCr Wer=
te, die <small>NULL</small>-Bytes haben. </p>
!     <p>Die hier erw=E4hnten Typen weisen =E4hnliche Performanzeigenschaft=
en auf.</p>
=20=20
      <h4><a name=3D"4.15.1">4.15.1</a>) Wie erzeuge ich ein serielles Feld=
 mit automatischer Erh=F6hung des
      Werts?</h4>
***************
*** 1043,1049 ****
      L=FCcken in der Sequenznummerierung verursacht.</p>
=20=20
=20=20
!     <h4><a name=3D"4.17">4.16</a>) Was ist ein <small>OID</small>? Was is=
t ein <small>TID</small>?</h4>
=20=20
      <p>OIDs sind PostgreSQLs Antwort auf eindeutige Zeilen-IDs. Jede Zeil=
e,
      die in PostgreSQL erzeugt wird, bekommt eine eindeutige OID. Alle
--- 1048,1054 ----
      L=FCcken in der Sequenznummerierung verursacht.</p>
=20=20
=20=20
!     <h4><a name=3D"4.16">4.16</a>) Was ist ein <small>OID</small>? Was is=
t ein <small>TID</small>?</h4>
=20=20
      <p>OIDs sind PostgreSQLs Antwort auf eindeutige Zeilen-IDs. Jede Zeil=
e,
      die in PostgreSQL erzeugt wird, bekommt eine eindeutige OID. Alle
***************
*** 1156,1162 ****
  </pre>
      <p> Damit diese Abfrage effizient durchgef=FChrt wird, sollte f=FCr '=
<em>spalte2</em>'
      ein Index angelegt worden sein. Die Einschr=E4nkung von Abfragen mit =
<small>IN</small>
!     soll in einer k=FCnftigen PotsgreSQL-Version behoben werden.</p>
=20=20
      <h4><a name=3D"4.23">4.23</a>) Wie f=FChre ich einen <small>OUTER JOI=
N</small> durch?</h4>
=20=20
--- 1161,1167 ----
  </pre>
      <p> Damit diese Abfrage effizient durchgef=FChrt wird, sollte f=FCr '=
<em>spalte2</em>'
      ein Index angelegt worden sein. Die Einschr=E4nkung von Abfragen mit =
<small>IN</small>
!     wird in der n=E4chsten PostgreSQL-Version (7.4) behoben werden.</p>
=20=20
      <h4><a name=3D"4.23">4.23</a>) Wie f=FChre ich einen <small>OUTER JOI=
N</small> durch?</h4>
=20=20

--------------Boundary-00=_JHIBPU4OEL0JRHGCSUBI--