release.sgml
上传用户:blenddy
上传日期:2007-01-07
资源大小:6495k
文件大小:95k
源码类别:

数据库系统

开发平台:

Unix_Linux

  1.  <chapter id="release">
  2.   <title>Release Notes</title>
  3. <sect1>
  4. <title>Release 6.5.2</title>
  5. <!--
  6. <docinfo>
  7. <authorgroup>
  8. <author>
  9. <firstname>Bruce</firstname>
  10. <surname>Momjian</surname>
  11. </author>
  12. </authorgroup>
  13. <date>1999-09-15</date>
  14. </docinfo>
  15. -->
  16. <para>
  17. This is basically a cleanup release for 6.5.1.  We have fixed a variety of
  18. problems reported by 6.5.1 users.
  19. </para>
  20. <sect2>
  21. <title>Migration to v6.5.2</title>
  22. <para>
  23. A dump/restore is <emphasis>not</emphasis> required for those running
  24. 6.5.*.
  25. </para>
  26. </sect2>
  27. <sect2>
  28. <title>Detailed Change List</title>
  29. <para>
  30. <programlisting>
  31. subselect+CASE fixes(Tom)
  32. Add SHLIB_LINK setting for solaris_i386 and solaris_sparc ports(Daren Sefcik)
  33. Fixes for CASE in WHERE join clauses(Tom)
  34. Fix BTScan abort(Tom)
  35. Repair the check for redundant UNIQUE and PRIMARY KEY indices(Thomas)
  36. Improve it so that it checks for multi-column constraints(Thomas)
  37. Fix for Win32 making problem with MB enabled(Hiroki Kataoka)
  38. Allow BSD yacc and bison to compile pl code(Bruce)
  39. Fix SET NAMES working
  40. int8 fixes(Thomas)
  41. Fix vacuum's memory consumption(Hiroshi,Tatsuo)
  42. Reduce the total memory consumption of vacuum(Tom)
  43. Fix for timestamp(datetime)
  44. Rule deparsing bugfixes(Tom)
  45. Fix quoting problems in mkMakefile.tcldefs.sh.in and mkMakefile.tkdefs.sh.in(Tom)
  46. This is to re-use space on index pages freed by vacuum(Vadim)
  47. document -x for pg_dump(Bruce)
  48. Fix for unary operators in rule deparser(Tom)
  49. Comment out FileUnlink of excess segments during mdtruncate()(Tom)
  50. Irix linking fix from Yu Cao <yucao@falcon.kla-tencor.com>
  51. Repair logic error in LIKE: should not return LIKE_ABORT
  52.    when reach end of pattern before end of text(Tom)
  53. Repair incorrect cleanup of heap memory allocation during transaction abort(Tom)
  54. Updated version of pgaccess 0.98
  55. </programlisting>
  56. </para>
  57. </sect2>
  58. </sect1>
  59. <sect1>
  60. <title>Release 6.5.1</title>
  61. <!--
  62. <docinfo>
  63. <authorgroup>
  64. <author>
  65. <firstname>Bruce</firstname>
  66. <surname>Momjian</surname>
  67. </author>
  68. </authorgroup>
  69. <date>1999-07-15</date>
  70. </docinfo>
  71. -->
  72. <para>
  73. This is basically a cleanup release for 6.5.  We have fixed a variety of
  74. problems reported by 6.5 users.
  75. </para>
  76. <sect2>
  77. <title>Migration to v6.5.1</title>
  78. <para>
  79. A dump/restore is <emphasis>not</emphasis> required for those running
  80. 6.5.
  81. </para>
  82. </sect2>
  83. <sect2>
  84. <title>Detailed Change List</title>
  85. <para>
  86. <programlisting>
  87. Add NT README file
  88. Portability fixes for linux_ppc, Irix, linux_alpha, OpenBSD, alpha
  89. Remove QUERY_LIMIT, use SELECT...LIMIT
  90. Fix for EXPLAIN on inheritance(Tom)
  91. Patch to allow vacuum on multi-segment tables(Hiroshi)
  92. R=Tree optimizer selectivity fix(Tom)
  93. ACL file descriptor leak fix(Atsushi Ogawa)
  94. New expresssion subtree code(Tom)
  95. Avoid disk writes for read-only transactions(Vadim)
  96. Fix for removal of temp tables if last transaction was aborted(Bruce)
  97. Fix to prevent too large tuple from being created(Bruce)
  98. plpgsql fixes
  99. Allow port numbers 32k - 64k(Bruce)
  100. Add ^ precidence(Bruce)
  101. Rename sort files called pg_temp to pg_sorttemp(Bruce)
  102. Fix for microseconds in time values(Tom)
  103. Tutorial source cleanup
  104. New linux_m68k port
  105. Fix for sorting of NULL's in some cases(Tom)
  106. Shared library dependencies fixed (Tom)
  107. Fixed glitches affecting GROUP BY in subselects(Tom)
  108. Fix some compiler warnings (Tomoaki Nishiyama)
  109. Add Win1250 (Czech) support (Pavel Behal)
  110. </programlisting>
  111. </para>
  112. </sect2>
  113. </sect1>
  114. <sect1>
  115. <title>Release 6.5</title>
  116. <!--
  117. <docinfo>
  118. <authorgroup>
  119. <author>
  120. <firstname>Bruce</firstname>
  121. <surname>Momjian</surname>
  122. </author>
  123. </authorgroup>
  124. <date>1998-06-09</date>
  125. </docinfo>
  126. -->
  127.    <para>
  128.     This release marks a major step in the development team's mastery of the source
  129.     code we inherited from Berkeley.  You will see we are now easily adding
  130.     major features, thanks to the increasing size and experience of our
  131.     world-wide development team.
  132.    </para>
  133.    <para>
  134.     Here is a brief summary of the more notable changes:
  135.     <variablelist>
  136.      <varlistentry>
  137.       <term>
  138.        Multi-version concurrency control(MVCC)
  139.       </term>
  140.       <listitem>
  141.        <para>
  142. This removes our old
  143. table-level locking, and replaces it with a locking system that is
  144. superior to most commercial database systems.  In a traditional system,
  145. each row that is modified is locked until committed, preventing reads by
  146. other users.  MVCC uses the natural multi-version nature of PostgreSQL
  147. to allow readers to continue reading consistent data during writer
  148. activity.  Writers continue to use the compact pg_log transaction
  149. system.  This is all performed without having to allocate a lock for
  150. every row like traditional database systems.  So, basically, we no
  151. longer are restricted by simple table-level locking;
  152. we have something better than row-level locking.
  153.        </para>
  154.       </listitem>
  155.      </varlistentry>
  156.      <varlistentry>
  157.       <term>
  158.        Hot backups from <application>pg_dump</application>
  159.       </term>
  160.       <listitem>
  161.        <para>
  162. <application>pg_dump</application> takes advantage of the new
  163. MVCC features to give a consistant database dump/backup while
  164. the database stays online and available for queries.
  165.        </para>
  166.       </listitem>
  167.      </varlistentry>
  168.      <varlistentry>
  169.       <term>
  170.        Numeric data type
  171.       </term>
  172.       <listitem>
  173.        <para>
  174. We now have a true numeric data type, with
  175. user-specified precision.
  176.        </para>
  177.       </listitem>
  178.      </varlistentry>
  179.      <varlistentry>
  180.       <term>
  181.        Temporary tables
  182.       </term>
  183.       <listitem>
  184.        <para>
  185. Temporary tables are guaranteed to have unique names
  186. within a database session, and are destroyed on session exit.
  187.        </para>
  188.       </listitem>
  189.      </varlistentry>
  190.      <varlistentry>
  191.       <term>
  192.        New SQL features
  193.       </term>
  194.       <listitem>
  195.        <para>
  196. We now have CASE, INTERSECT, and EXCEPT statement
  197. support.  We have new LIMIT/OFFSET, SET TRANSACTION ISOLATION LEVEL,
  198. SELECT ... FOR UPDATE, and an improved LOCK TABLE command.
  199.        </para>
  200.       </listitem>
  201.      </varlistentry>
  202.      <varlistentry>
  203.       <term>
  204.        Speedups
  205.       </term>
  206.       <listitem>
  207.        <para>
  208. We continue to speed up PostgreSQL, thanks to the variety of
  209. talents within our team.  We have sped up memory allocation,
  210. optimization, table joins, and row transfer routines.
  211.        </para>
  212.       </listitem>
  213.      </varlistentry>
  214.      <varlistentry>
  215.       <term>
  216.        Ports
  217.       </term>
  218.       <listitem>
  219.        <para>
  220. We continue to expand our port list, this time including
  221. WinNT/ix86 and NetBSD/arm32.
  222.        </para>
  223.       </listitem>
  224.      </varlistentry>
  225.      <varlistentry>
  226.       <term>
  227.        Interfaces
  228.       </term>
  229.       <listitem>
  230.        <para>
  231. Most interfaces have new versions, and existing functionality
  232. has been improved.
  233.        </para>
  234.       </listitem>
  235.      </varlistentry>
  236.      <varlistentry>
  237.       <term>
  238.        Documentation
  239.       </term>
  240.       <listitem>
  241.        <para>
  242. New and updated material is present throughout the
  243. documentation. New <acronym>FAQ</acronym>s have been
  244. contributed for SGI and AIX platforms.
  245. The <citetitle>Tutorial</citetitle> has introductory information
  246. on <acronym>SQL</acronym> from Stefan Simkovics.
  247. For the <citetitle>User's Guide</citetitle>, there are
  248. reference pages covering the postmaster and more utility
  249. programs, and a new appendix
  250. contains details on date/time behavior.
  251. The <citetitle>Administrator's Guide</citetitle> has a new
  252. chapter on troubleshooting from Tom Lane.
  253. And the <citetitle>Programmer's Guide</citetitle> has a
  254. description of query processing, also from Stefan, and details 
  255. on obtaining the <productname>Postgres</productname> source
  256. tree via anonymous <productname>CVS</productname> and
  257. <productname>CVSup</productname>. 
  258.        </para>
  259.       </listitem>
  260.      </varlistentry>
  261.     </variablelist>
  262.    </para>
  263.    <sect2>
  264.     <title>Migration to v6.5</title>
  265.     <para>
  266.      A dump/restore using <application>pg_dump</application>
  267.      is required for those wishing to migrate data from any
  268.      previous release of <productname>Postgres</productname>.
  269.      <application>pg_upgrade</application> can <emphasis>not</emphasis>
  270.      be used to upgrade to this release because the on-disk structure
  271.      of the tables has changed compared to previous releases.
  272.     </para>
  273.     <para>
  274.      The new Multi-Version Concurrency Control (MVCC) features can
  275.      give somewhat different behaviors in multi-user
  276.      environments. <emphasis>Read and understand the following section 
  277.       to ensure that your existing applications will give you the
  278.       behavior you need.</emphasis>
  279.     </para>
  280.     <sect3>
  281.      <title>Multi-Version Concurrency Control</title>
  282.      <para>
  283.       Because readers in 6.5 don't lock data, regardless of transaction
  284.       isolation level, data read by one transaction can be overwritten by
  285.       another. In other words, if a row is returned by
  286.       <command>SELECT</command> it doesn't mean that this row really exists
  287.       at the time it is returned (i.e. sometime after the statement or
  288.       transaction began) nor that the row is protected from being deleted or
  289.       updated by concurrent transactions before the current transaction does
  290.       a commit or rollback.
  291.      </para>
  292.      <para>
  293.       To ensure the actual existence of a row and protect it against
  294.       concurrent updates one must use <command>SELECT FOR UPDATE</command> or
  295.       an appropriate <command>LOCK TABLE</command> statement. This should be
  296.       taken into account when porting applications from previous releases of
  297.       <productname>Postgres</productname> and other environments.
  298.      </para>
  299.      <para>
  300.       Keep the above in mind if you are using
  301.       <filename>contrib/refint.*</filename> triggers for
  302.       referential integrity. Additional technics are required now. One way is
  303.       to use <command>LOCK parent_table IN SHARE ROW EXCLUSIVE MODE</command>
  304.       command if a transaction is going to update/delete a primary key and
  305.       use <command>LOCK parent_table IN SHARE MODE</command> command if a
  306.       transaction is going to update/insert a foreign key.
  307.       <note>
  308.        <para>
  309. Note that if you run a transaction in SERIALIZABLE mode then you must
  310. execute the <command>LOCK</command> commands above before execution of any
  311. DML statement
  312. (<command>SELECT/INSERT/DELETE/UPDATE/FETCH/COPY_TO</command>) in the
  313. transaction.
  314.        </para>
  315.       </note>
  316.      </para>
  317.      <para>
  318.       These inconveniences will disappear in the future
  319.       when the ability to read dirty
  320.       (uncommitted) data (regardless of isolation level) and true referential
  321.       integrity will be implemented.
  322.      </para>
  323.     </sect3>
  324.     </sect2>
  325.    <sect2>
  326.     <title>Detailed Change List</title>
  327.     <para>
  328.      <programlisting>
  329. Bug Fixes
  330. ---------
  331. Fix text<->float8 and text<->float4 conversion functions(Thomas)
  332. Fix for creating tables with mixed-case constraints(Billy)
  333. Change exp()/pow() behavior to generate error on underflow/overflow(Jan)
  334. Fix bug in pg_dump -z
  335. Memory overrun cleanups(Tatsuo)
  336. Fix for lo_import crash(Tatsuo)
  337. Adjust handling of data type names to suppress double quotes(Thomas)
  338. Use type coersion for matching columns and DEFAULT(Thomas)
  339. Fix deadlock so it only checks once after one second of sleep(Bruce)
  340. Fixes for aggregates and PL/pgsql(Hiroshi)
  341. Fix for subquery crash(Vadim)
  342. Fix for libpq function PQfnumber and case-insensitive names(Bahman Rafatjoo)
  343. Fix for large object write-in-middle, no extra block, memory consumption(Tatsuo)
  344. Fix for pg_dump -d or -D and  quote special characters in INSERT
  345. Repair serious problems with dynahash(Tom)
  346. Fix INET/CIDR portability problems
  347. Fix problem with selectivity error in ALTER TABLE ADD COLUMN(Bruce)
  348. Fix executor so mergejoin of different column types works(Tom)
  349. Fix for Alpha OR selectivity bug
  350. Fix OR index selectivity problem(Bruce)
  351. Fix so d shows proper length for char()/varchar()(Ryan)
  352. Fix tutorial code(Clark)
  353. Improve destroyuser checking(Oliver)
  354. Fix for Kerberos(Rodney McDuff)
  355. Fix for dropping database while dirty buffers(Bruce)
  356. Fix so sequence nextval() can be case-sensitive(Bruce)
  357. Fix !!= operator
  358. Drop buffers before destroying database files(Bruce)
  359. Fix case where executor evaluates functions twice(Tatsuo)
  360. Allow sequence nextval actions to be case-sensitive(Bruce)
  361. Fix optimizer indexing not working for negative numbers(Bruce)
  362. Fix for memory leak in executor with fjIsNull
  363. Fix for aggregate memory leaks(Erik Riedel)
  364. Allow username containing a dash GRANT permissions
  365. Cleanup of NULL in inet types
  366. Clean up system爐able bugs(Tom)
  367. Fix problems of PAGER and ? command(Masaaki Sakaida)
  368. Reduce default multi-segment file size limit to 1GB(Peter)
  369. Fix for dumping of CREATE OPERATOR(Tom)
  370. Fix for backward scanning of cursors(Hiroshi Inoue)
  371. Fix for COPY FROM STDIN when using i(Tom)
  372. Fix for subselect is compared inside an expression(Jan)
  373. Fix handling of error reporting while returning rows(Tom)
  374. Fix problems with reference to array types(Tom,Jan)
  375. Prevent UPDATE SET oid(Jan)
  376. Fix pg_dump so -t option can handle case-sensitive tablenames
  377. Fixes for GROUP BY in special cases(Tom, Jan)
  378. Fix for memory leak in failed queries(Tom)
  379. DEFAULT now supports mixed-case identifiers(Tom)
  380. Fix for multi-segment uses of DROP/RENAME table, indexes(Ole Gjerde)
  381. Disable use of pg_dump with both -o and -d options(Bruce)
  382. Allow pg_dump to properly dump GROUP permissions(Bruce)
  383. Fix GROUP BY in INSERT INTO table SELECT * FROM table2(Jan)
  384. Fix for computations in views(Jan)
  385. Fix for aggregates on array indexes(Tom)
  386. Fix for DEFAULT handles single quotes in value requiring too many quotes
  387. Fix security problem with non-super users importing/exporting large objects(Tom)
  388. Rollback of transaction that creates table cleaned up properly(Tom)
  389. Fix to allow long table and column names to generate proper serial names(Tom)
  390. Enhancements
  391. ------------
  392. Add "vacuumdb" utility
  393. Speed up libpq by allocating memory better(Tom)
  394. EXPLAIN all indices used(Tom)
  395. Implement CASE, COALESCE, NULLIF  expression(Thomas)
  396. New pg_dump table output format(Constantin)
  397. Add string min()/max() functions(Thomas)
  398. Extend new type coersion techniques to aggregates(Thomas)
  399. New moddatetime contrib(Terry)
  400. Update to pgaccess 0.96(Constantin)
  401. Add routines for single-byte "char" type(Thomas)
  402. Improved substr() function(Thomas)
  403. Improved multi-byte handling(Tatsuo)
  404. Multi-version concurrency control/MVCC(Vadim)
  405. New Serialized mode(Vadim)
  406. Fix for tables over 2gigs(Peter)
  407. New SET TRANSACTION ISOLATION LEVEL(Vadim)
  408. New LOCK TABLE IN ... MODE(Vadim)
  409. Update ODBC driver(Byron)
  410. New NUMERIC data type(Jan)
  411. New SELECT FOR UPDATE(Vadim)
  412. Handle "NaN" and "Infinity" for input values(Jan)
  413. Improved date/year handling(Thomas)
  414. Improved handling of backend connections(Magnus)
  415. New options ELOG_TIMESTAMPS and USE_SYSLOG options for log files(Massimo)
  416. New TCL_ARRAYS option(Massimo)
  417. New INTERSECT and EXCEPT(Stefan)
  418. New pg_index.indisprimary for primary key tracking(D'Arcy)
  419. New pg_dump option to allow dropping of tables before creation(Brook)
  420. Speedup of row output routines(Tom)
  421. New READ COMMITTED isolation level(Vadim)
  422. New TEMP tables/indexes(Bruce)
  423. Prevent sorting if result is already sorted(Jan)
  424. New memory allocation optimization(Jan)
  425. Allow psql to do pg(Bruce)
  426. Allow multiple rule actions(Jan)
  427. Added LIMIT/OFFSET functionality(Jan)
  428. Improve optimizer when joining a large number of tables(Bruce)
  429. New intro to SQL from S. Simkovics' Master's Thesis (Stefan, Thomas)
  430. New intro to backend processing from S. Simkovics' Master's Thesis (Stefan)
  431. Improved int8 support(Ryan Bradetich, Thomas, Tom)
  432. New routines to convert between int8 and text/varchar types(Thomas)
  433. New bushy plans, where meta-tables are joined(Bruce)
  434. Enable right-hand queries by default(Bruce)
  435. Allow reliable maximum number of backends to be set at configure time
  436.       (--with-maxbackends and postmaster switch (-N backends))(Tom)
  437. GEQO default now 10 tables because of optimizer speedups(Tom)
  438. Allow NULL=Var for MS-SQL portability(Michael, Bruce)
  439. Modify contrib check_primary_key() so either "automatic" or "dependent"(Anand)
  440. Allow psql d on a view show query(Ryan)
  441. Speedup for LIKE(Bruce)
  442. Ecpg fixes/features, see src/interfaces/ecpg/ChangeLog file(Michael)
  443. JDBC fixes/features, see src/interfaces/jdbc/CHANGELOG(Peter)
  444. Make % operator have precedence like /(Bruce)
  445. Add new postgres -O option to allow system table structure changes(Bruce)
  446. Update contrib/pginterface/findoidjoins script(Tom)
  447. Major speedup in vacuum of deleted rows with indexes(Vadim) 
  448. Allow non-SQL functions to run different versions based on arguments(Tom)
  449. Add -E option that shows actual queries sent by dt and friends(Masaaki Sakaida)
  450. Add version number in startup banners for psql(Masaaki Sakaida)
  451. New contrib/vacuumlo removes large objects not referenced(Peter)
  452. New initialization for table sizes so non-vacuumed tables perform better(Tom)
  453. Improve error messages when a connection is rejected(Tom)
  454. Support for arrays of char() and varchar() fields(Massimo)
  455. Overhaul of hash code to increase reliability and performance(Tom)
  456. Update to PyGreSQL 2.4(D'Arcy)
  457. Changed debug options so -d4 and -d5 produce different node displays(Jan)
  458. New pg_options: pretty_plan, pretty_parse, pretty_rewritten(Jan)
  459. Better optimization statistics for system table access(Tom)
  460. Better handling of non-default block sizes(Massimo)
  461. Improve GEQO optimizer memory consumption(Tom)
  462. UNION now suppports ORDER BY of columns not in target list(Jan)
  463. Major libpq++ improvements(Vince Vielhaber)
  464. pg_dump now uses -z(ACL's) as default(Bruce)
  465. backend cache, memory speedups(Tom)
  466. have pg_dump do everything in one snapshot transaction(Vadim)
  467. fix for large object memory leakage, fix for pg_dumping(Tom)
  468. INET type now respects netmask for comparisons
  469. Make VACUUM ANALYZE only use a readlock(Vadim)
  470. Allow VIEWs on UNIONS(Jan)
  471. pg_dump now can generate consistent snapshots on active databases(Vadim)
  472. Source Tree Changes
  473. -------------------
  474. Improve port matching(Tom)
  475. Portability fixes for SunOS
  476. Add NT/Win32 backend port and enable dynamic loading(Magnus and Daniel Horak)
  477. New port to Cobalt Qube(Mips) running Linux(Tatsuo)
  478. Port to NetBSD/m68k(Mr. Mutsuki Nakajima)
  479. Port to NetBSD/sun3(Mr. Mutsuki Nakajima)
  480. Port to NetBSD/macppc(Toshimi Aoki)
  481. Fix for tcl/tk configuration(Vince)
  482. Removed CURRENT keyword for rule queries(Jan)
  483. NT dynamic loading now works(Daniel Horak)
  484. Add ARM32 support(Andrew McMurry)
  485. Better support for HPUX 11 and Unixware
  486. Improve file handling to be more uniform, prevent file descriptor leak(Tom)
  487. New install commands for plpgsql(Jan)
  488.      </programlisting>
  489.     </para>
  490.    </sect2>
  491.   </sect1>
  492. <sect1>
  493. <title>Release 6.4.2</title>
  494. <!--
  495. <docinfo>
  496. <authorgroup>
  497. <author>
  498. <firstname>Bruce</firstname>
  499. <surname>Momjian</surname>
  500. </author>
  501. </authorgroup>
  502. <date>1999-12-20</date>
  503. </docinfo>
  504. -->
  505. <para>
  506. The 6.4.1 release was improperly packaged.  This also has one additional
  507. bug fix.
  508. </para>
  509. <sect2>
  510. <title>Migration to v6.4.2</title>
  511. <para>
  512. A dump/restore is <emphasis>not</emphasis> required for those running
  513. 6.4.*.
  514. </para>
  515. </sect2>
  516. <sect2>
  517. <title>Detailed Change List</title>
  518. <para>
  519. <programlisting>
  520. Fix for datetime constant problem on some platforms(Thomas)
  521. </programlisting>
  522. </para>
  523. </sect2>
  524. </sect1>
  525. <sect1>
  526. <title>Release 6.4.1</title>
  527. <!--
  528. <docinfo>
  529. <authorgroup>
  530. <author>
  531. <firstname>Bruce</firstname>
  532. <surname>Momjian</surname>
  533. </author>
  534. </authorgroup>
  535. <date>1999-12-18</date>
  536. </docinfo>
  537. -->
  538. <para>
  539. This is basically a cleanup release for 6.4.  We have fixed a variety of
  540. problems reported by 6.4 users.
  541. </para>
  542. <sect2>
  543. <title>Migration to v6.4.1</title>
  544. <para>
  545. A dump/restore is <emphasis>not</emphasis> required for those running
  546. 6.4.
  547. </para>
  548. </sect2>
  549. <sect2>
  550. <title>Detailed Change List</title>
  551. <para>
  552. <programlisting>
  553. Add pg_dump -N flag to force double quotes around identifiers.  This is
  554. the default(Thomas)
  555. Fix for NOT in where clause causing crash(Bruce)
  556. EXPLAIN VERBOSE coredump fix(Vadim)
  557. Fix shared-library problems on Linux
  558. Fix test for table existance to allow mixed-case and whitespace in
  559. the table name(Thomas)
  560. Fix a couple of pg_dump bugs
  561. Configure matches template/.similar entries better(Tom)
  562. Change builtin function names from SPI_* to spi_*
  563. OR WHERE clause fix(Vadim)
  564. Fixes for mixed-case table names(Billy)
  565. contrib/linux/postgres.init.csh/sh fix(Thomas)
  566. libpq memory overrun fix
  567. SunOS fixes(Tom)
  568. Change exp() behavior to generate error on underflow(Thomas)
  569. pg_dump fixes for memory leak, inheritance constraints, layout change
  570. update pgaccess to 0.93
  571. Fix prototype for 64-bit platforms
  572. Multi-byte fixes(Tatsuo)
  573. New ecpg man page
  574. Fix memory overruns(Tatsuo)
  575. Fix for lo_import() crash(Bruce)
  576. Better search for install program(Tom)
  577. Timezone fixes(Tom)
  578. HPUX fixes(Tom)
  579. Use implicit type coersion for matching DEFAULT values(Thomas)
  580. Add routines to help with single-byte (internal) character type(Thomas)
  581. Compilation of libpq for Win32 fixes(Magnus)
  582. Upgrade to PyGreSQL 2.2(D'Arcy)
  583. </programlisting>
  584. </para>
  585. </sect2>
  586. </sect1>
  587. <sect1>
  588. <title>Release 6.4</title>
  589. <!--
  590. <docinfo>
  591. <authorgroup>
  592. <author>
  593. <firstname>Bruce</firstname>
  594. <surname>Momjian</surname>
  595. </author>
  596. </authorgroup>
  597. <date>1998-10-30</date>
  598. </docinfo>
  599. -->
  600. <para>
  601. There are <emphasis>many</emphasis> new features and improvements in this release.
  602. Thanks to our developers and maintainers, nearly every aspect of the system
  603. has received some attention since the previous release.
  604. Here is a brief, incomplete summary:
  605. <itemizedlist>
  606. <listitem>
  607. <para>
  608. Views and rules are now functional thanks to extensive new code in the 
  609. rewrite rules system from Jan Wieck. He also wrote a chapter on it
  610. for the <citetitle>Programmer's Guide</citetitle>.
  611. </para>
  612. </listitem>
  613. <listitem>
  614. <para>
  615. Jan also contributed a second procedural language, PL/pgSQL, to go with the
  616. original PL/pgTCL procedural language he contributed last release.
  617. </para>
  618. </listitem>
  619. <listitem>
  620. <para>
  621. We have optional multiple-byte character set support from Tatsuo Iishi
  622. to complement our existing locale support.
  623. </para>
  624. </listitem>
  625. <listitem>
  626. <para>
  627. Client/server communications has been cleaned up, with better support for
  628. asynchronous messages and interrupts thanks to Tom Lane.
  629. </para>
  630. </listitem>
  631. <listitem>
  632. <para>
  633. The parser will now perform automatic type coersion to match arguments
  634. to available operators and functions, and to match columns and expressions
  635. with target columns. This uses a generic mechanism which supports
  636. the type extensibility features of <productname>Postgres</productname>.
  637. There is a new chapter in the <citetitle>User's Guide</citetitle>
  638. which covers this topic.
  639. </para>
  640. </listitem>
  641. <listitem>
  642. <para>
  643. Three new data types have been added. 
  644. Two types, <type>inet</type> and <type>cidr</type>, support various forms
  645. of IP network, subnet, and machine addressing. There is now an 8-byte integer
  646. type available on some platforms. See the chapter on data types
  647. in the <citetitle>User's Guide</citetitle> for details.
  648. A fourth type, <type>serial</type>, is now supported by the parser as an
  649. amalgam of the <type>int4</type> type, a sequence, and a unique index.
  650. </para>
  651. </listitem>
  652. <listitem>
  653. <para>
  654. Several more <acronym>SQL92</acronym>-compatible syntax features have been
  655. added, including <command>INSERT DEFAULT VALUES</command>
  656. </para>
  657. </listitem>
  658. <listitem>
  659. <para>
  660. The automatic configuration and installation system has received some
  661. attention, and should be more robust for more platforms than it has ever
  662. been.
  663. </para>
  664. </listitem>
  665. </itemizedlist>
  666. </para>
  667. <sect2>
  668. <title>Migration to v6.4</title>
  669. <para>
  670. A dump/restore using <application>pg_dump</application> 
  671. or <application>pg_dumpall</application>
  672. is required for those wishing to migrate data from any
  673. previous release of <productname>Postgres</productname>.
  674. </para>
  675. </sect2>
  676. <sect2>
  677. <title>Detailed Change List</title>
  678. <para>
  679. <programlisting>
  680. Bug Fixes
  681. ---------
  682. Fix for a tiny memory leak in PQsetdb/PQfinish(Bryan)
  683. Remove char2-16 data types, use char/varchar(Darren)
  684. Pqfn not handles a NOTICE message(Anders)
  685. Reduced busywaiting overhead for spinlocks with many backends (dg)
  686. Stuck spinlock detection (dg)
  687. Fix up "ISO-style" timespan decoding and encoding(Thomas)
  688. Fix problem with table drop after rollback of transaction(Vadim)
  689. Change error message and remove non-functional update message(Vadim)
  690. Fix for COPY array checking
  691. Fix for SELECT 1 UNION SELECT NULL
  692. Fix for buffer leaks in large object calls(Pascal)
  693. Change owner from oid to int4 type(Bruce)
  694. Fix a bug in the oracle compatibility functions btrim() ltrim() and rtrim()
  695. Fix for shared invalidation cache overflow(Massimo)
  696. Prevent file descriptor leaks in failed COPY's(Bruce)
  697. Fix memory leak in libpgtcl's pg_select(Constantin)
  698. Fix problems with username/passwords over 8 characters(Tom)
  699. Fix problems with handling of asynchronous NOTIFY in backend(Tom)
  700. Fix of many bad system table entries(Tom)
  701. Enhancements
  702. ------------
  703. Upgrade ecpg and ecpglib,see src/interfaces/ecpc/ChangeLog(Michael)
  704. Show the index used in an EXPLAIN(Zeugswetter)
  705. EXPLAIN  invokes  rule system and shows plan(s) for rewritten queries(Jan)
  706. Multi-byte awareness of many data types and functions, via configure(Tatsuo)
  707. New configure --with-mb option(Tatsuo)
  708. New initdb --pgencoding option(Tatsuo)
  709. New createdb -E multibyte option(Tatsuo)
  710. Select version(); now returns PostgreSQL version(Jeroen)
  711. Libpq now allows asynchronous clients(Tom)
  712. Allow cancel from client of backend query(Tom)
  713. Psql now cancels query with Control-C(Tom)
  714. Libpq users need not issue dummy queries to get NOTIFY messages(Tom)
  715. NOTIFY now sends sender's PID, so you can tell whether it was your own(Tom)
  716. PGresult struct now includes associated error message, if any(Tom)
  717. Define "tz_hour" and "tz_minute" arguments to date_part()(Thomas)
  718. Add routines to convert between varchar and bpchar(Thomas)
  719. Add routines to allow sizing of varchar and bpchar into target columns(Thomas)
  720. Add bit flags to support timezonehour and minute in data retrieval(Thomas)
  721. Allow more variations on valid floating point numbers (e.g. ".1", "1e6")(Thomas)
  722. Fixes for unary minus parsing with leading spaces(Thomas)
  723. Implement TIMEZONE_HOUR, TIMEZONE_MINUTE per SQL92 specs(Thomas)
  724. Check for and properly ignore FOREIGN KEY column constraints(Thomas)
  725. Define USER as synonym for CURRENT_USER per SQL92 specs(Thomas)
  726. Enable HAVING clause but no fixes elsewhere yet.
  727. Make "char" type a synonym for "char(1)" (actually implemented as bpchar)(Thomas)
  728. Save string type if specified for DEFAULT clause handling(Thomas)
  729. Coerce operations involving different data types(Thomas)
  730. Allow some index use for columns of different types(Thomas)
  731. Add capabilities for automatic type conversion(Thomas)
  732. Cleanups for large objects, so file is truncated on open(Peter)
  733. Readline cleanups(Tom)
  734. Allow psql  f  to make spaces as delimiter(Bruce)
  735. Pass pg_attribute.atttypmod to the frontend for column field lengths(Tom,Bruce)
  736. Msql compatibility library in /contrib(Aldrin)
  737. Remove the requirement that ORDER/GROUP BY clause identifiers be 
  738. included in the target list(David)
  739. Convert columns to match columns in UNION clauses(Thomas)
  740. Remove fork()/exec() and only do fork()(Bruce)
  741. Jdbc cleanups(Peter)
  742. Show backend status on ps command line(only works on some platforms)(Bruce)
  743. Pg_hba.conf now has a sameuser option in the database field
  744. Make lo_unlink take oid param, not int4
  745. New DISABLE_COMPLEX_MACRO for compilers that can't handle our macros(Bruce)
  746. Libpgtcl now handles NOTIFY as a Tcl event, need not send dummy queries(Tom)
  747. libpgtcl cleanups(Tom)
  748. Add -error option to libpgtcl's pg_result command(Tom)
  749. New locale patch, see docs/README/locale(Oleg)
  750. Fix for pg_dump so CONSTRAINT and CHECK syntax is correct(ccb)
  751. New contrib/lo code for large object orphan removal(Peter)
  752. New psql command "SET CLIENT_ENCODING TO 'encoding'" for multi-bytes
  753. feature, see /doc/README.mb(Tatsuo)
  754. /contrib/noupdate code to revoke update permission on a column
  755. Libpq can now be compiled on win32(Magnus)
  756. Add PQsetdbLogin() in libpq
  757. New 8-byte integer type, checked by configure for OS support(Thomas)
  758. Better support for quoted table/column names(Thomas)
  759. Surround table and column names with double-quotes in pg_dump(Thomas)
  760. PQreset() now works with passwords(Tom)
  761. Handle case of GROUP BY target list column number out of range(David)
  762. Allow UNION in subselects
  763. Add auto-size to screen to d? commands(Bruce)
  764. Use UNION to show all d? results in one query(Bruce)
  765. Add d? field search feature(Bruce)
  766. Pg_dump issues fewer connect requests(Tom)
  767. Make pg_dump -z flag work better, document it in manual page(Tom)
  768. Add HAVING clause with full support for subselects and unions(Stephan)
  769. Full text indexing routines in contrib/fulltextindex(Maarten)
  770. Transaction ids now stored in shared memory(Vadim)
  771. New PGCLIENTENCODING when issuing COPY command(Tatsuo)
  772. Support for SQL92 syntax "SET NAMES"(Tatsuo)
  773. Support for LATIN2-5(Tatsuo)
  774. Add UNICODE regression test case(Tatsuo)
  775. Lock manager cleanup, new locking modes for LLL(Vadim)
  776. Allow index use with OR clauses(Bruce)
  777. Allows "SELECT NULL ORDER BY 1;"
  778. Explain VERBOSE prints the plan, and now pretty-prints the plan to
  779. the postmaster log file(Bruce)
  780. Add Indices display to d command(Bruce)
  781. Allow GROUP BY on functions(David)
  782. New pg_class.relkind for large objects(Bruce)
  783. New way to send libpq NOTICE messages to a different location(Tom)
  784. New w write command to psql(Bruce)
  785. New /contrib/findoidjoins scans oid columns to find join relationships(Bruce)
  786. Allow binary-compatible indices to be considered when checking for valid
  787. indices for restriction clauses containing a constant(Thomas)
  788. New ISBN/ISSN code in /contrib/isbn_issn
  789. Allow NOT LIKE, IN, NOT IN, BETWEEN, and NOT BETWEEN constraint(Thomas)
  790. New rewrite system fixes many problems with rules and views(Jan)
  791. * Rules on relations work
  792. * Event qualifications on insert/update/delete work
  793. * New OLD variable to reference CURRENT, CURRENT will be remove in future
  794. * Update rules can reference NEW and OLD in rule qualifications/actions
  795. * Insert/update/delete rules on views work
  796. * Multiple rule actions are now supported, surrounded by parentheses
  797. * Regular users can create views/rules on tables they have RULE permits
  798. * Rules and views inherit the permissions on the creator
  799. * No rules at the column level
  800. * No UPDATE NEW/OLD rules
  801. * New pg_tables, pg_indexes, pg_rules and pg_views system views
  802. * Only a single action on SELECT rules
  803. * Total rewrite overhaul, perhaps for 6.5
  804. * handle subselects
  805. * handle aggregates on views
  806. * handle insert into select from view works
  807. System indexes are now multi-key(Bruce)
  808. Oidint2, oidint4, and oidname types are removed(Bruce)
  809. Use system cache for more system table lookups(Bruce)
  810. New backend programming language PL/pgSQL in backend/pl(Jan)
  811. New SERIAL data type, auto-creates sequence/index(Thomas)
  812. Enable assert checking without a recompile(Massimo)
  813. User lock enhancements(Massimo)
  814. New setval() command to set sequence value(Massimo)
  815. Auto-remove unix socket file on startup if no postmaster running(Massimo)
  816. Conditional trace package(Massimo)
  817. New UNLISTEN command(Massimo)
  818. Psql and libpq now compile under win32 using win32.mak(Magnus)
  819. Lo_read no longer stores trailing NULL(Bruce)
  820. Identifiers are now truncated to 31 characters internally(Bruce)
  821. Createuser options now availble on the command line
  822. Code for 64-bit integer supported added, configure tested, int8 type(Thomas)
  823. Prevent file descriptor leaf from failed COPY(Bruce)
  824. New pg_upgrade command(Bruce)
  825. Updated /contrib directories(Massimo)
  826. New CREATE TABLE DEFAULT VALUES statement available(Thomas)
  827. New INSERT INTO TABLE DEFAULT VALUES statement available(Thomas)
  828. New DECLARE and FETCH feature(Thomas)
  829. libpq's internal structures now not exported(Tom)
  830. Allow up to 8 key indexes(Bruce)
  831. Remove ARCHIVE keyword, that is no longer used(Thomas)
  832. pg_dump -n flag to supress quotes around indentifiers
  833. disable system columns for views(Jan)
  834. new INET and CIDR types for network addresses(TomH, Paul)
  835. no more double quotes in psql output
  836. pg_dump now dumps views(Terry)
  837. new SET QUERY_LIMIT(Tatsuo,Jan)
  838. Source Tree Changes
  839. -------------------
  840. /contrib cleanup(Jun)
  841. Inline some small functions called for every row(Bruce)
  842. Alpha/linux fixes
  843. Hp/UX cleanups(Tom)
  844. Multi-byte regression tests(Soonmyung.)
  845. Remove --disabled options from configure
  846. Define PGDOC to use POSTGRESDIR by default
  847. Make regression optional
  848. Remove extra braces code to pgindent(Bruce)
  849. Add bsdi shared library support(Bruce)
  850. New --without-CXX support configure option(Brook)
  851. New FAQ_CVS
  852. Update backend flowchart in tools/backend(Bruce)
  853. Change atttypmod from int16 to int32(Bruce, Tom)
  854. Getrusage() fix for platforms that do not have it(Tom)
  855. Add PQconnectdb, PGUSER, PGPASSWORD to libpq man page
  856. NS32K platform fixes(Phil Nelson, John Buller)
  857. Sco 7/UnixWare 2.x fixes(Billy,others)
  858. Sparc/Solaris 2.5 fixes(Ryan)
  859. Pgbuiltin.3 is obsolete, move to doc files(Thomas)
  860. Even more documention(Thomas)
  861. Nextstep support(Jacek)
  862. Aix support(David)
  863. pginterface manual page(Bruce)
  864. shared libraries all have version numbers
  865. merged all OS-specific shared library defines into one file
  866. smarter TCL/TK configuration checking(Billy)
  867. smarter perl configuration(Brook)
  868. configure uses supplied install-sh if no install script found(Tom)
  869. new Makefile.shlib for shared library configuration(Tom)
  870. </programlisting>
  871. </para>
  872. </sect2>
  873. </sect1>
  874. <sect1>
  875. <title>Release 6.3.2</title>
  876. <!--
  877. <docinfo>
  878. <authorgroup>
  879. <author>
  880. <firstname>Bruce</firstname>
  881. <surname>Momjian</surname>
  882. </author>
  883. </authorgroup>
  884. <date>Tue Apr  7 16:53:16 EDT 1998</date>
  885. </docinfo>
  886. -->
  887. <para>
  888. This is a bugfix release for 6.3.x.
  889. Refer to the release notes for v6.3 for a more complete summary of new features.
  890. </para>
  891. <para>
  892. Summary:
  893. <itemizedlist>
  894. <listitem>
  895. <para>
  896. Repairs automatic configuration support for some platforms, including Linux,
  897. from breakage inadvertently introduced in v6.3.1.
  898. </para>
  899. </listitem>
  900. <listitem>
  901. <para>
  902. Correctly handles function calls on the left side of BETWEEN and LIKE clauses.
  903. </para>
  904. </listitem>
  905. </itemizedlist>
  906. </para>
  907. <para>
  908. A dump/restore is NOT required for those running 6.3 or 6.3.1.  A 
  909. 'make distclean', 'make', and 'make install' is all that is required.
  910. This last step should be performed while the postmaster is not running.
  911. You should re-link any custom applications that use <productname>Postgres</productname> libraries.
  912. </para>
  913. <para>
  914. For upgrades from pre-v6.3 installations,
  915. refer to the installation and migration instructions for v6.3.
  916. </para>
  917. <sect2>
  918. <title>Detailed Change List</title>
  919. <para>
  920. <programlisting>
  921. Changes
  922. -------
  923. Configure detection improvements for tcl/tk(Brook Milligan, Alvin)
  924. Manual page improvements(Bruce)
  925. BETWEEN and LIKE fix(Thomas)
  926. fix for psql connect used by pg_dump(Oliver Elphick)
  927. New odbc driver
  928. pgaccess, version 0.86
  929. qsort removed, now uses libc version, cleanups(Jeroen)
  930. fix for buffer over-runs detected(Maurice Gittens)
  931. fix for buffer overrun in libpgtcl(Randy Kunkee)
  932. fix for UNION with DISTINCT or ORDER BY(Bruce)
  933. gettimeofday configure check(Doug Winterburn)
  934. Fix "indexes not used" bug(Vadim)
  935. docs additions(Thomas)
  936. Fix for backend memory leak(Bruce)
  937. libreadline cleanup(Erwan MAS)
  938. Remove DISTDIR(Bruce)
  939. Makefile dependency cleanup(Jeroen van Vianen)
  940. ASSERT fixes(Bruce)
  941. </programlisting>
  942. </para>
  943. </sect2>
  944. </sect1>
  945. <sect1>
  946. <title>Release 6.3.1</title>
  947. <!--
  948. <docinfo>
  949. <authorgroup>
  950. <author>
  951. <firstname>Bruce</firstname>
  952. <surname>Momjian</surname>
  953. </author>
  954. </authorgroup>
  955. <date>
  956. Mon Mar 23 10:21:52 EST 1998
  957. </date>
  958. </docinfo>
  959. -->
  960. <para>
  961. Summary:
  962. <itemizedlist>
  963. <listitem>
  964. <para>
  965. Additional support for multi-byte character sets.
  966. </para>
  967. </listitem>
  968. <listitem>
  969. <para>
  970. Repair byte ordering for mixed-endian clients and servers.
  971. </para>
  972. </listitem>
  973. <listitem>
  974. <para>
  975. Minor updates to allowed SQL syntax.
  976. </para>
  977. </listitem>
  978. <listitem>
  979. <para>
  980. Improvements to the configuration autodetection for installation.
  981. </para>
  982. </listitem>
  983. </itemizedlist>
  984. </para>
  985. <para>
  986. A dump/restore is NOT required for those running 6.3.  A 
  987. 'make distclean', 'make', and 'make install' is all that is required.
  988. This last step should be performed while the postmaster is not running.
  989. You should re-link any custom applications that use <productname>Postgres</productname> libraries.
  990. </para>
  991. <para>
  992. For upgrades from pre-v6.3 installations,
  993. refer to the installation and migration instructions for v6.3.
  994. </para>
  995. <sect2>
  996. <title>Detailed Change List</title>
  997. <para>
  998. <programlisting>
  999. Changes
  1000. -------
  1001. ecpg cleanup/fixes, now version 1.1(Michael Meskes)
  1002. pg_user cleanup(Bruce)
  1003. large object fix for pg_dump and tclsh (alvin)
  1004. LIKE fix for multiple adjacent underscores
  1005. fix for redefining builtin functions(Thomas)
  1006. ultrix4 cleanup
  1007. upgrade to pg_access 0.83
  1008. updated CLUSTER manual page
  1009. multi-byte character set support, see doc/README.mb(Tatsuo)
  1010. configure --with-pgport fix
  1011. pg_ident fix
  1012. big-endian fix for backend communications(Kataoka)
  1013. SUBSTR() and substring() fix(Jan)
  1014. several jdbc fixes(Peter)
  1015. libpgtcl improvements, see libptcl/README(Randy Kunkee)
  1016. Fix for "Datasize = 0" error(Vadim)
  1017. Prevent do from wrapping(Bruce)
  1018. Remove duplicate Russian character set entries
  1019. Sunos4 cleanup
  1020. Allow optional TABLE keyword in LOCK and SELECT INTO(Thomas)
  1021. CREATE SEQUENCE options to allow a negative integer(Thomas)
  1022. Add "PASSWORD" as an allowed column identifier(Thomas)
  1023. Add checks for UNION target fields(Bruce)
  1024. Fix Alpha port(Dwayne Bailey)
  1025. Fix for text arrays containing quotes(Doug Gibson)
  1026. Solaris compile fix(Albert Chin-A-Young)
  1027. Better identify tcl and tk libs and includes(Bruce)
  1028. </programlisting>
  1029. </para>
  1030. </sect2>
  1031. </sect1>
  1032. <sect1>
  1033. <title>Release 6.3</title>
  1034. <!--
  1035. <docinfo>
  1036. <authorgroup>
  1037. <author>
  1038. <firstname>Bruce</firstname>
  1039. <surname>Momjian</surname>
  1040. </author>
  1041. </authorgroup>
  1042. <date>
  1043. Sun Mar  1 14:57:30 EST 1998
  1044. </date>
  1045. </docinfo>
  1046. -->
  1047. <para>
  1048. There are <emphasis>many</emphasis> new features and improvements in this release.
  1049. Here is a brief, incomplete summary:
  1050. <itemizedlist>
  1051. <listitem>
  1052. <para>
  1053. Many new SQL features, including
  1054. full <acronym>SQL92</acronym> subselect capability
  1055. (everything is here but target-list subselects).
  1056. </para>
  1057. </listitem>
  1058. <listitem>
  1059. <para>
  1060. Support for client-side environment variables to specify time zone and date style.
  1061. </para>
  1062. </listitem>
  1063. <listitem>
  1064. <para>
  1065. Socket interface for client/server connection. This is the default now
  1066. so you may need to start <application>postmaster</application> with the
  1067. <quote>-i</quote> flag.
  1068. </para>
  1069. </listitem>
  1070. <listitem>
  1071. <para>
  1072. Better password authorization mechanisms. Default table permissions have changed.
  1073. </para>
  1074. </listitem>
  1075. <listitem>
  1076. <para>
  1077. Old-style <quote>time travel</quote> has been removed. Performance has been improved.
  1078. </para>
  1079. </listitem>
  1080. </itemizedlist>
  1081. </para>
  1082. <note>
  1083. <para>
  1084. Bruce Momjian wrote the following notes to introduce the new release.
  1085. </para>
  1086. </note>
  1087. <para>
  1088. There are some general 6.3 issues that I want to mention.  These are
  1089. only the big items that can not be described in one sentence.  A review
  1090. of the detailed changes list is still needed.
  1091. </para>
  1092. <para>
  1093. First, we now have subselects.  Now that we have them, I would like to
  1094. mention that without subselects, SQL is a very limited language.
  1095. Subselects are a major feature, and you should review your code for
  1096. places where subselects provide a better solution for your queries.  I
  1097. think you will find that there are more uses for subselects than you may
  1098. think.  Vadim has put us on the big SQL map with subselects, and fully
  1099. functional ones too.  The only thing you can't do with subselects is to
  1100. use them in the target list.
  1101. </para>
  1102. <para>
  1103. Second, 6.3 uses unix domain sockets rather than TCP/IP by default.  To
  1104. enable connections from other machines, you have to use the new
  1105. postmaster -i option, and of course edit pg_hba.conf.  Also, for this
  1106. reason, the format of pg_hba.conf has changed.
  1107. </para>
  1108. <para>
  1109. Third, char() fields will now allow faster access than varchar() or
  1110. text. Specifically, the text and varchar() have a penalty for access to
  1111. any columns after the first column of this type.  char() used to also
  1112. have this access penalty, but it no longer does.  This may suggest that
  1113. you redesign some of your tables, especially if you have short character
  1114. columns that you have defined as varchar() or text.  This and other
  1115. changes make 6.3 even faster than earlier releases.
  1116. </para>
  1117. <para>
  1118. We now have passwords definable independent of any Unix file.  There are
  1119. new SQL USER commands.  See the pg_hba.conf manual page for more
  1120. information.  There is a new table, pg_shadow, which is used to store
  1121. user information and user passwords, and it by default only SELECT-able
  1122. by the postgres super-user.  pg_user is now a view of pg_shadow, and is
  1123. SELECT-able by PUBLIC.  You should keep using pg_user in your
  1124. application without changes.
  1125. </para>
  1126. <para>
  1127. User-created tables now no longer have SELECT permission to PUBLIC by
  1128. default.  This was done because the ANSI standard requires it.  You can
  1129. of course GRANT any permissions you want after the table is created. 
  1130. System tables continue to be SELECT-able by PUBLIC.
  1131. </para>
  1132. <para>
  1133. We also have real deadlock detection code.  No more sixty-second
  1134. timeouts.  And the new locking code implements a FIFO better, so there
  1135. should be less resource starvation during heavy use.
  1136. </para>
  1137. <para>
  1138. Many complaints have been made about inadequate documenation in previous
  1139. releases.  Thomas has put much effort into many new manuals for this
  1140. release.  Check out the doc/ directory.
  1141. </para>
  1142. <para>
  1143. For performance reasons, time travel is gone, but can be implemented
  1144. using triggers (see pgsql/contrib/spi/README).  Please check out the new
  1145. d command for types, operators, etc.  Also, views have their own
  1146. permissions now, not based on the underlying tables, so permissions on
  1147. them have to be set separately.  Check /pgsql/interfaces for some new
  1148. ways to talk to <productname>Postgres</productname>.
  1149. </para>
  1150. <para>
  1151. This is the first release that really required an explanation for
  1152. existing users.  In many ways, this was necessary because the new
  1153. release removes many limitations, and the work-arounds people were using
  1154. are no longer needed.
  1155. </para>
  1156. <sect2>
  1157. <title>Migration to v6.3</title>
  1158. <para>
  1159. A dump/restore using <application>pg_dump</application> 
  1160. or <application>pg_dumpall</application>
  1161. is required for those wishing to migrate data from any
  1162. previous release of <productname>Postgres</productname>.
  1163. </para>
  1164. </sect2>
  1165. <sect2>
  1166. <title>Detailed Change List</title>
  1167. <para>
  1168. <programlisting>
  1169. Bug Fixes
  1170. ---------
  1171. Fix binary cursors broken by MOVE implementation(Vadim)
  1172. Fix for tcl library crash(Jan)
  1173. Fix for array handling, from Gerhard Hintermayer
  1174. Fix acl error, and remove duplicate pqtrace(Bruce)
  1175. Fix psql e for empty file(Bruce)
  1176. Fix for textcat on varchar() fields(Bruce)
  1177. Fix for DBT Sendproc (Zeugswetter Andres)
  1178. Fix vacuum analyze syntax problem(Bruce)
  1179. Fix for international identifiers(Tatsuo)
  1180. Fix aggregates on inherited tables(Bruce)
  1181. Fix substr() for out-of-bounds data
  1182. Fix for select 1=1 or 2=2, select 1=1 and 2=2, and select sum(2+2)(Bruce)
  1183. Fix notty output to show status result.  -q option still turns it off(Bruce)
  1184. Fix for count(*), aggs with views and multiple tables and sum(3)(Bruce)
  1185. Fix cluster(Bruce)
  1186. Fix for PQtrace start/stop several times(Bruce)
  1187. Fix a variety of locking problems like newer lock waiters getting
  1188. lock before older waiters, and having readlock people not share
  1189. locks if a writer is waiting for a lock, and waiting writers not
  1190. getting priority over waiting readers(Bruce)
  1191. Fix crashes in psql when executing queries from external files(James)
  1192. Fix problem with multiple order by columns, with the first one having
  1193. NULL values(Jeroen)
  1194. Use correct hash table support functions for float8 and int4(Thomas)
  1195. Re-enable JOIN= option in CREATE OPERATOR statement (Thomas)
  1196. Change precedence for boolean operators to match expected behavior(Thomas)
  1197. Generate elog(ERROR) on over-large integer(Bruce)
  1198. Allow multiple-argument functions in constraint clauses(Thomas)
  1199. Check boolean input literals for 'true','false','yes','no','1','0'
  1200. and throw elog(ERROR) if unrecognized(Thomas)
  1201. Major large objects fix
  1202. Fix for GROUP BY showing duplicates(Vadim)
  1203. Fix for index scans in MergeJion(Vadim)
  1204. Enhancements
  1205. ------------
  1206. Subselects with EXISTS, IN, ALL, ANY keywords (Vadim, Bruce, Thomas)
  1207. New User Manual(Thomas, others)
  1208. Speedup by inlining some frequently-called functions
  1209. Real deadlock detection, no more timeouts(Bruce)
  1210. Add SQL92 "constants" CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, 
  1211. CURRENT_USER(Thomas)
  1212. Modify constraint syntax to be SQL92-compliant(Thomas)
  1213. Implement SQL92 PRIMARY KEY and UNIQUE clauses using indices(Thomas)
  1214. Recognize SQL92 syntax for FOREIGN KEY. Throw elog notice(Thomas)
  1215. Allow NOT NULL UNIQUE constraint clause (each allowed separately before)(Thomas)
  1216. Allow Postgres-style casting ("::") of non-constants(Thomas)
  1217. Add support for SQL3 TRUE and FALSE boolean constants(Thomas)
  1218. Support SQL92 syntax for IS TRUE/IS FALSE/IS NOT TRUE/IS NOT FALSE(Thomas)
  1219. Allow shorter strings for boolean literals (e.g. "t", "tr", "tru")(Thomas)
  1220. Allow SQL92 delimited identifiers(Thomas)
  1221. Implement SQL92 binary and hexadecimal string decoding (b'10' and x'1F')(Thomas)
  1222. Support SQL92 syntax for type coercion of literal strings
  1223. (e.g. "DATETIME 'now'")(Thomas)
  1224. Add conversions for int2, int4, and OID types to and from text(Thomas)
  1225. Use shared lock when building indices(Vadim)
  1226. Free memory allocated for an user query inside transaction block after
  1227. this query is done, was turned off in <= 6.2.1(Vadim)
  1228. New SQL statement CREATE PROCEDURAL LANGUAGE(Jan)
  1229. New <productname>Postgres</productname> Procedural Language (PL) backend interface(Jan)
  1230. Rename pg_dump -H option to -h(Bruce)
  1231. Add Java support for passwords, European dates(Peter)
  1232. Use indices for LIKE and ~, !~ operations(Bruce)
  1233. Add hash functions for datetime and timespan(Thomas)
  1234. Time Travel removed(Vadim, Bruce)
  1235. Add paging for d and z, and fix i(Bruce)
  1236. Add Unix domain socket support to backend and to frontend library(Goran)
  1237. Implement CREATE DATABASE/WITH LOCATION and initlocation utility(Thomas)
  1238. Allow more SQL92 and/or <productname>Postgres</productname> reserved words as column identifiers(Thomas)
  1239. Augment support for SQL92 SET TIME ZONE...(Thomas)
  1240. SET/SHOW/RESET TIME ZONE uses TZ backend environment variable(Thomas)
  1241. Implement SET keyword = DEFAULT and SET TIME ZONE DEFAULT(Thomas)
  1242. Enable SET TIME ZONE using TZ environment variable(Thomas)
  1243. Add PGDATESTYLE environment variable to frontend and backend initialization(Thomas)
  1244. Add PGTZ, PGCOSTHEAP, PGCOSTINDEX, PGRPLANS, PGGEQO
  1245. frontend library initialization environment variables(Thomas)
  1246. Regression tests time zone automatically set with "setenv PGTZ PST8PDT"(Thomas)
  1247. Add pg_description table for info on tables, columns, operators, types, and
  1248. aggregates(Bruce)
  1249. Increase 16 char limit on system table/index names to 32 characters(Bruce)
  1250. Rename system indices(Bruce)
  1251. Add 'GERMAN' option to SET DATESTYLE(Thomas)
  1252. Define an "ISO-style" timespan output format with "hh:mm:ss" fields(Thomas)
  1253. Allow fractional values for delta times (e.g. '2.5 days')(Thomas)
  1254. Validate numeric input more carefully for delta times(Thomas)
  1255. Implement day of year as possible input to date_part()(Thomas)
  1256. Define timespan_finite() and text_timespan() functions(Thomas)
  1257. Remove archive stuff(Bruce)
  1258. Allow for a pg_password authentication database that is separate from
  1259. the system password file(Todd)
  1260. Dump ACLs, GRANT, REVOKE permissions(Matt)
  1261. Define text, varchar, and bpchar string length functions(Thomas)
  1262. Fix Query handling for inheritance, and cost computations(Bruce)
  1263. Implement CREATE TABLE/AS SELECT (alternative to SELECT/INTO)(Thomas)
  1264. Allow NOT, IS NULL, IS NOT NULL in constraints(Thomas)
  1265. Implement UNIONs for SELECT(Bruce)
  1266. Add UNION, GROUP, DISTINCT to INSERT(Bruce)
  1267. varchar() stores only necessary bytes on disk(Bruce)
  1268. Fix for BLOBs(Peter)
  1269. Mega-Patch for JDBC...see README_6.3 for list of changes(Peter)
  1270. Remove unused "option" from PQconnectdb()
  1271. New LOCK command and lock manual page describing deadlocks(Bruce)
  1272. Add new psql da, dd, df, do, dS, and dT commands(Bruce)
  1273. Enhance psql z to show sequences(Bruce)
  1274. Show NOT NULL and DEFAULT in psql d table(Bruce)
  1275. New psql .psqlrc file startup(Andrew)
  1276. Modify sample startup script in contrib/linux to show syslog(Thomas)
  1277. New types for IP and MAC addresses in contrib/ip_and_mac(TomH)
  1278. Unix system time conversions with date/time types in contrib/unixdate(Thomas)
  1279. Update of contrib stuff(Massimo)
  1280. Add Unix socket support to DBD::Pg(Goran)
  1281. New python interface (PyGreSQL 2.0)(D'Arcy)
  1282. New frontend/backend protocol has a version number, network byte order(Phil)
  1283. Security features in pg_hba.conf enhanced and documented, many cleanups(Phil)
  1284. CHAR() now faster access than VARCHAR() or TEXT
  1285. ecpg embedded SQL preprocessor
  1286. Reduce system column overhead(Vadmin)
  1287. Remove pg_time table(Vadim)
  1288. Add pg_type attribute to identify types that need length (bpchar, varchar)
  1289. Add report of offending line when COPY command fails
  1290. Allow VIEW permissions to be set separately from the underlying tables. 
  1291. For security, use GRANT/REVOKE on views as appropriate(Jan)
  1292. Tables now have no default GRANT SELECT TO PUBLIC.  You must
  1293. explicitly grant such permissions.
  1294. Clean up tutorial examples(Darren)
  1295. Source Tree Changes
  1296. -------------------
  1297. Add new html development tools, and flow chart in /tools/backend
  1298. Fix for SCO compiles
  1299. Stratus computer port Robert Gillies
  1300. Added support for shlib for BSD44_derived & i386_solaris
  1301. Make configure more automated(Brook)
  1302. Add script to check regression test results
  1303. Break parser functions into smaller files, group together(Bruce)
  1304. Rename heap_create to heap_create_and_catalog, rename heap_creatr
  1305. to heap_create()(Bruce)
  1306. Sparc/Linux patch for locking(TomS)
  1307. Remove PORTNAME and reorganize port-specific stuff(Marc)
  1308. Add optimizer README file(Bruce)
  1309. Remove some recursion in optimizer and clean up some code there(Bruce)
  1310. Fix for NetBSD locking(Henry)
  1311. Fix for libptcl make(Tatsuo)
  1312. AIX patch(Darren)
  1313. Change IS TRUE, IS FALSE, ... to expressions using "=" rather than
  1314. function calls to istrue() or isfalse() to allow optimization(Thomas)
  1315. Various fixes NetBSD/Sparc related(TomH)
  1316. Alpha linux locking(Travis,Ryan)
  1317. Change elog(WARN) to elog(ERROR)(Bruce)
  1318. FAQ for FreeBSD(Marc)
  1319. Bring in the PostODBC source tree as part of our standard distribution(Marc)
  1320. A minor patch for HP/UX 10 vs 9(Stan)
  1321. New pg_attribute.atttypmod for type-specific info like varchar length(Bruce)
  1322. Unixware patches(Billy)
  1323. New i386 'lock' for spin lock asm(Billy)
  1324. Support for multiplexed backends is removed
  1325. Start an OpenBSD port
  1326. Start an AUX port
  1327. Start a Cygnus port
  1328. Add string functions to regression suite(Thomas)
  1329. Expand a few function names formerly truncated to 16 characters(Thomas)
  1330. Remove un-needed malloc() calls and replace with palloc()(Bruce)
  1331. </programlisting>
  1332. </para>
  1333. </sect2>
  1334. </sect1>
  1335. <sect1>
  1336. <title>Release 6.2.1</title>
  1337. <!--
  1338. <docinfo>
  1339. <authorgroup>
  1340. <author>
  1341. <firstname>Bruce</firstname>
  1342. <surname>Momjian</surname>
  1343. </author>
  1344. </authorgroup>
  1345. <date>
  1346. Fri Oct 17 00:01:27 EDT 1997
  1347. </date>
  1348. </docinfo>
  1349. -->
  1350. <para>
  1351. v6.2.1 is a bug-fix and usability release on v6.2.
  1352. </para>
  1353. <para>
  1354. Summary:
  1355. <itemizedlist>
  1356. <listitem>
  1357. <para>
  1358. Allow strings to span lines, per <acronym>SQL92</acronym>.
  1359. </para>
  1360. </listitem>
  1361. <listitem>
  1362. <para>
  1363. Include example trigger function for inserting user names on table updates.
  1364. </para>
  1365. </listitem>
  1366. </itemizedlist>
  1367. </para>
  1368. <para>
  1369. This is a minor bug-fix release on v6.2. 
  1370. For upgrades from pre-v6.2 systems, a full dump/reload is required. 
  1371. Refer to the v6.2 release notes for instructions.
  1372. </para>
  1373. <sect2>
  1374. <title>Migration from v6.2 to v6.2.1</title>
  1375. <para>
  1376. This is a minor bug-fix release. A dump/reload is not required from v6.2,
  1377. but is required from any release prior to v6.2.
  1378. </para>
  1379. <para>
  1380. In upgrading from v6.2, if you choose to dump/reload you will find that
  1381. avg(money) is now calculated correctly. All other bug fixes take effect
  1382. upon updating the executables.
  1383. </para>
  1384. <para>
  1385. Another way to avoid dump/reload is to use the following SQL command
  1386. from psql to update the existing system table:
  1387. <programlisting>
  1388.   update pg_aggregate set aggfinalfn = 'cash_div_flt8'
  1389.    where aggname = 'avg' and aggbasetype = 790;
  1390. </programlisting>
  1391. </para>
  1392. <para>
  1393. This will need to be done to every existing database, including template1.
  1394. </para>
  1395. </sect2>
  1396. <sect2>
  1397. <title>Detailed Change List</title>
  1398. <para>
  1399. <programlisting>
  1400. Changes in this release
  1401. -----------------------
  1402. Allow TIME and TYPE column names(Thomas)
  1403. Allow larger range of true/false as boolean values(Thomas)
  1404. Support output of "now" and "current"(Thomas)
  1405. Handle DEFAULT with INSERT of NULL properly(Vadim)
  1406. Fix for relation reference counts problem in buffer manager(Vadim)
  1407. Allow strings to span lines, like ANSI(Thomas)
  1408. Fix for backward cursor with ORDER BY(Vadim)
  1409. Fix avg(cash) computation(Thomas)
  1410. Fix for specifying a column twice in ORDER/GROUP BY(Vadim)
  1411. Documented new libpq function to return affected rows, PQcmdTuples(Bruce)
  1412. Trigger function for inserting user names for INSERT/UPDATE(Brook Milligan)
  1413. </programlisting>
  1414. </para>
  1415. </sect2>
  1416. </sect1>
  1417. <sect1>
  1418. <title>Release 6.2</title>
  1419. <!--
  1420. <docinfo>
  1421. <authorgroup>
  1422. <author>
  1423. <firstname>Bruce</firstname>
  1424. <surname>Momjian</surname>
  1425. </author>
  1426. </authorgroup>
  1427. <date>
  1428. Thu Oct 02 12:53:46 EDT 1997
  1429. </date>
  1430. </docinfo>
  1431. -->
  1432. <para>
  1433. A dump/restore is required for those wishing to migrate data from
  1434. previous releases of <productname>Postgres</productname>.
  1435. </para>
  1436. <sect2>
  1437. <title>Migration from v6.1 to v6.2</title>
  1438. <para>
  1439. This migration requires a complete dump of the 6.1 database and a
  1440. restore of the database in 6.2.
  1441. </para>
  1442. <para>
  1443. Note that the pg_dump and pg_dumpall utility from 6.2 should be used
  1444. to dump the 6.1 database.
  1445. </para>
  1446. </sect2>
  1447. <sect2>
  1448. <title>Migration from v1.x to v6.2</title>
  1449. <para>
  1450. Those migrating from earlier 1.* releases should first upgrade to 1.09
  1451. because the COPY output format was improved from the 1.02 release.
  1452. </para>
  1453. </sect2>
  1454. <sect2>
  1455. <title>Detailed Change List</title>
  1456. <para>
  1457. <programlisting>
  1458. Bug Fixes
  1459. ---------
  1460. Fix problems with pg_dump for inheritance, sequences, archive tables(Bruce)
  1461. Fix compile errors on overflow due to shifts, unsigned, and bad prototypes
  1462.  from Solaris(Diab Jerius)
  1463. Fix bugs in geometric line arithmetic (bad intersection calculations)(Thomas)
  1464. Check for geometric intersections at endpoints to avoid rounding ugliness(Thomas)
  1465. Catch non-functional delete attempts(Vadim)
  1466. Change time function names to be more consistent(Michael Reifenberg)
  1467. Check for zero divides(Michael Reifenberg)
  1468. Fix very old bug which made tuples changed/inserted by a commnd
  1469. visible to the command itself (so we had multiple update of 
  1470. updated tuples, etc)(Vadim)
  1471. Fix for SELECT null, 'fail' FROM pg_am (Patrick)
  1472. SELECT NULL as EMPTY_FIELD now allowed(Patrick)
  1473. Remove un-needed signal stuff from contrib/pginterface
  1474. Fix OR (where x &lt;&gt; 1 or x isnull didn't return tuples with x NULL) (Vadim)
  1475. Fix time_cmp function (Vadim)
  1476. Fix handling of functions with non-attribute first argument in 
  1477. WHERE clauses (Vadim)
  1478. Fix GROUP BY when order of entries is different from order
  1479. in target list (Vadim)
  1480. Fix pg_dump for aggregates without sfunc1 (Vadim)
  1481. Enhancements
  1482. ------------
  1483. Default genetic optimizer GEQO parameter is now 8(Bruce)
  1484. Allow use parameters in target list having aggregates in functions(Vadim)
  1485. Added JDBC driver as an interface(Adrian & Peter)
  1486. pg_password utility
  1487. Return number of tuples inserted/affected by INSERT/UPDATE/DELETE etc.(Vadim)
  1488. Triggers implemented with CREATE TRIGGER (SQL3)(Vadim)
  1489. SPI (Server Programming Interface) allows execution of queries inside 
  1490. C-functions (Vadim)
  1491. NOT NULL implemented (SQL92)(Robson Paniago de Miranda)
  1492. Include reserved words for string handling, outer joins, and unions(Thomas)
  1493. Implement extended comments ("/* ... */") using exclusive states(Thomas)
  1494. Add "//" single-line comments(Bruce)
  1495. Remove some restrictions on characters in operator names(Thomas)
  1496. DEFAULT and CONSTRAINT for tables implemented (SQL92)(Vadim & Thomas)
  1497. Add text concatenation operator and function (SQL92)(Thomas)
  1498. Support WITH TIME ZONE syntax (SQL92)(Thomas)
  1499. Support INTERVAL unit TO unit syntax (SQL92)(Thomas)
  1500. Define types DOUBLE PRECISION, INTERVAL, CHARACTER,
  1501. and CHARACTER VARYING (SQL92)(Thomas)
  1502. Define type FLOAT(p) and rudimentary DECIMAL(p,s), NUMERIC(p,s) (SQL92)(Thomas)
  1503. Define EXTRACT(), POSITION(), SUBSTRING(), and TRIM() (SQL92)(Thomas)
  1504. Define CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP (SQL92)(Thomas)
  1505. Add syntax and warnings for UNION, HAVING, INNER and OUTER JOIN (SQL92)(Thomas)
  1506. Add more reserved words, mostly for SQL92 compliance(Thomas)
  1507. Allow hh:mm:ss time entry for timespan/reltime types(Thomas)
  1508. Add center() routines for lseg, path, polygon(Thomas)
  1509. Add distance() routines for circle-polygon, polygon-polygon(Thomas)
  1510. Check explicitly for points and polygons contained within polygons
  1511. using an axis-crossing algorithm(Thomas)
  1512. Add routine to convert circle-box(Thomas)
  1513. Merge conflicting operators for different geometric data types(Thomas)
  1514. Replace distance operator "<===>" with "<->"(Thomas)
  1515. Replace "above" operator "!^" with ">^" and "below" operator "!|" with "<^"(Thomas)
  1516. Add routines for text trimming on both ends, substring, and string position(Thomas)
  1517. Added conversion routines circle(box) and poly(circle)(Thomas)
  1518. Allow internal sorts to be stored in memory rather than in files(Bruce & Vadim)
  1519. Allow functions and operators on internally-identical types to succeed(Bruce)
  1520. Speed up backend startup after profiling analysis(Bruce)
  1521. Inline frequently called functions for performance(Bruce)
  1522. Reduce open() calls(Bruce)
  1523. psql:  Add PAGER for h and ?,C fix
  1524. Fix for psql pager when no tty(Bruce)
  1525. New entab utility(Bruce)
  1526. General trigger functions for referential integrity (Vadim)
  1527. General trigger functions for time travel (Vadim)
  1528. General trigger functions for AUTOINCREMENT/IDENTITY feature (Vadim)
  1529. MOVE implementation (Vadim)
  1530. Source Tree Changes
  1531. -------------------
  1532. HPUX 10 patches (Vladimir Turin)
  1533. Added SCO support, (Daniel Harris)
  1534. mkLinux patches (Tatsuo Ishii)
  1535. Change geometric box terminology from "length" to "width"(Thomas)
  1536. Deprecate temporary unstored slope fields in geometric code(Thomas)
  1537. Remove restart instructions from INSTALL(Bruce)
  1538. Look in /usr/ucb first for install(Bruce)
  1539. Fix c++ copy example code(Thomas)
  1540. Add -o to psql manual page(Bruce)
  1541. Prevent relname unallocated string length from being copied into database(Bruce)
  1542. Cleanup for NAMEDATALEN use(Bruce)
  1543. Fix pg_proc names over 15 chars in output(Bruce)
  1544. Add strNcpy() function(Bruce)
  1545. remove some (void) casts that are unnecessary(Bruce)
  1546. new interfaces directory(Marc)
  1547. Replace fopen() calls with calls to fd.c functions(Bruce)
  1548. Make functions static where possible(Bruce)
  1549. enclose unused functions in #ifdef NOT_USED(Bruce)
  1550. Remove call to difftime() in timestamp support to fix SunOS(Bruce & Thomas)
  1551. Changes for Digital Unix
  1552. Portability fix for pg_dumpall(Bruce)
  1553. Rename pg_attribute.attnvals to attdisbursion(Bruce)
  1554. "intro/unix" manual page now "pgintro"(Bruce)
  1555. "built-in" manual page now "pgbuiltin"(Bruce)
  1556. "drop" manual page now "drop_table"(Bruce)
  1557. Add "create_trigger", "drop_trigger" manual pages(Thomas)
  1558. Add constraints regression test(Vadim & Thomas)
  1559. Add comments syntax regression test(Thomas)
  1560. Add PGINDENT and support program(Bruce)
  1561. Massive commit to run PGINDENT on all *.c and *.h files(Bruce)
  1562. Files moved to /src/tools directory(Bruce)
  1563. SPI and Trigger programming guides (Vadim & D'Arcy)
  1564. </programlisting>
  1565. </para>
  1566. </sect2>
  1567. </sect1>
  1568. <sect1>
  1569. <title>Release 6.1.1</title>
  1570. <!--
  1571. <docinfo>
  1572. <authorgroup>
  1573. <author>
  1574. <firstname>Bruce</firstname>
  1575. <surname>Momjian</surname>
  1576. </author>
  1577. </authorgroup>
  1578. <date>
  1579. Mon Jul 22 18:04:49 EDT 1997
  1580. </date>
  1581. </docinfo>
  1582. -->
  1583. <sect2>
  1584. <title>Migration from v6.1 to v6.1.1</title>
  1585. <para>
  1586. This is a minor bug-fix release. A dump/reload is not required from v6.1,
  1587. but is required from any release prior to v6.1.
  1588. Refer to the release notes for v6.1 for more details.
  1589. </para>
  1590. </sect2>
  1591. <sect2>
  1592. <title>Detailed Change List</title>
  1593. <para>
  1594. <programlisting>
  1595. Changes in this release
  1596. -----------------------
  1597. fix for SET with options (Thomas)
  1598. allow pg_dump/pg_dumpall to preserve ownership of all tables/objects(Bruce)
  1599. new psql connect option allows changing usernames without changing databases
  1600. fix for initdb --debug option(Yoshihiko Ichikawa))
  1601. lextest cleanup(Bruce)
  1602. hash fixes(Vadim)
  1603. fix date/time month boundary arithmetic(Thomas)
  1604. fix timezone daylight handling for some ports(Thomas, Bruce, Tatsuo)
  1605. timestamp overhauled to use standard functions(Thomas)
  1606. other code cleanup in date/time routines(Thomas)
  1607. psql's d now case-insensitive(Bruce)
  1608. psql's backslash commands can now have trailing semicolon(Bruce)
  1609. fix memory leak in psql when using g(Bruce)
  1610. major fix for endian handling of communication to server(Thomas, Tatsuo)
  1611. Fix for Solaris assembler and include files(Yoshihiko Ichikawa)
  1612. allow underscores in usernames(Bruce)
  1613. pg_dumpall now returns proper status, portability fix(Bruce)
  1614. </programlisting>
  1615. </para>
  1616. </sect2>
  1617. </sect1>
  1618. <sect1>
  1619. <title>Release 6.1</title>
  1620. <!--
  1621. <docinfo>
  1622. <authorgroup>
  1623. <author>
  1624. <firstname>Bruce</firstname>
  1625. <surname>Momjian</surname>
  1626. </author>
  1627. </authorgroup>
  1628. <date>
  1629. Sun Jun  8 14:41:13 EDT 1997
  1630. </date>
  1631. </docinfo>
  1632. -->
  1633. <para>
  1634.   The regression tests have been adapted and extensively modified for the
  1635.   v6.1 release of <productname>Postgres</productname>.
  1636. </para>
  1637. <para>
  1638.   Three new data types (datetime, timespan, and circle) have been added to
  1639.   the native set of <productname>Postgres</productname> types. Points, boxes, paths, and polygons
  1640.   have had their output formats made consistant across the data types.
  1641.   The polygon output in misc.out has only been spot-checked for correctness
  1642.   relative to the original regression output.
  1643. </para>
  1644. <para>
  1645.   <productname>Postgres</productname> v6.1 introduces a new, alternate
  1646. optimizer which uses <firstterm>genetic</firstterm>
  1647.   algorithms. These algorithms introduce a random behavior in the ordering
  1648.   of query results when the query contains multiple qualifiers or multiple
  1649.   tables (giving the optimizer a choice on order of evaluation). Several
  1650.   regression tests have been modified to explicitly order the results, and
  1651.   hence are insensitive to optimizer choices. A few regression tests are
  1652.   for data types which are inherently unordered (e.g. points and time
  1653.   intervals) and tests involving those types are explicitly bracketed with
  1654.   <command>set geqo to 'off'</command> and <command>reset geqo</command>.
  1655. </para>
  1656. <para>
  1657.   The interpretation of array specifiers (the curly braces around atomic
  1658.   values) appears to have changed sometime after the original regression
  1659.   tests were generated. The current <filename>./expected/*.out</filename> files reflect this
  1660.   new interpretation, which may not be correct!
  1661. </para>
  1662. <para>
  1663.   The float8 regression test fails on at least some platforms. This is due
  1664.   to differences in implementations of pow() and exp() and the signaling
  1665.   mechanisms used for overflow and underflow conditions.
  1666. </para>
  1667. <para>
  1668.   The "random" results in the random test should cause the "random" test
  1669.   to be "failed", since the regression tests are evaluated using a simple
  1670.   diff. However, "random" does not seem to produce random results on my 
  1671.   test machine (Linux/gcc/i686).
  1672. </para>
  1673. <sect2>
  1674. <title>Migration to v6.1</title>
  1675. <para>
  1676. This migration requires a complete dump of the 6.0 database and a
  1677. restore of the database in 6.1.
  1678. </para>
  1679. <para>
  1680. Those migrating from earlier 1.* releases should first upgrade to 1.09
  1681. because the COPY output format was improved from the 1.02 release.
  1682. </para>
  1683. </sect2>
  1684. <sect2>
  1685. <title>Detailed Change List</title>
  1686. <para>
  1687. <programlisting>
  1688. Bug Fixes
  1689. ---------
  1690. packet length checking in library routines
  1691. lock manager priority patch
  1692. check for under/over flow of float8(Bruce)
  1693. multi-table join fix(Vadim)
  1694. SIGPIPE crash fix(Darren)
  1695. large object fixes(Sven)
  1696. allow btree indexes to handle NULLs(Vadim)
  1697. timezone fixes(D'Arcy)
  1698. select SUM(x) can return NULL on no rows(Thomas)
  1699. internal optimizer, executor bug fixes(Vadim)
  1700. fix problem where inner loop in < or <= has no rows(Vadim)
  1701. prevent re-commuting join index clauses(Vadim)
  1702. fix join clauses for multiple tables(Vadim)
  1703. fix hash, hashjoin for arrays(Vadim)
  1704. fix btree for abstime type(Vadim)
  1705. large object fixes(Raymond)
  1706. fix buffer leak in hash indices (Vadim)
  1707. fix rtree for use in inner scan (Vadim)
  1708. fix gist for use in inner scan, cleanups (Vadim, Andrea)
  1709. avoid unnecessary local buffers allocation (Vadim, Massimo)
  1710. fix local buffers leak in transaction aborts (Vadim)
  1711. fix file manager memmory leaks, cleanups (Vadim, Massimo)
  1712. fix storage manager memmory leaks (Vadim)
  1713. fix btree duplicates handling (Vadim)
  1714. fix deleted tuples re-incarnation caused by vacuum (Vadim)
  1715. fix SELECT varchar()/char() INTO TABLE made zero-length fields(Bruce)
  1716. many psql, pg_dump, and libpq memory leaks fixed using Purify (Igor)
  1717. Enhancements
  1718. ------------
  1719. attribute optimization statistics(Bruce)
  1720. much faster new btree bulk load code(Paul)
  1721. BTREE UNIQUE added to bulk load code(Vadim) 
  1722. new lock debug code(Massimo)
  1723. massive changes to libpg++(Leo)
  1724. new GEQO optimizer speeds table multi-table optimization(Martin)
  1725. new WARN message for non-unique insert into unique key(Marc)
  1726. update x=-3, no spaces, now valid(Bruce)
  1727. remove case-sensitive identifier handling(Bruce,Thomas,Dan)
  1728. debug backend now pretty-prints tree(Darren)
  1729. new Oracle character functions(Edmund)
  1730. new plaintext password functions(Dan)
  1731. no such class or insufficient privilege changed to distinct messages(Dan)
  1732. new ANSI timestamp function(Dan)
  1733. new ANSI Time and Date types (Thomas)
  1734. move large chunks of data in backend(Martin)
  1735. multi-column btree indexes(Vadim)
  1736. new SET var TO value command(Martin)
  1737. update transaction status on reads(Dan)
  1738. new locale settings for character types(Oleg)
  1739. new SEQUENCE serial number generator(Vadim)
  1740. GROUP BY function now possible(Vadim)
  1741. re-organize regression test(Thomas,Marc)
  1742. new optimizer operation weights(Vadim)
  1743. new psql z grant/permit option(Marc)
  1744. new MONEY data type(D'Arcy,Thomas)
  1745. tcp socket communication speed improved(Vadim)
  1746. new VACUUM option for attribute statistics, and for certain columns (Vadim)
  1747. many geometric type improvements(Thomas,Keith)
  1748. additional regression tests(Thomas)
  1749. new datestyle variable(Thomas,Vadim,Martin)
  1750. more comparison operators for sorting types(Thomas)
  1751. new conversion functions(Thomas)
  1752. new more compact btree format(Vadim)
  1753. allow pg_dumpall to preserve database ownership(Bruce)
  1754. new SET GEQO=# and R_PLANS variable(Vadim)
  1755. old (!GEQO) optimizer can use right-sided plans (Vadim)
  1756. typechecking improvement in SQL parser(Bruce)
  1757. new SET, SHOW, RESET commands(Thomas,Vadim)
  1758. new connect database USER option
  1759. new destroydb -i option (Igor)
  1760. new dt and di psql commands (Darren)
  1761. SELECT "n" now escapes newline (A. Duursma)
  1762. new geometry conversion functions from old format (Thomas)
  1763. Source tree changes
  1764. -------------------
  1765. new configuration script(Marc)
  1766. readline configuration option added(Marc)
  1767. OS-specific configuration options removed(Marc)
  1768. new OS-specific template files(Marc)
  1769. no more need to edit Makefile.global(Marc)
  1770. re-arrange include files(Marc)
  1771. nextstep patches (Gregor Hoffleit)
  1772. removed WIN32-specific code(Bruce)
  1773. removed postmaster -e option, now only postgres -e option (Bruce)
  1774. merge duplicate library code in front/backends(Martin)
  1775. now works with eBones, international Kerberos(Jun)
  1776. more shared library support
  1777. c++ include file cleanup(Bruce)
  1778. warn about buggy flex(Bruce)
  1779. DG-UX, Ultrix, Irix, AIX portability fixes
  1780. </programlisting>
  1781. </para>
  1782. </sect2>
  1783. </sect1>
  1784. <sect1>
  1785. <title>Release v6.0</title>
  1786. <!--
  1787. <docinfo>
  1788. <authorgroup>
  1789. <author>
  1790. <firstname>Bruce</firstname>
  1791. <surname>Momjian</surname>
  1792. </author>
  1793. </authorgroup>
  1794. <date>
  1795. Wed Jan 29 00:19:54 EST 1997
  1796. </date>
  1797. </docinfo>
  1798. -->
  1799. <para>
  1800. A dump/restore is required for those wishing to migrate data from
  1801. previous releases of <productname>Postgres</productname>.
  1802. </para>
  1803. <sect2>
  1804. <title>Migration from v1.09 to v6.0</title>
  1805. <para>
  1806. This migration requires a complete dump of the 1.09 database and a
  1807. restore of the database in 6.0.
  1808. </para>
  1809. </sect2>
  1810. <sect2>
  1811. <title>Migration from pre-v1.09 to v6.0</title>
  1812. <para>
  1813. Those migrating from earlier 1.* releases should first upgrade to 1.09
  1814. because the COPY output format was improved from the 1.02 release.
  1815. </para>
  1816. </sect2>
  1817. <sect2>
  1818. <title>Detailed Change List</title>
  1819. <para>
  1820. <programlisting>
  1821. Bug Fixes
  1822. ---------
  1823. ALTER TABLE bug - running postgress process needs to re-read table definition
  1824. Allow vacuum to be run on one table or entire database(Bruce)
  1825. Array fixes
  1826. Fix array over-runs of memory writes(Kurt)
  1827. Fix elusive btree range/non-range bug(Dan)
  1828. Fix for hash indexes on some types like time and date
  1829. Fix for pg_log size explosion
  1830. Fix permissions on lo_export()(Bruce)
  1831. Fix unitialized reads of memory(Kurt)
  1832. Fixed ALTER TABLE ... char(3) bug(Bruce)
  1833. Fixed a few small memory leaks
  1834. Fixed EXPLAIN handling of options and changed full_path option name
  1835. Fixed output of group acl permissions
  1836. Memory leaks (hunt and destroy with tools like Purify(Kurt)
  1837. Minor improvements to rules system
  1838. NOTIFY fixes
  1839. New asserts for run-checking
  1840. Overhauled parser/analyze code to properly report errors and increase speed
  1841. Pg_dump -d now handles NULL's properly(Bruce)
  1842. Prevent SELECT NULL from crashing server (Bruce)
  1843. Properly report errors when INSERT ... SELECT columns did not match
  1844. Properly report errors when insert column names were not correct
  1845. Psql g filename now works(Bruce)
  1846. Psql fixed problem with multiple statements on one line with multiple outputs
  1847. Removed duplicate system oid's
  1848. SELECT * INTO TABLE . GROUP/ORDER BY gives unlink error if table exists(Bruce)
  1849. Several fixes for queries that crashed the backend
  1850. Starting quote in insert string errors(Bruce)
  1851. Submitting an empty query now returns empty status, not just " " query(Bruce)
  1852. Enhancements
  1853. ------------
  1854. Add EXPLAIN manual page(Bruce)
  1855. Add UNIQUE index capability(Dan)
  1856. Add hostname/user level access control rather than just hostname and user
  1857. Add synonym of != for &lt;&gt;(Bruce)
  1858. Allow "select oid,* from table"
  1859. Allow BY,ORDER BY to specify columns by number, or by non-alias table.column(Bruce)
  1860. Allow COPY from the frontend(Bryan)
  1861. Allow GROUP BY to use alias column name(Bruce)
  1862. Allow actual compression, not just reuse on the same page(Vadim)
  1863. Allow installation-configuration option to auto-add all local users(Bryan)
  1864. Allow libpq to distinguish between text value '' and null(Bruce)
  1865. Allow non-postgres users with createdb privs to destroydb's
  1866. Allow restriction on who can create C functions(Bryan)
  1867. Allow restriction on who can do backend COPY(Bryan)
  1868. Can shrink tables, pg_time and pg_log(Vadim & Erich)
  1869. Change debug level 2 to print queries only, changed debug heading layout(Bruce)
  1870. Change default decimal constant representation from float4 to float8(Bruce)
  1871. European date format now set when postmaster is started
  1872. Execute lowercase function names if not found with exact case
  1873. Fixes for aggregate/GROUP processing, allow 'select sum(func(x),sum(x+y) from z'
  1874. Gist now included in the distrubution(Marc)
  1875. Idend authentication of local users(Bryan)
  1876. Implement BETWEEN qualifier(Bruce)
  1877. Implement IN qualifier(Bruce)
  1878. Libpq has PQgetisnull()(Bruce)
  1879. Libpq++ improvements
  1880. New options to initdb(Bryan)
  1881. Pg_dump allow dump of oid's(Bruce)
  1882. Pg_dump create indexes after tables are loaded for speed(Bruce)
  1883. Pg_dumpall dumps all databases, and the user table
  1884. Pginterface additions for NULL values(Bruce)
  1885. Prevent postmaster from being run as root
  1886. Psql h and ? is now readable(Bruce)
  1887. Psql allow backslashed, semicolons anywhere on the line(Bruce)
  1888. Psql changed command prompt for lines in query or in quotes(Bruce)
  1889. Psql char(3) now displays as (bp)char in d output(Bruce)
  1890. Psql return code now more accurate(Bryan?)
  1891. Psql updated help syntax(Bruce)
  1892. Re-visit and fix vacuum(Vadim)
  1893. Reduce size of regression diffs, remove timezone name difference(Bruce)
  1894. Remove compile-time parameters to enable binary distributions(Bryan)
  1895. Reverse meaning of HBA masks(Bryan)
  1896. Secure Authentication of local users(Bryan)
  1897. Speed up vacuum(Vadim)
  1898. Vacuum now had VERBOSE option(Bruce)
  1899. Source tree changes
  1900. -------------------
  1901. All functions now have prototypes that are compared against the calls
  1902. Allow asserts to be disabled easly from Makefile.global(Bruce)
  1903. Change oid constants used in code to #define names
  1904. Decoupled sparc and solaris defines(Kurt)
  1905. Gcc -Wall compiles cleanly with warnings only from unfixable constructs
  1906. Major include file reorganization/reduction(Marc)
  1907. Make now stops on compile failure(Bryan)
  1908. Makefile restructuring(Bryan, Marc)
  1909. Merge bsdi_2_1 to bsdi(Bruce)
  1910. Monitor program removed
  1911. Name change from Postgres95 to PostgreSQL
  1912. New config.h file(Marc, Bryan)
  1913. PG_VERSION now set to 6.0 and used by postmaster
  1914. Portability additions, including Ultrix, DG/UX, AIX, and Solaris
  1915. Reduced the number of #define's, centeralized #define's
  1916. Remove duplicate OIDS in system tables(Dan)
  1917. Remove duplicate system catalog info or report mismatches(Dan)
  1918. Removed many os-specific #define's
  1919. Restructured object file generation/location(Bryan, Marc)
  1920. Restructured port-specific file locations(Bryan, Marc)
  1921. Unused/uninialized variables corrected
  1922. </programlisting>
  1923. </para>
  1924. </sect2>
  1925. </sect1>
  1926. <sect1>
  1927. <title>Release v1.09</title>
  1928. <!--
  1929. <docinfo>
  1930. <authorgroup>
  1931. <author>
  1932. <firstname>Bruce</firstname>
  1933. <surname>Momjian</surname>
  1934. </author>
  1935. </authorgroup>
  1936. <date>
  1937. Unknown
  1938. </date>
  1939. </docinfo>
  1940. -->
  1941. <para>
  1942. Sorry, we stopped keeping track of changes from 1.02 to 1.09.  Some of
  1943. the changes listed in 6.0 were actually included in the 1.02.1 to 1.09
  1944. releases.
  1945. </para>
  1946. </sect1>
  1947. <sect1>
  1948. <title>Release v1.02</title>
  1949. <!--
  1950. <docinfo>
  1951. <authorgroup>
  1952. <author>
  1953. <firstname>Bruce</firstname>
  1954. <surname>Momjian</surname>
  1955. </author>
  1956. </authorgroup>
  1957. <date>
  1958. Thu Aug  1 18:00:00 EDT 1996
  1959. </date>
  1960. </docinfo>
  1961. -->
  1962. <sect2>
  1963. <title>Migration from v1.02 to v1.02.1</title>
  1964. <para>
  1965. Here is a new migration file for 1.02.1.  It includes the 'copy' change
  1966. and a script to convert old ascii files.
  1967. </para>
  1968. <note>
  1969. <para>
  1970. The following notes are for the benefit of users who want to migrate
  1971. databases from postgres95 1.01 and 1.02 to postgres95 1.02.1.
  1972. </para>
  1973. <para>
  1974. If you are starting afresh with postgres95 1.02.1 and do not need
  1975. to migrate old databases, you do not need to read any further.
  1976. </para>
  1977. </note>
  1978. <para>
  1979. In order to upgrade older postgres95 version 1.01 or 1.02 databases to
  1980. version 1.02.1, the following steps are required:
  1981. </para>
  1982. <procedure>
  1983. <step>
  1984. <para>
  1985. Start up a new 1.02.1 postmaster
  1986. </para>
  1987. </step>
  1988. <step>
  1989. <para>
  1990. Add the new built-in functions and operators of 1.02.1 to 1.01 or 1.02
  1991.    databases.  This is done by running the new 1.02.1 server against
  1992.    your own 1.01 or 1.02 database and applying the queries attached at
  1993.    the end of thie file.   This can be done easily through psql.  If your
  1994.    1.01 or 1.02 database is named "testdb" and you have cut the commands
  1995.    from the end of this file and saved them in addfunc.sql:
  1996. <programlisting>
  1997. % psql testdb -f addfunc.sql
  1998. </programlisting>
  1999. Those upgrading 1.02 databases will get a warning when executing the
  2000. last two statements in the file because they are already present in 1.02.  This is
  2001. not a cause for concern.
  2002. </para>
  2003. </step>
  2004. </procedure>
  2005. </sect2>
  2006. <sect2>
  2007. <title>Dump/Reload Procedure</title>
  2008. <para>
  2009. If you are trying to reload a pg_dump or text-mode 'copy tablename to
  2010. stdout' generated with a previous version, you will need to run the
  2011. attached sed script on the ASCII file before loading it into the
  2012. database.  The old format used '.' as end-of-data, while '.' is now the
  2013. end-of-data marker.  Also, empty strings are now loaded in as '' rather
  2014. than NULL. See the copy manual page for full details.
  2015. <programlisting>
  2016. sed 's/^.$/\./g' &lt;in_file &gt;out_file
  2017. </programlisting>
  2018. </para>
  2019. <para>
  2020. If you are loading an older binary copy or non-stdout copy, there is no
  2021. end-of-data character, and hence no conversion necessary.
  2022. <programlisting>
  2023. -- following lines added by agc to reflect the case-insensitive
  2024. -- regexp searching for varchar (in 1.02), and bpchar (in 1.02.1)
  2025. create operator ~* (leftarg = bpchar, rightarg = text, procedure = texticregexeq);
  2026. create operator !~* (leftarg = bpchar, rightarg = text, procedure = texticregexne);
  2027. create operator ~* (leftarg = varchar, rightarg = text, procedure = texticregexeq);
  2028. create operator !~* (leftarg = varchar, rightarg = text, procedure = texticregexne);
  2029. </programlisting>
  2030. </para>
  2031. </sect2>
  2032. <sect2>
  2033. <title>Detailed Change List</title>
  2034. <para>
  2035. <programlisting>
  2036. Source code maintenance and development
  2037.  * worldwide team of volunteers
  2038.  * the source tree now in CVS at ftp.ki.net
  2039. Enhancements
  2040.  * psql (and underlying libpq library) now has many more options for
  2041.    formatting output, including HTML
  2042.  * pg_dump now output the schema and/or the data, with many fixes to
  2043.    enhance completeness.
  2044.  * psql used in place of monitor in administration shell scripts.
  2045.    monitor to be depreciated in next release.
  2046.  * date/time functions enhanced
  2047.  * NULL insert/update/comparison fixed/enhanced
  2048.  * TCL/TK lib and shell fixed to work with both tck7.4/tk4.0 and tcl7.5/tk4.1
  2049. Bug Fixes (almost too numerous to mention)
  2050.  * indexes
  2051.  * storage management
  2052.  * check for NULL pointer before dereferencing
  2053.  * Makefile fixes
  2054. New Ports
  2055.  * added SolarisX86 port
  2056.  * added BSDI 2.1 port
  2057.  * added DGUX port
  2058. </programlisting>
  2059. </para>
  2060. <!--
  2061. Contributors (appologies to any missed)
  2062.  * Kurt J. Lidl <lidl@va.pubnix.com> 
  2063. (missed in first run, but no less important)
  2064.  * Erich Stamberger <eberger@gewi.kfunigraz.ac.at>
  2065.  * Jason Wright <jason@shiloh.vnet.net>
  2066.  * Cees de Groot <C.deGroot@inter.NL.net>
  2067.  * ernst.molitor@uni-bonn.de
  2068.  * michael.siebenborn@ae3.Hypo.DE (Michael Siebenborn (6929))
  2069.  * Brian E. Gallew <geek+@cmu.edu>
  2070.  * Vadim B. Mikheev <vadim@sable.krasnoyarsk.su>
  2071.  * Adam Sussman <myddryn@vidya.com>
  2072.  * Chris Dunlop <chris@onthe.net.au>
  2073.  * Marc G. Fournier <scrappy@ki.net>
  2074.  * Dan McGuirk <mcguirk@indirect.com>
  2075.  * Dr_George_D_Detlefsen <drgeorge@ilt.com>
  2076.  * Erich Stamberger <eberger@gewi.kfunigraz.ac.at>
  2077.  * Massimo Dal Zotto <dz@cs.unitn.it>
  2078.  * Randy Kunkee <kunkee@Starbase.NeoSoft.COM>
  2079.  * Rick Weldon <rick@wisetech.com>
  2080.  * Thomas van Reimersdahl <reimersd@dali.techinfo.rwth-aachen.de>
  2081.  * david bennett <dave@bensoft.com>
  2082.  * ernst.molitor@uni-bonn.de
  2083.  * Julian Assange <proff@suburbia.net>
  2084.  * Bruce Momjian <maillist@candle.pha.pa.us>
  2085.  * Paul "Shag" Walmsley <ccshag@cclabs.missouri.edu>
  2086.  * "Alistair G. Crooks" <azcb0@sde.uts.amdahl.com>
  2087. -->
  2088. </sect2>
  2089. </sect1>
  2090. <sect1>
  2091. <title>Release v1.01</title>
  2092. <!--
  2093. <docinfo>
  2094. <authorgroup>
  2095. <author>
  2096. <firstname>Bruce</firstname>
  2097. <surname>Momjian</surname>
  2098. </author>
  2099. </authorgroup>
  2100. <date>
  2101. Fri Feb 23 18:20:36 PST 1996
  2102. </date>
  2103. </docinfo>
  2104. -->
  2105. <sect2>
  2106. <title>Migration from v1.0 to v1.01</title>
  2107. <para>
  2108. The following notes are for the benefit of users who want to migrate
  2109. databases from postgres95 1.0 to postgres95 1.01.  
  2110. </para>
  2111. <para>
  2112. If you are starting afresh with postgres95 1.01 and do not need
  2113. to migrate old databases, you do not need to read any further.
  2114. </para>
  2115. <para>
  2116. In order to postgres95 version 1.01 with databases created with
  2117. postgres95 version 1.0, the following steps are required:  
  2118. </para>
  2119. <procedure>
  2120. <step>
  2121. <para>
  2122. Set the definition of NAMEDATALEN in src/Makefile.global to 16
  2123.    and OIDNAMELEN to 20.
  2124. </para>
  2125. </step>
  2126. <step>
  2127. <para>
  2128. Decide whether you want to use Host based authentication.  
  2129. </para>
  2130. <substeps>
  2131. <step>
  2132. <para>
  2133. If you do, you must create a file name "pg_hba" in your top-level data
  2134.    directory (typically the value of your $PGDATA).  src/libpq/pg_hba
  2135.    shows an example syntax.
  2136. </para>
  2137. </step>
  2138. <step>
  2139. <para>
  2140. If you do not want host-based authentication, you can comment out
  2141.    the line
  2142. <programlisting>
  2143. HBA = 1
  2144. </programlisting>
  2145.    in src/Makefile.global
  2146. </para>
  2147. <para>
  2148.    Note that host-based authentication is turned on by default, and if
  2149.    you do not take steps A or B above, the out-of-the-box 1.01 will
  2150.    not allow you to connect to 1.0 databases.
  2151. </para>
  2152. </step>
  2153. </substeps>
  2154. </step>
  2155. <step>
  2156. <para>
  2157. Compile and install 1.01, but DO NOT do the initdb step.
  2158. </para>
  2159. </step>
  2160. <step>
  2161. <para>
  2162. Before doing anything else, terminate your 1.0 postmaster, and
  2163.    backup your existing $PGDATA directory.   
  2164. </para>
  2165. </step>
  2166. <step>
  2167. <para>
  2168. Set your PGDATA environment variable to your 1.0 databases, but set up
  2169.    path up so that 1.01 binaries are being used.
  2170. </para>
  2171. </step>
  2172. <step>
  2173. <para>
  2174. Modify the file $PGDATA/PG_VERSION from 5.0 to 5.1
  2175. </para>
  2176. </step>
  2177. <step>
  2178. <para>
  2179. Start up a new 1.01 postmaster
  2180. </para>
  2181. </step>
  2182. <step>
  2183. <para>
  2184. Add the new built-in functions and operators of 1.01 to 1.0
  2185.    databases.  This is done by running the new 1.01 server against
  2186.    your own 1.0 database and applying the queries attached and saving 
  2187.    in the file 1.0_to_1.01.sql.   This can be done easily through psql.
  2188.    If your 1.0 database is name "testdb":
  2189. <programlisting>
  2190. % psql testdb -f 1.0_to_1.01.sql
  2191. </programlisting>
  2192. and then execute the following commands (cut and paste from here):
  2193. <programlisting>
  2194. -- add builtin functions that are new to 1.01
  2195. create function int4eqoid (int4, oid) returns bool as 'foo'
  2196. language 'internal';
  2197. create function oideqint4 (oid, int4) returns bool as 'foo'
  2198. language 'internal';
  2199. create function char2icregexeq (char2, text) returns bool as 'foo'
  2200. language 'internal';
  2201. create function char2icregexne (char2, text) returns bool as 'foo'
  2202. language 'internal';
  2203. create function char4icregexeq (char4, text) returns bool as 'foo'
  2204. language 'internal';
  2205. create function char4icregexne (char4, text) returns bool as 'foo'
  2206. language 'internal';
  2207. create function char8icregexeq (char8, text) returns bool as 'foo'
  2208. language 'internal';
  2209. create function char8icregexne (char8, text) returns bool as 'foo'
  2210. language 'internal';
  2211. create function char16icregexeq (char16, text) returns bool as 'foo'
  2212. language 'internal';
  2213. create function char16icregexne (char16, text) returns bool as 'foo'
  2214. language 'internal';
  2215. create function texticregexeq (text, text) returns bool as 'foo'
  2216. language 'internal';
  2217. create function texticregexne (text, text) returns bool as 'foo'
  2218. language 'internal';
  2219. -- add builtin functions that are new to 1.01
  2220. create operator = (leftarg = int4, rightarg = oid, procedure = int4eqoid);
  2221. create operator = (leftarg = oid, rightarg = int4, procedure = oideqint4);
  2222. create operator ~* (leftarg = char2, rightarg = text, procedure = char2icregexeq);
  2223. create operator !~* (leftarg = char2, rightarg = text, procedure = char2icregexne);
  2224. create operator ~* (leftarg = char4, rightarg = text, procedure = char4icregexeq);
  2225. create operator !~* (leftarg = char4, rightarg = text, procedure = char4icregexne);
  2226. create operator ~* (leftarg = char8, rightarg = text, procedure = char8icregexeq);
  2227. create operator !~* (leftarg = char8, rightarg = text, procedure = char8icregexne);
  2228. create operator ~* (leftarg = char16, rightarg = text, procedure = char16icregexeq);
  2229. create operator !~* (leftarg = char16, rightarg = text, procedure = char16icregexne);
  2230. create operator ~* (leftarg = text, rightarg = text, procedure = texticregexeq);
  2231. create operator !~* (leftarg = text, rightarg = text, procedure = texticregexne);
  2232. </programlisting>
  2233. </para>
  2234. </step>
  2235. </procedure>
  2236. </sect2>
  2237. <sect2>
  2238. <title>Detailed Change List</title>
  2239. <para>
  2240. <programlisting>
  2241. Incompatibilities:
  2242.  * 1.01 is backwards compatible with 1.0 database provided the user
  2243.    follow the steps outlined in the MIGRATION_from_1.0_to_1.01 file.
  2244.    If those steps are not taken, 1.01 is not compatible with 1.0 database.
  2245. Enhancements:
  2246.  * added PQdisplayTuples() to libpq and changed monitor and psql to use it
  2247.  * added NeXT port (requires SysVIPC implementation)
  2248.  * added CAST .. AS ... syntax
  2249.  * added ASC and DESC keywords
  2250.  * added 'internal' as a possible language for CREATE FUNCTION
  2251.    internal functions are C functions which have been statically linked
  2252.    into the postgres backend.
  2253.  * a new type "name" has been added for system identifiers (table names,
  2254.    attribute names, etc.)  This replaces the old char16 type.   The
  2255.    of name is set by the NAMEDATALEN #define in src/Makefile.global
  2256.  * a readable reference manual that describes the query language.
  2257.  * added host-based access control.  A configuration file ($PGDATA/pg_hba)
  2258.    is used to hold the configuration data.  If host-based access control
  2259.    is not desired, comment out HBA=1 in src/Makefile.global.
  2260.  * changed regex handling to be uniform use of Henry Spencer's regex code
  2261.    regardless of platform.  The regex code is included in the distribution
  2262.  * added functions and operators for case-insensitive regular expressions. 
  2263.    The operators are ~* and !~*.
  2264.  * pg_dump uses COPY instead of SELECT loop for better performance
  2265. Bug fixes:
  2266.  * fixed an optimizer bug that was causing core dumps when 
  2267.    functions calls were used in comparisons in the WHERE clause
  2268.  * changed all uses of getuid to geteuid so that effective uids are used
  2269.  * psql now returns non-zero status on errors when using -c
  2270.  * applied public patches 1-14
  2271. </programlisting>
  2272. </para>
  2273. </sect2>
  2274. </sect1>
  2275. <sect1>
  2276. <title>Release v1.0</title>
  2277. <!--
  2278. <docinfo>
  2279. <authorgroup>
  2280. <author>
  2281. <firstname>Bruce</firstname>
  2282. <surname>Momjian</surname>
  2283. </author>
  2284. </authorgroup>
  2285. <date>
  2286. Tue Sep  5 11:24:11 PDT 1995
  2287. </date>
  2288. </docinfo>
  2289. -->
  2290. <sect2>
  2291. <title>Detailed Change List</title>
  2292. <para>
  2293. <programlisting>
  2294. Copyright change:
  2295.  * The copyright of <productname>Postgres</productname> 1.0 has been loosened to be freely modifiable
  2296.    and modifiable for any purpose.  Please read the COPYRIGHT file.
  2297.    Thanks to Professor Michael Stonebraker for making this possible.
  2298. Incompatibilities:
  2299.  *  date formats have to be MM-DD-YYYY (or DD-MM-YYYY if you're using
  2300.    EUROPEAN STYLE).  This follows SQL-92 specs.
  2301.  *  "delimiters" is now a keyword
  2302. Enhancements:
  2303.  *  sql LIKE syntax has been added
  2304.  *  copy command now takes an optional USING DELIMITER specification.
  2305.    delimiters can be any single-character string. 
  2306.  *  IRIX 5.3 port has been added.
  2307.    Thanks to Paul Walmsley and others.
  2308.  *  updated pg_dump to work with new libpq
  2309.  *  d has been added psql 
  2310.    Thanks to Keith Parks
  2311.  *  regexp performance for architectures that use POSIX regex has been
  2312.    improved due to caching of precompiled patterns.
  2313.    Thanks to Alistair Crooks
  2314.  *  a new version of libpq++
  2315.    Thanks to William Wanders
  2316. Bug fixes:
  2317.  *  arbitrary userids can be specified in the createuser script
  2318.  *  c to connect to other databases in psql now works.
  2319.  *  bad pg_proc entry for float4inc() is fixed
  2320.  *  users with usecreatedb field set can now create databases without
  2321.    having to be usesuper
  2322.  *  remove access control entries when the entry no longer has any
  2323.    permissions
  2324.  *  fixed non-portable datetimes implementation
  2325.  *  added kerberos flags to the src/backend/Makefile
  2326.  *  libpq now works with kerberos
  2327.  *  typographic errors in the user manual have been corrected.
  2328.  *  btrees with multiple index never worked, now we tell you they don't
  2329.    work when you try to use them
  2330. </programlisting>
  2331. </para>
  2332. </sect2>
  2333. </sect1>
  2334. <sect1>
  2335. <title><productname>Postgres95</productname> Beta 0.03</title>
  2336. <!--
  2337. <docinfo>
  2338. <authorgroup>
  2339. <author>
  2340. <firstname>Bruce</firstname>
  2341. <surname>Momjian</surname>
  2342. </author>
  2343. </authorgroup>
  2344. <date>
  2345. Fri Jul 21 14:49:31 PDT 1995
  2346. </date>
  2347. </docinfo>
  2348. -->
  2349. <sect2>
  2350. <title>Detailed Change List</title>
  2351. <para>
  2352. <programlisting>
  2353. Incompatible changes:
  2354.  * BETA-0.3 IS INCOMPATIBLE WITH DATABASES CREATED WITH PREVIOUS VERSIONS
  2355.    (due to system catalog changes and indexing structure changes).
  2356.  * double-quote (") is deprecated as a quoting character for string literals;
  2357.    you need to convert them to single quotes (').
  2358.  * name of aggregates (eg. int4sum) are renamed in accordance with the
  2359.    SQL standard (eg. sum).
  2360.  * CHANGE ACL syntax is replaced by GRANT/REVOKE syntax.
  2361.  * float literals (eg. 3.14) are now of type float4 (instead of float8 in
  2362.    previous releases); you might have to do typecasting if you depend on it
  2363.    being of type float8.  If you neglect to do the typecasting and you assign
  2364.    a float literal to a field of type float8, you may get incorrect values
  2365.    stored!
  2366.  * LIBPQ has been totally revamped so that frontend applications
  2367.    can connect to multiple backends
  2368.  * the usesysid field in pg_user has been changed from int2 to int4 to
  2369.    allow wider range of Unix user ids.
  2370.  * the netbsd/freebsd/bsd o/s ports have been consolidated into a
  2371.    single BSD44_derived port.  (thanks to Alistair Crooks)
  2372. SQL standard-compliance (the following details changes that makes postgres95
  2373. more compliant to the SQL-92 standard):
  2374.  * the following SQL types are now built-in: smallint, int(eger), float, real,
  2375.    char(N), varchar(N), date and time.
  2376.    The following are aliases to existing postgres types:
  2377. smallint -> int2
  2378. integer, int -> int4
  2379. float, real  -> float4
  2380.    char(N) and varchar(N) are implemented as truncated text types. In
  2381.    addition, char(N) does blank-padding. 
  2382.  * single-quote (') is used for quoting string literals; '' (in addition to
  2383.    ') is supported as means of inserting a single quote in a string
  2384.  * SQL standard aggregate names (MAX, MIN, AVG, SUM, COUNT) are used
  2385.    (Also, aggregates can now be overloaded, i.e. you can define your
  2386.    own MAX aggregate to take in a user-defined type.)
  2387.  * CHANGE ACL removed. GRANT/REVOKE syntax added.  
  2388.    - Privileges can be given to a group using the "GROUP" keyword.
  2389. For example:
  2390. GRANT SELECT ON foobar TO GROUP my_group;
  2391. The keyword 'PUBLIC' is also supported to mean all users.
  2392. Privileges can only be granted or revoked to one user or group
  2393. at a time.  
  2394. "WITH GRANT OPTION" is not supported.  Only class owners can change
  2395. access control
  2396.    - The default access control is to to grant users readonly access.
  2397.      You must explicitly grant insert/update access to users.  To change
  2398.      this, modify the line in 
  2399. src/backend/utils/acl.h 
  2400.      that defines ACL_WORLD_DEFAULT 
  2401. Bug fixes:
  2402.  * the bug where aggregates of empty tables were not run has been fixed. Now,
  2403.    aggregates run on empty tables will return the initial conditions of the
  2404.    aggregates. Thus, COUNT of an empty table will now properly return 0.
  2405.    MAX/MIN of an empty table will return a tuple of value NULL. 
  2406.  * allow the use of ; inside the monitor
  2407.  * the LISTEN/NOTIFY asynchronous notification mechanism now work
  2408.  * NOTIFY in rule action bodies now work
  2409.  * hash indices work, and access methods in general should perform better.
  2410.    creation of large btree indices should be much faster.  (thanks to Paul
  2411.    Aoki)
  2412. Other changes and enhancements:
  2413.  * addition of an EXPLAIN statement used for explaining the query execution
  2414.    plan (eg. "EXPLAIN SELECT * FROM EMP" prints out the execution plan for
  2415.    the query).
  2416.  * WARN and NOTICE messages no longer have timestamps on them. To turn on
  2417.    timestamps of error messages, uncomment the line in
  2418.    src/backend/utils/elog.h:
  2419. /* define ELOG_TIMESTAMPS */ 
  2420.  * On an access control violation, the message
  2421. "Either no such class or insufficient privilege"
  2422.    will be given.  This is the same message that is returned when
  2423.    a class is not found.  This dissuades non-privileged users from
  2424.    guessing the existence of privileged classes.
  2425.  * some additional system catalog changes have been made that are not
  2426.    visible to the user.
  2427. libpgtcl changes:
  2428.  * The -oid option has been added to the "pg_result" tcl command.
  2429.    pg_result -oid returns oid of the last tuple inserted.   If the
  2430.    last command was not an INSERT, then pg_result -oid returns "".
  2431.  * the large object interface is available as pg_lo* tcl commands:
  2432.    pg_lo_open, pg_lo_close, pg_lo_creat, etc.
  2433. Portability enhancements and New Ports:
  2434.  * flex/lex problems have been cleared up.  Now, you should be able to use
  2435.    flex instead of lex on any platforms.  We no longer make assumptions of
  2436.    what lexer you use based on the platform you use. 
  2437.  * The Linux-ELF port is now supported.  Various configuration have been 
  2438.    tested:  The following configuration is known to work:
  2439. kernel 1.2.10, gcc 2.6.3, libc 4.7.2, flex 2.5.2, bison 1.24
  2440.    with everything in ELF format,
  2441. New utilities:
  2442.  * ipcclean added to the distribution
  2443.    ipcclean usually does not need to be run, but if your backend crashes
  2444.    and leaves shared memory segments hanging around, ipcclean will
  2445.    clean them up for you.
  2446. New documentation:
  2447.  * the user manual has been revised and libpq documentation added.
  2448. </programlisting>
  2449. </para>
  2450. </sect2>
  2451. </sect1>
  2452. <sect1>
  2453. <title><productname>Postgres95</productname> Beta 0.02</title>
  2454. <!--
  2455. <docinfo>
  2456. <authorgroup>
  2457. <author>
  2458. <firstname>Bruce</firstname>
  2459. <surname>Momjian</surname>
  2460. </author>
  2461. </authorgroup>
  2462. <date>
  2463. Thu May 25 16:54:46 PDT 1995
  2464. </date>
  2465. </docinfo>
  2466. -->
  2467. <sect2>
  2468. <title>Detailed Change List</title>
  2469. <para>
  2470. <programlisting>
  2471. Incompatible changes:
  2472.  * The SQL statement for creating a database is 'CREATE DATABASE' instead
  2473.    of 'CREATEDB'. Similarly, dropping a database is 'DROP DATABASE' instead
  2474.    of 'DESTROYDB'. However, the names of the executables 'createdb' and 
  2475.    'destroydb' remain the same.
  2476.  
  2477. New tools:
  2478.  * pgperl - a Perl (4.036) interface to Postgres95
  2479.  * pg_dump - a utility for dumping out a postgres database into a
  2480. script file containing query commands. The script files are in a ASCII
  2481. format and can be used to reconstruct the database, even on other
  2482. machines and other architectures. (Also good for converting
  2483. a Postgres 4.2 database to Postgres95 database.)
  2484. The following ports have been incorporated into postgres95-beta-0.02:
  2485.  * the NetBSD port by Alistair Crooks
  2486.  * the AIX port by Mike Tung
  2487.  * the Windows NT port by Jon Forrest (more stuff but not done yet)
  2488.  * the Linux ELF port by Brian Gallew
  2489. The following bugs have been fixed in postgres95-beta-0.02:
  2490.  * new lines not escaped in COPY OUT and problem with COPY OUT when first
  2491.    attribute is a '.' 
  2492.  * cannot type return to use the default user id in createuser
  2493.  * SELECT DISTINCT on big tables crashes
  2494.  * Linux installation problems
  2495.  * monitor doesn't allow use of 'localhost' as PGHOST
  2496.  * psql core dumps when doing c or l
  2497.  * the "pgtclsh" target missing from src/bin/pgtclsh/Makefile
  2498.  * libpgtcl has a hard-wired default port number
  2499.  * SELECT DISTINCT INTO TABLE hangs
  2500.  * CREATE TYPE doesn't accept 'variable' as the internallength
  2501.  * wrong result using more than 1 aggregate in a SELECT
  2502. </programlisting>
  2503. </para>
  2504. </sect2>
  2505. </sect1>
  2506. <sect1>
  2507. <title><productname>Postgres95</productname> Beta 0.01</title>
  2508. <!--
  2509. <docinfo>
  2510. <authorgroup>
  2511. <author>
  2512. <firstname>Bruce</firstname>
  2513. <surname>Momjian</surname>
  2514. </author>
  2515. </authorgroup>
  2516. <date>
  2517. Mon May 1 19:03:10 PDT 1995
  2518. </date>
  2519. </docinfo>
  2520. -->
  2521. <para>
  2522. Initial release.
  2523. </para>
  2524. </sect1>
  2525.   <sect1>
  2526.    <title>Timing Results</title>
  2527.    <para>
  2528.     These timing results are from running the regression test with the commands
  2529.     <programlisting>
  2530. % cd src/test/regress
  2531. % make all
  2532. % time make runtest
  2533.     </programlisting>
  2534.    </para>
  2535.    <para>
  2536.     Timing under Linux 2.0.27 seems to have a roughly 5% variation from run
  2537.     to run, presumably due to the scheduling vagaries of multitasking systems.
  2538.    </para>
  2539.    <sect2>
  2540.     <title>v6.5</title>
  2541.     <para>
  2542.      As has been the case for previous releases, timing between
  2543.      releases is not directly comparable since new regression tests
  2544.      have been added. In general, v6.5 is faster than previous
  2545.      releases.
  2546.     </para>
  2547.     <para>
  2548.      Timing with <function>fsync()</function> disabled:
  2549.      <programlisting>
  2550.   Time   System
  2551.   02:00  Dual Pentium Pro 180, 224MB, UW-SCSI, Linux 2.0.36, gcc 2.7.2.3 -O2 -m486
  2552.   04:38  Sparc Ultra 1 143MHz, 64MB, Solaris 2.6
  2553.      </programlisting>
  2554.     </para>
  2555.     <para>
  2556.      Timing with <function>fsync()</function> enabled:
  2557.      <programlisting>
  2558.   Time   System
  2559.   04:21  Dual Pentium Pro 180, 224MB, UW-SCSI, Linux 2.0.36, gcc 2.7.2.3 -O2 -m486
  2560.      </programlisting>
  2561.      For the linux system above, using UW-SCSI disks rather than (older) IDE
  2562.      disks leads to a 50% improvement in speed on the regression test.
  2563.     </para>
  2564.    </sect2>
  2565. <sect2>
  2566. <title>v6.4beta</title>
  2567. <para>
  2568. The times for this release are not directly comparable to those for previous releases
  2569. since some additional regression tests have been included.
  2570. In general, however, v6.4 should be slightly faster than the previous release (thanks, Bruce!).
  2571. </para>
  2572. <para>
  2573. <programlisting>
  2574.   Time   System
  2575.   02:26  Dual Pentium Pro 180, 96MB, UW-SCSI, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
  2576. </programlisting>
  2577. </para>
  2578. </sect2>
  2579. <sect2>
  2580. <title>v6.3</title>
  2581. <para>
  2582. The times for this release are not directly comparable to those for previous releases
  2583. since some additional regression tests have been included and some obsolete tests involving
  2584. time travel have been removed.
  2585. In general, however, v6.3 is substantially faster than previous releases (thanks, Bruce!).
  2586. </para>
  2587. <para>
  2588. <programlisting>
  2589.   Time   System
  2590.   02:30  Dual Pentium Pro 180, 96MB, UW-SCSI, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
  2591.   04:12  Dual Pentium Pro 180, 96MB, EIDE, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
  2592. </programlisting>
  2593. </para>
  2594. </sect2>
  2595. <sect2>
  2596. <title>v6.1</title>
  2597. <para>
  2598. <programlisting>
  2599.   Time   System
  2600.   06:12  Pentium Pro 180, 32MB, EIDE, Linux 2.0.30, gcc 2.7.2 -O2 -m486
  2601.   12:06  P-100, 48MB, Linux 2.0.29, gcc
  2602.   39:58  Sparc IPC 32MB, Solaris 2.5, gcc 2.7.2.1 -O -g
  2603. </programlisting>
  2604. </para>
  2605. </sect2>
  2606. </sect1>
  2607. </chapter>
  2608. <!-- Keep this comment at the end of the file
  2609. Local variables:
  2610. mode: sgml
  2611. sgml-omittag:nil
  2612. sgml-shorttag:t
  2613. sgml-minimize-attributes:nil
  2614. sgml-always-quote-attributes:t
  2615. sgml-indent-step:1
  2616. sgml-indent-data:t
  2617. sgml-parent-document:nil
  2618. sgml-default-dtd-file:"./reference.ced"
  2619. sgml-exposed-tags:nil
  2620. sgml-local-catalogs:"/usr/lib/sgml/catalog"
  2621. sgml-local-ecat-files:nil
  2622. End:
  2623. -->