Версия для печати

Архив документации на OpenNet.ru / Раздел "Базы данных, SQL" (Многостраничная версия)
Руководство администратора по PostgreSQL

The PostgreSQL Development Team

Под редакцией

Thomas Lockhart

Авторское право на PostgreSQL принадлежит © 1996-9 Postgres Global Development Group.


Исходный вариант взят из PostgreSQL v6.5.3 по адресу www.postgreSQL.org.
Перевод выполнил Юрий Козлов, очень рад замечаниям по адресу off@tsinet.ru.
17 Ноя Срд 19:18:58 MSK 1999
Сергиев-Посадская LUG spslug.sposad.ru
Оглавление
Резюме
1. Введение
Ресурсы
Терминология
Нотация
О Y2K
Авторские права и торговые марки
2. Переносимость
Поддерживаемые платформы на данный момент
Неподдерживаемые платформы
3. Опции конфигурации
Параметры конфигурации (configure)
Параметры сборки (make)
Поддержка локали
Какая польза?
Какие недостатки?
Kerberos идентификация
Доступность
Установка
Работа
4. Схема размещения системы
5. Установка
Требования для запуска Postgres
Процедура установки
Использование Postgres
Следующий шаг
Замечания по переносу
6. Установка на Win32
Сборка библиотек
Установка библиотек
Использование библиотек
7. Рабочая среда
Использование Postgres из Unix
Запуск postmaster
Использование pg_options
Распознаваемые опции
8. Безопасность
Аутентификация пользователя
Имена пользователей и группы
Создание пользователей
Создание групп
Назначение пользователей в группы
Контроль доступа
Функции и правила
Функции
Правила
Предостережения
9. Добавление и удаление пользователей
10. Управление диском
Дополнительные местоположения
11. Управление базой данных
Создание базы данных
Доступ к базе данных
Уничтожение базы данных
Резервное копирование и восстановление
Огромные базы данных
12. Поиск неисправностей
Отказ запуска postmaster
Проблемы подключения клиента
Сообщения отладки
pg_options
13. Восстановление базы данных
14. Регрессивный тест
Регрессивная среда
Схема размещения каталогов
Процедура регрессивного тестирования
Регрессивный анализ
Расхождения в сообщениях об ошибках
OID различия
Различия в дате и времени
Различия в числах с плавающей запятой
Различия в многоугольниках
Random различия
“Ожидаемые” файлы
15. Замечания по выпускам
Release 6.5.1
Migration to v6.5.1
Detailed Change List
Release 6.5
Migration to v6.5
Detailed Change List
Release 6.4.2
Migration to v6.4.2
Detailed Change List
Release 6.4.1
Migration to v6.4.1
Detailed Change List
Release 6.4
Migration to v6.4
Detailed Change List
Release 6.3.2
Detailed Change List
Release 6.3.1
Detailed Change List
Release 6.3
Migration to v6.3
Detailed Change List
Release 6.2.1
Migration from v6.2 to v6.2.1
Detailed Change List
Release 6.2
Migration from v6.1 to v6.2
Migration from v1.x to v6.2
Detailed Change List
Release 6.1.1
Migration from v6.1 to v6.1.1
Detailed Change List
Release 6.1
Migration to v6.1
Detailed Change List
Release v6.0
Migration from v1.09 to v6.0
Migration from pre-v1.09 to v6.0
Detailed Change List
Release v1.09
Release v1.02
Migration from v1.02 to v1.02.1
Dump/Reload Procedure
Detailed Change List
Release v1.01
Migration from v1.0 to v1.01
Detailed Change List
Release v1.0
Detailed Change List
Postgres95 Beta 0.03
Detailed Change List
Postgres95 Beta 0.02
Detailed Change List
Postgres95 Beta 0.01
Расчёт времени результатов
v6.5
v6.4beta
v6.3
v6.1
Библиография

Руководство администратора по PostgreSQL

The PostgreSQL Development Team

Под редакцией

Thomas Lockhart

Авторское право на PostgreSQL принадлежит © 1996-9 Postgres Global Development Group.


Исходный вариант взят из PostgreSQL v6.5.3 по адресу www.postgreSQL.org.
Перевод выполнил Юрий Козлов, очень рад замечаниям по адресу off@tsinet.ru.
17 Ноя Срд 19:18:58 MSK 1999
Сергиев-Посадская LUG spslug.sposad.ru
Оглавление
Резюме
1. Введение
Ресурсы
Терминология
Нотация
О Y2K
Авторские права и торговые марки
2. Переносимость
Поддерживаемые платформы на данный момент
Неподдерживаемые платформы
3. Опции конфигурации
Параметры конфигурации (configure)
Параметры сборки (make)
Поддержка локали
Какая польза?
Какие недостатки?
Kerberos идентификация
Доступность
Установка
Работа
4. Схема размещения системы
5. Установка
Требования для запуска Postgres
Процедура установки
Использование Postgres
Следующий шаг
Замечания по переносу
6. Установка на Win32
Сборка библиотек
Установка библиотек
Использование библиотек
7. Рабочая среда
Использование Postgres из Unix
Запуск postmaster
Использование pg_options
Распознаваемые опции
8. Безопасность
Аутентификация пользователя
Имена пользователей и группы
Создание пользователей
Создание групп
Назначение пользователей в группы
Контроль доступа
Функции и правила
Функции
Правила
Предостережения
9. Добавление и удаление пользователей
10. Управление диском
Дополнительные местоположения
11. Управление базой данных
Создание базы данных
Доступ к базе данных
Уничтожение базы данных
Резервное копирование и восстановление
Огромные базы данных
12. Поиск неисправностей
Отказ запуска postmaster
Проблемы подключения клиента
Сообщения отладки
pg_options
13. Восстановление базы данных
14. Регрессивный тест
Регрессивная среда
Схема размещения каталогов
Процедура регрессивного тестирования
Регрессивный анализ
Расхождения в сообщениях об ошибках
OID различия
Различия в дате и времени
Различия в числах с плавающей запятой
Различия в многоугольниках
Random различия
“Ожидаемые” файлы
15. Замечания по выпускам
Release 6.5.1
Migration to v6.5.1
Detailed Change List
Release 6.5
Migration to v6.5
Detailed Change List
Release 6.4.2
Migration to v6.4.2
Detailed Change List
Release 6.4.1
Migration to v6.4.1
Detailed Change List
Release 6.4
Migration to v6.4
Detailed Change List
Release 6.3.2
Detailed Change List
Release 6.3.1
Detailed Change List
Release 6.3
Migration to v6.3
Detailed Change List
Release 6.2.1
Migration from v6.2 to v6.2.1
Detailed Change List
Release 6.2
Migration from v6.1 to v6.2
Migration from v1.x to v6.2
Detailed Change List
Release 6.1.1
Migration from v6.1 to v6.1.1
Detailed Change List
Release 6.1
Migration to v6.1
Detailed Change List
Release v6.0
Migration from v1.09 to v6.0
Migration from pre-v1.09 to v6.0
Detailed Change List
Release v1.09
Release v1.02
Migration from v1.02 to v1.02.1
Dump/Reload Procedure
Detailed Change List
Release v1.01
Migration from v1.0 to v1.01
Detailed Change List
Release v1.0
Detailed Change List
Postgres95 Beta 0.03
Detailed Change List
Postgres95 Beta 0.02
Detailed Change List
Postgres95 Beta 0.01
Расчёт времени результатов
v6.5
v6.4beta
v6.3
v6.1
Библиография

Руководство администратора по PostgreSQLПредыдущий 

Библиография

Избранные руководства и лекции по SQL и Postgres.

SQLСправочные руководства

The Practical SQL Handbook , Judity Bowman, Sandra Emerson, and Marcy Damovsky, ISBN: 0-201-44787-8, 1996, Addison-Wesley.

A Guide to the SQL Standard , C. J. Date and Hugh Darwen, ISBN: 0-201-96426-0, 1997, Addison-Wesley.

An Введение to Database Systems , C. J. Date, 1994, Addison-Wesley.

Understanding the New SQL , Jim Melton and Alan R. Simon, ISBN: 1-55860-245-3, 1993, Morgan Kaufmann.

Principles of Database and Knowledge , Jeffrey D. Ullman, Computer Science Press , 1988 .

Документация по PostgreSQL

The PostgreSQL Administrator's Guide , 1998-10-01, The PostgreSQL Global Development Group.

The PostgreSQL Developer's Guide , 1998-10-01, The PostgreSQL Global Development Group.

The PostgreSQL Programmer's Guide , 1998-10-01, The PostgreSQL Global Development Group.

The PostgreSQL Tutorial Introduction , 1998-10-01, The PostgreSQL Global Development Group.

The PostgreSQL User's Guide , 1998-10-01, The PostgreSQL Global Development Group.

Enhancement of the ANSI SQL Implementation of PostgreSQL , Stefan Simkovics, November 29, 1998, Department of Information Systems, Vienna University of Technology .

The Postgres95 User Manual , A. Yu and J. Chen, The POSTGRES Group , Sept. 5, 1995, University of California, Berkeley CA.

Записки и статьи

Partial indexing in POSTGRES: research project , Nels Olson, 1993, ISSN: UCB Engin T7.49.1993 O676, University of California, Berkeley CA.

A Unified Framework for Version Modeling Using Production Rules in a Database System , L. Ong and J. Goh, April, 1990, ISSN: ERL Technical Memorandum M90/33, University of California, Berkeley CA.

The Postgres Data Model , L. Rowe and M. Stonebraker.

Generalized partial indexes , P. Seshadri and A. Swami, 1995, ISSN: Cat. No.95CH35724, IEEE Computer Society Press.

The Design of Postgres , M. Stonebraker and L. Rowe.

The Design of the Postgres Rules System, M. Stonebraker, E. Hanson, and C. H. Hong.

The Postgres Storage System , M. Stonebraker.

A Commentary on the Postgres Rules System , M. Stonebraker, M. Hearst, and S. Potamianos.

The case for partial indexes (DBMS) , M. Stonebraker.

The Implementation of Postgres , M. Stonebraker, L. A. Rowe, and M. Hirohama.

On Rules, Procedures, Caching and Views in Database Systems , M. Stonebraker and et al.


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 3. Опции конфигурации

Оглавление
Параметры конфигурации (configure)
Параметры сборки (make)
Поддержка локали
Kerberos идентификация

Параметры конфигурации (configure)

Полный набор параметров, доступных в configure, можно получить, набрав

    $ ./configure --help
   

Следующие параметры могут заинтересовать установщиков:

Каталог и имена файлов:
  --prefix=PREFIX         устанавливать архитектурно-независимые файлы в PREFIX
                          [/usr/local/pgsql]
  --bindir=DIR            исполняемые пользователем в DIR [EPREFIX/bin]
  --libdir=DIR            библиотеки объектных кодов в DIR [EPREFIX/lib]
  --includedir=DIR        Заговочные файлы C в DIR [PREFIX/include]
  --mandir=DIR            документация man в DIR [PREFIX/man]
Свойства и пакеты:
  --disable-FEATURE       не включать FEATURE (тоже что и --enable-FEATURE=no)
  --enable-FEATURE[=ARG]  включать FEATURE [ARG=yes]
  --with-PACKAGE[=ARG]    использовать PACKAGE [ARG=yes]
  --without-PACKAGE       не использовать PACKAGE (тоже что и --with-PACKAGE=no)
Опции --enable and --with распознаются:
  --with-template=template
                          использовать файл шаблона операционной системы
                              смотри каталог template
  --with-includes=incdir
                          заголовочные файлы сайта для tk/tcl, и т.д. в DIR
  --with-libs=incdir
                          также искать библиотеки в DIR
  --with-libraries=libdir
                          также искать библиотеки в DIR
  --enable-locale         разрешить поддержку локали
  --enable-recode         разрешить кириллическую перекодировку
  --with-mb=encoding
                          разрешить многобайтовую поддержку
  --with-pgport=portnum
                          изменить порт запуска по умолчанию
  --with-maxbackends=n
                          установить по умолчанию максимальное число серверных процессов
  --with-tcl              построить интерфейсы Tcl и pgtclsh
  --with-tclconfig=tcldir
                          tclConfig.sh и tkConfig.sh в DIR
  --with-perl             построить интерфейс Perl
  --with-odbc             построить пакет драйвера ODBC
  --with-odbcinst=odbcdir
                          изменить каталог по умолчанию для odbcinst.ini
  --enable-cassert        разрешить проверки утверждения (для отладки)
  --with-CC=compiler
                          использовать указанный компилятор C
  --with-CXX=compiler
                          использовать определённый компилятор C++
  --without-CXX           недопускать создания кода C++
   

На некоторых системах могут быть проблемы при построении определённых свойств Postgres. Например, системам с испорченным компилятором C++ могут потребоваться определённые --without-CXX чтобы указать процедуре сборки пропускать конструкции libpq++.


Руководство администратора по PostgreSQLПредыдущийГлава 3. Опции конфигурацииСледующий

Параметры сборки (make)

Многие инсталяционные параметры могут быть установлены при стадии сборки установки Postgres.

В большинстве случаев, эти параметры нужно помещать в файл, Makefile.custom, предназначенный как раз для этих целей. По умолчанию, дистрибутив не содержит этот необязательный файл, поэтому тебе нужно создать его с помощью любимого редактора. При модернизации установки, можно перед сборкой просто скопировать старый Makefile.custom в новую установку.

    make [ variable=value [,...] ]
   

Некоторые переменные, которые могут быть указаны здесь:

POSTGRESDIR

Корень дерева установки.

BINDIR

Местоположение приложений и утилит.

LIBDIR

Местоположение объектных библиотек, включая разделяемые библиотеки.

HEADERDIR

Местоположение заголовочных файлов.

ODBCINST

Местоположение для всей установки файла конфигурации psqlODBC (ODBC).

Существуют ещё необязательные параметры, которые не так широко используются. Многие из них описаны ниже в соответствии с разработкой кода сервера Postgres.

CFLAGS

Установка флагов для компилятора C. Должны назначаться с "+=", чтобы сохранить уместные параметры по умолчанию.

YFLAGS

Установка флагов для разборщиков синтаксиса yacc/bison. -v может использоваться для помощи в определении проблем при сборки новым разборщиком. Должны назначаться с "+=", чтобы сохранить уместные параметры по умолчанию.

USE_TCL

Разрешить сборку Tcl интерфейса.

HSTYLE

Листы в формате DocBook HTML для сборки документации с нуля. Не используется, если только ты не разрабатываешь новую документацию из DocBook-совместимых SGML исходных текстов doc/src/sgml/.

PSTYLE

Листы в формате DocBook для сборки печатной документации с нуля. Не используется, если только ты не разрабатываешь новую документацию из DocBook-совместимых SGML исходных текстов doc/src/sgml/.

Вот пример Makefile.custom для системы PentiumPro Linux:

# Makefile.custom
# Thomas Lockhart 1999-06-01

POSTGRESDIR= /opt/postgres/current
CFLAGS+= -m486 -O2

# документация

HSTYLE= /home/tgl/SGML/db118.d/docbook/html
PSTYLE= /home/tgl/SGML/db118.d/docbook/print
   


Руководство администратора по PostgreSQLПредыдущийГлава 3. Опции конфигурацииСледующий

Поддержка локали

Замечание: Написал Oleg Bartunov. Смотри на web странице Олега дополнительную информацию про локаль и поддержку русского языка.

Во время выполнения проекта для компании в Москве, Россия, я столкнулся с проблемой postgresql - он не поддерживал национальные алфавиты. Поискав возможные пути обхода, я решил разработать поддержку локали сам. Я не программист на C, но у меня уже был некоторый опыт программирования с локалью, когда я работал с perl (отладка) и glimpse. После нескольких дней ковыряния исходников Postgres, я сделал несколько маленьких правочек в src/backend/utils/adt/varlena.c и src/backend/main/main.c и получил то что хотел! Я сделал поддержку только для LC_CTYPE и LC_COLLATE, но позднее LC_MONETARY была добавлена другими. Я получил много сообщений от людей об этом патче, и поэтому решил послать его разработчикам, и (к моему удивлению) он был включён в дистрибутив Postgres.

Люди часто жаловались, что локаль у них не работает. Вот несколько распространённых ошибок:

Какая польза?

Ты можешь использовать ~* и order с операторами для строк, содержащих символы национальных алфавитов. Не английским пользователям определённо это нужно. Если ты не хочешь использовать свойство локали, просто удали определение переменной USE_LOCALE.

Какие недостатки?

Есть только один очевидный недостаток использования локали - это скорость! Так что, используй локаль, только если тебе это действительно необходимо.


Руководство администратора по PostgreSQLПредыдущийГлава 3. Опции конфигурацииСледующий

Kerberos идентификация

Kerberos - это система безопасной аутентификации промышленного стандарта, подходящая для распределённых вычислений через общедоступные сети.

Доступность

Система аутентификации Kerberos не распространяется с Postgres. Версии Kerberos обычно доступны как необязательное программное обеспечение от продавцов операционных систем. Вдобавок, распространяемый исходный код можно получить через Проект MIT Афина.

Замечание: Тебе всё равно может понадобиться версия MIT, даже если продавец обеспечил тебя версией, из-за того что некоторые перенесенные продавцами версии умышленно испорчены или не взаимодействуют с версией MIT.

Пользователи, расположенные вне США и Канады предупреждаются, что распространение настоящего кода шифрования в Kerberosограничено правилами экспорта правительства США.

Вопросы относительно Kerberos должны адресоваться продавцу или Проект MIT Афина. Заметим, что FAQLи (Список наиболее часто задаваемых вопросов) периодически помещаются в список рассылки Kerberos (пошли письмо чтобы подписаться), и группу новостей USENET.

Установка

Сам процесс установки Kerberos подробно описан в Замечания по установке Kerberos. Удостоверься, что ключевой файл сервера (srvtab или keytab) как-нибудь читается бюджетом Postgres.

Postgres и его клиенты могут компилироваться при использовании протоколов или версии 4 или версии 5 MIT Kerberos с установленной переменной KRBVERS в файле src/Makefile.global в соответствующее значение. Также можно изменить место поиска Postgres где ожидается найти соответствующие библиотеки, заголовочные файлы и сам ключевой файл сервера.

После окончания компиляции, Postgres должен быть зарегистрирован как сервис Kerberos. Подробней смотри Замечания по работе с Kerberos и соответствующие страницы руководства о регистрации сервиса.

Работа

После начальной установки, Postgres будет работать везде как обычный сервис Kerberos. Подробней про использование аутентификации, смотри в Руководство пользователя PostgreSQL разделы про postmaster и psql.

В обработчиках Kerberos версии 5, делаются следующие предположения об именах пользователя и сервиса:

Таблица 3-1. Примеры параметров Kerberos

Параметр Пример
user frew@S2K.ORG
user aoki/HOST=miyu.S2K.Berkeley.EDU@S2K.ORG
host postgres_dbms/ucbvax@S2K.ORG

Поддержка версии 4 исчезнет сразу после выпуска промышленной версии 5 MIT.


Руководство администратора по PostgreSQLПредыдущийГлава 1. ВведениеСледующий

Авторские права и торговые марки

Авторские права на Postgres95 © 1994-5 принадлежат Regents of the University of California. Разрешается использовать, копировать, модифицировать, и распространять это программное обеспечение и его документацию с любой целью, бесплатно, и без чьего-либо согласия, если указанное выше уведомление об авторском праве и этот параграф и следующие два параграфа будут присутствовать во всех копиях.

University of California не несет ответственности за любые события, повлекшие за собой прямо, косвенно, специально, случайно, или как следствие повреждения, включая потерю выгоды, являющуюся результатом использования этого программного обеспечения и его документации, даже если University of California был осведомлен о таких возможных повреждениях.

University of California определенно отказывается от любых гарантий, включая, но не ограничиваясь, подразумевающимися гарантиями продаваемости и пригодность для особенных целей. Программное обеспечение поставляется по принципу "какое есть", и University of California не берет обязанности предоставлять обслуживание, поддержку, обновления, расширения, или модификации.

Unix является торговой маркой X/Open, Ltd. Sun4, SPARC, SunOS и Solaris торговые марки Sun Microsystems, Inc. DEC, DECstation, Alpha AXP и ULTRIX торговые марки Digital Equipment Corp. PA-RISC и HP-UX торговые марки Hewlett-Packard Co. OSF/1 торговая марка Open Software Foundation.


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 10. Управление диском

Дополнительные местоположения

Возможно создавать базы данных в местоположении, отличном от расположения установки по умолчанию. Помни, что весь доступ к базам данных на самом деле происходит через сервер базы данных, поэтому любое указанное местоположение должно быть доступно серверу.

Для создания и доступа к дополнительным расположениям баз данных используется переменная среды, которая задает абсолютный путь, где предполагается хранить данные. Эта переменная среды должна определяться перед запуском сервера и должна быть доступна для записи бюджету администратора postgres. Любое правильное имя переменной среды может использоваться как ссылка на дополнительное место хранения, хотя рекомендуется использовать имена с префиксом PGDATA во избежании беспорядка и конфликтов с другими переменными.

Замечание: В предыдущих версиях Postgres, также было разрешено использовать абсолютный путь для указания дополнительного местоположения. Стиль указания в переменной среды предпочтительнее, т.к. это дает администратору сайта большую гибкость в управлении дисковым пространством. Если ты предпочитаешь использование абсолютных путей, то ты можешь это делать, определив "ALLOW_ABSOLUTE_DBPATHS" и перекомпилив Postgres. Для этого, добавь строчку CLASS="PROGRAMLISTING" >#define ALLOW_ABSOLUTE_DBPATHS 1 в файл src/include/config.h, или укажи

 CFLAGS+= -DALLOW_ABSOLUTE_DBPATHS
     
в своем Makefile.custom.

Помни, что создание базы данных на самом деле выполняет сервер базы данных. Поэтому, любая переменная среды, указывающая дополнительное местоположение, должна определяться перед запуском сервера. Для определения дополнительного местоположения PGDATA2, указывающей на /home/postgres/data, во-первых, набери

% setenv PGDATA2 /home/postgres/data
    
что определит переменную среды для дальнейшего использования в командах. Обычно, эту переменную определяют в .profile суперпользователя Postgres или в файле инициализации .cshrc, чтобы обеспечить ее определение при загрузке системы. Можно использовать любую переменную среды для указания дополнительного местоположения, хотя предпочтительней, чтобы переменные начинались с "PGDATA" для устранения беспорядка и возможных конфликтов с перезаписью других переменных.

Чтобы создать область хранения данных в PGDATA2, обеспечь существование /home/postgres и разрешение на запись администратору postgres. Затем, в командной строке набери

% setenv PGDATA2 /home/postgres/data
% initlocation $PGDATA2
Creating Postgres database system directory /home/postgres/data

Creating Postgres database system directory /home/postgres/data/base

    

Чтобы проверить новое местоположение, создай базу данных test, набрав

% createdb -D PGDATA2 test
% dropdb test
    


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 6. Установка на Win32

Оглавление
Сборка библиотек
Установка библиотек
Использование библиотек

Инструкции по сборке и установке клиентской библиотеки Postgres v6.4 под Win32.

Сборка библиотек

makefileы, включенные в Postgres, написаны для Microsoft Visual C++, и вероятно не будут работать с другими системами. В некоторых случаях возможно компилировать библиотеки вручную.

Для сборки библиотек, измени текущий каталог на каталог src и набери команду

nmake /f win32.mak
Предполагается, что Visual C++ имеется в твоем пути.

Будут собраны следующие файлы:


Руководство администратора по PostgreSQLПредыдущийГлава 6. Установка на Win32Следующий

Установка библиотек

В действительности устанавливается только часть библиотеки libpq.dll. В большинстве случаев, файл помещается в каталог WINNT\SYSTEM32 (или WINDOWS\SYSTEM в системах Windows 95/98). Если этот файл устанавливается с помощью программы установки, то он будет установлен с проверкой версии с помощью ресурса VERSIONINFO, включенного в этот файл, чтобы гарантировать что новая версия библиотеки не будет перезаписана.

Если ты планируешь разработки с использованием libpq на этой машине, то тебе нужно добавить каталоги src\include и src\interfaces\libpq в путь include в настройках твоего компилятора.


Руководство администратора по PostgreSQLПредыдущийГлава 6. Установка на Win32Следующий

Использование библиотек

Чтобы использовать библиотеки, ты должен добавить файл libpqdll.lib в свой проект (в Visual C++, просто щелкни правой клавишей мыши на проекте и выбери добавить).

После того как это сделано, станет возможным использовать библиотеку также как и на Unix платформе.


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 5. Установка

Оглавление
Требования для запуска Postgres
Процедура установки
Использование Postgres
Следующий шаг
Замечания по переносу

Полная инструкция по установке Postgres v6.5.1.

Перед установкой Postgres, посети www.postgresql.org, чтобы посмотреть новую информацию, патчи, и т.д.

Эти инструкции по установке предполагают:

Команды тестировались на RedHat Linux версии 5.2, при использовании tcsh shell. Вероятно они будут работать на большинстве систем, если не отмечено другого. Команды типа ps и tar могут дико расходиться между платформами по используемым опциям. Пользуйся здравым смыслом перед вводом этих команд.

Нашим Makefile-ам необходим GNU make (называется “gmake” в этом документе). Они не будут работать с не-GNU make программами. Если у тебя GNU make установлен с именем “make” вместо “gmake”, то пользуйся командой make. Это хорошо, но тебе нужно иметь GNU form из make для успешной установки.

Требования для запуска Postgres

Новейшая информация о поддерживаемых платформах - http://www.postgresql.org/docs/admin/install.html. В общем, большинство Unix-совместимых платформ с современными библиотеками должны быть способны запустить Postgres.

Хотя минимальный размер требуемой памяти для запуска Postgres не меньше 8MB, есть заметные улучшения при выполнении регрессивных тестов при добавлении памяти до 96MB на относительно быстрых двухпроцессорных системах, работающих под X-Windows. Правило - ты не можешь иметь слишком много памяти.

Проверь, достаточно ли у тебя дискового пространства. Тебе нужно около 30 мегабайт под /usr/src/pgsql, около 5 мегабайт под /usr/local/pgsql (не включая твоих баз данных) и 1 мегабайт под пустую базу данных. База данных на время увеличится до 20 мегабайт в течении регрессивных тестов. Также, тебе потребуется около 3 мегабайт под дистрибутивный tar файл.

Поэтому мы рекомендуем, чтобы во время установки и тестирования было больше 20 мегабайт свободных под /usr/local и еще 25 мегабайт свободных на дисковом разделе, содержащем твою базу данных. После удаления файлов исходных текстов, tar файла и регриссивной базы данных, тебе потребуется 2 мегабайта под /usr/local/pgsql, 1 мегабайт под пустую базу данных, плюс в пять раз больше места тебе потребуется чтобы сохранить данные базы данных в плоском файле.

Для проверки дискового места используй

$ df -k
    


Руководство администратора по PostgreSQLПредыдущийГлава 5. УстановкаСледующий

Использование Postgres

После того как Postgres установлен, системная база данных создана, демон postmaster запущен, и регрессивные тесты прошли, ты наверно, хочешь увидеть как Postgres делает чего-нибудь. Это легко. Вызови диалоговый интерфейс Postgres, psql:

% psql template1
(psql открывает эту базу данных, но на данный момент существует только одна база данных - template1, которая всегда существует. Мы будем подключаться к ней до того момента, пока не создадим другую и будем ее использовать.)

Отклик от psql:

Welcome to the POSTGRESQL interactive sql monitor:
  Please read the file COPYRIGHT for copyright terms of POSTGRESQL

   type \? for help on slash commands
   type \q to quit
   type \g or terminate with semicolon to execute query
 You are currently connected to the database: template1

template1=>

Создадим базу данных foo:

template1=> create database foo;
CREATEDB
(Возьми в привычку включать в SQL точки с запятой. Psql ничего не выполнит, пока не увидит точку с запятой или "\g" и точка с запятой необходима для разделения операторов.)

Теперь подключимся к новой базе данных:

template1=> \c foo
connecting to new database: foo
(команда "слэш" не SQL, как и точка с запятой. Используй \?, чтобы увидеть все команды слэш.)

И создадим таблицу:

foo=> create table bar (i int4, c char(16));
CREATE

Затем изучим новую таблицу:

foo=> \d bar

Table    = bar
+----------------------------------+----------------------------------+-------+
|              Field               |              Type                | Length|
+----------------------------------+----------------------------------+-------+
| i                                | int4                             |     4 |
| c                                | (bp)char                         |    16 |
+----------------------------------+----------------------------------+-------+

И так далее. Идею ты понял.


Руководство администратора по PostgreSQLПредыдущийГлава 5. УстановкаСледующий

Следующий шаг

Вопросы? Баги? Обратная связь? Во-первых, почитай файлы из каталога /usr/src/pgsql/doc/. FAQ из этого каталога может быть особенно полезен.

Если Postgres не проходит компиляцию на твоем компьютере, то заполни форму в файле /usr/src/pgsql/doc/bug.template и пошли ее по адресу, указанному наверху формы.

Начни работу с web сайта http://www.postgresql.org Дополнительная информация есть в нескольких списках рассылки поддержки.


Руководство администратора по PostgreSQLПредыдущийГлава 5. УстановкаСледующий

Замечания по переносу

Посмотри любые платформо-зависимые FAQи в каталоге doc/ исходного дистрибутива.


Руководство администратора по PostgreSQLПредыдущийГлава 5. УстановкаСледующий

Процедура установки

Установка Postgres

Новая установка или обновление предыдущих версий Postgres:

  1. Прочитай всю последнюю информацию и замечания об особенностях переноса на платформу. Некоторые замечания об особенностях платформы в конце этого файла для Ultrix4.x, Linux, BSD/OS и NeXT. Другие файлы из каталога /usr/src/pgsql/doc, включая файлы FAQ-Irix и FAQ-Linux. Также загляни в каталог ftp://ftp.postgresql.org/pub. Если в этом каталоге есть файл INSTALL, то этот файл содержит последнюю информацию по установке.

    Заметьте, что "тестированные" платформы из списка данного выше, просто означает, что кто-то приложил усилия в этом направлении, чтобы удостовериться, что дистрибутив Postgres компилируется и запускается на этой платформе без правки кода. Т.к. текущие разработчики не имеют доступа ко всем этим платформам, то некоторые из них могут компилироваться не чисто и проводимые регрессивные тесты текущей версии могут иметь небольшие проблемы. Все известные проблемы и решения помещаются в ftp://ftp.postgresql.org/pub/INSTALL.

  2. Создай бюджет суперпользователя Postgres(обычно используется postgres), если он ещё не существует.

    Владельцем файлов Postgres может быть любой непревелигерованный пользовательский бюджет. Им не должен быть root, bin, или любой другой бюджет со специальными правами доступа, это может создать дыру в защите.

  3. Войди под бюджетом суперпользователя Postgres. Большинство оставшихся шагов установки будут производиться из этого бюджета.

  4. Скачай файл ftp://ftp.postgresql.org/pub/postgresql-v6.5.1.tar.gz из Internet. Сохрани его в своём домашнем каталоге.

  5. Некоторые платформы используют flex. Если твоя система использует flex, то удостоверься, хорошая ли у тебя версия. Чтобы проверить, набери

    $ flex --version

    Если команда flex не найдена, то, вероятно, она тебе не нужна. Если версия 2.5.2 или 2.5.4 или выше, то всё в порядке. Если 2.5.3 или ниже 2.5.2, то тебе надо обновить flex. Ты можешь получить его на ftp://prep.ai.mit.edu/pub/gnu/flex-2.5.4.tar.gz.

    Если тебе нужен flex и у тебя его нет или неправильная версия, то тебе скажут об этом, когда ты попытаешься компилировать программу. Спокойно пропусти этот шаг, если ты не уверен, что он тебе нужен. Если ты сделаешь его нужным, то тебе скажут установить/обновить flex, когда ты попытаешься откомпилировать Postgres.

    Ты можешь выполнить всю установку flex из бюджета root, хотя в этом нет абсолютной необходимости. Предполагая, что ты хочешь разместить файлы установки в местоположения по умолчанию, введи следующее:

    $ su -
    $ cd /usr/local/src
    ftp prep.ai.mit.edu
    ftp> cd /pub/gnu/
    ftp> binary
    ftp> get flex-2.5.4.tar.gz
    ftp> quit
    $ gunzip -c flex-2.5.4.tar.gz | tar xvf -
    $ cd flex-2.5.4
    $ configure --prefix=/usr
    $ gmake
    $ gmake check
    # Ты должен быть root при наборе следующей строчки:
    $ gmake install
    $ cd /usr/local/src
    $ rm -rf flex-2.5.4

    В результате обновятся файлы /usr/man/man1/flex.1, /usr/bin/flex, /usr/lib/libfl.a, /usr/include/FlexLexer.h и появится ссылка /usr/bin/flex++, которая указывает на flex.

  6. Если ты не обновляешь существующую систему, пропусти всё до шага 9. Если ты делаешь обновление с 6.5, то тебе не нужно делать dump/reload или initdb. Просто компилируй исходный код, останови postmaster, выполни "make install" и перезапусти postmaster. Если ты делаешь обновление с 6.4.* или раньше, сделай резервную копию базы данных. Для релизов alpha и beta уровней, формат базы данных подвергался изменению почти каждые несколько недель, без уведомления, кроме коротких комментариев в в списке рассылки HACKERS. Полным релизам всегда необходим dump/reload из предыдущих релизов. Поэтому плохая идея пропускать этот шаг.

    Подсказка: Не используй сценарий pg_dumpall из v6.0 или все, принадлежащие суперпользователю Postgres.

    Чтобы выполнить дамп фактически новой после-v6.0 установки базы данных, введи

    $ pg_dumpall > db.out

    Чтобы использовать последний сценарий pg_dumpall существующей старой базы данных перед обновлением Postgres, вытяни наиболее свежую версию pg_dumpall из нового дистрибутива:

    $ cd
    $ gunzip -c postgresql-v6.5.1.tar.gz \
        | tar xvf - src/bin/pg_dump/pg_dumpall
    $ chmod a+x src/bin/pg_dump/pg_dumpall
    $ src/bin/pg_dump/pg_dumpall > db.out
    $ rm -rf src

    Если ты хочешь сохранить idы объектов (oids), то используй опцию -o при запуске pg_dumpall. Однако, если у тебя нет специальный причин делать это ( например, использование OIDов как ключей в таблицах), то не делай этого.

    Если, кажется, что команда pg_dumpall работает слишком долго и ты думаешь что она умерла, то из другого терминала введи

    $ ls -l db.out
    несколько раз, чтобы увидеть растёт ли размер файла.

    Заметьте, что если ты выполняешь обновление версии ранее чем Postgres95 v1.09, то ты должен сделать резервную копию базы данных, установить Postgres95 v1.09, восстановить базу данных, затем сделать резервную копию опять. Также, тебе нужно прочитать замечания версии, которые описывают любые проблемы этой версии.

    Предупреждение

    Ты должен удостовериться, что база данных не обновляется во время резервного копирования. При необходимости, опусти postmaster, отредактируй права в файле /usr/local/pgsql/data/pg_hba.conf чтобы работать мог только ты, затем подними postmaster обратно.

  7. Если ты обновлял существующую систему, то прибей postmaster. Введи

    $ ps -ax | grep postmaster
    Это даст тебе список с номерами процессов. Введи следующую строку с заменой pid на id процесса postmaster. (Не используй id процесса "grep postmaster".) Введи
    $ kill pid
    чтобы на самом деле остановить процесс.

    Подсказка: В системах, которые запускают Postgres во время загрузки, вероятно существует файл запуска, который выполняет это действие. Например, на моей Linux системе я могу набрать

    $ /etc/rc.d/init.d/postgres.init stop
    чтобы остановить Postgres.

  8. Если ты обновляешь существующую систему, то перемести старые каталоги куда-нибудь. Если у тебя мало места, то вместо этого можешь сделать резервную копию и удалить каталоги. Если ты поступаешь так, то сохрани старую базу данных в /usr/local/pgsql/data дереве каталогов. Как минимум, сохрани файл /usr/local/pgsql/data/pg_hba.conf.

    Введи следующее:

    $ su -
    $ cd /usr/src
    $ mv pgsql pgsql_6_0
    $ cd /usr/local
    $ mv pgsql pgsql_6_0
    $ exit

    Если ты не используешь /usr/local/pgsql/data в качестве каталога данных (посмотри, как установлена переменная среды PGDATA), то тебе также надо бы переместить этот каталог в той же манере.

  9. Сделай новые каталоги для исходников и установки. Фактические пути могут отличаться от твоих, но ты должен пройти через эту процедуру.

    Замечание: Существует два места в процедуре установки, где ты имеешь возможность задать местоположение установки для программ, библиотек, документации, и других файлов. Обычно, достаточно задать их перед стадией установки gmake install.

    Введи

    $ su
    $ cd /usr/src
    $ mkdir pgsql
    $ chown postgres:postgres pgsql
    $ cd /usr/local
    $ mkdir pgsql
    $ chown postgres:postgres pgsql
    $ exit

  10. Unzip и untar новый файл исходников. Введи

    $ cd /usr/src/pgsql
    $ gunzip -c ~/postgresql-v6.5.1.tar.gz | tar xvf -

  11. Настрой исходный код под твою систему. В этом шаге ты должен задать фактический путь установки для процесса сборки (смотри ниже опцию --prefix). Введи

    $ cd /usr/src/pgsql/src
    $ ./configure [ options ]

    1. Помимо других действий, сценарий configure выбирает системо-зависимый файл "шаблон" из файлов из подкаталога template. Если он не определит какая система используется, то он об этом скажет и завершится. В этом случае тебе нужно указать какой из них использовать и запустить configure снова, указав, в этот раз, опцию --with-template=TEMPLATE с правильно выбранным файлом.

      Сообщай о проблемах: Если твоя система не распозналась configure автоматически и ты делал это, пожалуйста, пошли на email scrappy@hub.org вывод программы ./config.guess. Укажи, какой файл шаблона должен быть.

    2. Задай опции конфигурации. Подробней смотри Опции конфигурации. Однако, для простой первой установки без дополнительных опций, типа поддержки мульти-байтовых символов или поддержки сравнивания из локали, можно выбрать достаточную для задач установку и запустить configure без указания дополнительных опций. Сценарий configure принимает много дополнительных опций, которые ты можешь использовать, если тебе не нравятся установки по умолчанию. Чтобы увидеть их все, введи

           ./configure --help
      Вот наиболее широко используемые:
             --prefix=BASEDIR   Выбрать другой начальный каталог для
                                установки конфигурацииPostgres.
                                По умолчанию /usr/local/pgsql.
             --with-template=TEMPLATE
                                Использовать файл шаблона TEMPLATE - файлы шаблона
      			  лежат в каталоге src/template, т.е. правильные
      			  значения там.
             --with-tcl         Собирать библиотеку интерфейса и программы,
                                необходимые Tcl/Tk, включает libpgtcl,
      			  pgtclsh, и pgtksh.
             --with-perl        Собирать библиотеку интерфейса Perl.
             --with-odbc        Собирать пакет драйвера ODBC.
             --enable-hba       Разрешить аутентификацию, основанную на хосте (ПО УМОЛЧАНИЮ)
             --disable-hba      Запретить аутентификацию, основанную на хосте
             --enable-locale    Разрешить USE_LOCALE
             --enable-cassert   Разрешить ASSERT_CHECKING
             --with-CC=compiler
                                Использовать заданный компилятор C, который
      			  сценарий configure не смог найти.
             --with-CXX=compiler
             --without-CXX
                                Использовать заданный компилятор C++, который
      			  сценарий configure не смог найти, или исключить
      			  компиляцию C++ целиком.(В настоящее время, это
      			  влияет на libpq++.)

    3. Вот сценарий configure, используемый на системе Sparc Solaris 2.5, с /opt/postgres заданный как начальный каталог установки:

      $ ./configure --prefix=/opt/postgres \
          --with-template=sparc_solaris-gcc --with-pgport=5432 \
          --enable-hba --disable-locale

      Подсказка: Конечно, ты можешь ввести все три строки в одной.

  12. Установи документацию man и HTML. Введи

    $ cd /usr/src/pgsql/doc
    $ gmake install

    Также, документация доступна в Postscript формате. Ищи файлы, оканчивающиеся на .ps.gz в том же каталоге.

  13. Скомпилируй программу. Введи

    $ cd /usr/src/pgsql/src
    $ gmake all >& make.log &
    $ tail -f make.log

    Надеемся, что последняя строка будет

    All of PostgreSQL is successfully made. Ready to install.
    Помни, что “gmake” может называться “make” в твоей системе. Отсюда, или ранее, если хочешь, нажми control-C для выхода из tail. (Если ты имеешь проблемы, позже можно посмотреть предупреждающее и сообщения об ошибках в файле make.log.)

    Замечание: Вероятно, ты обнаружишь несколько предупреждающих сообщений в make.log. Если проблемы не возникнут позднее, то эти сообщения могут ты благополучно проигнорированы.

    Если компилятор потерпел неудачу с сообщением, что команда flex не найдена, то установи flex, как описывалось ранее. Затем, измени каталог обратно на этот каталог, введи

    $ gmake clean
    , затем перекомпилируй опять.

    Опции компилятора, такие как оптимизация и отладка, могут быть заданы в командной строке, с помощью переменной COPT. Например, набрав

    $ gmake COPT="-g" all >& make.log &
    вызовет компилятор с опцией -g во всех шагах сборки. Смотри в src/Makefile.global.in остальные подробности.

  14. Установи программу. Введи

    $ cd /usr/src/pgsql/src
    $ gmake install >& make.install.log &
    $ tail -f make.install.log

    Последняя отображённая строка будет

    gmake[1]: Leaving directory `/usr/src/pgsql/src/man'
    Отсюда, или ранее, если хочешь, нажми control-C для выхода из tail. Помни, что “gmake” может называться “make” в твоей системе.

  15. Если потребуется, скажи своей системе как найти новые разделяемые библиотеки. Ты можешь выполнить один из следующих, предпочтительно первый:

    1. Как root, отредактируй файл /etc/ld.so.conf. Добавь строку

      /usr/local/pgsql/lib
      в файл. Затем, выполни команду /sbin/ldconfig.

    2. В bash shell, введи

          export LD_LIBRARY_PATH=/usr/local/pgsql/lib

    3. В csh shell, введи

          setenv LD_LIBRARY_PATH /usr/local/pgsql/lib

    Заметьте, что команды выше могут дико отличаться в зависимости от операционных систем. Посмотри замечания по платформе, например для Ultrix4.x или для не-ELF Linux.

    Если при создании базы данных, ты получаешь сообщение

    pg_id: can't load library 'libpq.so'
    , то был необходим шаг выше. Просто выполни этот шаг, затем попытайся создать базу данных снова.

  16. Если ты используешь опцию --with-perl в configure, проверь установочный лог был ли установлен модуль Perl. Если ты следуешь нашему совету по созданию файлов Postgres, что они принадлежат непревелигерованному userid, то модуль Perl не установился, из-за отсутствия прав на запись в каталоги библиотеки Perl. Ты можешь выполнить его установку, или сейчас или позднее, став пользователем, которому принадлежит библиотека Perl (чаще root) (посредством su) и выполнив

          $ cd /usr/src/pgsql/src/interfaces/perl5
          $ gmake install
         

  17. Если этого ещё не было сделано, то создай бюджет postgres для использования Postgres. Любой бюджет, который будет использовать Postgres должен создаваться подобным образом.

    Есть несколько путей влияния на рабочую среду сервера Postgres. Обратись к Руководство администратора за полной информацией.

    Замечание: Следующие инструкции для bash/sh shell. Переделай, соответственно с другими shellами.

    1. Добавь следующие строки в твою среду входа: shell, ~/.bash_profile:

      	PATH=$PATH:/usr/local/pgsql/bin
      	MANPATH=$MANPATH:/usr/local/pgsql/man
      	PGLIB=/usr/local/pgsql/lib
      	PGDATA=/usr/local/pgsql/data
      	export PATH MANPATH PGLIB PGDATA
             

    2. Некоторые регрессивные тесты потерпят неудачу, если пользовательская схема сравнивания из локали отличается от стандартной C локали.

      Если ты настраиваешь и компилируешь Postgres с --enable-locale, то ты должен установить среду локали в “C” (или удалить все “LC_*” переменные), поместив эти дополнительные строки в свою среду входа перед запуском postmaster:

      	LC_COLLATE=C
      	LC_CTYPE=C
      	export LC_COLLATE LC_CTYPE
             
      	
             

    3. Убедись, что ты определил эти переменные перед тем как продолжить выполнять оставшиеся шаги. Самый лёгкий путь сделать это - это набрать:

      	$ source ~/.bash_profile
             

  18. Создай базу данных установки из бюджета суперпользователя Postgres (обычно бюджета postgres). Не выполняй их как root! Эта главная дыра в безопасности. Введи

    $ initdb

  19. Настрой права доступа к системе баз данных. Чтобы сделать это, отредактируй файл /usr/local/pgsql/data/pg_hba.conf. Инструкции включены в файл. (Если твоя база данных расположена не местоположении по умолчанию, т.е. если указывает PGDATA куда-нибудь ещё, то размещение этого файла должно быть изменено соответственно.) Этот файл должен быть сделан только для чтения опять после завершения. Если ты выполняешь обновление с v6.0 или позже то можешь скопировать файл pg_hba.conf из своей старой базы данных в свою новую базу данных, вместо переделывания файла сначала.

  20. Краткий тест - сервер будет запускаться и работать из командной строки.

    1. Запусти демона postmaster в фоновом режиме, набрав

      $ cd
      $ nohup postmaster -i > pgserver.log 2>&1 &

    2. Создай базу данных, набрав

      $ createdb

    3. Подключись к новой базе данных:

      $ psql

    4. И запусти простой запрос:

      postgres=> SELECT datetime 'now';

    5. Выйди из psql:

      postgres=> \q

    6. Удали тестовую базу данных (если ты не хочешь использовать её позднее для других тестов):

      $ dropdb

  21. Запусти postmaster в фоновом режиме из бюджета суперпользователя Postgres (обычно, бюджет postgres). Не запускай postmaster из-под бюджета root!

    Обычно, ты хочешь изменить свой компьютер так, чтобы он автоматически запускал postmaster во время начальной загрузки. Это не необходимо; сервер Postgres может успешно запускаться из непревелгерованных бюджетов без вмешательства root.

    Вот несколько предположений о том как это сделать, при содействии различных пользователей.

    Чтобы ты не делал, postmaster должен быть запущен суперпользователем Postgres (postgres?) и не root. Вот почему все примеры ниже начинаются с переключения пользователя (su) на postgres. Также, раз эти команды входят в другой бюджет, то переменные среды, типа PATH и PGDATA, могут быть установлены неправильно. Примеры следующие. Используй их крайне осторожно.

    • Если ты устанавливал из-под непривилегированного бюджета и не имеешь прав доступа root, то запусти postmaster и помести его в фоновый режим:

      $ cd
      $ nohup postmaster > regress.log 2>&1 &

    • Отредактируй файл rc.local на NetBSD или файл rc2.d на SPARC Solaris 2.5.1, чтобы он содержал следующую одну строку:

      su postgres -c "/usr/local/pgsql/bin/postmaster -S -D /usr/local/pgsql/data"

    • В FreeBSD 2.2-RELEASE отредактируй /usr/local/etc/rc.d/pgsql.sh, чтобы он содержал следующие строки и выполни на нём chmod 755 и chown root:bin.

      #!/bin/sh
      [ -x /usr/local/pgsql/bin/postmaster ] && {
          su -l pgsql -c 'exec /usr/local/pgsql/bin/postmaster
              -D/usr/local/pgsql/data
              -S -o -F > /usr/local/pgsql/errlog' &
          echo -n ' pgsql'
      }
      Ты можешь разрывать строки как показано выше. shell достаточно умный чтобы не продолжать разбор за концом файла, если выражение не закончено. exec сохраняет один слой shell под процесс postmaster, так чтобы родителем был init.

    • В RedHat Linux добавь файл /etc/rc.d/init.d/postgres.init, который основан на примере из contrib/linux/. Затем сделай мягкую ссылку на этот файл из /etc/rc.d/rc5.d/S98postgres.init.

    • В RedHat Linux отредактируй файл /etc/inittab, добавив одну строку:

      pg:2345:respawn:/bin/su - postgres -c
          "/usr/local/pgsql/bin/postmaster -D/usr/local/pgsql/data
          >> /usr/local/pgsql/server.log 2>&1 </dev/null"
      (Автор примера говорит, что пример будет оживлять postmaster если он умрёт, но он не знает есть ли другая сторона эффекта.)

  22. Запусти регрессивные тесты. Файл /usr/src/pgsql/src/test/regress/README детально описывает инструкции по запуску и толкования регрессивных тестов. Сокращёная версия вот:

    1. Введи

      $ cd /usr/src/pgsql/src/test/regress
      $ gmake clean
      $ gmake all runtest

      Тебе не нужно вводить gmake clean, если ты первый раз выполняешь тесты.

      Ты получишь на экране (и также в файле ./regress.out) серию отчётов о состоянии, какие тесты прошли и какие тесты провалились. Заметьте, что может быть нормальным, что некоторые тесты "провалились" на некоторых платформах. Сценарий говори, что тест не прошёл, если есть любое различие между фактическим выводом теста и ожидаемым выводом. Таким образом, тесты могут "провалиться" из-за несущественной разницы в словах сообщений ошибок, маленьких различиях в округлении плавающей точки, и т.д., между твоей системой и регрессивным тестом эталонной платформы. "Провал" такого типа не указывает на проблему с Postgres. Файл ./regression.diffs содержит текстовую разницу между фактическим выводом теста на твоей машине и "ожидаемым" выводом (который просто произведен на эталонной машине). Тебе нужно осторожно исследовать каждое различие, чтобы увидеть приведёт ли оно значительной проблеме.

      Например,

      • For a i686/Linux-ELF platform, no tests failed since this is the v6.5.1 regression testing reference platform.

      Даже если результат теста точно указывает на настоящую ошибку, это может быть локальной проблемой, которая тебе повредит. Как пример, в котором провалился тест int8, может быть явно вызван некорректным выводом, если твоя машина и компилятор C не работают с 64-битным целым типом данных (или, если они работают, но configure не обнаружила этого). Это не то о чём стоит беспокоится, если тебе не нужно хранить 64-битные целые.

      Вывод? Если ты увидел неудачу, постарайся понять природу различий и затем реши, как повлияет это на твои задачи использования Postgres. Регрессивные тесты - полезное инструментальное средство, но чтобы они были полезны их нужно немного исследовать..

      После работы регрессивных тестов, набери

      $ dropdb regression
      $ cd /usr/src/pgsql/src/test/regress
      $ gmake clean
      , чтобы получить обратно дисковое пространство, занятое тестами. (Можно сохранить файл regression.diffs куда-нибудь, прежде чем делать это.)

  23. Если этого уже не было сделано, то сейчас самое время настроить свой компьютер на выполнение систематического технического обслуживания. Следующее нужно делать через регулярные интервалы:

    Минимальная процедура резервного копирования

    1. Запусти команду SQL VACUUM. Она произведёт очистку твоей базы данных.

    2. Выполни резервное копирование системы. (Вероятно, тебе придёт сделать несколько резервных копирований вручную.) Лучше, чтобы никто не использовал систему в это время.

    В идеале, задачи выше должны выполняться из сценария shell script, который запускался бы каждую ночь или неделю с помощью cron. Посмотри man страницу crontab для начала, о том как это сделать. (Если ты сделал это, пожалуйста, e-mail нам копию твоего сценария shell. Мы бы тоже хотели настроить наши системы.)

  24. Если ты обновлял существовавшую систему, то переустанови свою старую базу данных. Введи

    $ cd
    $ psql -e template1 < db.out
    Если ты использовал pre-v6.2 базу данных или такие геометрические типы данных как путь или многоугольник, то тебе нужно обновить все столбцы, содержащие эти типы. Чтобы выполнить это, введи (из psql)
    UPDATE FirstTable SET PathCol = UpgradePath(PathCol);
    UPDATE SecondTable SET PathCol = UpgradePath(PathCol);
    ...
    VACUUM;
    Проверка UpgradePath() смотрит, использует ли значение path старый синтаксис и не обновляет столбцы, которые не проходят этот осмотр. UpgradePoly() не проверяет использует ли polygon фактически старый синтаксис, но RevertPoly() обеспечивает противоположный эффект неправильного использования обновления.

  25. Если ты новый пользователь, ты можешь поиграться с Postgres как описано ниже.

  26. Выполни очистку. Введи

    $ rm -rf /usr/src/pgsql_6_5
    $ rm -rf /usr/local/pgsql_6_5
    # Also delete old database directory tree if it is not in
    #  /usr/local/pgsql_6_5/data
    $ rm ~/postgresql-v6.5.1.tar.gz

  27. Ты, вероятно, захочешь распечатать документацию. Если у тебя Postscript принтер, или на твоей машине установлен фильтр, принимающий Postscript файлы, то для печати Руководства пользователя просто введи

    $ cd /usr/local/pgsql/doc
    $ gunzip user.ps.tz | lpr

    Это же можно сделать, если ты имеешь Ghostscript в системе и принтер laserjet.

    $ alias gshp='gs -sDEVICE=laserjet -r300 -dNOPAUSE'
    $ export GS_LIB=/usr/share/ghostscript:/usr/share/ghostscript/fonts
    $ gunzip user.ps.gz
    $ gshp -sOUTPUTFILE=user.hp user.ps
    $ gzip user.ps
    $ lpr -l -s -r manpage.hp

  28. Команда Postgres хочет сохранить Postgres работающим на всех поддерживаемых платформах. Поэтому мы просим тебя дать знать, заработал или нет Postgres на твоей системе. Пожалуйста, пошли почтовое сообщение pgsql-ports@postgresql.org, указав следующее:

    • Версию Postgres (v6.5.1, 6.5, beta 990318, и т.д.).

    • Твою операционную систему (т.е. RedHat v5.1 Linux v2.0.34).

    • Твое аппаратное обеспечение (SPARC, i486, и т.д.).

    • Компилировалось, устанавливалось и отработали ли регрессивные тесты чисто? Если нет, какой исходный код ты изменил (т.е. применявшиеся патчи, сделанные изменения, и т.д.), какие тесты не прошли, и т.д. Предупреждающие сообщения при компиляции - это нормально. Тебе не нужно указывать их здесь.

  29. Теперь, подключайся и управляй базами данных как хочешь. Пиши клиентские программы для доступа к серверу базы данных. Другими словами, пользуйся!


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 1. Введение

Оглавление
Ресурсы
Терминология
Нотация
О Y2K
Авторские права и торговые марки

Этот документ является Руководством администратора для системы управления базами данных PostgreSQL, изначально разработанной в University of California at Berkeley. PostgreSQL основан на Postgres версии 4.2. Проект Postgres, возглавляемый профессором Michael Stonebraker, был субсидирован в рамках министерства обороны агентством по перспективным научным проектам (DARPA), Army Research Office (ARO), национальным научным фондом (NSF), и ESL, Inc.

Ресурсы

Этот набор описаний состоит из нескольких частей:

Tutorial

Введение для новых пользователей. Не раскрывает внутренних свойств.

Руководство пользователя

Общая информация для пользователей, включая доступные команды и типы данных.

Руководство программиста

Информация о внутренностях для программистов приложений. Обсуждаются расширяемость типов и функций, библиотечный интерфейс и проблемы разработки приложений.

Руководство администратора

Установка и управление. Список поддерживаемых машин.

Руководство разработчика

Информация для разработчиков Postgres. Здесь подразумеваются те, кто способствуют проекту Postgres; информация о разработке приложений должна быть в Руководстве программиста. В настоящий момент включено в Руководство программиста.

Справочное руководство

Содержит справочную информацию о синтаксисе команд. В настоящий момент включено в Руководство пользователя.

В дополнении к этому набору описаний, есть другие источники помощи с установкой и использованием Postgres:

страницы man

Страницы man содержат общую информацию о синтаксисе команд.

FAQи

Документы, описывающие наиболее часто задаваемые вопросы (FAQ) посвящённые общим и некоторым платформенным проблемам.

README

Файлы README доступны в некоторых распространяемых пакетах.

Web сайт

На web сайте Postgres может иметься другая информация, не встречающаяся в дистрибутиве. Например, подборка из списка рассылки mhonarc, которая посвящена многим темам.

Списки рассылки

Список рассылки pgsql-general (архив) это хорошее место где ответят на вопрос пользователя. Есть другие списки рассылки; проконсультируйся в разделе Info Central на PostgreSQL web сайте.

Ты сам!

Postgres это открытый продукт. По существу, его поддержка зависит от пользовательского сообщества. Как только ты начинаешь использовать Postgres, ты полагаешься на помощь других, или через документацию или через списки рассылки. Подумай, как можно помочь другим. Если ты узнал что-то, чего нет в документации, напиши про это и подари всем. Если ты добавил свойство в код - подари всем.

Даже без этих экспериментов можно исправить и немного изменить документацию, это тоже хороший путь начать. Список рассылки pgsql-docs (архив) - место для продолжения.


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 4. Схема размещения системы

Рисунок 4-1. Расположение файлов Postgres

Расположение файлов Postgres показывает как размещается дистрибутив Postgres, если он установлен с настройками по умолчанию. Для простоты, мы предполагаем, что Postgres установлен в каталог /usr/local/pgsql. Следовательно, если ты увидел каталог /usr/local/pgsql, то ты должен заменить его на каталог, в котором установлен Postgres на самом деле. Все команды Postgres устанавливаются в каталог /usr/local/pgsql/bin. Следовательно, тебе нужно добавить этот каталог в командный путь shell. Если ты используешь один из Berkeley C shell, например csh или tcsh, то добавь
set path = ( /usr/local/pgsql/bin path )
в файл .login из своего домашнего каталога. Если ты используешь один из Bourne shell, например sh, ksh, или bash, то добавь
PATH=/usr/local/pgsql/bin:$PATH
export PATH
в файл .profile из своего домашнего каталога. С этого момента, мы предполагаем, что ты добавил Postgres bin каталог в свой путь. В дополнении, мы часто ссылаемся на "установку переменной shell" или "установку переменной среды" по всему этому документу. Если ты полностью не понимаешь последний параграф по изменению пути поиска, то посмотри страницы руководства UNIX, которые описывают твой shell, перед тем как двигаться дальше.

Если у тебя нетрадиционный случай, то тебе может потребоваться ещё кое-что сделать. Например, если машина сервер базы данных - это удалённая машина, то нужно задать в переменной среды PGHOST имя машины сервера баз данных. Переменную среды PGPORT можно также установить. И напоследок: если ты пытаешься запустить программу приложение и она жалуется что не может подключиться к postmaster, то тебе немедленно нужно вернуться назад и убедиться, что среда правильно настроена.


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 11. Управление базой данных

Оглавление
Создание базы данных
Доступ к базе данных
Уничтожение базы данных
Резервное копирование и восстановление

Если Postgres postmaster запущен и работает, мы можем создать несколько баз данных для экспериментов. Здесь мы опишем основные команды управления базой данных.

Создание базы данных

Скажем, ты хочешь создать базу данных с названием mydb. Ты можешь сделать это с помощью следующей команды:

% createdb dbname
    
Postgres позволяет создавать любое количество баз данных на одном сайте и ты автоматически становишься администратором созданной тобой базы данных. Имена баз данных должны иметь первым символом букву и ограничены в длину 16 символами. Не каждый пользователь имеет право становится администратором базы данных. Если Postgres дает тебе создать базу данных, то администратору сайта нужно дать тебе право на создание баз данных. Проконсультируйся у администратора сайта, если это случилось.


Руководство администратора по PostgreSQLПредыдущийГлава 11. Управление базой данныхСледующий

Доступ к базе данных

Если ты имеешь созданную базу данных, ты можешь получить к ней доступ:

Ты можешь запустить psql, чтобы попробовать примеры из этого руководства. Это можно сделать для базы данных dbname, набрав команду:
% psql dbname
    
Ты получишь следующее приветственное сообщение:
Welcome to the Postgres interactive sql monitor:

  type \? for help on slash commands
  type \q to quit
  type \g or terminate with semicolon to execute query
You are currently connected to the database: dbname

dbname=>
    

Такая подсказка показывает, что управляющая программа слушает тебя и что ты можешь набирать SQL запросы в рабочей области, обслуживаемой управляющей программой. Программа psql реагирует на управляющие коды, которые начинаются с символа обратного слэша, "\". Например, можно получить помощь по синтаксису различных команд Postgres SQL введя:

dbname=> \h
    
После того как, ты закончил вводить запросы в рабочую область, ты можешь передать её содержимое на сервер Postgres введя:
dbname=> \g
    
Это говорит серверу обработать запрос. Если ты заканчиваешь запрос точкой с запятой, то обратный слэш-g не нужен. psql автоматически обрабатывает запросы, оканчивающиеся точкой с запятой. Чтобы прочитать запросы из файла вместо ввода в диалоговом режиме, набери:
dbname=> \i filename
    
Чтобы выйти из psql и вернуться в UNIX, набери
dbname=> \q
    
и psql завершится и ты вернёшься в свой командный shell. ( Чтобы увидеть остальные управляющие коды, набери обратный слэш-h в строке монитора.) Пустые места (т.е., пробелы, табуляции и символы новой строки) можно свободно использоваться в SQL запросах. Одностроковые комментарии обозначены двумя линиями (“--”). Всё после линий до конца строки игнорируется. Многостроковые комментарии и в пределах этих строк, обозначаются “/* ... */”, соглашение, позаимствованное из Ingres.


Руководство администратора по PostgreSQLПредыдущийГлава 11. Управление базой данныхСледующий

Уничтожение базы данных

Если ты администратор базы данных mydb, то ты можешь уничтожить её с помощью следующей команды UNIX:

% dropdb dbname
    
Это действие физически уничтожает все файлы UNIX, связанные с базой данных и их нельзя восстановить, поэтому это нужно выполнять только по всеобщему соглашению.

Также, возможно уничтожить базу данных из сессии SQL, используя

> drop database dbname
    


Руководство администратора по PostgreSQLПредыдущийГлава 11. Управление базой данныхСледующий

Резервное копирование и восстановление

Предупреждение

Для каждой базы данных необходимо делать резервное копирование на регулярной основе. Т.к. Postgres сам управляет своими файлами в файловой системе, то не благоразумно полагаться на системное резервное копирование файловой системы для резервного копирования баз данных; она не гарантирует, что файлы останутся рабочими после восстановления.

Postgres обеспечивает две утилиты для резервного копирования системы: pg_dump для резервного копирования индивидуальных баз данных и pg_dumpall для резервного копирования установки за один шаг.

Для отдельной базы данных можно сделать резервную копию с помощью следующей команды:

% pg_dump dbname > dbname.pgdump
    
и восстановить с помощью
cat dbname.pgdump | psql dbname
    

Эта техника может быть использована для перемещения базы данных в новое место, и для переименования существующих баз данных.

Огромные базы данных

Автор: Написано Hannu Krosing в 1999-06-19.

Т.к. Postgres позволяет таблицы больше чем максимальный размер файла в системе, может быть проблематично сбросить таблицу в файл, вероятно, что результирующий файл окажется больше, чем максимальный размер файла, разрешенной в системе.

Так как pg_dump пишет в stdout, ты можешь использовать стандартные утилиты *nix для работы над этой возможной проблемой:

Конечно, имя файла (filename) и содержимое вывода pg_dump не нужно сравнивать с именем базы данных. Также, восстановленная база данных может иметь произвольное новое имя, так что этот механизм также подходит для переименования базы данных.


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 9. Добавление и удаление пользователей

createuser разрешает указанным пользователям доступ к Postgres. destroyuser удаляет пользователей и препятствует их доступу к Postgres.

Эти команды влияют только на пользователей относящихся к Postgres; они не влияют на другие привилегии пользователей или их состояние в операционной системе.


Руководство администратора по PostgreSQLПредыдущийГлава 1. ВведениеСледующий

Нотация

“...” или /usr/local/pgsql/ в начале имени файла используются для представления пути к домашнему каталогу суперпользователя Postgres.

В командном синтаксисе, скобки (“[” и “]”) показывают, что выражение или ключевое слово необязательны. Всё в фигурных скобках (“{” и “}”) и содержащие вертикальные штрихи (“|”) показывают, что ты можешь выбрать из них что-то одно.

В примерах, круглые скобки (“(” и “)”) используются для группировки логических выражений. “|” - это логический оператор OR.

В примерах показано выполнение команд из различных бюджетов и программ. Команды, выполняемые из бюджета root предваряются “>”. Команды, выполняемые из бюджета суперпользователя Postgres предваряются “%”, в то время как команды выполняемые из бюджета непревелигерованных пользователей предваряются “$”. Команды SQL предваряются “=>” или не имеют приглашения, в зависимости от смысла.

Внимание: На время написания (Postgres v6.5) нотации выделение команд не последовательно по всему набору документации. Пожалуйста, сообщайте об этой проблеме в список рассылки по документации.


Руководство администратора по PostgreSQLПредыдущийГлава 7. Рабочая средаСледующий

Использование pg_options

Замечание: При содействии Massimo Dal Zotto

Необязательный файл data/pg_options содержит опции выполнения, используемые сервером для управления трассировкой сообщений и другие настраиваемые параметры сервера. Файл перечитывается сервером при приеме сигнала SIGHUP, что дает возможность изменять опции выполнения на лету без перезапуска Postgres. Опции, указанные в этом файле, могут быть флагами отладки, используемые пакетом трассировки (backend/utils/misc/trace.c) или числовыми параметрами, которые могут использоваться сервером для управления его работой.

Все опции pg_options при запуске сервера установлены в ноль. Новые или измененные опции будут читаться всеми новыми серверами при их запуске. Чтобы сделать действительными любые изменения для всех запущенных серверов, нужно послать SIGHUP в postmaster. Сигнал будет автоматически послан всем серверам. Также мы можем включить изменения только для определенных серверов, посылая им сигнал SIGHUP напрямую.

pg_options также можно указать в ключе -T Postgres:

postgres options -T "verbose=2,query,hostlookup-"
    

Функции, используемые для печати ошибок и сообщений отладки теперь могут использовать удобства syslog(2). Сообщения, печатающиеся в stdout или stderr, предваряются временной отметкой и pid сервера:

#timestamp          #pid    #message
980127.17:52:14.173 [29271] StartTransactionCommand
980127.17:52:14.174 [29271] ProcessUtility: drop table t;
980127.17:52:14.186 [29271] SIIncNumEntries: table is 70% full
980127.17:52:14.186 [29286] Async_NotifyHandler
980127.17:52:14.186 [29286] Waking up sleeping backend process
980127.19:52:14.292 [29286] Async_NotifyFrontEnd
980127.19:52:14.413 [29286] Async_NotifyFrontEnd done
980127.19:52:14.466 [29286] Async_NotifyHandler done
    

Этот формат улучшает читабельность logs и позволяет людям точно понять какой сервер что делал и в какое время. Это также облегчает написание простых сценариев awk или perl, которые проверяют log для обнаружения ошибок базы данных и проблем, или для вычисления временной статистики по транзакциям.

Сообщения, выводящиеся в syslog, используют log возможность LOG_LOCAL0. Использование syslog можно контролировать с помощью syslog pg_option. К сожалению, многие функции вызывают напрямую printf() для печати своих сообщений в stdout или stderr и этот вывод не может быть перенаправлен в syslog или иметь временных отметок. Рекомендуется, чтобы все вызовы printf замещались макросами PRINTF и вывод в stderr использовал бы EPRINTF, для того чтобы мы могли контролировать весь вывод в стандартном виде.

Формат файла pg_options следующий:

# comment
option=integer_value  # set value for option
option                # set option = 1
option+               # set option = 1
option-               # set option = 0
    
Заметьте, что ключевым словом также может быть аббревиатура названия опции, определённой в backend/utils/misc/trace.c.

Пример 7-1. Файл pg_options

Например мой файл pg_options содержит следующие значения:

verbose=2
query
hostlookup
showportnumber
      

Распознаваемые опции

В настоящий момент определены следующие опции:

all

Флаг глобальной трассировки. Допустимые значения:

0

Сообщения трассировки разрешаются индивидуально

1

Разрешены все сообщения трассировки

-1

Запрещены все сообщения трассировки

verbose

Флаг подробностей. Допустимые значения:

0

Нет сообщений. По умолчанию.

1

Печатать информационные сообщения.

2

Печатать более информативные сообщения.

query

Флаг трассировки запроса. Допустимые значения:

0

Не печатать запрос.

1

Печатать сжатый запрос в одну строку.

4

Печатать полный запрос.

plan

Печатать план запроса.

parse

Печатать после разбора.

rewritten

Печатать переписанный запрос.

parserstats

Печатать статистику разборщика.

plannerstats

Печатать статистику планировщика.

executorstats

Печатать статистику исполнителя.

shortlocks

В настоящий момент не используется, но необходима для использования в будущем.

locks

Трассировка блокировок.

userlocks

Трассировка блокировок пользователя.

spinlocks

Трассировка spin блокировок.

notify

Трассировка уведомляющих функций.

malloc

В настоящий момент не используется.

palloc

В настоящий момент не используется.

lock_debug_oidmin

Минимальный oid для трассировки блокировок.

lock_debug_relid

Если oid не равно нулю, то трассировка блокировок.

lock_read_priority

В настоящий момент не используется.

deadlock_timeout

Таймер проверки взаимных блокировок.

syslog

Флаг syslog. Допустимые значения:

0

Сообщения в stdout/stderr.

1

Сообщения в stdout/stderr и syslog.

2

Сообщения только в syslog.

hostlookup

Разрешить поиск имени хоста в ps_status.

showportnumber

Разрешить отображение номера порта в ps_status.

notifyunlock

Разблокировка pg_listener после уведомления.

notifyhack

Удалять дубликаты кортежей из pg_listener.


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 2. Переносимость

Оглавление
Поддерживаемые платформы на данный момент
Неподдерживаемые платформы

Это руководство описывает Postgres версии 6.5. Сообщество разработчиков Postgres компилировало и тестировало Postgres на многих платформах. Проверяй последнюю информацию на на web сайте.

Поддерживаемые платформы на данный момент

На время публикации, прошли тесты следующие платформы:

Таблица 2-1. Поддерживаемые платформы

ОСПроцессорВерсияСообщилЗамечания
AIX 4.3.2RS6000v6.51999-05-26(Andreas Zeugswetter)
BSDIx86v6.51999-05-25(Bruce Momjian
FreeBSD 2.2.x-4.0x86v6.51999-05-25(Tatsuo Ishii, Marc Fournier)
DGUX 5.4R4.11m88kv6.31998-03-01с v6.4, вероятно, OK. Нужен новый сопровождающий. (Brian E Gallew)
Digital Unix 4.0Alphav6.41998-10-29Небольшие проблемы, решаемые патчами (Pedro J. Lobo)
HPUXPA-RISCv6.41998-10-25Обе версии 9.0x и 10.20 (Tom Lane, Stan Brown)
IRIX 6.5MIPSv6.41998-12-29IRIX 5.x - другой (Mark Dalphin)
linux 2.0.xAlphav6.3.21998-04-16По большей части порядок. Нужно работать над v6.4. (Ryan Kirkpatrick)
linux 2.0.x/libc5x86v6.41998-10-27(Thomas Lockhart)
linux 2.0.x/glibc2x86v6.51999-05-24(Thomas Lockhart)
linux 2.0.xMIPSv6.41998-12-16Cobalt Qube (Tatsuo Ishii)
linux 2.0.xSparcv6.41998-10-25(Tom Szybist)
linuxPPC 2.1.24PPC603ev6.41998-10-26Powerbook 2400c (Tatsuo Ishii)
mklinux DR3PPC750v6.41998-09-16PowerMac 7600 (Tatsuo Ishii)
NetBSDarm32v6.51999-04-14(Andrew McMurry)
NetBSD/i386 1.3.2x86v6.41998-10-25(Brook Milligan)
NetBSDm68kv6.4.21998-12-28Mac SE/30 (Mr. Mutsuki Nakajima, Tatsuo Ishii)
NetBSD-currentNS32532v6.41998-10-27маленькие проблемы с математикой в дате/времени (Jon Buller)
NetBSD/sparc 1.3HSparcv6.41998-10-27(Tom I Helbekkmo)
NetBSD 1.3VAXv6.31998-03-01(Tom I Helbekkmo)
SCO OpenServer 5x86v6.51999-05-25(Andrew Merrill)
SCO UnixWare 7x86v6.51999-05-25(Andrew Merrill)
Solarisx86v6.41998-10-28(Marc Fournier)
Solaris 2.6-2.7Sparcv6.41998-10-28(Tom Szybist, Frank Ridderbusch)
SunOS 4.1.4Sparcv6.31998-03-01Работает с патчем (Tatsuo Ishii)
SVR4MIPSv6.41998-10-28Нет поддержки компилятором 64-bit int (Frank Ridderbusch)
Windowsx86v6.41999-01-06Клиентские библиотеки или ODBC/JDBC. Сервера ещё нет. (Magnus Hagander
Windows NTx86v6.51999-05-26Работает с библиотекой Cygwin. (Daniel Horak)

Платформы, работающие с v6.3.x и v6.4.x, должны также работать и с v6.5, но мы не получили явного подтверждения ко времени компиляции списка.

Замечание: Для Windows NT перенос серверной части Postgres был завершён недавно. Для его компиляции необходима библиотека Cygnus.


Руководство администратора по PostgreSQLПредыдущийГлава 2. ПереносимостьСледующий

Неподдерживаемые платформы

Есть несколько платформ, на которых пытались и сообщили, что на них не работает стандартный дистрибутив. Ещё здесь есть платформы, которые не обеспечивают достаточных библиотек для попытки.

Таблица 2-2. Вероятно, несовместимые платформы

ОСПроцессорВерсияСообщилЗамечания
MacOSallv6.31998-03-01Несовместимые библиотеки; используй ODBC/JDBC
NextStepx86v6.x1998-03-01Поддержка только клиентов; v1.0.9 работает с патчами (David Wetzel)
SVR4 4.4m88kv6.2.11998-03-01Приемлемо с патчами; v6.4.x необходим TAS spinlock код (Doug Winterburn)
UltrixMIPS,VAX?v6.x1998-03-01Давно нет сообщений; вышла из употребления?


Руководство администратора по PostgreSQLПредыдущийГлава 7. Рабочая средаСледующий

Запуск postmaster

Ничего не происходит с базой данных, пока не запущен процесс postmaster. Для администратора сайта, есть несколько вещей о которых нужно помнить перед запуском postmaster. Они обсуждаются в разделах установки и настройки этого руководства. Однако, если Postgres был установлен по инструкции точно как написано, то следующие простые команды - это все что надо для запуска postmaster:

% postmaster
    

The postmaster время от времени выводит сообщения, которые часто полезны при поисках неисправностей. Если ты хочешь посмотреть сообщения отладки от postmaster, ты можешь запустить его с опцией -d и перенаправить вывод в log файл:

% postmaster -d > pm.log 2>&1 &
    
Если ты не хочешь видеть эти сообщения, ты можешь набрать
% postmaster -S
    
и postmaster будет работать тихо ("S"ilent). Предупреждаем, что в конце строки нет амперсанда ("&") в последнем примере, поэтому postmaster будет запущен в интерактивном режиме.


Руководство администратора по PostgreSQLПредыдущийСледующий

Резюме

Postgres изначально разрабатывался в UC Berkeley Computer Science Department, цитадели многих объектно-реляционных концепций, теперь ставших доступными в некоторых коммерческих базах данных. Он обеспечивает поддержку языка SQL92/SQL3, целостность транзакций и расширяемость типов. PostgreSQL является всеобщим достоянием, потомком с открытыми исходными текстами этого оригинального кода Berkeley.


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 13. Восстановление базы данных

Этот раздел необходимо переписать. Добровольцы?


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 14. Регрессивный тест

Оглавление
Регрессивная среда
Схема размещения каталогов
Процедура регрессивного тестирования
Регрессивный анализ

Инструкции регрессивных тестов и анализ.

Регрессивные тесты PostgreSQL - это обширный набор тестов для реализации SQL, встроенного в PostgreSQL, разработанного Jolly Chen и Andrew Yu. Он тестируют как стандартны операции SQL, как расширенные возможности PostgreSQL.

Эти тесты недавно были были исправлены Marc Fournier и Thomas Lockhart и теперь упакованы как функциональные модули, которые легче запускать и понимать. После PostgreSQL v6.1 регрессивные тесты теперь в каждом официальном релизе.

Некоторые правильно установленные и полностью функциональные установки PostgreSQL, могут не пройти некоторые регрессивные тесты из-за различного представления чисел с плавающей точкой и поддержки временных зон. Текущие тесты оцениваются с помощью простого алгоритма "diff", и чувствительны к маленьким системным различиям. Для явно не прошедших тестов, при исследовании различий может обнаружиться, что различия несущественны.

Регрессивное тестирование, отмечаемое ниже, предполагает следующее (исключая замечания):

Регрессивная среда

Регрессивный тест вызывается командой make, которая компилирует программу C, в разделяемую библиотеку в текущем каталоге. Также в текущем каталоге создаются локализованные сценарии shell. Файлы шаблонов вывода в файлах ./expected/*.out. Локализация заменяет макросы в исходных файлах абсолютными именами и именами пользователей.

Обычно, регрессивный тест должен запускаться pg_superuser, т.к. каталог 'src/test/regress' и подкаталоги принадлежат pg_superuser. Если ты запустил регрессивный тест другим пользователем, то он должен иметь право на запись в дерево каталогов 'src/test/regress'.

Прежде было необходимо запускать postmaster с системной временной зоной установленной в PST, но теперь это больше ненужно. Ты можешь запускать регерессивные тесты под обычной конфигурацией postmaster. Сценарий теста устанавливает переменную среды PGTZ, чтобы быть уверенным что тесты зависящие от временной зоны приведут к ожидаемым результатам. Однако, твоя система должна быть обеспечена библиотекой поддержки для временной зоны PST8PDT, или тесты зависящие от временной зоны, не пройдут. Для проверки, что твоя система имеет такую поддержку, набери следующее:

    setenv TZ PST8PDT
    date

Команда "date" выше, должна вернуть текущую системное время во временной зоне PST8PDT. Если база данных PST8PDT недоступна, то твоя система может вернуть время в GMT. Если временная зона PST8PDT недоступна, то можно установить правила временной зоны так:

    setenv PGTZ PST8PDT7,M04.01.0,M10.05.03
      


Руководство администратора по PostgreSQLПредыдущийГлава 14. Регрессивный тестСледующий

Схема размещения каталогов

Замечание: Здесь должна быть таблица из предыдущего раздела.

  input/ .... .source файлы, которые преобразуются 'make all' в другие
              файлы .sql в 'sql' подкаталоге

  output/ ... .source файл, которые преобразуются 'make all' в
              .out файлы в 'expected' подкаталоге

  sql/ ...... .sql файлы, используемые для выполнения регрессивных тестов

  expected/ . .out файлы, которые представляют что мы *ожидаем* результаты
              look like

  results/ .. .out файлы, которые представляют какие результаты мы *получили*
	      на самом деле. Также, используется как временное хранение
	      для тестирования копирования таблиц.
      


Руководство администратора по PostgreSQLПредыдущийГлава 14. Регрессивный тестСледующий

Процедура регрессивного тестирования

Команды тестировались на RedHat Linux версии 4.2 с использованием bash shell. Где не отмечено, они будут работать на большинстве систем. Команды типа ps и tar, имеют опции, сильно отличающиеся на разных платформах. Пользуйся здравым смыслом, перед тем как вводить эти команды.

Для новой установки или обновления с предыдущих версий Postgres:

Настройка регрессии Postgres

  1. Файл /usr/src/pgsql/src/test/regress/README содержит подробные инструкции для запуска и понимания регрессивных тестов. Сокращенная версия здесь:

    Если postmaster ещё не запущен, запусти postmaster в доступном окне, набрав

    	    postmaster
    	  
    , или запусти демон postmaster в фоновом режиме, набрав
    	    cd
    	    nohup postmaster > regress.log 2>&1 &
    	  

    Запускай postmaster из под бюджета суперпользователя Postgres(обычно, бюджет postgres).

    Замечание: Не запускай postmaster из бюджета root.

  2. Если ты уже вызывал регрессивный тест, очисти рабочий каталог:

    	    cd /usr/src/pgsql/src/test/regress
    	    gmake clean
    	  

    Тебе не нужно вводить "gmake clean", если ты первый раз запускаешь эти тесты.

  3. Собери регрессивный тест. Введи

    	    cd /usr/src/pgsql/src/test/regress
    	    gmake all
    	  

  4. Запусти регрессивные тесты. Введи

    	    cd /usr/src/pgsql/src/test/regress
    	    gmake runtest
    	  

  5. Ты получить на экране (а также в файле ./regress.out) серию предложений, из которых видно какие тесты прошли, а какие нет. Пожалуйста заметьте, что может быть нормально что некоторые тесты "не прошли". Для несработавших тестов, используй diff, чтобы сравнить файлы в каталогах ./results и ./expected. Если float8 не прошёл, введи что-то вроде этого:

    	    cd /usr/src/pgsql/src/test/regress
    	    diff -w expected/float8.out results
    	  

  6. После запуска тестов и исследования результатов, введи

    	    dropdb regression
    	    cd /usr/src/pgsql/src/test/regress
    	    gmake clean
    	  
    чтобы освободить временное дисковое пространство, использованное тестами.


Руководство администратора по PostgreSQLПредыдущийГлава 14. Регрессивный тестСледующий

Регрессивный анализ

Результаты лежат в файлах в каталоге ./results. Эти результаты можно сравнить с результатами в каталоге ./expected, используя 'diff'. (Тестирующий сценарий сделает это за тебя, и поместит отличия в ./regression.diffs.)

Файлы могут точно не совпадать. Тестирующий сценарий сообщит о любом отличии как о "провале", но отличие может быть из-за маленьких системо-зависимых различий в написании сообщений ошибок, работы математической библиотеки, и т.д. "Провалы" такого типа не указывают на проблему с Postgres.

Поэтому, необходимо исследовать фактическую разницу для каждого "непрошедшего" теста, чтобы определить, есть ли реальная проблема. Следующие параграфы пытаются предоставить некоторое руководство в определении значима ли разница или нет.

Расхождения в сообщения об ошибках

Некоторые регрессивные тесты включают в себя создаваемые неправильные значения ввода. Сообщения об ошибках могут появиться или из кода Postgres code или из процедур системы платформы хоста. В последнем случае, сообщения могут различаться между платформами, но должны отражать похожую информацию. Эти различия в сообщениях приводят к "провалу" регрессивного теста, которая может быть обоснована проверкой.

OID различия

Есть несколько мест, где PostgreSQL OID (идентификаторы объектов) появляются в 'regress.out'. OIDы - это уникальные 32-битные целые, которые генерируются сервером PostgreSQL, в зависимости от того вставляется ли строка таблицы или обновляется. Если ты запустил регрессивный тест над уже пользованной базой данных или запускал его несколько раз, то выдаваемые OIDы будут иметь разные значения. Следующие предложения SQL в 'misc.out' отражают такое поведение: QUERY: SELECT user_relns() AS user_relns ORDER BY user_relns; The 'a,523676' row is composed from an OID.

Различия в дате и времени

Большинство результатов даты и времени зависят от среды временной зоны. Соответствующие файлы генерировались для временной зоны PST8PDT (Berkeley, California) и поэтому обнаружится несостоятельность, если тесты запущены в ненастроенной временной зоне. Драйвер регрессивного теста устанавливает переменную среды PGTZ в PST8PDT чтобы получить правильные результаты.

Подобное случается на некоторых системах, которые не поддерживают рекомендуемый синтаксические правила настройки локальной временной зоны; тебе могут потребоваться другие настройки PGTZ на таких машинах.

Некоторые системы, использующие старые библиотеки временных зон, не смогут выполнить перевод часовой стрелки на даты до-1970 dates, и время до-1970 PDT будет отображаться в PST. Все эти различия локализации отразятся на результатах тестов.

Различия в числах с плавающей запятой

Некоторые тесты затрагивают вычисления 64-битных (float8) чисел из таблицы столбцов. Разница в результатах предполагает наблюдение за математическими функциями над столбцами float8. float8 и геометрические тесты особенно падки на маленькие отличия между платформами. При сравнении человеческим глазом нужно определить реальную значимость этих отличий, которые обычно имеются в 10 знаках справа от десятичной точки.

Некоторые системы сигнализируют об ошибках от pow() и exp() по-разному, в зависимости от механизма, ожидаемого текущим кодом Postgres.

Различия в многоугольниках

Некоторые тесты затрагивают операции с географическими данными о карте улиц Oakland/Berkley CA. Данные карты представлены в виде многоугольников, чьи вершины представляются в виде пары float8 чисел (десятичные широта и долгота). Сначала, создавались таблицы и заполнялись географическими данными, затем создавались некоторые представления, которые объединяли две таблицы, используя оператор пересечения многоугольников (##), затем представление заканчивалось выборкой. Когда сравнивались результаты сравнения разных платформ, то появлялась разница во 2м или 3м порядке справа от десятичной точки. Вот операторы SQL, где возникали эти проблемы:

	  QUERY: SELECT * from street;
	  QUERY: SELECT * from iexit;
	

Random различия

Есть по крайней мере один тест в random.out, который предназначен для создания результатов random. Это вызывает неудачу random регрессивных тестов в это время. Набрав

	  diff results/random.out expected/random.out
	
получим только одну или несколько строк различий по этой причине, но другие различия с плавающей точкой с непохожей архитектурой могут вызывать много других различий. Смотри замечания по релизам ниже.

“Ожидаемые” файлы

Файлы ./expected/*.out переделываются из первоначального монолитного expected.input файла, созданного Jolly Chen et al. Новые версии этих файлов, генерируемые различными машина разработки, заменяются после тщательной (?) проверки. Многие машины разработки работают на на вариантах ОС Unix (FreeBSD, Linux, и т.д.) на аппаратуре Ix86. Первоначальный expected.input файл создан на системе SPARC Solaris 2.4, используя postgres5-1.02a5.tar.gz дерево исходников. Он был сравнён с файлом, созданным на системе I386 Solaris 2.4 и отличался только в многоугольниках плавающей точкой в 3ей цифре справа от десятичной точки. (смотри ниже) Первоначальный sample.regress.out файл был в postgres-1.01 релизе, собранном Jolly Chen и включён здесь для ссылки. Он мог быть создан на машине DEC ALPHA как Makefile.global в postgres-1.01 релизе с именем PORTNAME=alpha.


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 15. Замечания по выпускам

Оглавление
Выпуск 6.5.1
Выпуск 6.5
Выпуск 6.4.2
Выпуск 6.4.1
Выпуск 6.4
Выпуск 6.3.2
Выпуск 6.3.1
Выпуск 6.3
Выпуск 6.2.1
Выпуск 6.2
Выпуск 6.1.1
Выпуск 6.1
Выпуск v6.0
Выпуск v1.09
Выпуск v1.02
Выпуск v1.01
Выпуск v1.0
Postgres95 Beta 0.03
Postgres95 Beta 0.02
Postgres95 Beta 0.01
Расчёт времени результатов

Выпуск 6.5.1

This is basically a cleanup release for 6.5. We have fixed a variety of problems reported by 6.5 users.

Переход на v6.5.1

A dump/restore is not required for those running 6.5.

Подробный список изменений

Add NT README file
Portability fixes for linux_ppc, Irix, linux_alpha, OpenBSD, alpha
Remove QUERY_LIMIT, use SELECT...LIMIT
Fix for EXPLAIN on inheritance(Tom)
Patch to allow vacuum on multi-segment tables(Hiroshi)
R=Tree optimizer selectivity fix(Tom)
ACL file descriptor leak fix(Atsushi Ogawa)
New expresssion subtree code(Tom)
Avoid disk writes for read-only transactions(Vadim)
Fix for removal of temp tables if last transaction was aborted(Bruce)
Fix to prevent too large tuple from being created(Bruce)
plpgsql fixes
Allow port numbers 32k - 64k(Bruce)
Add ^ precidence(Bruce)
Rename sort files called pg_temp to pg_sorttemp(Bruce)
Fix for microseconds in time values(Tom)
Tutorial source cleanup
New linux_m68k port
Fix for sorting of NULL's in some cases(Tom)
Shared library dependencies fixed (Tom)
Fixed glitches affecting GROUP BY in subselects(Tom)
Fix some compiler warnings (Tomoaki Nishiyama)
Add Win1250 (Czech) support (Pavel Behal)


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск 6.5

This release marks a major step in the development team's mastery of the source code we inherited from Berkeley. You will see we are now easily adding major features, thanks to the increasing size and experience of our world-wide development team.

Here is a brief summary of the more notable changes:

Multi-version concurrency control(MVCC)

This removes our old table-level locking, and replaces it with a locking system that is superior to most commercial database systems. In a traditional system, each row that is modified is locked until committed, preventing reads by other users. MVCC uses the natural multi-version nature of PostgreSQL to allow readers to continue reading consistent data during writer activity. Writers continue to use the compact pg_log transaction system. This is all performed without having to allocate a lock for every row like traditional database systems. So, basically, we no longer are restricted by simple table-level locking; we have something better than row-level locking.

Hot backups from pg_dump

pg_dump takes advantage of the new MVCC features to give a consistant database dump/backup while the database stays online and available for queries.

Numeric data type

We now have a true numeric data type, with user-specified precision.

Temporary tables

Temporary tables are guaranteed to have unique names within a database session, and are destroyed on session exit.

New SQL features

We now have CASE, INTERSECT, and EXCEPT statement support. We have new LIMIT/OFFSET, SET TRANSACTION ISOLATION LEVEL, SELECT ... FOR UPDATE, and an improved LOCK TABLE command.

Speedups

We continue to speed up PostgreSQL, thanks to the variety of talents within our team. We have sped up memory allocation, optimization, table joins, and row transfer routines.

Переносимость

We continue to expand our port list, this time including WinNT/ix86 and NetBSD/arm32.

Interfaces

Most interfaces have new versions, and existing functionality has been improved.

Documentation

New and updated material is present throughout the documentation. New FAQs have been contributed for SGI and AIX platforms. The Tutorial has introductory information on SQL from Stefan Simkovics. For the Руководство пользователя, there are reference pages covering the postmaster and more utility programs, and a new appendix contains details on date/time behavior. The Руководство администратора has a new chapter on troubleshooting from Tom Lane. And the Руководство программиста has a description of query processing, also from Stefan, and details on obtaining the Postgres source tree via anonymous CVS and CVSup.

Migration to v6.5

A dump/restore using pg_dump is required for those wishing to migrate data from any previous release of Postgres. pg_upgrade can not be used to upgrade to this release because the on-disk structure of the tables has changed compared to previous releases.

The new Multi-Version Concurrency Control (MVCC) features can give somewhat different behaviors in multi-user environments. Read and understand the following section to ensure that your existing applications will give you the behavior you need.

Multi-Version Concurrency Control

Because readers in 6.5 don't lock data, regardless of transaction isolation level, data read by one transaction can be overwritten by another. In other words, if a row is returned by SELECT it doesn't mean that this row really exists at the time it is returned (i.e. sometime after the statement or transaction began) nor that the row is protected from being deleted or updated by concurrent transactions before the current transaction does a commit or rollback.

To ensure the actual existence of a row and protect it against concurrent updates one must use SELECT FOR UPDATE or an appropriate LOCK TABLE statement. This should be taken into account when porting applications from previous releases of Postgres and other environments.

Keep the above in mind if you are using contrib/refint.* triggers for referential integrity. Additional technics are required now. One way is to use LOCK parent_table IN SHARE ROW EXCLUSIVE MODE command if a transaction is going to update/delete a primary key and use LOCK parent_table IN SHARE MODE command if a transaction is going to update/insert a foreign key.

Note: Note that if you run a transaction in SERIALIZABLE mode then you must execute the LOCK commands above before execution of any DML statement (SELECT/INSERT/DELETE/UPDATE/FETCH/COPY_TO) in the transaction.

These inconveniences will disappear in the future when the ability to read dirty (uncommitted) data (regardless of isolation level) and true referential integrity will be implemented.

Подробный список изменений

Bug Fixes
---------
Fix text<->float8 and text<->float4 conversion functions(Thomas)
Fix for creating tables with mixed-case constraints(Billy)
Change exp()/pow() behavior to generate error on underflow/overflow(Jan)
Fix bug in pg_dump -z
Memory overrun cleanups(Tatsuo)
Fix for lo_import crash(Tatsuo)
Adjust handling of data type names to suppress double quotes(Thomas)
Use type coersion for matching columns and DEFAULT(Thomas)
Fix deadlock so it only checks once after one second of sleep(Bruce)
Fixes for aggregates and PL/pgsql(Hiroshi)
Fix for subquery crash(Vadim)
Fix for libpq function PQfnumber and case-insensitive names(Bahman Rafatjoo)
Fix for large object write-in-middle, no extra block, memory consumption(Tatsuo)
Fix for pg_dump -d or -D and  quote special characters in INSERT
Repair serious problems with dynahash(Tom)
Fix INET/CIDR portability problems
Fix problem with selectivity error in ALTER TABLE ADD COLUMN(Bruce)
Fix executor so mergejoin of different column types works(Tom)
Fix for Alpha OR selectivity bug
Fix OR index selectivity problem(Bruce)
Fix so \d shows proper length for char()/varchar()(Ryan)
Fix tutorial code(Clark)
Improve destroyuser checking(Oliver)
Fix for Kerberos(Rodney McDuff)
Fix for dropping database while dirty buffers(Bruce)
Fix so sequence nextval() can be case-sensitive(Bruce)
Fix !!= operator
Drop buffers before destroying database files(Bruce)
Fix case where executor evaluates functions twice(Tatsuo)
Allow sequence nextval actions to be case-sensitive(Bruce)
Fix optimizer indexing not working for negative numbers(Bruce)
Fix for memory leak in executor with fjIsNull
Fix for aggregate memory leaks(Erik Riedel)
Allow username containing a dash GRANT permissions
Cleanup of NULL in inet types
Clean up system═table bugs(Tom)
Fix problems of PAGER and \? command(Masaaki Sakaida)
Reduce default multi-segment file size limit to 1GB(Peter)
Fix for dumping of CREATE OPERATOR(Tom)
Fix for backward scanning of cursors(Hiroshi Inoue)
Fix for COPY FROM STDIN when using \i(Tom)
Fix for subselect is compared inside an expression(Jan)
Fix handling of error reporting while returning rows(Tom)
Fix problems with reference to array types(Tom,Jan)
Prevent UPDATE SET oid(Jan)
Fix pg_dump so -t option can handle case-sensitive tablenames
Fixes for GROUP BY in special cases(Tom, Jan)
Fix for memory leak in failed queries(Tom)
DEFAULT now supports mixed-case identifiers(Tom)
Fix for multi-segment uses of DROP/RENAME table, indexes(Ole Gjerde)
Disable use of pg_dump with both -o and -d options(Bruce)
Allow pg_dump to properly dump GROUP permissions(Bruce)
Fix GROUP BY in INSERT INTO table SELECT * FROM table2(Jan)
Fix for computations in views(Jan)
Fix for aggregates on array indexes(Tom)
Fix for DEFAULT handles single quotes in value requiring too many quotes
Fix security problem with non-super users importing/exporting large objects(Tom)
Rollback of transaction that creates table cleaned up properly(Tom)
Fix to allow long table and column names to generate proper serial names(Tom)

Enhancements
------------
Add "vacuumdb" utility
Speed up libpq by allocating memory better(Tom)
EXPLAIN all indices used(Tom)
Implement CASE, COALESCE, NULLIF  expression(Thomas)
New pg_dump table output format(Constantin)
Add string min()/max() functions(Thomas)
Extend new type coersion techniques to aggregates(Thomas)
New moddatetime contrib(Terry)
Update to pgaccess 0.96(Constantin)
Add routines for single-byte "char" type(Thomas)
Improved substr() function(Thomas)
Improved multi-byte handling(Tatsuo)
Multi-version concurrency control/MVCC(Vadim)
New Serialized mode(Vadim)
Fix for tables over 2gigs(Peter)
New SET TRANSACTION ISOLATION LEVEL(Vadim)
New LOCK TABLE IN ... MODE(Vadim)
Update ODBC driver(Byron)
New NUMERIC data type(Jan)
New SELECT FOR UPDATE(Vadim)
Handle "NaN" and "Infinity" for input values(Jan)
Improved date/year handling(Thomas)
Improved handling of backend connections(Magnus)
New options ELOG_TIMESTAMPS and USE_SYSLOG options for log files(Massimo)
New TCL_ARRAYS option(Massimo)
New INTERSECT and EXCEPT(Stefan)
New pg_index.indisprimary for primary key tracking(D'Arcy)
New pg_dump option to allow dropping of tables before creation(Brook)
Speedup of row output routines(Tom)
New READ COMMITTED isolation level(Vadim)
New TEMP tables/indexes(Bruce)
Prevent sorting if result is already sorted(Jan)
New memory allocation optimization(Jan)
Allow psql to do \p\g(Bruce)
Allow multiple rule actions(Jan)
Added LIMIT/OFFSET functionality(Jan)
Improve optimizer when joining a large number of tables(Bruce)
New intro to SQL from S. Simkovics' Master's Thesis (Stefan, Thomas)
New intro to backend processing from S. Simkovics' Master's Thesis (Stefan)
Improved int8 support(Ryan Bradetich, Thomas, Tom)
New routines to convert between int8 and text/varchar types(Thomas)
New bushy plans, where meta-tables are joined(Bruce)
Enable right-hand queries by default(Bruce)
Allow reliable maximum number of backends to be set at configure time
      (--with-maxbackends and postmaster switch (-N backends))(Tom)
GEQO default now 10 tables because of optimizer speedups(Tom)
Allow NULL=Var for MS-SQL portability(Michael, Bruce)
Modify contrib check_primary_key() so either "automatic" or "dependent"(Anand)
Allow psql \d on a view show query(Ryan)
Speedup for LIKE(Bruce)
Ecpg fixes/features, see src/interfaces/ecpg/ChangeLog file(Michael)
JDBC fixes/features, see src/interfaces/jdbc/CHANGELOG(Peter)
Make % operator have precedence like /(Bruce)
Add new postgres -O option to allow system table structure changes(Bruce)
Update contrib/pginterface/findoidjoins script(Tom)
Major speedup in vacuum of deleted rows with indexes(Vadim) 
Allow non-SQL functions to run different versions based on arguments(Tom)
Add -E option that shows actual queries sent by \dt and friends(Masaaki Sakaida)
Add version number in startup banners for psql(Masaaki Sakaida)
New contrib/vacuumlo removes large objects not referenced(Peter)
New initialization for table sizes so non-vacuumed tables perform better(Tom)
Improve error messages when a connection is rejected(Tom)
Support for arrays of char() and varchar() fields(Massimo)
Overhaul of hash code to increase reliability and performance(Tom)
Update to PyGreSQL 2.4(D'Arcy)
Changed debug options so -d4 and -d5 produce different node displays(Jan)
New pg_options: pretty_plan, pretty_parse, pretty_rewritten(Jan)
Better optimization statistics for system table access(Tom)
Better handling of non-default block sizes(Massimo)
Improve GEQO optimizer memory consumption(Tom)
UNION now suppports ORDER BY of columns not in target list(Jan)
Major libpq++ improvements(Vince Vielhaber)
pg_dump now uses -z(ACL's) as default(Bruce)
backend cache, memory speedups(Tom)
have pg_dump do everything in one snapshot transaction(Vadim)
fix for large object memory leakage, fix for pg_dumping(Tom)
INET type now respects netmask for comparisons
Make VACUUM ANALYZE only use a readlock(Vadim)
Allow VIEWs on UNIONS(Jan)
pg_dump now can generate consistent snapshots on active databases(Vadim)

Source Tree Changes
-------------------
Improve port matching(Tom)
Portability fixes for SunOS
Add NT/Win32 backend port and enable dynamic loading(Magnus and Daniel Horak)
New port to Cobalt Qube(Mips) running Linux(Tatsuo)
Port to NetBSD/m68k(Mr. Mutsuki Nakajima)
Port to NetBSD/sun3(Mr. Mutsuki Nakajima)
Port to NetBSD/macppc(Toshimi Aoki)
Fix for tcl/tk configuration(Vince)
Removed CURRENT keyword for rule queries(Jan)
NT dynamic loading now works(Daniel Horak)
Add ARM32 support(Andrew McMurry)
Better support for HPUX 11 and Unixware
Improve file handling to be more uniform, prevent file descriptor leak(Tom)
New install commands for plpgsql(Jan)
     


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск 6.4.2

Релиз 6.4.1 был неправильно упакован. Также был добавлен одно дополнительное исправление бага.

Переход на v6.4.2

A dump/restore не нужны для запуска 6.4.*.

Подробный список изменений

Исправление проблемы с константами дат/времени на некоторых платформах(Thomas)


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск 6.4.1

В основном, чистка после релиза 6.4. Мы исправили различные проблемы, отмеченные пользователями 6.4.

Переход на v6.4.1

A dump/restore не нужны для запуска 6.4.

Подробный список изменений

Add pg_dump -N flag to force double quotes around identifiers.  This is
	the default(Thomas)
Fix for NOT in where clause causing crash(Bruce)
EXPLAIN VERBOSE coredump fix(Vadim)
Fix shared-library problems on Linux
Fix test for table existance to allow mixed-case and whitespace in
	the table name(Thomas)
Fix a couple of pg_dump bugs
Configure matches template/.similar entries better(Tom)
Change builtin function names from SPI_* to spi_*
OR WHERE clause fix(Vadim)
Fixes for mixed-case table names(Billy)
contrib/linux/postgres.init.csh/sh fix(Thomas)
libpq memory overrun fix
SunOS fixes(Tom)
Change exp() behavior to generate error on underflow(Thomas)
pg_dump fixes for memory leak, inheritance constraints, layout change
update pgaccess to 0.93
Fix prototype for 64-bit platforms
Multi-byte fixes(Tatsuo)
New ecpg man page
Fix memory overruns(Tatsuo)
Fix for lo_import() crash(Bruce)
Better search for install program(Tom)
Timezone fixes(Tom)
HPUX fixes(Tom)
Use implicit type coersion for matching DEFAULT values(Thomas)
Add routines to help with single-byte (internal) character type(Thomas)
Compilation of libpq for Win32 fixes(Magnus)
Upgrade to PyGreSQL 2.2(D'Arcy)


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск 6.4

There are many new features and improvements in this release. Thanks to our developers and maintainers, nearly every aspect of the system has received some attention since the previous release. Here is a brief, incomplete summary:

Migration to v6.4

A dump/restore using pg_dump or pg_dumpall is required for those wishing to migrate data from any previous release of Postgres.

Подробный список изменений

Bug Fixes
---------
Fix for a tiny memory leak in PQsetdb/PQfinish(Bryan)
Remove char2-16 data types, use char/varchar(Darren)
Pqfn not handles a NOTICE message(Anders)
Reduced busywaiting overhead for spinlocks with many backends (dg)
Stuck spinlock detection (dg)
Fix up "ISO-style" timespan decoding and encoding(Thomas)
Fix problem with table drop after rollback of transaction(Vadim)
Change error message and remove non-functional update message(Vadim)
Fix for COPY array checking
Fix for SELECT 1 UNION SELECT NULL
Fix for buffer leaks in large object calls(Pascal)
Change owner from oid to int4 type(Bruce)
Fix a bug in the oracle compatibility functions btrim() ltrim() and rtrim()
Fix for shared invalidation cache overflow(Massimo)
Prevent file descriptor leaks in failed COPY's(Bruce)
Fix memory leak in libpgtcl's pg_select(Constantin)
Fix problems with username/passwords over 8 characters(Tom)
Fix problems with handling of asynchronous NOTIFY in backend(Tom)
Fix of many bad system table entries(Tom)

Enhancements
------------
Upgrade ecpg and ecpglib,see src/interfaces/ecpc/ChangeLog(Michael)
Show the index used in an EXPLAIN(Zeugswetter)
EXPLAIN  invokes  rule system and shows plan(s) for rewritten queries(Jan)
Multi-byte awareness of many data types and functions, via configure(Tatsuo)
New configure --with-mb option(Tatsuo)
New initdb --pgencoding option(Tatsuo)
New createdb -E multibyte option(Tatsuo)
Select version(); now returns PostgreSQL version(Jeroen)
Libpq now allows asynchronous clients(Tom)
Allow cancel from client of backend query(Tom)
Psql now cancels query with Control-C(Tom)
Libpq users need not issue dummy queries to get NOTIFY messages(Tom)
NOTIFY now sends sender's PID, so you can tell whether it was your own(Tom)
PGresult struct now includes associated error message, if any(Tom)
Define "tz_hour" and "tz_minute" arguments to date_part()(Thomas)
Add routines to convert between varchar and bpchar(Thomas)
Add routines to allow sizing of varchar and bpchar into target columns(Thomas)
Add bit flags to support timezonehour and minute in data retrieval(Thomas)
Allow more variations on valid floating point numbers (e.g. ".1", "1e6")(Thomas)
Fixes for unary minus parsing with leading spaces(Thomas)
Implement TIMEZONE_HOUR, TIMEZONE_MINUTE per SQL92 specs(Thomas)
Check for and properly ignore FOREIGN KEY column constraints(Thomas)
Define USER as synonym for CURRENT_USER per SQL92 specs(Thomas)
Enable HAVING clause but no fixes elsewhere yet.
Make "char" type a synonym for "char(1)" (actually implemented as bpchar)(Thomas)
Save string type if specified for DEFAULT clause handling(Thomas)
Coerce operations involving different data types(Thomas)
Allow some index use for columns of different types(Thomas)
Add capabilities for automatic type conversion(Thomas)
Cleanups for large objects, so file is truncated on open(Peter)
Readline cleanups(Tom)
Allow psql  \f \ to make spaces as delimiter(Bruce)
Pass pg_attribute.atttypmod to the frontend for column field lengths(Tom,Bruce)
Msql compatibility library in /contrib(Aldrin)
Remove the requirement that ORDER/GROUP BY clause identifiers be 
included in the target list(David)
Convert columns to match columns in UNION clauses(Thomas)
Remove fork()/exec() and only do fork()(Bruce)
Jdbc cleanups(Peter)
Show backend status on ps command line(only works on some platforms)(Bruce)
Pg_hba.conf now has a sameuser option in the database field
Make lo_unlink take oid param, not int4
New DISABLE_COMPLEX_MACRO for compilers that can't handle our macros(Bruce)
Libpgtcl now handles NOTIFY as a Tcl event, need not send dummy queries(Tom)
libpgtcl cleanups(Tom)
Add -error option to libpgtcl's pg_result command(Tom)
New locale patch, see docs/README/locale(Oleg)
Fix for pg_dump so CONSTRAINT and CHECK syntax is correct(ccb)
New contrib/lo code for large object orphan removal(Peter)
New psql command "SET CLIENT_ENCODING TO 'encoding'" for multi-bytes
feature, see /doc/README.mb(Tatsuo)
/contrib/noupdate code to revoke update permission on a column
Libpq can now be compiled on win32(Magnus)
Add PQsetdbLogin() in libpq
New 8-byte integer type, checked by configure for OS support(Thomas)
Better support for quoted table/column names(Thomas)
Surround table and column names with double-quotes in pg_dump(Thomas)
PQreset() now works with passwords(Tom)
Handle case of GROUP BY target list column number out of range(David)
Allow UNION in subselects
Add auto-size to screen to \d? commands(Bruce)
Use UNION to show all \d? results in one query(Bruce)
Add \d? field search feature(Bruce)
Pg_dump issues fewer \connect requests(Tom)
Make pg_dump -z flag work better, document it in manual page(Tom)
Add HAVING clause with full support for subselects and unions(Stephan)
Full text indexing routines in contrib/fulltextindex(Maarten)
Transaction ids now stored in shared memory(Vadim)
New PGCLIENTENCODING when issuing COPY command(Tatsuo)
Support for SQL92 syntax "SET NAMES"(Tatsuo)
Support for LATIN2-5(Tatsuo)
Add UNICODE regression test case(Tatsuo)
Lock manager cleanup, new locking modes for LLL(Vadim)
Allow index use with OR clauses(Bruce)
Allows "SELECT NULL ORDER BY 1;"
Explain VERBOSE prints the plan, and now pretty-prints the plan to
the postmaster log file(Bruce)
Add Indices display to \d command(Bruce)
Allow GROUP BY on functions(David)
New pg_class.relkind for large objects(Bruce)
New way to send libpq NOTICE messages to a different location(Tom)
New \w write command to psql(Bruce)
New /contrib/findoidjoins scans oid columns to find join relationships(Bruce)
Allow binary-compatible indices to be considered when checking for valid
indices for restriction clauses containing a constant(Thomas)
New ISBN/ISSN code in /contrib/isbn_issn
Allow NOT LIKE, IN, NOT IN, BETWEEN, and NOT BETWEEN constraint(Thomas)
New rewrite system fixes many problems with rules and views(Jan)
	* Rules on relations work
	* Event qualifications on insert/update/delete work
	* New OLD variable to reference CURRENT, CURRENT will be remove in future
	* Update rules can reference NEW and OLD in rule qualifications/actions
	* Insert/update/delete rules on views work
	* Multiple rule actions are now supported, surrounded by parentheses
	* Regular users can create views/rules on tables they have RULE permits
	* Rules and views inherit the permissions on the creator
	* No rules at the column level
	* No UPDATE NEW/OLD rules
	* New pg_tables, pg_indexes, pg_rules and pg_views system views
	* Only a single action on SELECT rules
	* Total rewrite overhaul, perhaps for 6.5
	* handle subselects
	* handle aggregates on views
	* handle insert into select from view works
System indexes are now multi-key(Bruce)
Oidint2, oidint4, and oidname types are removed(Bruce)
Use system cache for more system table lookups(Bruce)
New backend programming language PL/pgSQL in backend/pl(Jan)
New SERIAL data type, auto-creates sequence/index(Thomas)
Enable assert checking without a recompile(Massimo)
User lock enhancements(Massimo)
New setval() command to set sequence value(Massimo)
Auto-remove unix socket file on startup if no postmaster running(Massimo)
Conditional trace package(Massimo)
New UNLISTEN command(Massimo)
Psql and libpq now compile under win32 using win32.mak(Magnus)
Lo_read no longer stores trailing NULL(Bruce)
Identifiers are now truncated to 31 characters internally(Bruce)
Createuser options now availble on the command line
Code for 64-bit integer supported added, configure tested, int8 type(Thomas)
Prevent file descriptor leaf from failed COPY(Bruce)
New pg_upgrade command(Bruce)
Updated /contrib directories(Massimo)
New CREATE TABLE DEFAULT VALUES statement available(Thomas)
New INSERT INTO TABLE DEFAULT VALUES statement available(Thomas)
New DECLARE and FETCH feature(Thomas)
libpq's internal structures now not exported(Tom)
Allow up to 8 key indexes(Bruce)
Remove ARCHIVE keyword, that is no longer used(Thomas)
pg_dump -n flag to supress quotes around indentifiers
disable system columns for views(Jan)
new INET and CIDR types for network addresses(TomH, Paul)
no more double quotes in psql output
pg_dump now dumps views(Terry)
new SET QUERY_LIMIT(Tatsuo,Jan)

Source Tree Changes
-------------------
/contrib cleanup(Jun)
Inline some small functions called for every row(Bruce)
Alpha/linux fixes
Hp/UX cleanups(Tom)
Multi-byte regression tests(Soonmyung.)
Remove --disabled options from configure
Define PGDOC to use POSTGRESDIR by default
Make regression optional
Remove extra braces code to pgindent(Bruce)
Add bsdi shared library support(Bruce)
New --without-CXX support configure option(Brook)
New FAQ_CVS
Update backend flowchart in tools/backend(Bruce)
Change atttypmod from int16 to int32(Bruce, Tom)
Getrusage() fix for platforms that do not have it(Tom)
Add PQconnectdb, PGUSER, PGPASSWORD to libpq man page
NS32K platform fixes(Phil Nelson, John Buller)
Sco 7/UnixWare 2.x fixes(Billy,others)
Sparc/Solaris 2.5 fixes(Ryan)
Pgbuiltin.3 is obsolete, move to doc files(Thomas)
Even more documention(Thomas)
Nextstep support(Jacek)
Aix support(David)
pginterface manual page(Bruce)
shared libraries all have version numbers
merged all OS-specific shared library defines into one file
smarter TCL/TK configuration checking(Billy)
smarter perl configuration(Brook)
configure uses supplied install-sh if no install script found(Tom)
new Makefile.shlib for shared library configuration(Tom)


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск 6.3.2

This is a bugfix release for 6.3.x. Refer to the release notes for v6.3 for a more complete summary of new features.

Summary:

A dump/restore is NOT required for those running 6.3 or 6.3.1. A 'make distclean', 'make', and 'make install' is all that is required. This last step should be performed while the postmaster is not running. You should re-link any custom applications that use Postgres libraries.

For upgrades from pre-v6.3 installations, refer to the installation and migration instructions for v6.3.

Подробный список изменений

Changes
-------
Configure detection improvements for tcl/tk(Brook Milligan, Alvin)
Manual page improvements(Bruce)
BETWEEN and LIKE fix(Thomas)
fix for psql \connect used by pg_dump(Oliver Elphick)
New odbc driver
pgaccess, version 0.86
qsort removed, now uses libc version, cleanups(Jeroen)
fix for buffer over-runs detected(Maurice Gittens)
fix for buffer overrun in libpgtcl(Randy Kunkee)
fix for UNION with DISTINCT or ORDER BY(Bruce)
gettimeofday configure check(Doug Winterburn)
Fix "indexes not used" bug(Vadim)
docs additions(Thomas)
Fix for backend memory leak(Bruce)
libreadline cleanup(Erwan MAS)
Remove DISTDIR(Bruce)
Makefile dependency cleanup(Jeroen van Vianen)
ASSERT fixes(Bruce)


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск 6.3.1

Summary:

A dump/restore is NOT required for those running 6.3. A 'make distclean', 'make', and 'make install' is all that is required. This last step should be performed while the postmaster is not running. You should re-link any custom applications that use Postgres libraries.

For upgrades from pre-v6.3 installations, refer to the installation and migration instructions for v6.3.

Подробный список изменений

Changes
-------
ecpg cleanup/fixes, now version 1.1(Michael Meskes)
pg_user cleanup(Bruce)
large object fix for pg_dump and tclsh (alvin)
LIKE fix for multiple adjacent underscores
fix for redefining builtin functions(Thomas)
ultrix4 cleanup
upgrade to pg_access 0.83
updated CLUSTER manual page
multi-byte character set support, see doc/README.mb(Tatsuo)
configure --with-pgport fix
pg_ident fix
big-endian fix for backend communications(Kataoka)
SUBSTR() and substring() fix(Jan)
several jdbc fixes(Peter)
libpgtcl improvements, see libptcl/README(Randy Kunkee)
Fix for "Datasize = 0" error(Vadim)
Prevent \do from wrapping(Bruce)
Remove duplicate Russian character set entries
Sunos4 cleanup
Allow optional TABLE keyword in LOCK and SELECT INTO(Thomas)
CREATE SEQUENCE options to allow a negative integer(Thomas)
Add "PASSWORD" as an allowed column identifier(Thomas)
Add checks for UNION target fields(Bruce)
Fix Alpha port(Dwayne Bailey)
Fix for text arrays containing quotes(Doug Gibson)
Solaris compile fix(Albert Chin-A-Young)
Better identify tcl and tk libs and includes(Bruce)


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск 6.3

There are many new features and improvements in this release. Here is a brief, incomplete summary:

Note: Bruce Momjian wrote the following notes to introduce the new release.

There are some general 6.3 issues that I want to mention. These are only the big items that can not be described in one sentence. A review of the detailed changes list is still needed.

First, we now have subselects. Now that we have them, I would like to mention that without subselects, SQL is a very limited language. Subselects are a major feature, and you should review your code for places where subselects provide a better solution for your queries. I think you will find that there are more uses for subselects than you may think. Vadim has put us on the big SQL map with subselects, and fully functional ones too. The only thing you can't do with subselects is to use them in the target list.

Second, 6.3 uses unix domain sockets rather than TCP/IP by default. To enable connections from other machines, you have to use the new postmaster -i option, and of course edit pg_hba.conf. Also, for this reason, the format of pg_hba.conf has changed.

Third, char() fields will now allow faster access than varchar() or text. Specifically, the text and varchar() have a penalty for access to any columns after the first column of this type. char() used to also have this access penalty, but it no longer does. This may suggest that you redesign some of your tables, especially if you have short character columns that you have defined as varchar() or text. This and other changes make 6.3 even faster than earlier releases.

We now have passwords definable independent of any Unix file. There are new SQL USER commands. See the pg_hba.conf manual page for more information. There is a new table, pg_shadow, which is used to store user information and user passwords, and it by default only SELECT-able by the postgres super-user. pg_user is now a view of pg_shadow, and is SELECT-able by PUBLIC. You should keep using pg_user in your application without changes.

User-created tables now no longer have SELECT permission to PUBLIC by default. This was done because the ANSI standard requires it. You can of course GRANT any permissions you want after the table is created. System tables continue to be SELECT-able by PUBLIC.

We also have real deadlock detection code. No more sixty-second timeouts. And the new locking code implements a FIFO better, so there should be less resource starvation during heavy use.

Many complaints have been made about inadequate documenation in previous releases. Thomas has put much effort into many new manuals for this release. Check out the doc/ directory.

For performance reasons, time travel is gone, but can be implemented using triggers (see pgsql/contrib/spi/README). Please check out the new \d command for types, operators, etc. Also, views have their own permissions now, not based on the underlying tables, so permissions on them have to be set separately. Check /pgsql/interfaces for some new ways to talk to Postgres.

This is the first release that really required an explanation for existing users. In many ways, this was necessary because the new release removes many limitations, and the work-arounds people were using are no longer needed.

Migration to v6.3

A dump/restore using pg_dump or pg_dumpall is required for those wishing to migrate data from any previous release of Postgres.

Подробный список изменений

Bug Fixes
---------
Fix binary cursors broken by MOVE implementation(Vadim)
Fix for tcl library crash(Jan)
Fix for array handling, from Gerhard Hintermayer
Fix acl error, and remove duplicate pqtrace(Bruce)
Fix psql \e for empty file(Bruce)
Fix for textcat on varchar() fields(Bruce)
Fix for DBT Sendproc (Zeugswetter Andres)
Fix vacuum analyze syntax problem(Bruce)
Fix for international identifiers(Tatsuo)
Fix aggregates on inherited tables(Bruce)
Fix substr() for out-of-bounds data
Fix for select 1=1 or 2=2, select 1=1 and 2=2, and select sum(2+2)(Bruce)
Fix notty output to show status result.  -q option still turns it off(Bruce)
Fix for count(*), aggs with views and multiple tables and sum(3)(Bruce)
Fix cluster(Bruce)
Fix for PQtrace start/stop several times(Bruce)
Fix a variety of locking problems like newer lock waiters getting
	lock before older waiters, and having readlock people not share
	locks if a writer is waiting for a lock, and waiting writers not
	getting priority over waiting readers(Bruce)
Fix crashes in psql when executing queries from external files(James)
Fix problem with multiple order by columns, with the first one having
	NULL values(Jeroen)
Use correct hash table support functions for float8 and int4(Thomas)
Re-enable JOIN= option in CREATE OPERATOR statement (Thomas)
Change precedence for boolean operators to match expected behavior(Thomas)
Generate elog(ERROR) on over-large integer(Bruce)
Allow multiple-argument functions in constraint clauses(Thomas)
Check boolean input literals for 'true','false','yes','no','1','0'
	and throw elog(ERROR) if unrecognized(Thomas)
Major large objects fix
Fix for GROUP BY showing duplicates(Vadim)
Fix for index scans in MergeJion(Vadim)

Enhancements
------------
Subselects with EXISTS, IN, ALL, ANY keywords (Vadim, Bruce, Thomas)
New User Manual(Thomas, others)
Speedup by inlining some frequently-called functions
Real deadlock detection, no more timeouts(Bruce)
Add SQL92 "constants" CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, 
	CURRENT_USER(Thomas)
Modify constraint syntax to be SQL92-compliant(Thomas)
Implement SQL92 PRIMARY KEY and UNIQUE clauses using indices(Thomas)
Recognize SQL92 syntax for FOREIGN KEY. Throw elog notice(Thomas)
Allow NOT NULL UNIQUE constraint clause (each allowed separately before)(Thomas)
Allow Postgres-style casting ("::") of non-constants(Thomas)
Add support for SQL3 TRUE and FALSE boolean constants(Thomas)
Support SQL92 syntax for IS TRUE/IS FALSE/IS NOT TRUE/IS NOT FALSE(Thomas)
Allow shorter strings for boolean literals (e.g. "t", "tr", "tru")(Thomas)
Allow SQL92 delimited identifiers(Thomas)
Implement SQL92 binary and hexadecimal string decoding (b'10' and x'1F')(Thomas)
Support SQL92 syntax for type coercion of literal strings
	(e.g. "DATETIME 'now'")(Thomas)
Add conversions for int2, int4, and OID types to and from text(Thomas)
Use shared lock when building indices(Vadim)
Free memory allocated for an user query inside transaction block after
	this query is done, was turned off in <= 6.2.1(Vadim)
New SQL statement CREATE PROCEDURAL LANGUAGE(Jan)
New Postgres Procedural Language (PL) backend interface(Jan)
Rename pg_dump -H option to -h(Bruce)
Add Java support for passwords, European dates(Peter)
Use indices for LIKE and ~, !~ operations(Bruce)
Add hash functions for datetime and timespan(Thomas)
Time Travel removed(Vadim, Bruce)
Add paging for \d and \z, and fix \i(Bruce)
Add Unix domain socket support to backend and to frontend library(Goran)
Implement CREATE DATABASE/WITH LOCATION and initlocation utility(Thomas)
Allow more SQL92 and/or Postgres reserved words as column identifiers(Thomas)
Augment support for SQL92 SET TIME ZONE...(Thomas)
SET/SHOW/RESET TIME ZONE uses TZ backend environment variable(Thomas)
Implement SET keyword = DEFAULT and SET TIME ZONE DEFAULT(Thomas)
Enable SET TIME ZONE using TZ environment variable(Thomas)
Add PGDATESTYLE environment variable to frontend and backend initialization(Thomas)
Add PGTZ, PGCOSTHEAP, PGCOSTINDEX, PGRPLANS, PGGEQO
	frontend library initialization environment variables(Thomas)
Regression tests time zone automatically set with "setenv PGTZ PST8PDT"(Thomas)
Add pg_description table for info on tables, columns, operators, types, and
	aggregates(Bruce)
Increase 16 char limit on system table/index names to 32 characters(Bruce)
Rename system indices(Bruce)
Add 'GERMAN' option to SET DATESTYLE(Thomas)
Define an "ISO-style" timespan output format with "hh:mm:ss" fields(Thomas)
Allow fractional values for delta times (e.g. '2.5 days')(Thomas)
Validate numeric input more carefully for delta times(Thomas)
Implement day of year as possible input to date_part()(Thomas)
Define timespan_finite() and text_timespan() functions(Thomas)
Remove archive stuff(Bruce)
Allow for a pg_password authentication database that is separate from
	the system password file(Todd)
Dump ACLs, GRANT, REVOKE permissions(Matt)
Define text, varchar, and bpchar string length functions(Thomas)
Fix Query handling for inheritance, and cost computations(Bruce)
Implement CREATE TABLE/AS SELECT (alternative to SELECT/INTO)(Thomas)
Allow NOT, IS NULL, IS NOT NULL in constraints(Thomas)
Implement UNIONs for SELECT(Bruce)
Add UNION, GROUP, DISTINCT to INSERT(Bruce)
varchar() stores only necessary bytes on disk(Bruce)
Fix for BLOBs(Peter)
Mega-Patch for JDBC...see README_6.3 for list of changes(Peter)
Remove unused "option" from PQconnectdb()
New LOCK command and lock manual page describing deadlocks(Bruce)
Add new psql \da, \dd, \df, \do, \dS, and \dT commands(Bruce)
Enhance psql \z to show sequences(Bruce)
Show NOT NULL and DEFAULT in psql \d table(Bruce)
New psql .psqlrc file startup(Andrew)
Modify sample startup script in contrib/linux to show syslog(Thomas)
New types for IP and MAC addresses in contrib/ip_and_mac(TomH)
Unix system time conversions with date/time types in contrib/unixdate(Thomas)
Update of contrib stuff(Massimo)
Add Unix socket support to DBD::Pg(Goran)
New python interface (PyGreSQL 2.0)(D'Arcy)
New frontend/backend protocol has a version number, network byte order(Phil)
Безопасность features in pg_hba.conf enhanced and documented, many cleanups(Phil)
CHAR() now faster access than VARCHAR() or TEXT
ecpg embedded SQL preprocessor
Reduce system column overhead(Vadmin)
Remove pg_time table(Vadim)
Add pg_type attribute to identify types that need length (bpchar, varchar)
Add report of offending line when COPY command fails
Allow VIEW permissions to be set separately from the underlying tables. 
	For security, use GRANT/REVOKE on views as appropriate(Jan)
Tables now have no default GRANT SELECT TO PUBLIC.  You must
	explicitly grant such permissions.
Clean up tutorial examples(Darren)

Source Tree Changes
-------------------
Add new html development tools, and flow chart in /tools/backend
Fix for SCO compiles
Stratus computer port Robert Gillies
Added support for shlib for BSD44_derived & i386_solaris
Make configure more automated(Brook)
Add script to check regression test results
Break parser functions into smaller files, group together(Bruce)
Rename heap_create to heap_create_and_catalog, rename heap_creatr
	to heap_create()(Bruce)
Sparc/Linux patch for locking(TomS)
Remove PORTNAME and reorganize port-specific stuff(Marc)
Add optimizer README file(Bruce)
Remove some recursion in optimizer and clean up some code there(Bruce)
Fix for NetBSD locking(Henry)
Fix for libptcl make(Tatsuo)
AIX patch(Darren)
Change IS TRUE, IS FALSE, ... to expressions using "=" rather than
	function calls to istrue() or isfalse() to allow optimization(Thomas)
Various fixes NetBSD/Sparc related(TomH)
Alpha linux locking(Travis,Ryan)
Change elog(WARN) to elog(ERROR)(Bruce)
FAQ for FreeBSD(Marc)
Bring in the PostODBC source tree as part of our standard distribution(Marc)
A minor patch for HP/UX 10 vs 9(Stan)
New pg_attribute.atttypmod for type-specific info like varchar length(Bruce)
Unixware patches(Billy)
New i386 'lock' for spin lock asm(Billy)
Support for multiplexed backends is removed
Start an OpenBSD port
Start an AUX port
Start a Cygnus port
Add string functions to regression suite(Thomas)
Expand a few function names formerly truncated to 16 characters(Thomas)
Remove un-needed malloc() calls and replace with palloc()(Bruce)


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск 6.2.1

v6.2.1 is a bug-fix and usability release on v6.2.

Summary:

This is a minor bug-fix release on v6.2. For upgrades from pre-v6.2 systems, a full dump/reload is required. Refer to the v6.2 release notes for instructions.

Migration from v6.2 to v6.2.1

This is a minor bug-fix release. A dump/reload is not required from v6.2, but is required from any release prior to v6.2.

In upgrading from v6.2, if you choose to dump/reload you will find that avg(money) is now calculated correctly. All other bug fixes take effect upon updating the executables.

Another way to avoid dump/reload is to use the following SQL command from psql to update the existing system table:

  update pg_aggregate set aggfinalfn = 'cash_div_flt8'
   where aggname = 'avg' and aggbasetype = 790;

This will need to be done to every existing database, including template1.

Подробный список изменений

Changes in this release
-----------------------
Allow TIME and TYPE column names(Thomas)
Allow larger range of true/false as boolean values(Thomas)
Support output of "now" and "current"(Thomas)
Handle DEFAULT with INSERT of NULL properly(Vadim)
Fix for relation reference counts problem in buffer manager(Vadim)
Allow strings to span lines, like ANSI(Thomas)
Fix for backward cursor with ORDER BY(Vadim)
Fix avg(cash) computation(Thomas)
Fix for specifying a column twice in ORDER/GROUP BY(Vadim)
Documented new libpq function to return affected rows, PQcmdTuples(Bruce)
Trigger function for inserting user names for INSERT/UPDATE(Brook Milligan)


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск 6.2

A dump/restore is required for those wishing to migrate data from previous releases of Postgres.

Migration from v6.1 to v6.2

This migration requires a complete dump of the 6.1 database and a restore of the database in 6.2.

Note that the pg_dump and pg_dumpall utility from 6.2 should be used to dump the 6.1 database.

Migration from v1.x to v6.2

Those migrating from earlier 1.* releases should first upgrade to 1.09 because the COPY output format was improved from the 1.02 release.

Подробный список изменений

Bug Fixes
---------
Fix problems with pg_dump for inheritance, sequences, archive tables(Bruce)
Fix compile errors on overflow due to shifts, unsigned, and bad prototypes
	 from Solaris(Diab Jerius)
Fix bugs in geometric line arithmetic (bad intersection calculations)(Thomas)
Check for geometric intersections at endpoints to avoid rounding ugliness(Thomas)
Catch non-functional delete attempts(Vadim)
Change time function names to be more consistent(Michael Reifenberg)
Check for zero divides(Michael Reifenberg)
Fix very old bug which made tuples changed/inserted by a commnd
	visible to the command itself (so we had multiple update of 
	updated tuples, etc)(Vadim)
Fix for SELECT null, 'fail' FROM pg_am (Patrick)
SELECT NULL as EMPTY_FIELD now allowed(Patrick)
Remove un-needed signal stuff from contrib/pginterface
Fix OR (where x <> 1 or x isnull didn't return tuples with x NULL) (Vadim)
Fix time_cmp function (Vadim)
Fix handling of functions with non-attribute first argument in 
	WHERE clauses (Vadim)
Fix GROUP BY when order of entries is different from order
	in target list (Vadim)
Fix pg_dump for aggregates without sfunc1 (Vadim)

Enhancements
------------
Default genetic optimizer GEQO parameter is now 8(Bruce)
Allow use parameters in target list having aggregates in functions(Vadim)
Added JDBC driver as an interface(Adrian & Peter)
pg_password utility
Return number of tuples inserted/affected by INSERT/UPDATE/DELETE etc.(Vadim)
Triggers implemented with CREATE TRIGGER (SQL3)(Vadim)
SPI (Server Programming Interface) allows execution of queries inside 
	C-functions (Vadim)
NOT NULL implemented (SQL92)(Robson Paniago de Miranda)
Include reserved words for string handling, outer joins, and unions(Thomas)
Implement extended comments ("/* ... */") using exclusive states(Thomas)
Add "//" single-line comments(Bruce)
Remove some restrictions on characters in operator names(Thomas)
DEFAULT and CONSTRAINT for tables implemented (SQL92)(Vadim & Thomas)
Add text concatenation operator and function (SQL92)(Thomas)
Support WITH TIME ZONE syntax (SQL92)(Thomas)
Support INTERVAL unit TO unit syntax (SQL92)(Thomas)
Define types DOUBLE PRECISION, INTERVAL, CHARACTER,
	and CHARACTER VARYING (SQL92)(Thomas)
Define type FLOAT(p) and rudimentary DECIMAL(p,s), NUMERIC(p,s) (SQL92)(Thomas)
Define EXTRACT(), POSITION(), SUBSTRING(), and TRIM() (SQL92)(Thomas)
Define CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP (SQL92)(Thomas)
Add syntax and warnings for UNION, HAVING, INNER and OUTER JOIN (SQL92)(Thomas)
Add more reserved words, mostly for SQL92 compliance(Thomas)
Allow hh:mm:ss time entry for timespan/reltime types(Thomas)
Add center() routines for lseg, path, polygon(Thomas)
Add distance() routines for circle-polygon, polygon-polygon(Thomas)
Check explicitly for points and polygons contained within polygons
	using an axis-crossing algorithm(Thomas)
Add routine to convert circle-box(Thomas)
Merge conflicting operators for different geometric data types(Thomas)
Replace distance operator "<===>" with "<->"(Thomas)
Replace "above" operator "!^" with ">^" and "below" operator "!|" with "<^"(Thomas)
Add routines for text trimming on both ends, substring, and string position(Thomas)
Added conversion routines circle(box) and poly(circle)(Thomas)
Allow internal sorts to be stored in memory rather than in files(Bruce & Vadim)
Allow functions and operators on internally-identical types to succeed(Bruce)
Speed up backend startup after profiling analysis(Bruce)
Inline frequently called functions for performance(Bruce)
Reduce open() calls(Bruce)
psql:  Add PAGER for \h and \?,\C fix
Fix for psql pager when no tty(Bruce)
New entab utility(Bruce)
General trigger functions for referential integrity (Vadim)
General trigger functions for time travel (Vadim)
General trigger functions for AUTOINCREMENT/IDENTITY feature (Vadim)
MOVE implementation (Vadim)

Source Tree Changes
-------------------
HPUX 10 patches (Vladimir Turin)
Added SCO support, (Daniel Harris)
mkLinux patches (Tatsuo Ishii)
Change geometric box terminology from "length" to "width"(Thomas)
Deprecate temporary unstored slope fields in geometric code(Thomas)
Remove restart instructions from INSTALL(Bruce)
Look in /usr/ucb first for install(Bruce)
Fix c++ copy example code(Thomas)
Add -o to psql manual page(Bruce)
Prevent relname unallocated string length from being copied into database(Bruce)
Cleanup for NAMEDATALEN use(Bruce)
Fix pg_proc names over 15 chars in output(Bruce)
Add strNcpy() function(Bruce)
remove some (void) casts that are unnecessary(Bruce)
new interfaces directory(Marc)
Replace fopen() calls with calls to fd.c functions(Bruce)
Make functions static where possible(Bruce)
enclose unused functions in #ifdef NOT_USED(Bruce)
Remove call to difftime() in timestamp support to fix SunOS(Bruce & Thomas)
Changes for Digital Unix
Portability fix for pg_dumpall(Bruce)
Rename pg_attribute.attnvals to attdisbursion(Bruce)
"intro/unix" manual page now "pgintro"(Bruce)
"built-in" manual page now "pgbuiltin"(Bruce)
"drop" manual page now "drop_table"(Bruce)
Add "create_trigger", "drop_trigger" manual pages(Thomas)
Add constraints regression test(Vadim & Thomas)
Add comments syntax regression test(Thomas)
Add PGINDENT and support program(Bruce)
Massive commit to run PGINDENT on all *.c and *.h files(Bruce)
Files moved to /src/tools directory(Bruce)
SPI and Trigger programming guides (Vadim & D'Arcy)


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск 6.1.1

Migration from v6.1 to v6.1.1

This is a minor bug-fix release. A dump/reload is not required from v6.1, but is required from any release prior to v6.1. Refer to the release notes for v6.1 for more details.

Подробный список изменений

Changes in this release
-----------------------
fix for SET with options (Thomas)
allow pg_dump/pg_dumpall to preserve ownership of all tables/objects(Bruce)
new psql \connect option allows changing usernames without changing databases
fix for initdb --debug option(Yoshihiko Ichikawa))
lextest cleanup(Bruce)
hash fixes(Vadim)
fix date/time month boundary arithmetic(Thomas)
fix timezone daylight handling for some ports(Thomas, Bruce, Tatsuo)
timestamp overhauled to use standard functions(Thomas)
other code cleanup in date/time routines(Thomas)
psql's \d now case-insensitive(Bruce)
psql's backslash commands can now have trailing semicolon(Bruce)
fix memory leak in psql when using \g(Bruce)
major fix for endian handling of communication to server(Thomas, Tatsuo)
Fix for Solaris assembler and include files(Yoshihiko Ichikawa)
allow underscores in usernames(Bruce)
pg_dumpall now returns proper status, portability fix(Bruce)


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск 6.1

The regression tests have been adapted and extensively modified for the v6.1 release of Postgres.

Three new data types (datetime, timespan, and circle) have been added to the native set of Postgres types. Points, boxes, paths, and polygons have had their output formats made consistant across the data types. The polygon output in misc.out has only been spot-checked for correctness relative to the original regression output.

Postgres v6.1 introduces a new, alternate optimizer which uses genetic algorithms. These algorithms introduce a random behavior in the ordering of query results when the query contains multiple qualifiers or multiple tables (giving the optimizer a choice on order of evaluation). Several regression tests have been modified to explicitly order the results, and hence are insensitive to optimizer choices. A few regression tests are for data types which are inherently unordered (e.g. points and time intervals) and tests involving those types are explicitly bracketed with set geqo to 'off' and reset geqo.

The interpretation of array specifiers (the curly braces around atomic values) appears to have changed sometime after the original regression tests were generated. The current ./expected/*.out files reflect this new interpretation, which may not be correct!

The float8 regression test fails on at least some platforms. This is due to differences in implementations of pow() and exp() and the signaling mechanisms used for overflow and underflow conditions.

The "random" results in the random test should cause the "random" test to be "failed", since the regression tests are evaluated using a simple diff. However, "random" does not seem to produce random results on my test machine (Linux/gcc/i686).

Migration to v6.1

This migration requires a complete dump of the 6.0 database and a restore of the database in 6.1.

Those migrating from earlier 1.* releases should first upgrade to 1.09 because the COPY output format was improved from the 1.02 release.

Подробный список изменений

Bug Fixes
---------
packet length checking in library routines
lock manager priority patch
check for under/over flow of float8(Bruce)
multi-table join fix(Vadim)
SIGPIPE crash fix(Darren)
large object fixes(Sven)
allow btree indexes to handle NULLs(Vadim)
timezone fixes(D'Arcy)
select SUM(x) can return NULL on no rows(Thomas)
internal optimizer, executor bug fixes(Vadim)
fix problem where inner loop in < or <= has no rows(Vadim)
prevent re-commuting join index clauses(Vadim)
fix join clauses for multiple tables(Vadim)
fix hash, hashjoin for arrays(Vadim)
fix btree for abstime type(Vadim)
large object fixes(Raymond)
fix buffer leak in hash indices (Vadim)
fix rtree for use in inner scan (Vadim)
fix gist for use in inner scan, cleanups (Vadim, Andrea)
avoid unnecessary local buffers allocation (Vadim, Massimo)
fix local buffers leak in transaction aborts (Vadim)
fix file manager memmory leaks, cleanups (Vadim, Massimo)
fix storage manager memmory leaks (Vadim)
fix btree duplicates handling (Vadim)
fix deleted tuples re-incarnation caused by vacuum (Vadim)
fix SELECT varchar()/char() INTO TABLE made zero-length fields(Bruce)
many psql, pg_dump, and libpq memory leaks fixed using Purify (Igor)

Enhancements
------------
attribute optimization statistics(Bruce)
much faster new btree bulk load code(Paul)
BTREE UNIQUE added to bulk load code(Vadim) 
new lock debug code(Massimo)
massive changes to libpg++(Leo)
new GEQO optimizer speeds table multi-table optimization(Martin)
new WARN message for non-unique insert into unique key(Marc)
update x=-3, no spaces, now valid(Bruce)
remove case-sensitive identifier handling(Bruce,Thomas,Dan)
debug backend now pretty-prints tree(Darren)
new Oracle character functions(Edmund)
new plaintext password functions(Dan)
no such class or insufficient privilege changed to distinct messages(Dan)
new ANSI timestamp function(Dan)
new ANSI Time and Date types (Thomas)
move large chunks of data in backend(Martin)
multi-column btree indexes(Vadim)
new SET var TO value command(Martin)
update transaction status on reads(Dan)
new locale settings for character types(Oleg)
new SEQUENCE serial number generator(Vadim)
GROUP BY function now possible(Vadim)
re-organize regression test(Thomas,Marc)
new optimizer operation weights(Vadim)
new psql \z grant/permit option(Marc)
new MONEY data type(D'Arcy,Thomas)
tcp socket communication speed improved(Vadim)
new VACUUM option for attribute statistics, and for certain columns (Vadim)
many geometric type improvements(Thomas,Keith)
additional regression tests(Thomas)
new datestyle variable(Thomas,Vadim,Martin)
more comparison operators for sorting types(Thomas)
new conversion functions(Thomas)
new more compact btree format(Vadim)
allow pg_dumpall to preserve database ownership(Bruce)
new SET GEQO=# and R_PLANS variable(Vadim)
old (!GEQO) optimizer can use right-sided plans (Vadim)
typechecking improvement in SQL parser(Bruce)
new SET, SHOW, RESET commands(Thomas,Vadim)
new \connect database USER option
new dropdb -i option (Igor)
new \dt and \di psql commands (Darren)
SELECT "\n" now escapes newline (A. Duursma)
new geometry conversion functions from old format (Thomas)

Source tree changes
-------------------
new configuration script(Marc)
readline configuration option added(Marc)
OS-specific configuration options removed(Marc)
new OS-specific template files(Marc)
no more need to edit Makefile.global(Marc)
re-arrange include files(Marc)
nextstep patches (Gregor Hoffleit)
removed WIN32-specific code(Bruce)
removed postmaster -e option, now only postgres -e option (Bruce)
merge duplicate library code in front/backends(Martin)
now works with eBones, international Kerberos(Jun)
more shared library support
c++ include file cleanup(Bruce)
warn about buggy flex(Bruce)
DG-UX, Ultrix, Irix, AIX portability fixes


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск v6.0

A dump/restore is required for those wishing to migrate data from previous releases of Postgres.

Migration from v1.09 to v6.0

This migration requires a complete dump of the 1.09 database and a restore of the database in 6.0.

Migration from pre-v1.09 to v6.0

Those migrating from earlier 1.* releases should first upgrade to 1.09 because the COPY output format was improved from the 1.02 release.

Подробный список изменений

Bug Fixes
---------
ALTER TABLE bug - running postgress process needs to re-read table definition
Allow vacuum to be run on one table or entire database(Bruce)
Array fixes
Fix array over-runs of memory writes(Kurt)
Fix elusive btree range/non-range bug(Dan)
Fix for hash indexes on some types like time and date
Fix for pg_log size explosion
Fix permissions on lo_export()(Bruce)
Fix unitialized reads of memory(Kurt)
Fixed ALTER TABLE ... char(3) bug(Bruce)
Fixed a few small memory leaks
Fixed EXPLAIN handling of options and changed full_path option name
Fixed output of group acl permissions
Memory leaks (hunt and destroy with tools like Purify(Kurt)
Minor improvements to rules system
NOTIFY fixes
New asserts for run-checking
Overhauled parser/analyze code to properly report errors and increase speed
Pg_dump -d now handles NULL's properly(Bruce)
Prevent SELECT NULL from crashing server (Bruce)
Properly report errors when INSERT ... SELECT columns did not match
Properly report errors when insert column names were not correct
Psql \g filename now works(Bruce)
Psql fixed problem with multiple statements on one line with multiple outputs
Removed duplicate system oid's
SELECT * INTO TABLE . GROUP/ORDER BY gives unlink error if table exists(Bruce)
Several fixes for queries that crashed the backend
Запуск quote in insert string errors(Bruce)
Submitting an empty query now returns empty status, not just " " query(Bruce)

Enhancements
------------
Add EXPLAIN manual page(Bruce)
Add UNIQUE index capability(Dan)
Add hostname/user level access control rather than just hostname and user
Add synonym of != for <>(Bruce)
Allow "select oid,* from table"
Allow BY,ORDER BY to specify columns by number, or by non-alias table.column(Bruce)
Allow COPY from the frontend(Bryan)
Allow GROUP BY to use alias column name(Bruce)
Allow actual compression, not just reuse on the same page(Vadim)
Allow installation-configuration option to auto-add all local users(Bryan)
Allow libpq to distinguish between text value '' and null(Bruce)
Allow non-postgres users with createdb privs to destroydb's
Allow restriction on who can create C functions(Bryan)
Allow restriction on who can do backend COPY(Bryan)
Can shrink tables, pg_time and pg_log(Vadim & Erich)
Change debug level 2 to print queries only, changed debug heading layout(Bruce)
Change default decimal constant representation from float4 to float8(Bruce)
European date format now set when postmaster is started
Execute lowercase function names if not found with exact case
Fixes for aggregate/GROUP processing, allow 'select sum(func(x),sum(x+y) from z'
Gist now included in the distrubution(Marc)
Idend authentication of local users(Bryan)
Implement BETWEEN qualifier(Bruce)
Implement IN qualifier(Bruce)
Libpq has PQgetisnull()(Bruce)
Libpq++ improvements
New options to initdb(Bryan)
Pg_dump allow dump of oid's(Bruce)
Pg_dump create indexes after tables are loaded for speed(Bruce)
Pg_dumpall dumps all databases, and the user table
Pginterface additions for NULL values(Bruce)
Prevent postmaster from being run as root
Psql \h and \? is now readable(Bruce)
Psql allow backslashed, semicolons anywhere on the line(Bruce)
Psql changed command prompt for lines in query or in quotes(Bruce)
Psql char(3) now displays as (bp)char in \d output(Bruce)
Psql return code now more accurate(Bryan?)
Psql updated help syntax(Bruce)
Re-visit and fix vacuum(Vadim)
Reduce size of regression diffs, remove timezone name difference(Bruce)
Remove compile-time parameters to enable binary distributions(Bryan)
Reverse meaning of HBA masks(Bryan)
Secure Authentication of local users(Bryan)
Speed up vacuum(Vadim)
Vacuum now had VERBOSE option(Bruce)

Source tree changes
-------------------
All functions now have prototypes that are compared against the calls
Allow asserts to be disabled easly from Makefile.global(Bruce)
Change oid constants used in code to #define names
Decoupled sparc and solaris defines(Kurt)
Gcc -Wall compiles cleanly with warnings only from unfixable constructs
Major include file reorganization/reduction(Marc)
Make now stops on compile failure(Bryan)
Makefile restructuring(Bryan, Marc)
Merge bsdi_2_1 to bsdi(Bruce)
Monitor program removed
Name change from Postgres95 to PostgreSQL
New config.h file(Marc, Bryan)
PG_VERSION now set to 6.0 and used by postmaster
Portability additions, including Ultrix, DG/UX, AIX, and Solaris
Reduced the number of #define's, centeralized #define's
Remove duplicate OIDS in system tables(Dan)
Remove duplicate system catalog info or report mismatches(Dan)
Removed many os-specific #define's
Restructured object file generation/location(Bryan, Marc)
Restructured port-specific file locations(Bryan, Marc)
Unused/uninialized variables corrected


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск v1.09

Извините, мы бросили вести список изменений с 1.02 по 1.09. Некоторые изменения внесены с список 6.0, который на самом деле включают с 1.02.1 по 1.09 releases.


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск v1.02

Migration from v1.02 to v1.02.1

Here is a new migration file for 1.02.1. It includes the 'copy' change and a script to convert old ascii files.

Note: The following notes are for the benefit of users who want to migrate databases from postgres95 1.01 and 1.02 to postgres95 1.02.1.

If you are starting afresh with postgres95 1.02.1 and do not need to migrate old databases, you do not need to read any further.

In order to upgrade older postgres95 version 1.01 or 1.02 databases to version 1.02.1, the following steps are required:

  1. Start up a new 1.02.1 postmaster

  2. Add the new built-in functions and operators of 1.02.1 to 1.01 or 1.02 databases. This is done by running the new 1.02.1 server against your own 1.01 or 1.02 database and applying the queries attached at the end of thie file. This can be done easily through psql. If your 1.01 or 1.02 database is named "testdb" and you have cut the commands from the end of this file and saved them in addfunc.sql:

    	% psql testdb -f addfunc.sql
    Those upgrading 1.02 databases will get a warning when executing the last two statements in the file because they are already present in 1.02. This is not a cause for concern.

Dump/Reload Procedure

If you are trying to reload a pg_dump or text-mode 'copy tablename to stdout' generated with a previous version, you will need to run the attached sed script on the ASCII file before loading it into the database. The old format used '.' as end-of-data, while '\.' is now the end-of-data marker. Also, empty strings are now loaded in as '' rather than NULL. See the copy manual page for full details.

	sed 's/^\.$/\\./g' <in_file >out_file

If you are loading an older binary copy or non-stdout copy, there is no end-of-data character, and hence no conversion necessary.

-- following lines added by agc to reflect the case-insensitive
-- regexp searching for varchar (in 1.02), and bpchar (in 1.02.1)
create operator ~* (leftarg = bpchar, rightarg = text, procedure = texticregexeq);
create operator !~* (leftarg = bpchar, rightarg = text, procedure = texticregexne);
create operator ~* (leftarg = varchar, rightarg = text, procedure = texticregexeq);
create operator !~* (leftarg = varchar, rightarg = text, procedure = texticregexne);

Подробный список изменений

Source code maintenance and development
 * worldwide team of volunteers
 * the source tree now in CVS at ftp.ki.net

Enhancements
 * psql (and underlying libpq library) now has many more options for
   formatting output, including HTML
 * pg_dump now output the schema and/or the data, with many fixes to
   enhance completeness.
 * psql used in place of monitor in administration shell scripts.
   monitor to be depreciated in next release.
 * date/time functions enhanced
 * NULL insert/update/comparison fixed/enhanced
 * TCL/TK lib and shell fixed to work with both tck7.4/tk4.0 and tcl7.5/tk4.1

Bug Fixes (almost too numerous to mention)
 * indexes
 * storage management
 * check for NULL pointer before dereferencing
 * Makefile fixes

New Переносимость
 * added SolarisX86 port
 * added BSDI 2.1 port
 * added DGUX port


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск v1.01

Переход с v1.0 на v1.01

Следующие замечания о том что выиграют пользователи, кто хотел бы перейти с базы данных postgres95 1.0 на postgres95 1.01.

Если ты первый раз ставишь postgres95 1.01 и тебе не нужно переносить старые базы, то читать дальше тебе не нужно.

In order to postgres95 version 1.01 with databases created with postgres95 version 1.0, the following steps are required:

  1. Set the definition of NAMEDATALEN in src/Makefile.global to 16 and OIDNAMELEN to 20.

  2. Decide whether you want to use Host based authentication.

    1. If you do, you must create a file name "pg_hba" in your top-level data directory (typically the value of your $PGDATA). src/libpq/pg_hba shows an example syntax.

    2. If you do not want host-based authentication, you can comment out the line

      	HBA = 1
      in src/Makefile.global

      Note that host-based authentication is turned on by default, and if you do not take steps A or B above, the out-of-the-box 1.01 will not allow you to connect to 1.0 databases.

  3. Compile and install 1.01, but DO NOT do the initdb step.

  4. Before doing anything else, terminate your 1.0 postmaster, and backup your existing $PGDATA directory.

  5. Set your PGDATA environment variable to your 1.0 databases, but set up path up so that 1.01 binaries are being used.

  6. Modify the file $PGDATA/PG_VERSION from 5.0 to 5.1

  7. Start up a new 1.01 postmaster

  8. Add the new built-in functions and operators of 1.01 to 1.0 databases. This is done by running the new 1.01 server against your own 1.0 database and applying the queries attached and saving in the file 1.0_to_1.01.sql. This can be done easily through psql. If your 1.0 database is name "testdb":

    	% psql testdb -f 1.0_to_1.01.sql
    and then execute the following commands (cut and paste from here):
    -- add builtin functions that are new to 1.01
    
    create function int4eqoid (int4, oid) returns bool as 'foo'
    language 'internal';
    create function oideqint4 (oid, int4) returns bool as 'foo'
    language 'internal';
    create function char2icregexeq (char2, text) returns bool as 'foo'
    language 'internal';
    create function char2icregexne (char2, text) returns bool as 'foo'
    language 'internal';
    create function char4icregexeq (char4, text) returns bool as 'foo'
    language 'internal';
    create function char4icregexne (char4, text) returns bool as 'foo'
    language 'internal';
    create function char8icregexeq (char8, text) returns bool as 'foo'
    language 'internal';
    create function char8icregexne (char8, text) returns bool as 'foo'
    language 'internal';
    create function char16icregexeq (char16, text) returns bool as 'foo'
    language 'internal';
    create function char16icregexne (char16, text) returns bool as 'foo'
    language 'internal';
    create function texticregexeq (text, text) returns bool as 'foo'
    language 'internal';
    create function texticregexne (text, text) returns bool as 'foo'
    language 'internal';
    
    -- add builtin functions that are new to 1.01
    
    create operator = (leftarg = int4, rightarg = oid, procedure = int4eqoid);
    create operator = (leftarg = oid, rightarg = int4, procedure = oideqint4);
    create operator ~* (leftarg = char2, rightarg = text, procedure = char2icregexeq);
    create operator !~* (leftarg = char2, rightarg = text, procedure = char2icregexne);
    create operator ~* (leftarg = char4, rightarg = text, procedure = char4icregexeq);
    create operator !~* (leftarg = char4, rightarg = text, procedure = char4icregexne);
    create operator ~* (leftarg = char8, rightarg = text, procedure = char8icregexeq);
    create operator !~* (leftarg = char8, rightarg = text, procedure = char8icregexne);
    create operator ~* (leftarg = char16, rightarg = text, procedure = char16icregexeq);
    create operator !~* (leftarg = char16, rightarg = text, procedure = char16icregexne);
    create operator ~* (leftarg = text, rightarg = text, procedure = texticregexeq);
    create operator !~* (leftarg = text, rightarg = text, procedure = texticregexne);

Подробный список изменений

Incompatibilities:
 * 1.01 is backwards compatible with 1.0 database provided the user
   follow the steps outlined in the MIGRATION_from_1.0_to_1.01 file.
   If those steps are not taken, 1.01 is not compatible with 1.0 database.

Enhancements:
 * added PQdisplayTuples() to libpq and changed monitor and psql to use it
 * added NeXT port (requires SysVIPC implementation)
 * added CAST .. AS ... syntax
 * added ASC and DESC keywords
 * added 'internal' as a possible language for CREATE FUNCTION
   internal functions are C functions which have been statically linked
   into the postgres backend.
 * a new type "name" has been added for system identifiers (table names,
   attribute names, etc.)  This replaces the old char16 type.   The
   of name is set by the NAMEDATALEN #define in src/Makefile.global
 * a readable reference manual that describes the query language.
 * added host-based access control.  A configuration file ($PGDATA/pg_hba)
   is used to hold the configuration data.  If host-based access control
   is not desired, comment out HBA=1 in src/Makefile.global.
 * changed regex handling to be uniform use of Henry Spencer's regex code
   regardless of platform.  The regex code is included in the distribution
 * added functions and operators for case-insensitive regular expressions. 
   The operators are ~* and !~*.
 * pg_dump uses COPY instead of SELECT loop for better performance

Bug fixes:
 * fixed an optimizer bug that was causing core dumps when 
   functions calls were used in comparisons in the WHERE clause
 * changed all uses of getuid to geteuid so that effective uids are used
 * psql now returns non-zero status on errors when using -c
 * applied public patches 1-14


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Выпуск v1.0

Подробный список изменений

Изменение авторских прав:
 * Авторские права Postgres 1.0 ослабли и он стал свободным для модификации и для модификации
для любых целей.  Пожалуйста, прочитай COPYRIGHT файл.
Спасибо профессору Michael Stonebraker, за то что стало это возможным.

Несовместимости:
 *  формат даты стал MM-DD-YYYY (или DD-MM-YYYY, если ты используешь
ЕВРОПЕЙСКИЙ СТИЛЬ).  Это по спецификации SQL-92.
 *  "delimiters" теперь ключевое слово

Улучшения:
 *  добавлен синтаксис sql LIKE
 *  команда copy теперь принимает необязательную спецификацию USING DELIMITER.
    delimiters может быть любой односимвольной строкой. 
 *  добавлен порт IRIX 5.3.
    Спасибо Paul Walmsley и другим.
 *  обновлен pg_dump для работы с новой libpq
 *  \d добавлен в psql 
    Спасибо Keith Parks
 *  выполнение regexp для архитектур, использующих POSIX regex был
    усовершенствован из-за кэширования прекомпилированных образцов.
    Спасибо Alistair Crooks
 *  новая версия libpq++
    Спасибо William Wanders

Исправления багов:
 *  произвольные userids могут указываться в сценарии createuser
 *  теперь работает \c для подключения к другим базам в psql.
 *  исправленные плохие pg_proc входы для float4inc()
 *  пользователи с установленным полем usecreatedb могут теперь создавать базы данных без
    наличия usesuper
 *  удален контроль доступа входов, когда вход не имеет никаких прав
 *  исправлена непортируемая реализация даты времени
 *  добавлены флаги kerberos в src/backend/Makefile
 *  libpq теперь работает с kerberos
 *  откорректированы типографские ошибки в руководстве пользователя.
 *  btrees с несколькими индексами никогда не работали, 
    теперь мы говорим, что они не работают, при попытки использовать их


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Postgres95 Beta 0.03

Подробный список изменений

Несовместимые изменения:
 * BETA-0.3 НЕСОВМЕСТИМА С БАЗАМИ ДАННЫХ, СОЗДАННЫМИ ПРЕДЫДУЩИМИ ВЕРСИЯМИ
   (из-за изменения системного каталога и структур индексов).
 * двойные кавычки (") резко осуждаются как ограничивающий символ для строк;
   тебе нужно преобразовать их в одиночные кавычки (').
 * имена итоговых функций (например. int4sum) переименованы в соответствии с
   SQL стандартом (например. sum).
 * Синтаксис CHANGE ACL заменен на синтаксис GRANT/REVOKE.
 * float литералы (например. 3.14) теперь типа float4 (вместо float8 в предыдущих
   версиях); тебе нужно сделать преобразование типа, если ты использовал
   тип float8.  Если ты пренебрег выполнением преобразования и назначил
   полю float литералов тип float8, то ты можешь получить неправильные значения
   из-за хранения!
 * LIBPQ была полностью отремонтирована, так что клиентские приложения могут
   подключаться к нескольким серверам
 * поле usesysid в pg_user было изменено из int2 в int4, чтобы расширить
   диапазон ids пользователей Unix.
 * netbsd/freebsd/bsd o/s порты были объединены в один
   BSD44_derived порт.  (спасибо Alistair Crooks)

SQL standard-compliance (следующие список изменений делает postgres95
более compliant со стандартом SQL-92):
 * следующие типы SQL теперь встроены: smallint, int(eger), float, real,
   char(N), varchar(N), date и time.

   Псевдонимы существовавших типов postgres:
		smallint -> int2
		integer, int -> int4
		float, real  -> float4
   char(N) и varchar(N) реализованы как обрезанный тип text. Вдобавок,
   char(N) выполняет заполнение пробелами. 
 * одинарная кавычка (') используется для ограничивания строк; '' (в дополнении к
   \') поддерживается для вставки одинарной кавычки в строку
 * Используются стандартные SQL названия итоговых функций (MAX, MIN, AVG, SUM, COUNT)
   (Также, итоговые функции теперь могут быть перегружены, т.е. ты можешь определить
   свою собственную итоговую функцию MAX для работы с пользовательским типом.)
 * CHANGE ACL удалена. Добавлен синтаксис GRANT/REVOKE.  
   - Группам могут быть назначены привилегии с помощью ключевого слова "GROUP".
	Например:
		GRANT SELECT ON foobar TO GROUP my_group;
	Ключевое слово 'PUBLIC' также поддерживается для обозначения всех пользователей.

	Привилегии могут быть предоставлены или отменены только для одного пользователя или группы 
	по одному.  

	"WITH GRANT OPTION" не поддерживается.  Только владельцы класса могут
	изменять контроль доступа
   - Контроль доступа по умолчанию предоставляет пользователям доступ только для чтения.
     Ты должен точно указывать предоставление доступа вставки/обновления пользователям.  Чтобы
     изменить это, измени строку
		src/backend/utils/acl.h, которая определяет ACL_WORLD_DEFAULT

Исправленные баги:
 * баг где итоговые функции с пустыми таблицами не работали был исправлен. Теперь,
   итоговые функции работающие на пустых таблицах возвращают начальные условия
   итоговых функций. Таким образом, COUNT пустой таблицы вернет теперь правильный 0.
   MAX/MIN пустой таблицы вернут кортеж значений NULL. 
 * разрешено использование \; внутри монитора
 * механизм асинхронного уведомления LISTEN/NOTIFY теперь работает
 * NOTIFY в телах правил действий теперь работают
 * хэш индексация работает, и метод доступа, в общем, должен выполняться быстрее.
   создание больших индексов btree выполняется намного быстрее.  (спасибо Paul
   Aoki)

Другие изменения и улучшения:
 * добавлен оператор EXPLAIN, используемый для объяснения плана выполнения запросов
   (например. "EXPLAIN SELECT * FROM EMP" выводит план выполнения для запроса).
 * сообщения WARN и NOTICE больше не имеют временных отметок. Чтобы включить
   временные отметки в сообщениях об ошибках, раскомментируй строку в
   src/backend/utils/elog.h:
	/* define ELOG_TIMESTAMPS */ 
 * При нарушении контроля доступа выдается сообщение
	"Either no such class or insufficient privilege".
   Тоже самое сообщение выдается когда класс не найден.
   Это предостережёт непревелигерованных пользователей от угадывания существующих
   превелигерованных классов.
 * изменились некоторые дополнительные системные каталоги, которые не видимы
   для пользователя.

libpgtcl изменения:
 * Опция -oid добавлена в команду "pg_result" tcl.
   pg_result -oid возвращает oid последнего вставленного кортежа. Если последняя
   команда была не INSERT, то pg_result -oid возвращает "".
 * доступен интерфейс большого объекта как команды pg_lo* tcl:
   pg_lo_open, pg_lo_close, pg_lo_creat и т.д.

Улучшения портируемости и новые порты:
 * была убрана flex/lex. Теперь, ты можешь использовать
   flex вместо lex на любой платформе.  Больше мы не делаем
   предположений, какой lex взят за основу на используемой платформе. 
 * Порт Linux-ELF теперь поддерживается.  Протестированы  различные конфигурации:
   Признаны рабочими следующие конфигурации:
	ядро 1.2.10, gcc 2.6.3, libc 4.7.2, flex 2.5.2, bison 1.24
   все в ELF формате,

Новые утилиты:
 * добавлена в дистрибутив ipcclean
   ipcclean обычно не нужно запускать, но если сервер упал и оставшиеся
   разделяемые сегменты памяти повисли, ipcclean очистит их.

Новая документация:
 * руководство пользователя был пересмотрен и добавлена документация libpq.


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Postgres95 Beta 0.02

Подробный список изменений

Несовместимые изменения:
 * Оператор SQL для создания базы данных теперь 'CREATE DATABASE' вместо
   'CREATEDB'. Также, бросить базу данных теперь 'DROP DATABASE' вместо
   'DESTROYDB'. Однако, имена исполняемых файлов 'createdb' и
   'dropdb' остались прежними.
 
Новые инструменты:
 * pgperl - интерфейс Perl (4.036) к Postgres95
 * pg_dump - утилита для дампа базы данных в файл сценария команд запросов.
   Файлы сценариев в ASCII формате и могут использоваться для реконструкции
   базы данных, даже на других машинах и других архитектурах.
   (Также отлично подходят для преобразования базы данных
   Postgres 4.2 в базу данных Postgres95.)

Следующие порты включены в postgres95-beta-0.02:
 * the NetBSD порт Alistair Crooks
 * the AIX порт Mike Tung
 * the Windows NT порт Jon Forrest (много частей, но пока не все)
 * the Linux ELF порт Brian Gallew

Следующие баги были исправлены в postgres95-beta-0.02:
 * символ новая строка не уходили в COPY OUT и проблема с COPY OUT, когда
   первый атрибут '.' 
 * нельзя использовать возвращаемый тип id пользователя по умолчанию в createuser
 * SELECT DISTINCT при больших таблицах грохалась
 * Проблемы при установке на Linux
 * монитор не позволял использовать 'localhost' как PGHOST
 * psql падала в core когда выполняла \c или \l
 * назначение "pgtclsh" забыли в src/bin/pgtclsh/Makefile
 * libpgtcl имела железно зашитый номер порта по умолчанию
 * SELECT DISTINCT INTO TABLE висла
 * CREATE TYPE не принимал 'variable' как internallength
 * неправильный результат при использовании более одной 1 итоговой функции в SELECT


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Postgres95 Beta 0.01

Начальный выпуск.


Руководство администратора по PostgreSQLПредыдущийГлава 15. Замечания по выпускамСледующий

Расчёт времени результатов

Здесь находится расчёт времени результатов работы регрессивного теста с помощью команды

% cd src/test/regress
% make all
% time make runtest
    

Расчёт времени под Linux 2.0.27 кажется меняется приблизительно на 5%от запуска к к запуску, по-видимом из-за превратностей планирования многозадачных систем.

v6.5

Как случалось в предыдущих релизах, расчёт времени между релизами не связан напрямую с добавление новых регрессивных тестов. В общем, v6.5 быстрее чем предыдущие релизы.

Расчёт времени с запрещённой fsync():

  Время  Система
  02:00  Dual Pentium Pro 180, 224MB, UW-SCSI, Linux 2.0.36, gcc 2.7.2.3 -O2 -m486
  04:38  Sparc Ultra 1 143MHz, 64MB, Solaris 2.6
     

Расчёт времени с разрешённой fsync():

  Время  Система
  04:21  Dual Pentium Pro 180, 224MB, UW-SCSI, Linux 2.0.36, gcc 2.7.2.3 -O2 -m486
     
Для linux систем, приведенных выше, использование UW-SCSI дисков вместо (старых) IDE дисков приводит к 50% улучшению по скорости регрессивных тестов.

v6.4beta

Расчёт времени для этого релиза не связан напрямую с добавление новых регрессивных тестов. В общем, однако, v6.4 должна быть немного быстрее чем предыдущий релиз (спасибо, Bruce!).

  Время  Система
  02:26  Dual Pentium Pro 180, 96MB, UW-SCSI, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486

v6.3

Расчёт времени для этого релиза не связан напрямую из-за включения дополнительных регрессивных тестов и удаления некоторых устаревших тестов. В общем, однако, v6.3 в значительной степени быстрее чем предыдущие релизы (спасибо, Bruce!).

  Время  Система
  02:30  Dual Pentium Pro 180, 96MB, UW-SCSI, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
  04:12  Dual Pentium Pro 180, 96MB, EIDE, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486

v6.1

  Время  Система
  06:12  Pentium Pro 180, 32MB, EIDE, Linux 2.0.30, gcc 2.7.2 -O2 -m486
  12:06  P-100, 48MB, Linux 2.0.29, gcc
  39:58  Sparc IPC 32MB, Solaris 2.5, gcc 2.7.2.1 -O -g


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 7. Рабочая среда

Оглавление
Использование Postgres из Unix
Запуск postmaster
Использование pg_options

Эта глава обрисовывает в общих чертах взаимодействие между Postgres и операционной системой.

Использование Postgres из Unix

Все команды Postgres, которые исполняются напрямую из Unix shell находятся в каталоге “.../bin”. Включение этого каталога в путь поиска, облегчит выполнение команд.

Совокупность системных каталогов существует на каждом сайте. Они включают класс (pg_user), который содержит экземпляр каждого правильного пользователя Postgres. Экземпляр состоит из набора привилегий Postgres, типа действовать в качестве суперпользователя Postgres, создавать/удалять базы данных, и обновлять системные каталоги. Пользователь Unix ничего не сможет делать с Postgres, пока соответствующий экземпляр не установлен в этом классе. Дальнейшая информация системных каталогов доступна из работы запросов над соответствующими классами.


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 8. Безопасность

Оглавление
Аутентификация пользователя
Имена пользователей и группы
Контроль доступа
Функции и правила

Безопасность базы данных распределена по нескольким уровням:

Аутентификация пользователя

Аутентификация - это процесс, с помощью которого серверу и postmaster гарантируется, что запрашиваемый пользователем доступ к данным получит такой, кем фактически он/она себя заявил. Все пользователи, которые вызывают Postgres, проверяются на содержание в pg_user классе, чтобы удостовериться что они уполномочены это делать. Однако, проверка подлинности пользователя выполняется различными путями:

Из пользовательского shell

Клиент запускается из пользовательского shell, пользовательский (эффективный) user-id которого перед выполнением setuid заменяется на user-id пользователя postgres. Эффективный user-id используется как основа для проверки контроля доступа. Других аутентификаций не проводится.

Из сети

Если система Postgres собрана как рапспределённая, то доступ к порту Internet TCP процесса postmaster доступен для всех. DBA настраивает файл pg_hba.conf в каталоге PGDATA чтобы указать какая система аутентификации будет использоваться в зависимости от того какой хост установил соединение и к какой базе данных он хочет подключиться. Смотри pg_hba.conf(5), который описывает доступные системы аутентификации. Конечно, аутентификация, основанная на хосте, также небезопасна для Unix. Конечно, возможно определить захватчиков выдающих себя на первоначальный хост. Эти проблемы безопасности лежат вне пределов Postgres.


Руководство администратора по PostgreSQLПредыдущийГлава 8. БезопасностьСледующий

Имена пользователей и группы

Для определения нового пользователя, запусти программную утилиту createuser.

Можно назначить пользователю или собрать пользователей в группу, сначала должна быть определена сама группа, и затем можно назначить пользователям группу. В Postgres эти шаги в настоящий момент не поддерживаются командой create group. Вместо неё, группы определяются с помощью вставки соответствующих значений в системную таблицу pg_group, а затем используется команда grant, чтобы назначить привилегии группе.

Создание пользователей

Создание групп

В настоящий момент, нет лёгкого интерфейса для настройки групп. Ты должен явно вставлять/обновлять таблицу pg_group. Например: jolly=> insert into pg_group (groname, grosysid, grolist) jolly=> values ('posthackers', '1234', '{5443, 8261}'); INSERT 548224 jolly=> grant insert on foo to group posthackers; CHANGE jolly=> Поля в pg_group: * groname: имя группы. Это название и должно быть исключительно буквенноцифровым. Не включай подчёркивания и другие знаки препинания. * grosysid: id группы. Типа int4. Должно быть уникальным для каждой группы. * grolist: список pg_user id's, которые принадлежат группе. Типа int4[].

Назначение пользователей в группы


Руководство администратора по PostgreSQLПредыдущийГлава 8. БезопасностьСледующий

Контроль доступа

Postgres обеспечивает механизмы, позволяющие ограничивать права доступа пользователей к данным, которые могут быть доступны другим пользователям.

Суперпользователи базы данных

Суперпользователи базы данных (т.е., у которых установлен pg_user.usesuper), бесшумно проходят все контроль доступа, описанные ниже, за исключением двух случаев: обновление вручную системного каталога не разрешается, если пользователь не имеет установленного pg_user.usecatupd, и уничтожение системных каталогов (или изменение их схем) никогда не разрешается.

Привилегии доступа

Использование привилегий доступа ограничивает чтение, запись и установку правил на классы, описываемые в grant/revoke(l).

Удаление класса и изменение схемы

Командами, которые уничтожают или модифицируют структуру существующего класса, такие как alter, drop table, и drop index, оперирует только владелец класса. Как отмечалось выше, эти операции никогда не позволено производить над системными каталогами.


Руководство администратора по PostgreSQLПредыдущийГлава 8. БезопасностьСледующий

Функции и правила

Функции и правила позволяют пользователям вставлять код в сервер, который могут выполнять другие пользователи не зная об этом. Следовательно, оба механизма дают пользователям троянского коня, с относительной безнаказанностью создателей. Существует только одна реальная защита - это аккуратный контроль над тем кто определяет функции (например, записывать в отношения с полями SQL) и правила. Проверять следы и изменения в pg_class, pg_user and pg_group также рекомендуется.

Функции

Функции пишутся на любом языке, кроме SQL, работают внутри процесса сервера, с правами пользователя postgres (сервер работает с своим реальным и эффективным user-id установленным в postgres. Это даёт возможность пользователям изменять внутренние структуры данных сервера изнутри доверенных функций. Следовательно, помимо прочих вещей, такие функции могут обмануть любую систему контроля доступа. Это врождённая проблема определяемых пользователем функций на C.

Правила

Подобно функциям SQL, правила всегда работают с идентификатором и правами пользователя, который вызвал сервер.

Предостережения

Не планируется явной поддержки шифрования данных внутри Postgres (хотя, ничего не удерживает пользователей от шифрования данных с помощью функций, определяемых пользователем). Не планируется явной поддержки шифрования сетевых соединений, до принятия решения по полной переписи протокола клиент/сервере.

Имена пользователей, групп и идентификаторы связанных систем (например, содержащиеся в pg_user.usesysid) предполагается сделать уникальными в всей базы данных. Могут случаться непредсказуемые результаты, если этого нет.


Руководство администратора по PostgreSQLПредыдущийГлава 1. ВведениеСледующий

Терминология

В последующем тексте, термин сайт означает хост машину, на которой установлен Postgres. Т.к. возможно установить более одной базы данных Postgres на один хост, то этот термин более точно указывает на любой отдельный набор установленных исполняемых файлов и баз данных Postgres.

Суперпользователь Postgres - это имя пользователя postgres, которому принадлежат исполняемые и файлы баз данных Postgres. Для суперпользователя, все механизмы защиты пропускаются и доступны любые произвольные данные. К тому же, суперпользователю Postgres позволено запускать некоторые программы поддержки, которые, в основном, недоступны для всех пользователей. Заметим, что суперпользователь Postgres - это не суперпользователь Unix (на который будем ссылаться как на root). Суперпользователь должен иметь не нулевой идентификатор пользователя (UID) по причинам безопасности.

Администратор базы данных или DBA - это человек, который отвечает за установку механизмов Postgres в соответствии с политикой безопасности сайта. DBA может добавлять новых пользователей по методике, описанной ниже и поддерживать набор шаблонов баз данных для использования с createdb.

postmaster - это процесс, который работает как расчётная палата для запросов к системе Postgres. Клиентские приложения подключаются к postmaster, который отслеживает любые системные ошибки и взаимодействие с процессами сервера. postmaster может принимать некоторые аргументы из командной строки для настройки своего поведения. Однако, указывать аргументы необходимо только если ты намереваешься запускаться на нескольких сайтах или не на сайте по умолчанию.

Сервер Postgres (т.е. исполняемая программа postgres) может быть запущена прямо из пользовательского shell суперпользователем Postgres (с именем базы данных в качестве аргумента). Однако, из-за этого не принимается во внимание разделяемый буферный пул и блокировка таблиц, связанных с postmaster/сайтом, поэтому это не рекомендуется на многопользовательском сайте.


Руководство администратора по PostgreSQLПредыдущийСледующий

Глава 12. Поиск неисправностей

Оглавление
Отказ запуска postmaster
Проблемы подключения клиента
Сообщения отладки

Отказ запуска postmaster

Есть несколько общих причин по которым postmaster отказывается стартовать. Проверь log файл postmaster или запусти его вручную (без перенаправления стандартного вывода или стандартного потока ошибок), чтобы увидеть какие сообщения выдаются. Некоторые возможные сообщения об ошибках говорят сами за себя, а вот которые нет:

FATAL: StreamServerPort: bind() failed: Address already in use
        Is another postmaster already running on that port?
    
Это, обычно, означает что только можно предположить: ты случайно запускаешь второго postmaster на том же порту где один уже есть. Однако, если сообщение об ошибке ядра не "Address already in use" или какой-то вариант этих слов, то это может быть другая проблема. Например, попытайся запустить postmaster на зарезервированном номере порта
$ postmaster -i -p 666
FATAL: StreamServerPort: bind() failed: Permission denied
        Is another postmaster already running on that port?
    

IpcMemoryCreate: shmget failed (Invalid argument) key=5440001, size=83918612, permission=600
FATAL 1:  ShmemCreate: cannot create region
    
Сообщение типа этого, вероятно, означает, что предел размера ядра разделяемой области памяти меньше чем область буфера, которую Postgres пытается создать. (Или это может означать что ты не имеешь поддержки SysV-типа разделяемой памяти, которое всегда настраивается в ядре.) В качестве временной рабочей области, ты можешь запустить postmaster с меньшим чем нормальным числом буферов (-B переключатель). Однако, в конце концов, ты захочешь переконфигурировать ядро, увеличив разрешённый размер разделяемой памяти. Ты можешь увидеть это сообщение, когда попытаешься запустить несколько postmasterов на одной машине, если её общее пространство запросов превысит предел ядра.

IpcSemaphoreCreate: semget failed (No space left on device) key=5440026, num=16, permission=600
    
Сообщение, подобное этому, не означают, что ты забил дисковое пространство; оно означает, что предел ядра на число SysV семафоров, меньше чем число, которое хочет создать Postgres. Как указывалось выше, обойти эту проблему, запустив postmaster с уменьшенным числом процессов сервера (-N переключатель), но в конце концов, ты захочешь увеличить предел ядра.


Руководство администратора по PostgreSQLПредыдущийГлава 12. Поиск неисправностейСледующий

Проблемы подключения клиента

После запуска postmaster, попытка подключиться к нему из клиентского приложения может потерпеть неудачу по различным причинам. Примеры сообщений ошибок показанных здесь для клиентов, основаны на новых версиях libpq --- клиенты, основанные на других библиотеках интерфейса могут выдавать другие сообщения более или менее информативные.

connectDB() -- connect() failed: Connection refused
Is the postmaster running (with -i) at 'server.joe.com' and accepting connections on TCP/IP port '5432'?
    
В общем это - "Я не могут найти postmaster с которым можно поговорить". Оно появляется при попытки соединения TCP/IP, или при попытки соединения через Unix-сокет к локальному postmaster:
connectDB() -- connect() failed: No such file or directory
Is the postmaster running at 'localhost' and accepting connections on Unix socket '5432'?
    
Последняя строка полезна для той проверки, что клиент пытается подключиться к тому к чему предполагает. Это фактически не запущенный postmaster, это ядро выводит обычно или "Connection refused" или "No such file or directory", как показано. (Особенно важно понимать это "Connection refused" в том контексте что это не значит что postmaster получил твой запрос на соединение и отверг его --- этот случай выводит другое сообщение, какое показано ниже.) Другие сообщения об ошибках, типа "Connection timed out", могут указывать на более принципиальную проблему, подобно недостатку сетевой подключаемости.

No pg_hba.conf entry for host 123.123.123.123, user joeblow, database testdb
    
Это то, что ты наиболее часто получаешь, если произошёл контакт с postmaster, но он не хочет говорить с тобой. Как написано в сообщении, postmaster отверг соединение, потому что не нашёл записи авторизации в своем pg_hba.conf файле конфигурации.

Password authentication failed for user 'joeblow'
    
Сообщения, подобно этому, указывают, что на контакт с postmaster, и он бы хотел поговорить с тобой, но пока ты не прошёл авторизацию, указанную в pg_hba.conf файле. Проверь передаваемый пароль, или проверь программное обеспечение Kerberos или IDENT, если жалобы появляются только с этими типами аутентификации.

FATAL 1:  SetUserId: user 'joeblow' is not in 'pg_shadow'
    
Это другой вариант неудачной аутентификации: команда Postgres create_user не может быть выполнена для заданного имени пользователя.

FATAL 1:  Database testdb does not exist in pg_database
    
Такое имя базы данных вне контроля postmaster. Заметим, что если ты не указал имя базы данных, по умолчанию оно будет твоим именем пользователя Postgres, которое может быть, а может и нет нужным тебе.


Руководство администратора по PostgreSQLПредыдущийГлава 12. Поиск неисправностейСледующий

Сообщения отладки

postmaster изредка выводит сообщения, которые бывают часто полезными при поиске неисправностей. Если ты хочешь видеть сообщения отладки postmaster, то ты можешь запустить его с опцией -d и перенаправить выводи в log файл:

% postmaster -d >& pm.log &
    
Если ты не хочешь видеть эти сообщения, то можешь набрать
% postmaster -S
    
и postmaster будет безмолвен. Заметим, что нет амперсанда ("&") в конце строки последнего примера, поэтому postmaster будет работать в интерактивном режиме.

pg_options

Замечание: При содействии Massimo Dal Zotto

Необязательный файл data/pg_options содержит опции выполнения, используемые сервером для управления трассировкой сообщений и другие настраиваемые параметры сервера. Файл перечитывается сервером при приеме сигнала SIGHUP, что дает возможность изменять опции выполнения на лету без перезапуска Postgres. Опции, указанные в этом файле, могут быть флагами отладки, используемые пакетом трассировки (backend/utils/misc/trace.c) или числовыми параметрами, которые могут использоваться сервером для управления его работой.

Все опции pg_options при запуске сервера установлены в ноль. Новые или измененные опции будут читаться всеми новыми серверами при их запуске. Чтобы сделать действительными любые изменения для всех запущенных серверов, нужно послать SIGHUP в postmaster. Сигнал будет автоматически послан всем серверам. Также мы можем включить изменения только для определенных серверов, посылая им сигнал SIGHUP напрямую.

pg_options также можно указать в ключе -T Postgres:

postgres options -T "verbose=2,query,hostlookup-"
    

Функции, используемые для печати ошибок и сообщений отладки теперь могут использовать удобства syslog(2). Сообщения, печатающиеся в stdout или stderr, предваряются временной отметкой и pid сервера:

#timestamp          #pid    #message
980127.17:52:14.173 [29271] StartTransactionCommand
980127.17:52:14.174 [29271] ProcessUtility: drop table t;
980127.17:52:14.186 [29271] SIIncNumEntries: table is 70% full
980127.17:52:14.186 [29286] Async_NotifyHandler
980127.17:52:14.186 [29286] Waking up sleeping backend process
980127.19:52:14.292 [29286] Async_NotifyFrontEnd
980127.19:52:14.413 [29286] Async_NotifyFrontEnd done
980127.19:52:14.466 [29286] Async_NotifyHandler done
    

Этот формат улучшает читабельность logs и позволяет людям точно понять какой сервер что делал и в какое время. Это также облегчает написание простых сценариев awk или perl, которые проверяют log для обнаружения ошибок базы данных и проблем, или для вычисления временной статистики по транзакциям.

Сообщения, выводящиеся в syslog, используют log возможность LOG_LOCAL0. Использование syslog можно контролировать с помощью syslog pg_option. К сожалению, многие функции вызывают напрямую printf() для печати своих сообщений в stdout или stderr и этот вывод не может быть перенаправлен в syslog или иметь временных отметок. Рекомендуется, чтобы все вызовы printf замещались макросами PRINTF и вывод в stderr использовал бы EPRINTF, для того чтобы мы могли контролировать весь вывод в стандартном виде.

Формат файла pg_options следующий:

# comment
option=integer_value  # set value for option
option                # set option = 1
option+               # set option = 1
option-               # set option = 0
    
Заметьте, что ключевым словом также может быть аббревиатура названия опции, определённой в backend/utils/misc/trace.c.

Смотри в Использование pg_options полный список опций ключевых слов и возможных значений.


Руководство администратора по PostgreSQLПредыдущийГлава 1. ВведениеСледующий

О Y2K

Автор: Написано Thomas Lockhart в 1998-10-22.

PostgreSQL Global Development Team предоставляет код программного обеспечения Postgres в общее пользование, без гарантий и без ответственности за его поведение и производительность. Однако, за время написания:

Обратись к Проект Gnu и Институт Perl за дальнейшим обсуждением проблемы Y2K, в особенности что касается открытых исходных текстов, бесплатного программного обеспечения.