public inbox for [email protected]
help / color / mirror / Atom feedFAQ patches
2+ messages / 2 participants
[nested] [flat]
* FAQ patches
@ 2003-02-14 21:32 Ian Barwick <[email protected]>
0 siblings, 1 reply; 2+ messages in thread
From: Ian Barwick @ 2003-02-14 21:32 UTC (permalink / raw)
To: pgsql-docs
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
[email protected]
Attachments:
[text/x-diff] FAQ.html.diff (5.2K, 2-FAQ.html.diff)
download | inline 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>
[text/x-diff] FAQ_german.html.diff (10.8K, 3-FAQ_german.html.diff)
download | inline diff:
Index: FAQ_german.html
===================================================================
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 ****
<p>Deutsche �bersetzung von Ian Barwick (<a href="mailto:[email protected]">[email protected]</a>).</p>
! <p>Letzte Aktualisierung der deutschen �bersetzung: So., den 15.12.2002, 18:00 CET</p>
<p>Die aktuellste Version dieses Dokuments liegt auf der PostgreSQL Website:</p>
<ul>
! <li><a href="http://www.PostgreSQL.org/docs/faq-english.html">http://www.PostgreSQL.org/docs/faq-english.html</a> (engl.)</li>
! <li><a href="http://www.PostgreSQL.org/docs/faq-german.html">http://www.PostgreSQL.org/docs/faq-german.html</a> (dt.)</li>
</ul>
<p>�bersetzungen dieses Dokuments in andere Sprachen sowie plattform-
spezifische FAQs k�nnen unter
! <a href="http://www.PostgreSQL.org/users-lounge/docs/faq.html">http://www.PostgreSQL.org/users-lounge/docs/faq.html</a>
eingesehen werden.</p>
<hr />
--- 14,29 ----
<p>Deutsche �bersetzung von Ian Barwick (<a href="mailto:[email protected]">[email protected]</a>).</p>
! <p>Letzte Aktualisierung der deutschen �bersetzung: Fr., den 14.02.2003, 22:30 CET</p>
<p>Die aktuellste Version dieses Dokuments liegt auf der PostgreSQL Website:</p>
<ul>
! <li><a href="http://www.ca.PostgreSQL.org/docs/faq-english.html">http://www.ca.PostgreSQL.org/docs/faq-english.html</a> (engl.)</li>
! <li><a href="http://www.ca.PostgreSQL.org/docs/faq-german.html">http://www.ca.PostgreSQL.org/docs/faq-german.html</a> (dt.)</li>
</ul>
<p>�bersetzungen dieses Dokuments in andere Sprachen sowie plattform-
spezifische FAQs k�nnen unter
! <a href="http://www.ca.PostgreSQL.org/users-lounge/docs/faq.html">http://www.ca.PostgreSQL.org/users-lounge/docs/faq.html</a>
eingesehen werden.</p>
<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="http://www.PostgreSQL.org/docs/faq-mswin.html">http://www.PostgreSQL.org/docs/faq-mswin.html</a>.</p>
<p>Eine eigenst�ndige 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="http://www.ca.PostgreSQL.org/docs/faq-mswin.html">http://www.ca.PostgreSQL.org/docs/faq-mswin.html</a>.</p>
<p>Eine eigenst�ndige Portierung auf MS Win NT/2000/XP befindet sich
in Vorbereitung.</p>
***************
*** 270,281 ****
<p>Eine Liste von Unternehmen, die Support f�r PostgreSQL auf kommerzieller
Basis leisten, kann unter
! <a href="http://www.PostgreSQL.org/users-lounge/commercial-support.html">http://www.PostgreSQL.org/users-lounge/commercial-support.html</a>
eingesehen werden.</p>
<h4><a name="1.7">1.7</a>) Was ist die neueste Version von PostgreSQL?</h4>
! <p>Die neueste Version von PostgreSQL ist 7.3.</p>
<p>Wir planen alle 4 Monate eine neue Version herauszugeben.</p>
--- 270,281 ----
<p>Eine Liste von Unternehmen, die Support f�r PostgreSQL auf kommerzieller
Basis leisten, kann unter
! <a href="http://www.ca.PostgreSQL.org/users-lounge/commercial-support.html">http://www.ca.PostgreSQL.org/users-lounge/commercial-support.html</a>
eingesehen werden.</p>
<h4><a name="1.7">1.7</a>) Was ist die neueste Version von PostgreSQL?</h4>
! <p>Die neueste Version von PostgreSQL ist 7.3.2 .</p>
<p>Wir planen alle 4 Monate eine neue Version herauszugeben.</p>
***************
*** 665,675 ****
erlaubter Backend-Prozesse wird verhindert, dass System-Ressourcen
durch PostgreSQL aufgebraucht werden.</p>
- <p>In den PostgreSQL-Versionen vor 6.5 war die maximale Anzahl von Backends
- auf 64 festgelegt und eine �nderung setzte eine erneute Kompilierung
- voraus, bei der die Konstante <em>MaxBackendId</em> in <em>include/storage/sinvaladt.h</em>
- entsprechend angepasst werden mu�te.
-
<h4><a name="3.9">3.9</a>) Was befindet sich im Verzeichnis <em>pgsql_tmp/</em>?</h4>
<p>Dieses Verzeichnis enth�lt tempor�re Dateien, die durch den <em>query executor</em>
--- 665,670 ----
***************
*** 861,866 ****
--- 856,865 ----
</pre>
<p>(Die Aggregatfunktionen MIN() und MAX() verwenden keine Indizes). </p>
+ <p>Sollte es danach aussehen, also ob der Optimierer irrt�mlich einen sequentiellen
+ Scan ausf�hrt, f�hren Sie <small>SET enable_seqscan TO 'off'</small> aus und pr�fen
+ Sie, ob die Indexabfrage dadurch scheller geworden ist.</p>
+
<p>Bei der Nutzung von Wildcard-Operatoren wie <small>LIKE</small> oder <small>~</small>, k�nnen
Indizes nur unter bestimmten Umst�nden verwendet werden:</p>
<ul>
***************
*** 946,975 ****
<h4><a name="4.14">4.14</a>) Was ist der Unterschied zwischen den verschiedenen <small>CHAR</small>-Typen?</h4><pre>
Typ interner Name Bemerkungen
-------------------------------------------------
- "char" char 1 Zeichen
- CHAR(n) bpchar mit Leerzeichen gef�llt bis zur angegebenen L�nge
VARCHAR(n) varchar die Gr��e legt die Maximall�nge fest; kein
Ausf�llen mit Leerzeichen
TEXT text Die L�nge wird nur durch die maximale Zeilenl�nge
beschr�nkt
BYTEA bytea Bytearray mit variabler L�nge
</pre>
<p>Der <em>interne Name</em> kommt vor allem in den Systemkatalogen und in manchen
Fehlermeldungen vor.</p>
! <p>Die letzten vier Typen sind "<em>varlena</em>"-Typen (d.h. die ersten vier
Bytes geben die L�nge an, gefolgt von den Daten). Daher ist der tats�chlich
belegte Platz immer etwas mehr als die deklarierte Feldgr��e. Allerdings
wird unter Umst�nden auf diese Datentypen Datenkompression durch das <small>TOAST</small>-
Verfahren angewendet, womit der tats�chlich belegte Platz auch geringer
als erwartet ausfallen kann.</p>
! <p><small>CHAR(n)</small> ist geeignet f�r die Speicherung von Zeichenketten �hnlicher L�nge.
! VARCHAR(n) ist geeignet f�r Zeichenketten abweichender L�ngen, setzt jedoch
! eine maximale L�nge. <small>TEXT</small> setzt keine L�ngengrenze, allerdings gibt es
! eine systembedingte Obergrenze von 1 GB. <small>BYTEA</small> ist f�r bin�re Daten,
! besonders f�r Werte, die <small>NULL</small>-Bytes haben. Die erw�hnten Typen weisen
! �hnliche Performanzeigenschaften auf.</p>
<h4><a name="4.15.1">4.15.1</a>) Wie erzeuge ich ein serielles Feld mit automatischer Erh�hung des
Werts?</h4>
--- 945,980 ----
<h4><a name="4.14">4.14</a>) Was ist der Unterschied zwischen den verschiedenen <small>CHAR</small>-Typen?</h4><pre>
Typ interner Name Bemerkungen
-------------------------------------------------
VARCHAR(n) varchar die Gr��e legt die Maximall�nge fest; kein
Ausf�llen mit Leerzeichen
+ CHAR(n) bpchar mit Leerzeichen gef�llt bis zur angegebenen L�nge
TEXT text Die L�nge wird nur durch die maximale Zeilenl�nge
beschr�nkt
BYTEA bytea Bytearray mit variabler L�nge
+ "char" char 1 Zeichen
</pre>
<p>Der <em>interne Name</em> kommt vor allem in den Systemkatalogen und in manchen
Fehlermeldungen vor.</p>
! <p>Die ersten vier Typen sind "<em>varlena</em>"-Typen (d.h. die ersten vier
Bytes geben die L�nge an, gefolgt von den Daten). Daher ist der tats�chlich
belegte Platz immer etwas mehr als die deklarierte Feldgr��e. Allerdings
wird unter Umst�nden auf diese Datentypen Datenkompression durch das <small>TOAST</small>-
Verfahren angewendet, womit der tats�chlich belegte Platz auch geringer
als erwartet ausfallen kann.</p>
+
+ <p>F�r die Speicherung von Zeichenketten variabler L�nge empfiehlt sich <small>VARCHAR(n)</small>.
+ Die maximale L�nge eines <small>VARCHAR(n)</small>-Felds wird bei der Tabellendefinition
+ festgelegt. <small>TEXT</small> setzt keine L�ngengrenze, allerdings gibt es
+ eine systembedingte Obergrenze von 1 GB.
+
+ <p><small>CHAR(n)</small> ist geeignet f�r die Speicherung von Zeichenketten, die alle
+ die gleiche L�nge haben. Bitte beachten Sie, dass <small>CHAR(n)</small> automatisch Zeichenketten
+ bis zur definierten Feldl�nge mit Leerzeichen ausf�llt, w�hrend bei <small>VARCHAR(n)</small> nur
+ die tats�chlich eingegebene Zeichenkette gespeichert wird.</p>
! <p><small>BYTEA</small> ist f�r bin�re Daten, besonders f�r Werte, die <small>NULL</small>-Bytes haben. </p>
! <p>Die hier erw�hnten Typen weisen �hnliche Performanzeigenschaften auf.</p>
<h4><a name="4.15.1">4.15.1</a>) Wie erzeuge ich ein serielles Feld mit automatischer Erh�hung des
Werts?</h4>
***************
*** 1043,1049 ****
L�cken in der Sequenznummerierung verursacht.</p>
! <h4><a name="4.17">4.16</a>) Was ist ein <small>OID</small>? Was ist ein <small>TID</small>?</h4>
<p>OIDs sind PostgreSQLs Antwort auf eindeutige Zeilen-IDs. Jede Zeile,
die in PostgreSQL erzeugt wird, bekommt eine eindeutige OID. Alle
--- 1048,1054 ----
L�cken in der Sequenznummerierung verursacht.</p>
! <h4><a name="4.16">4.16</a>) Was ist ein <small>OID</small>? Was ist ein <small>TID</small>?</h4>
<p>OIDs sind PostgreSQLs Antwort auf eindeutige Zeilen-IDs. Jede Zeile,
die in PostgreSQL erzeugt wird, bekommt eine eindeutige OID. Alle
***************
*** 1156,1162 ****
</pre>
<p> Damit diese Abfrage effizient durchgef�hrt wird, sollte f�r '<em>spalte2</em>'
ein Index angelegt worden sein. Die Einschr�nkung von Abfragen mit <small>IN</small>
! soll in einer k�nftigen PotsgreSQL-Version behoben werden.</p>
<h4><a name="4.23">4.23</a>) Wie f�hre ich einen <small>OUTER JOIN</small> durch?</h4>
--- 1161,1167 ----
</pre>
<p> Damit diese Abfrage effizient durchgef�hrt wird, sollte f�r '<em>spalte2</em>'
ein Index angelegt worden sein. Die Einschr�nkung von Abfragen mit <small>IN</small>
! wird in der n�chsten PostgreSQL-Version (7.4) behoben werden.</p>
<h4><a name="4.23">4.23</a>) Wie f�hre ich einen <small>OUTER JOIN</small> durch?</h4>
^ permalink raw reply [nested|flat] 2+ messages in thread
* Re: FAQ patches
@ 2003-02-18 05:08 Bruce Momjian <[email protected]>
parent: Ian Barwick <[email protected]>
0 siblings, 0 replies; 2+ messages in thread
From: Bruce Momjian @ 2003-02-18 05:08 UTC (permalink / raw)
To: Ian Barwick <[email protected]>; +Cc: pgsql-docs
Patches applied. Thanks.
---------------------------------------------------------------------------
Ian Barwick wrote:
>
> 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
> [email protected]
>
[ Attachment, skipping... ]
[ Attachment, skipping... ]
>
> ---------------------------(end of broadcast)---------------------------
> TIP 4: Don't 'kill -9' the postmaster
--
Bruce Momjian | http://candle.pha.pa.us
[email protected] | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2003-02-18 05:08 UTC | newest]
Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2003-02-14 21:32 FAQ patches Ian Barwick <[email protected]>
2003-02-18 05:08 ` Bruce Momjian <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox