Add capitalization mention.

This commit is contained in:
Bruce Momjian 2006-11-21 15:38:09 +00:00
parent 150328cd61
commit cc6c10a7a0
2 changed files with 22 additions and 19 deletions

20
doc/FAQ
View File

@ -1,7 +1,7 @@
Frequently Asked Questions (FAQ) for PostgreSQL Frequently Asked Questions (FAQ) for PostgreSQL
Last updated: Sat Oct 14 19:08:19 EDT 2006 Last updated: Tue Nov 21 10:37:54 EST 2006
Current maintainer: Bruce Momjian (bruce@momjian.us) Current maintainer: Bruce Momjian (bruce@momjian.us)
@ -79,6 +79,7 @@
when accessing temporary tables in PL/PgSQL functions? when accessing temporary tables in PL/PgSQL functions?
4.20) What replication solutions are available? 4.20) What replication solutions are available?
4.21) Why are my table and column names not recognized in my query? 4.21) Why are my table and column names not recognized in my query?
Why is capitalization not preserved?
_________________________________________________________________ _________________________________________________________________
General Questions General Questions
@ -830,15 +831,16 @@
There are also commercial and hardware-based replication solutions There are also commercial and hardware-based replication solutions
available supporting a variety of replication models. available supporting a variety of replication models.
4.21) Why are my table and column names not recognized in my query? 4.21) Why are my table and column names not recognized in my query? Why is
capitalization not preserved?
The most common cause is the use of double-quotes around table or The most common cause of recognized names is the use of double-quotes
column names during table creation. When double-quotes are used, table around table or column names during table creation. When double-quotes
and column names (called identifiers) are stored case-sensitive, are used, table and column names (called identifiers) are stored
meaning you must use double-quotes when referencing the names in a case-sensitive, meaning you must use double-quotes when referencing
query. Some interfaces, like pgAdmin, automatically double-quote the names in a query. Some interfaces, like pgAdmin, automatically
identifiers during table creation. So, for identifiers to be double-quote identifiers during table creation. So, for identifiers to
recognized, you must either: be recognized, you must either:
* Avoid double-quoting identifiers when creating tables * Avoid double-quoting identifiers when creating tables
* Use only lowercase characters in identifiers * Use only lowercase characters in identifiers
* Double-quote identifiers when referencing them in queries * Double-quote identifiers when referencing them in queries

View File

@ -10,7 +10,7 @@
alink="#0000ff"> alink="#0000ff">
<H1>Frequently Asked Questions (FAQ) for PostgreSQL</H1> <H1>Frequently Asked Questions (FAQ) for PostgreSQL</H1>
<P>Last updated: Sat Oct 14 19:08:19 EDT 2006</P> <P>Last updated: Tue Nov 21 10:37:54 EST 2006</P>
<P>Current maintainer: Bruce Momjian (<A href= <P>Current maintainer: Bruce Momjian (<A href=
"mailto:bruce@momjian.us">bruce@momjian.us</A>) "mailto:bruce@momjian.us">bruce@momjian.us</A>)
@ -117,7 +117,7 @@
functions?<BR> functions?<BR>
<A href="#item4.20">4.20</A>) What replication solutions are available?<BR> <A href="#item4.20">4.20</A>) What replication solutions are available?<BR>
<A href="#item4.21">4.21</A>) Why are my table and column names not <A href="#item4.21">4.21</A>) Why are my table and column names not
recognized in my query?<BR> recognized in my query? Why is capitalization not preserved?<BR>
<HR> <HR>
@ -1085,16 +1085,17 @@ length</TD></TR>
available supporting a variety of replication models.</P> available supporting a variety of replication models.</P>
<H3 id="item4.21">4.21) Why are my table and column names not <H3 id="item4.21">4.21) Why are my table and column names not
recognized in my query?</H3> recognized in my query? Why is capitalization not preserved?</H3>
<P>The most common cause is the use of double-quotes around table or <P>The most common cause of recognized names is the use of
column names during table creation. When double-quotes are used, double-quotes around table or column names during table creation.
table and column names (called identifiers) are stored <a When double-quotes are used, table and column names (called
href="http://www.postgresql.org/docs/8.0/static/sql-syntax.html#SQL-SYNTAX-IDENTIFIERS"> identifiers) are stored <a
href="http://www.postgresql.org/docs/8.1/static/sql-syntax.html#SQL-SYNTAX-IDENTIFIERS">
case-sensitive</a>, meaning you must use double-quotes when case-sensitive</a>, meaning you must use double-quotes when
referencing the names in a query. Some interfaces, like pgAdmin, referencing the names in a query. Some interfaces, like pgAdmin,
automatically double-quote identifiers during table creation. So, automatically double-quote identifiers during table creation.
for identifiers to be recognized, you must either: So, for identifiers to be recognized, you must either:
<UL> <UL>
<LI>Avoid double-quoting identifiers when creating tables</LI> <LI>Avoid double-quoting identifiers when creating tables</LI>
<LI>Use only lowercase characters in identifiers</LI> <LI>Use only lowercase characters in identifiers</LI>