Авторское право на PostgreSQL принадлежит © 1996-9 Postgres Global Development Group.
Следующий | ||
Резюме |
Авторское право на PostgreSQL принадлежит © 1996-9 Postgres Global Development Group.
Следующий | ||
Резюме |
Избранные руководства и лекции по SQL и Postgres.
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 .
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.
Предыдущий | Начало | |
Расчёт времени результатов |
Полный набор параметров, доступных в 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++.
Предыдущий | Начало | Следующий |
Неподдерживаемые платформы | Параметры сборки (make) |
Многие инсталяционные параметры могут быть установлены при стадии сборки установки Postgres.
В большинстве случаев, эти параметры нужно помещать в файл, Makefile.custom, предназначенный как раз для этих целей. По умолчанию, дистрибутив не содержит этот необязательный файл, поэтому тебе нужно создать его с помощью любимого редактора. При модернизации установки, можно перед сборкой просто скопировать старый Makefile.custom в новую установку.
make [ variable=value [,...] ]
Некоторые переменные, которые могут быть указаны здесь:
Корень дерева установки.
Местоположение приложений и утилит.
Местоположение объектных библиотек, включая разделяемые библиотеки.
Местоположение заголовочных файлов.
Местоположение для всей установки файла конфигурации psqlODBC (ODBC).
Существуют ещё необязательные параметры, которые не так широко используются. Многие из них описаны ниже в соответствии с разработкой кода сервера Postgres.
Установка флагов для компилятора C. Должны назначаться с "+=", чтобы сохранить уместные параметры по умолчанию.
Установка флагов для разборщиков синтаксиса yacc/bison. -v может использоваться для помощи в определении проблем при сборки новым разборщиком. Должны назначаться с "+=", чтобы сохранить уместные параметры по умолчанию.
Разрешить сборку Tcl интерфейса.
Листы в формате DocBook HTML для сборки документации с нуля. Не используется, если только ты не разрабатываешь новую документацию из DocBook-совместимых SGML исходных текстов doc/src/sgml/.
Листы в формате 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 - он не поддерживал национальные алфавиты. Поискав возможные пути обхода, я решил разработать поддержку локали сам. Я не программист на C, но у меня уже был некоторый опыт программирования с локалью, когда я работал с perl (отладка) и glimpse. После нескольких дней ковыряния исходников Postgres, я сделал несколько маленьких правочек в src/backend/utils/adt/varlena.c и src/backend/main/main.c и получил то что хотел! Я сделал поддержку только для LC_CTYPE и LC_COLLATE, но позднее LC_MONETARY была добавлена другими. Я получил много сообщений от людей об этом патче, и поэтому решил послать его разработчикам, и (к моему удивлению) он был включён в дистрибутив Postgres.Замечание: Написал Oleg Bartunov. Смотри на web странице Олега дополнительную информацию про локаль и поддержку русского языка.
Люди часто жаловались, что локаль у них не работает. Вот несколько распространённых ошибок:
Неправильно сконфигурированный postgresql перед компиляцией. Ты должен запустить configure с опцией --enable-locale, чтобы разрешить поддержку локали. Неправильно настроенная среда при запуске postmaster. Нужно определять переменные среды LC_CTYPE и LC_COLLATE перед запуском postmaster, потому что сервер берёт информацию о локали из среды. Я использую такой сценарий shell (runpostgres):
#!/bin/sh export LC_CTYPE=koi8-r export LC_COLLATE=koi8-r postmaster -B 1024 -S -D/usr/local/pgsql/data/ -o '-Fe'и запускаю его из rc.local посредством
/bin/su - postgres -c "/home/postgres/runpostgres"
Плохая поддержка локали в ОС (например, поддержка локали в libc под Linux несколько раз изменялась и это привело к многочисленным проблемам). Последний perl также имеет поддержку локали и если локаль не работает, то perl -v выразит недовольство:
8:17[mira]:~/WWW/postgres>setenv LC_CTYPE not_exist 8:18[mira]:~/WWW/postgres>perl -v perl: warning: Setting locale failed. perl: warning: Please check that your locale settings: LC_ALL = (unset), LC_CTYPE = "not_exist", LANG = (unset) are supported and installed on your system. perl: warning: Falling back to the standard locale ("C").
Неправильное расположение файлов локали! Возможные местоположения локали: /usr/lib/locale (Linux, Solaris), /usr/share/locale (Linux), /usr/lib/nls/loc (DUX 4.0). Ищи в man locale правильное местоположение. Под Linux я создаю символическую ссылку между /usr/lib/locale и /usr/share/locale чтобы быть уверенным, что следующая libc не грохнет мне локаль.
Ты можешь использовать ~* и order с операторами для строк, содержащих символы национальных алфавитов. Не английским пользователям определённо это нужно. Если ты не хочешь использовать свойство локали, просто удали определение переменной USE_LOCALE.
Есть только один очевидный недостаток использования локали - это скорость! Так что, используй локаль, только если тебе это действительно необходимо.
Предыдущий | Начало | Следующий |
Параметры сборки (make) | В начало главы | 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, делаются следующие предположения об именах пользователя и сервиса:
Предполагается, что главные имена пользователей (anames) содержат реальные имена пользователей Unix/Postgres в первой компоненте.
Предполагается, что сервис Postgres имеет две компоненты, имя сервиса и имя машины, как предписывает версия 4 (т.е., с удалением всех суффиксов доменов).
Таблица 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.
Предыдущий | Начало | Следующий |
Поддержка локали | В начало главы | Схема размещения системы |
Авторские права на 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.
Предыдущий | Начало | Следующий |
О Y2K | В начало главы | Переносимость |
Возможно создавать базы данных в местоположении, отличном от расположения установки по умолчанию. Помни, что весь доступ к базам данных на самом деле происходит через сервер базы данных, поэтому любое указанное местоположение должно быть доступно серверу.
Для создания и доступа к дополнительным расположениям баз данных используется переменная среды, которая задает абсолютный путь, где предполагается хранить данные. Эта переменная среды должна определяться перед запуском сервера и должна быть доступна для записи бюджету администратора 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
Предыдущий | Начало | Следующий |
Добавление и удаление пользователей | Управление базой данных |
Инструкции по сборке и установке клиентской библиотеки Postgres v6.4 под Win32.
makefileы, включенные в Postgres, написаны для Microsoft Visual C++, и вероятно не будут работать с другими системами. В некоторых случаях возможно компилировать библиотеки вручную.
Для сборки библиотек, измени текущий каталог на каталог src и набери команду
nmake /f win32.makПредполагается, что Visual C++ имеется в твоем пути.
Будут собраны следующие файлы:
interfaces\libpq\Release\libpq.dll - Динамически подключаемая клиентская библиотека
interfaces\libpq\Release\libpqdll.lib - Библиотека импорта для связи твоих программ с libpq.dll
interfaces\libpq\Release\libpq.lib - Статическая версия клиентской библиотеки
bin\psql\Release\psql.exe - Интерактивный SQL монитор Postgresql
Предыдущий | Начало | Следующий |
Замечания по переносу | Установка библиотек |
В действительности устанавливается только часть библиотеки libpq.dll. В большинстве случаев, файл помещается в каталог WINNT\SYSTEM32 (или WINDOWS\SYSTEM в системах Windows 95/98). Если этот файл устанавливается с помощью программы установки, то он будет установлен с проверкой версии с помощью ресурса VERSIONINFO, включенного в этот файл, чтобы гарантировать что новая версия библиотеки не будет перезаписана.
Если ты планируешь разработки с использованием libpq на этой машине, то тебе нужно добавить каталоги src\include и src\interfaces\libpq в путь include в настройках твоего компилятора.
Предыдущий | Начало | Следующий |
Установка на Win32 | В начало главы | Использование библиотек |
Чтобы использовать библиотеки, ты должен добавить файл libpqdll.lib в свой проект (в Visual C++, просто щелкни правой клавишей мыши на проекте и выбери добавить).
После того как это сделано, станет возможным использовать библиотеку также как и на Unix платформе.
Предыдущий | Начало | Следующий |
Установка библиотек | В начало главы | Рабочая среда |
Полная инструкция по установке Postgres v6.5.1.
Перед установкой Postgres, посети www.postgresql.org, чтобы посмотреть новую информацию, патчи, и т.д.
Эти инструкции по установке предполагают:
Unix-совместимые команды. Смотри замечание ниже.
Значения по умолчанию используются везде, где не отмечено другого.
Пользователь postgres суперпользователь Postgres.
Путь к исходным файлам /usr/src/pgsql (возможны другие пути).
Путь куда ставится /usr/local/pgsql (возможны другие пути).
Команды тестировались на RedHat Linux версии 5.2, при использовании tcsh shell. Вероятно они будут работать на большинстве систем, если не отмечено другого. Команды типа ps и tar могут дико расходиться между платформами по используемым опциям. Пользуйся здравым смыслом перед вводом этих команд.
Нашим Makefile-ам необходим GNU make (называется “gmake” в этом документе). Они не будут работать с не-GNU make программами. Если у тебя GNU make установлен с именем “make” вместо “gmake”, то пользуйся командой make. Это хорошо, но тебе нужно иметь GNU form из make для успешной установки.
Новейшая информация о поддерживаемых платформах - 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
Предыдущий | Начало | Следующий |
Схема размещения системы | Процедура установки |
После того как 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 | +----------------------------------+----------------------------------+-------+
И так далее. Идею ты понял.
Предыдущий | Начало | Следующий |
Процедура установки | В начало главы | Следующий шаг |
Вопросы? Баги? Обратная связь? Во-первых, почитай файлы из каталога /usr/src/pgsql/doc/. FAQ из этого каталога может быть особенно полезен.
Если Postgres не проходит компиляцию на твоем компьютере, то заполни форму в файле /usr/src/pgsql/doc/bug.template и пошли ее по адресу, указанному наверху формы.
Начни работу с web сайта http://www.postgresql.org Дополнительная информация есть в нескольких списках рассылки поддержки.
Предыдущий | Начало | Следующий |
Использование Postgres | В начало главы | Замечания по переносу |
Посмотри любые платформо-зависимые FAQи в каталоге doc/ исходного дистрибутива.
Предыдущий | Начало | Следующий |
Следующий шаг | В начало главы | Установка на Win32 |
Установка Postgres
Новая установка или обновление предыдущих версий Postgres:
Прочитай всю последнюю информацию и замечания об особенностях переноса на платформу. Некоторые замечания об особенностях платформы в конце этого файла для 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.
Создай бюджет суперпользователя Postgres(обычно используется postgres), если он ещё не существует.
Владельцем файлов Postgres может быть любой непревелигерованный пользовательский бюджет. Им не должен быть root, bin, или любой другой бюджет со специальными правами доступа, это может создать дыру в защите.
Войди под бюджетом суперпользователя Postgres. Большинство оставшихся шагов установки будут производиться из этого бюджета.
Скачай файл ftp://ftp.postgresql.org/pub/postgresql-v6.5.1.tar.gz из Internet. Сохрани его в своём домашнем каталоге.
Некоторые платформы используют 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.
Если ты не обновляешь существующую систему, пропусти всё до шага 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 обратно. |
Если ты обновлял существующую систему, то прибей postmaster. Введи
$ ps -ax | grep postmasterЭто даст тебе список с номерами процессов. Введи следующую строку с заменой pid на id процесса postmaster. (Не используй id процесса "grep postmaster".) Введи
$ kill pidчтобы на самом деле остановить процесс.
Подсказка: В системах, которые запускают Postgres во время загрузки, вероятно существует файл запуска, который выполняет это действие. Например, на моей Linux системе я могу набрать
$ /etc/rc.d/init.d/postgres.init stopчтобы остановить Postgres.
Если ты обновляешь существующую систему, то перемести старые каталоги куда-нибудь. Если у тебя мало места, то вместо этого можешь сделать резервную копию и удалить каталоги. Если ты поступаешь так, то сохрани старую базу данных в /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), то тебе также надо бы переместить этот каталог в той же манере.
Сделай новые каталоги для исходников и установки. Фактические пути могут отличаться от твоих, но ты должен пройти через эту процедуру.
Замечание: Существует два места в процедуре установки, где ты имеешь возможность задать местоположение установки для программ, библиотек, документации, и других файлов. Обычно, достаточно задать их перед стадией установки gmake install.
Введи
$ su $ cd /usr/src $ mkdir pgsql $ chown postgres:postgres pgsql $ cd /usr/local $ mkdir pgsql $ chown postgres:postgres pgsql $ exit
Unzip и untar новый файл исходников. Введи
$ cd /usr/src/pgsql $ gunzip -c ~/postgresql-v6.5.1.tar.gz | tar xvf -
Настрой исходный код под твою систему. В этом шаге ты должен задать фактический путь установки для процесса сборки (смотри ниже опцию --prefix). Введи
$ cd /usr/src/pgsql/src $ ./configure [ options ]
Помимо других действий, сценарий configure выбирает системо-зависимый файл "шаблон" из файлов из подкаталога template. Если он не определит какая система используется, то он об этом скажет и завершится. В этом случае тебе нужно указать какой из них использовать и запустить configure снова, указав, в этот раз, опцию --with-template=TEMPLATE с правильно выбранным файлом.
Сообщай о проблемах: Если твоя система не распозналась configure автоматически и ты делал это, пожалуйста, пошли на email scrappy@hub.org вывод программы ./config.guess. Укажи, какой файл шаблона должен быть.
Задай опции конфигурации. Подробней смотри Опции конфигурации. Однако, для простой первой установки без дополнительных опций, типа поддержки мульти-байтовых символов или поддержки сравнивания из локали, можно выбрать достаточную для задач установку и запустить 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++.)
Вот сценарий configure, используемый на системе Sparc Solaris 2.5, с /opt/postgres заданный как начальный каталог установки:
$ ./configure --prefix=/opt/postgres \ --with-template=sparc_solaris-gcc --with-pgport=5432 \ --enable-hba --disable-locale
Подсказка: Конечно, ты можешь ввести все три строки в одной.
Установи документацию man и HTML. Введи
$ cd /usr/src/pgsql/doc $ gmake install
Также, документация доступна в Postscript формате. Ищи файлы, оканчивающиеся на .ps.gz в том же каталоге.
Скомпилируй программу. Введи
$ 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 остальные подробности.
Установи программу. Введи
$ 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” в твоей системе.
Если потребуется, скажи своей системе как найти новые разделяемые библиотеки. Ты можешь выполнить один из следующих, предпочтительно первый:
Как root, отредактируй файл /etc/ld.so.conf. Добавь строку
/usr/local/pgsql/libв файл. Затем, выполни команду /sbin/ldconfig.
В bash shell, введи
export LD_LIBRARY_PATH=/usr/local/pgsql/lib
В csh shell, введи
setenv LD_LIBRARY_PATH /usr/local/pgsql/lib
Заметьте, что команды выше могут дико отличаться в зависимости от операционных систем. Посмотри замечания по платформе, например для Ultrix4.x или для не-ELF Linux.
Если при создании базы данных, ты получаешь сообщение
pg_id: can't load library 'libpq.so', то был необходим шаг выше. Просто выполни этот шаг, затем попытайся создать базу данных снова.
Если ты используешь опцию --with-perl в configure, проверь установочный лог был ли установлен модуль Perl. Если ты следуешь нашему совету по созданию файлов Postgres, что они принадлежат непревелигерованному userid, то модуль Perl не установился, из-за отсутствия прав на запись в каталоги библиотеки Perl. Ты можешь выполнить его установку, или сейчас или позднее, став пользователем, которому принадлежит библиотека Perl (чаще root) (посредством su) и выполнив
$ cd /usr/src/pgsql/src/interfaces/perl5 $ gmake install
Если этого ещё не было сделано, то создай бюджет postgres для использования Postgres. Любой бюджет, который будет использовать Postgres должен создаваться подобным образом.
Есть несколько путей влияния на рабочую среду сервера Postgres. Обратись к Руководство администратора за полной информацией.
Замечание: Следующие инструкции для bash/sh shell. Переделай, соответственно с другими shellами.
Добавь следующие строки в твою среду входа: 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
Некоторые регрессивные тесты потерпят неудачу, если пользовательская схема сравнивания из локали отличается от стандартной C локали.
Если ты настраиваешь и компилируешь Postgres с --enable-locale, то ты должен установить среду локали в “C” (или удалить все “LC_*” переменные), поместив эти дополнительные строки в свою среду входа перед запуском postmaster:
LC_COLLATE=C LC_CTYPE=C export LC_COLLATE LC_CTYPE
Убедись, что ты определил эти переменные перед тем как продолжить выполнять оставшиеся шаги. Самый лёгкий путь сделать это - это набрать:
$ source ~/.bash_profile
Создай базу данных установки из бюджета суперпользователя Postgres (обычно бюджета postgres). Не выполняй их как root! Эта главная дыра в безопасности. Введи
$ initdb
Настрой права доступа к системе баз данных. Чтобы сделать это, отредактируй файл /usr/local/pgsql/data/pg_hba.conf. Инструкции включены в файл. (Если твоя база данных расположена не местоположении по умолчанию, т.е. если указывает PGDATA куда-нибудь ещё, то размещение этого файла должно быть изменено соответственно.) Этот файл должен быть сделан только для чтения опять после завершения. Если ты выполняешь обновление с v6.0 или позже то можешь скопировать файл pg_hba.conf из своей старой базы данных в свою новую базу данных, вместо переделывания файла сначала.
Краткий тест - сервер будет запускаться и работать из командной строки.
Запусти демона postmaster в фоновом режиме, набрав
$ cd $ nohup postmaster -i > pgserver.log 2>&1 &
Создай базу данных, набрав
$ createdb
Подключись к новой базе данных:
$ psql
И запусти простой запрос:
postgres=> SELECT datetime 'now';
Выйди из psql:
postgres=> \q
Удали тестовую базу данных (если ты не хочешь использовать её позднее для других тестов):
$ dropdb
Запусти 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 если он умрёт, но он не знает есть ли другая сторона эффекта.)
Запусти регрессивные тесты. Файл /usr/src/pgsql/src/test/regress/README детально описывает инструкции по запуску и толкования регрессивных тестов. Сокращёная версия вот:
Введи
$ 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 куда-нибудь, прежде чем делать это.)
Если этого уже не было сделано, то сейчас самое время настроить свой компьютер на выполнение систематического технического обслуживания. Следующее нужно делать через регулярные интервалы:
Минимальная процедура резервного копирования
Запусти команду SQL VACUUM. Она произведёт очистку твоей базы данных.
Выполни резервное копирование системы. (Вероятно, тебе придёт сделать несколько резервных копирований вручную.) Лучше, чтобы никто не использовал систему в это время.
В идеале, задачи выше должны выполняться из сценария shell script, который запускался бы каждую ночь или неделю с помощью cron. Посмотри man страницу crontab для начала, о том как это сделать. (Если ты сделал это, пожалуйста, e-mail нам копию твоего сценария shell. Мы бы тоже хотели настроить наши системы.)
Если ты обновлял существовавшую систему, то переустанови свою старую базу данных. Введи
$ 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() обеспечивает противоположный эффект неправильного использования обновления.
Если ты новый пользователь, ты можешь поиграться с Postgres как описано ниже.
Выполни очистку. Введи
$ 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
Ты, вероятно, захочешь распечатать документацию. Если у тебя 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
Команда Postgres хочет сохранить Postgres работающим на всех поддерживаемых платформах. Поэтому мы просим тебя дать знать, заработал или нет Postgres на твоей системе. Пожалуйста, пошли почтовое сообщение pgsql-ports@postgresql.org, указав следующее:
Версию Postgres (v6.5.1, 6.5, beta 990318, и т.д.).
Твою операционную систему (т.е. RedHat v5.1 Linux v2.0.34).
Твое аппаратное обеспечение (SPARC, i486, и т.д.).
Компилировалось, устанавливалось и отработали ли регрессивные тесты чисто? Если нет, какой исходный код ты изменил (т.е. применявшиеся патчи, сделанные изменения, и т.д.), какие тесты не прошли, и т.д. Предупреждающие сообщения при компиляции - это нормально. Тебе не нужно указывать их здесь.
Теперь, подключайся и управляй базами данных как хочешь. Пиши клиентские программы для доступа к серверу базы данных. Другими словами, пользуйся!
Предыдущий | Начало | Следующий |
Установка | В начало главы | Использование Postgres |
Этот документ является Руководством администратора для системы управления базами данных PostgreSQL, изначально разработанной в University of California at Berkeley. PostgreSQL основан на Postgres версии 4.2. Проект Postgres, возглавляемый профессором Michael Stonebraker, был субсидирован в рамках министерства обороны агентством по перспективным научным проектам (DARPA), Army Research Office (ARO), национальным научным фондом (NSF), и ESL, Inc.
Этот набор описаний состоит из нескольких частей:
Введение для новых пользователей. Не раскрывает внутренних свойств.
Общая информация для пользователей, включая доступные команды и типы данных.
Информация о внутренностях для программистов приложений. Обсуждаются расширяемость типов и функций, библиотечный интерфейс и проблемы разработки приложений.
Установка и управление. Список поддерживаемых машин.
Информация для разработчиков Postgres. Здесь подразумеваются те, кто способствуют проекту Postgres; информация о разработке приложений должна быть в Руководстве программиста. В настоящий момент включено в Руководство программиста.
Содержит справочную информацию о синтаксисе команд. В настоящий момент включено в Руководство пользователя.
В дополнении к этому набору описаний, есть другие источники помощи с установкой и использованием Postgres:
Страницы man содержат общую информацию о синтаксисе команд.
Документы, описывающие наиболее часто задаваемые вопросы (FAQ) посвящённые общим и некоторым платформенным проблемам.
Файлы README доступны в некоторых распространяемых пакетах.
На web сайте Postgres может иметься другая информация, не встречающаяся в дистрибутиве. Например, подборка из списка рассылки mhonarc, которая посвящена многим темам.
Список рассылки pgsql-general (архив) это хорошее место где ответят на вопрос пользователя. Есть другие списки рассылки; проконсультируйся в разделе Info Central на PostgreSQL web сайте.
Postgres это открытый продукт. По существу, его поддержка зависит от пользовательского сообщества. Как только ты начинаешь использовать Postgres, ты полагаешься на помощь других, или через документацию или через списки рассылки. Подумай, как можно помочь другим. Если ты узнал что-то, чего нет в документации, напиши про это и подари всем. Если ты добавил свойство в код - подари всем.
Даже без этих экспериментов можно исправить и немного изменить документацию, это тоже хороший путь начать. Список рассылки pgsql-docs (архив) - место для продолжения.
Предыдущий | Начало | Следующий |
Резюме | Терминология |
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, то тебе немедленно нужно вернуться назад и убедиться, что среда правильно настроена.
Предыдущий | Начало | Следующий |
Kerberos идентификация | Установка |
Если Postgres postmaster запущен и работает, мы можем создать несколько баз данных для экспериментов. Здесь мы опишем основные команды управления базой данных.
Скажем, ты хочешь создать базу данных с названием mydb. Ты можешь сделать это с помощью следующей команды:
% createdb dbnamePostgres позволяет создавать любое количество баз данных на одном сайте и ты автоматически становишься администратором созданной тобой базы данных. Имена баз данных должны иметь первым символом букву и ограничены в длину 16 символами. Не каждый пользователь имеет право становится администратором базы данных. Если Postgres дает тебе создать базу данных, то администратору сайта нужно дать тебе право на создание баз данных. Проконсультируйся у администратора сайта, если это случилось.
Предыдущий | Начало | Следующий |
Управление диском | Доступ к базе данных |
Если ты имеешь созданную базу данных, ты можешь получить к ней доступ:
запустив диалоговую программу управления Postgres (psql), который позволит тебе в диалоговом режиме вводить, удалять, и выполнять команды SQL.
написав программу на C, используя библиотеку процедур libpq. Она позволяет выполнять команды SQL из C и получать ответы и сообщения о состоянии обратно в программу. Ее интерфейс обсуждается дальше в Руководстве программиста по PostgreSQL.
% 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.
Предыдущий | Начало | Следующий |
Управление базой данных | В начало главы | Уничтожение базы данных |
Если ты администратор базы данных mydb, то ты можешь уничтожить её с помощью следующей команды UNIX:
% dropdb dbnameЭто действие физически уничтожает все файлы UNIX, связанные с базой данных и их нельзя восстановить, поэтому это нужно выполнять только по всеобщему соглашению.
Также, возможно уничтожить базу данных из сессии SQL, используя
> drop database dbname
Предыдущий | Начало | Следующий |
Доступ к базе данных | В начало главы | Резервное копирование и восстановление |
Предупреждение |
Для каждой базы данных необходимо делать резервное копирование на регулярной основе. Т.к. 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 для работы над этой возможной проблемой:
Используй сжатие при сбросе:
% pg_dump dbname | gzip > filename.dump.gzвосстановив с помощью
% createdb dbname % gunzip -c filename.dump.gz | psql dbnameили
% cat filename.dump.gz | gunzip | psql dbname
Используй разбиение:
% pg_dump dbname | split -b 1m - filename.dump.восстановив с помощью
% createdb dbname % cat filename.dump.* | pgsql dbname
Конечно, имя файла (filename) и содержимое вывода pg_dump не нужно сравнивать с именем базы данных. Также, восстановленная база данных может иметь произвольное новое имя, так что этот механизм также подходит для переименования базы данных.
Предыдущий | Начало | Следующий |
Уничтожение базы данных | В начало главы | Поиск неисправностей |
createuser разрешает указанным пользователям доступ к Postgres. destroyuser удаляет пользователей и препятствует их доступу к Postgres.
Эти команды влияют только на пользователей относящихся к Postgres; они не влияют на другие привилегии пользователей или их состояние в операционной системе.
Предыдущий | Начало | Следующий |
Функции и правила | Управление диском |
“...” или /usr/local/pgsql/ в начале имени файла используются для представления пути к домашнему каталогу суперпользователя Postgres.
В командном синтаксисе, скобки (“[” и “]”) показывают, что выражение или ключевое слово необязательны. Всё в фигурных скобках (“{” и “}”) и содержащие вертикальные штрихи (“|”) показывают, что ты можешь выбрать из них что-то одно.
В примерах, круглые скобки (“(” и “)”) используются для группировки логических выражений. “|” - это логический оператор OR.
В примерах показано выполнение команд из различных бюджетов и программ. Команды, выполняемые из бюджета root предваряются “>”. Команды, выполняемые из бюджета суперпользователя Postgres предваряются “%”, в то время как команды выполняемые из бюджета непревелигерованных пользователей предваряются “$”. Команды SQL предваряются “=>” или не имеют приглашения, в зависимости от смысла.
Внимание: На время написания (Postgres v6.5) нотации выделение команд не последовательно по всему набору документации. Пожалуйста, сообщайте об этой проблеме в список рассылки по документации.
Предыдущий | Начало | Следующий |
Терминология | В начало главы | О Y2K |
Замечание: При содействии 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
В настоящий момент определены следующие опции:
Флаг глобальной трассировки. Допустимые значения:
Сообщения трассировки разрешаются индивидуально
Разрешены все сообщения трассировки
Запрещены все сообщения трассировки
Флаг подробностей. Допустимые значения:
Нет сообщений. По умолчанию.
Печатать информационные сообщения.
Печатать более информативные сообщения.
Флаг трассировки запроса. Допустимые значения:
Не печатать запрос.
Печатать сжатый запрос в одну строку.
Печатать полный запрос.
Печатать план запроса.
Печатать после разбора.
Печатать переписанный запрос.
Печатать статистику разборщика.
Печатать статистику планировщика.
Печатать статистику исполнителя.
В настоящий момент не используется, но необходима для использования в будущем.
Трассировка блокировок.
Трассировка блокировок пользователя.
Трассировка spin блокировок.
Трассировка уведомляющих функций.
В настоящий момент не используется.
В настоящий момент не используется.
Минимальный oid для трассировки блокировок.
Если oid не равно нулю, то трассировка блокировок.
В настоящий момент не используется.
Таймер проверки взаимных блокировок.
Флаг syslog. Допустимые значения:
Сообщения в stdout/stderr.
Сообщения в stdout/stderr и syslog.
Сообщения только в syslog.
Разрешить поиск имени хоста в ps_status.
Разрешить отображение номера порта в ps_status.
Разблокировка pg_listener после уведомления.
Удалять дубликаты кортежей из pg_listener.
Предыдущий | Начало | Следующий |
Запуск postmaster | В начало главы | Безопасность |
Это руководство описывает Postgres версии 6.5. Сообщество разработчиков Postgres компилировало и тестировало Postgres на многих платформах. Проверяй последнюю информацию на на web сайте.
На время публикации, прошли тесты следующие платформы:
Таблица 2-1. Поддерживаемые платформы
ОС | Процессор | Версия | Сообщил | Замечания |
---|---|---|---|---|
AIX 4.3.2 | RS6000 | v6.5 | 1999-05-26 | (Andreas Zeugswetter) |
BSDI | x86 | v6.5 | 1999-05-25 | (Bruce Momjian |
FreeBSD 2.2.x-4.0 | x86 | v6.5 | 1999-05-25 | (Tatsuo Ishii, Marc Fournier) |
DGUX 5.4R4.11 | m88k | v6.3 | 1998-03-01 | с v6.4, вероятно, OK. Нужен новый сопровождающий. (Brian E Gallew) |
Digital Unix 4.0 | Alpha | v6.4 | 1998-10-29 | Небольшие проблемы, решаемые патчами (Pedro J. Lobo) |
HPUX | PA-RISC | v6.4 | 1998-10-25 | Обе версии 9.0x и 10.20 (Tom Lane, Stan Brown) |
IRIX 6.5 | MIPS | v6.4 | 1998-12-29 | IRIX 5.x - другой (Mark Dalphin) |
linux 2.0.x | Alpha | v6.3.2 | 1998-04-16 | По большей части порядок. Нужно работать над v6.4. (Ryan Kirkpatrick) |
linux 2.0.x/libc5 | x86 | v6.4 | 1998-10-27 | (Thomas Lockhart) |
linux 2.0.x/glibc2 | x86 | v6.5 | 1999-05-24 | (Thomas Lockhart) |
linux 2.0.x | MIPS | v6.4 | 1998-12-16 | Cobalt Qube (Tatsuo Ishii) |
linux 2.0.x | Sparc | v6.4 | 1998-10-25 | (Tom Szybist) |
linuxPPC 2.1.24 | PPC603e | v6.4 | 1998-10-26 | Powerbook 2400c (Tatsuo Ishii) |
mklinux DR3 | PPC750 | v6.4 | 1998-09-16 | PowerMac 7600 (Tatsuo Ishii) |
NetBSD | arm32 | v6.5 | 1999-04-14 | (Andrew McMurry) |
NetBSD/i386 1.3.2 | x86 | v6.4 | 1998-10-25 | (Brook Milligan) |
NetBSD | m68k | v6.4.2 | 1998-12-28 | Mac SE/30 (Mr. Mutsuki Nakajima, Tatsuo Ishii) |
NetBSD-current | NS32532 | v6.4 | 1998-10-27 | маленькие проблемы с математикой в дате/времени (Jon Buller) |
NetBSD/sparc 1.3H | Sparc | v6.4 | 1998-10-27 | (Tom I Helbekkmo) |
NetBSD 1.3 | VAX | v6.3 | 1998-03-01 | (Tom I Helbekkmo) |
SCO OpenServer 5 | x86 | v6.5 | 1999-05-25 | (Andrew Merrill) |
SCO UnixWare 7 | x86 | v6.5 | 1999-05-25 | (Andrew Merrill) |
Solaris | x86 | v6.4 | 1998-10-28 | (Marc Fournier) |
Solaris 2.6-2.7 | Sparc | v6.4 | 1998-10-28 | (Tom Szybist, Frank Ridderbusch) |
SunOS 4.1.4 | Sparc | v6.3 | 1998-03-01 | Работает с патчем (Tatsuo Ishii) |
SVR4 | MIPS | v6.4 | 1998-10-28 | Нет поддержки компилятором 64-bit int (Frank Ridderbusch) |
Windows | x86 | v6.4 | 1999-01-06 | Клиентские библиотеки или ODBC/JDBC. Сервера ещё нет. (Magnus Hagander |
Windows NT | x86 | v6.5 | 1999-05-26 | Работает с библиотекой Cygwin. (Daniel Horak) |
Платформы, работающие с v6.3.x и v6.4.x, должны также работать и с v6.5, но мы не получили явного подтверждения ко времени компиляции списка.
Замечание: Для Windows NT перенос серверной части Postgres был завершён недавно. Для его компиляции необходима библиотека Cygnus.
Предыдущий | Начало | Следующий |
Авторские права и торговые марки | Неподдерживаемые платформы |
Есть несколько платформ, на которых пытались и сообщили, что на них не работает стандартный дистрибутив. Ещё здесь есть платформы, которые не обеспечивают достаточных библиотек для попытки.
Таблица 2-2. Вероятно, несовместимые платформы
ОС | Процессор | Версия | Сообщил | Замечания |
---|---|---|---|---|
MacOS | all | v6.3 | 1998-03-01 | Несовместимые библиотеки; используй ODBC/JDBC |
NextStep | x86 | v6.x | 1998-03-01 | Поддержка только клиентов; v1.0.9 работает с патчами (David Wetzel) |
SVR4 4.4 | m88k | v6.2.1 | 1998-03-01 | Приемлемо с патчами; v6.4.x необходим TAS spinlock код (Doug Winterburn) |
Ultrix | MIPS,VAX? | v6.x | 1998-03-01 | Давно нет сообщений; вышла из употребления? |
Предыдущий | Начало | Следующий |
Переносимость | В начало главы | Опции конфигурации |
Ничего не происходит с базой данных, пока не запущен процесс postmaster. Для администратора сайта, есть несколько вещей о которых нужно помнить перед запуском postmaster. Они обсуждаются в разделах установки и настройки этого руководства. Однако, если Postgres был установлен по инструкции точно как написано, то следующие простые команды - это все что надо для запуска postmaster:
% postmaster
The postmaster время от времени выводит сообщения, которые часто полезны при поисках неисправностей. Если ты хочешь посмотреть сообщения отладки от postmaster, ты можешь запустить его с опцией -d и перенаправить вывод в log файл:
% postmaster -d > pm.log 2>&1 &Если ты не хочешь видеть эти сообщения, ты можешь набрать
% postmaster -Sи postmaster будет работать тихо ("S"ilent). Предупреждаем, что в конце строки нет амперсанда ("&") в последнем примере, поэтому postmaster будет запущен в интерактивном режиме.
Предыдущий | Начало | Следующий |
Рабочая среда | В начало главы | Использование pg_options |
Postgres изначально разрабатывался в UC Berkeley Computer Science Department, цитадели многих объектно-реляционных концепций, теперь ставших доступными в некоторых коммерческих базах данных. Он обеспечивает поддержку языка SQL92/SQL3, целостность транзакций и расширяемость типов. PostgreSQL является всеобщим достоянием, потомком с открытыми исходными текстами этого оригинального кода Berkeley.
Предыдущий | Начало | Следующий |
Руководство администратора по PostgreSQL | Введение |
Этот раздел необходимо переписать. Добровольцы?
Предыдущий | Начало | Следующий |
Сообщения отладки | Регрессивный тест |
Инструкции регрессивных тестов и анализ.
Регрессивные тесты PostgreSQL - это обширный набор тестов для реализации SQL, встроенного в PostgreSQL, разработанного Jolly Chen и Andrew Yu. Он тестируют как стандартны операции SQL, как расширенные возможности PostgreSQL.
Эти тесты недавно были были исправлены Marc Fournier и Thomas Lockhart и теперь упакованы как функциональные модули, которые легче запускать и понимать. После PostgreSQL v6.1 регрессивные тесты теперь в каждом официальном релизе.
Некоторые правильно установленные и полностью функциональные установки PostgreSQL, могут не пройти некоторые регрессивные тесты из-за различного представления чисел с плавающей точкой и поддержки временных зон. Текущие тесты оцениваются с помощью простого алгоритма "diff", и чувствительны к маленьким системным различиям. Для явно не прошедших тестов, при исследовании различий может обнаружиться, что различия несущественны.
Регрессивное тестирование, отмечаемое ниже, предполагает следующее (исключая замечания):
Команды - Unix-совместимые. Замечание ниже.
Используются значения по умолчанию, кроме где отмечено другое.
Пользователь postgres - это суперпользователь Postgres.
Путь к исходным текстам - /usr/src/pgsql (возможны другие пути).
Путь во время выполнения - /usr/local/pgsql (возможны другие пути).
Регрессивный тест вызывается командой 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
Предыдущий | Начало | Следующий |
Восстановление базы данных | Схема размещения каталогов |
Замечание: Здесь должна быть таблица из предыдущего раздела.
input/ .... .source файлы, которые преобразуются 'make all' в другие файлы .sql в 'sql' подкаталоге output/ ... .source файл, которые преобразуются 'make all' в .out файлы в 'expected' подкаталоге sql/ ...... .sql файлы, используемые для выполнения регрессивных тестов expected/ . .out файлы, которые представляют что мы *ожидаем* результаты look like results/ .. .out файлы, которые представляют какие результаты мы *получили* на самом деле. Также, используется как временное хранение для тестирования копирования таблиц.
Предыдущий | Начало | Следующий |
Регрессивный тест | В начало главы | Процедура регрессивного тестирования |
Команды тестировались на RedHat Linux версии 4.2 с использованием bash shell. Где не отмечено, они будут работать на большинстве систем. Команды типа ps и tar, имеют опции, сильно отличающиеся на разных платформах. Пользуйся здравым смыслом, перед тем как вводить эти команды.
Для новой установки или обновления с предыдущих версий Postgres:
Настройка регрессии Postgres
Файл /usr/src/pgsql/src/test/regress/README содержит подробные инструкции для запуска и понимания регрессивных тестов. Сокращенная версия здесь:
Если postmaster ещё не запущен, запусти postmaster в доступном окне, набрав
postmaster, или запусти демон postmaster в фоновом режиме, набрав
cd nohup postmaster > regress.log 2>&1 &
Запускай postmaster из под бюджета суперпользователя Postgres(обычно, бюджет postgres).
Замечание: Не запускай postmaster из бюджета root.
Если ты уже вызывал регрессивный тест, очисти рабочий каталог:
cd /usr/src/pgsql/src/test/regress gmake clean
Тебе не нужно вводить "gmake clean", если ты первый раз запускаешь эти тесты.
Собери регрессивный тест. Введи
cd /usr/src/pgsql/src/test/regress gmake all
Запусти регрессивные тесты. Введи
cd /usr/src/pgsql/src/test/regress gmake runtest
Ты получить на экране (а также в файле ./regress.out) серию предложений, из которых видно какие тесты прошли, а какие нет. Пожалуйста заметьте, что может быть нормально что некоторые тесты "не прошли". Для несработавших тестов, используй diff, чтобы сравнить файлы в каталогах ./results и ./expected. Если float8 не прошёл, введи что-то вроде этого:
cd /usr/src/pgsql/src/test/regress diff -w expected/float8.out results
После запуска тестов и исследования результатов, введи
dropdb regression cd /usr/src/pgsql/src/test/regress gmake cleanчтобы освободить временное дисковое пространство, использованное тестами.
Предыдущий | Начало | Следующий |
Схема размещения каталогов | В начало главы | Регрессивный анализ |
Результаты лежат в файлах в каталоге ./results. Эти результаты можно сравнить с результатами в каталоге ./expected, используя 'diff'. (Тестирующий сценарий сделает это за тебя, и поместит отличия в ./regression.diffs.)
Файлы могут точно не совпадать. Тестирующий сценарий сообщит о любом отличии как о "провале", но отличие может быть из-за маленьких системо-зависимых различий в написании сообщений ошибок, работы математической библиотеки, и т.д. "Провалы" такого типа не указывают на проблему с Postgres.
Поэтому, необходимо исследовать фактическую разницу для каждого "непрошедшего" теста, чтобы определить, есть ли реальная проблема. Следующие параграфы пытаются предоставить некоторое руководство в определении значима ли разница или нет.
Некоторые регрессивные тесты включают в себя создаваемые неправильные значения ввода. Сообщения об ошибках могут появиться или из кода Postgres code или из процедур системы платформы хоста. В последнем случае, сообщения могут различаться между платформами, но должны отражать похожую информацию. Эти различия в сообщениях приводят к "провалу" регрессивного теста, которая может быть обоснована проверкой.
Есть несколько мест, где 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.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.
Предыдущий | Начало | Следующий |
Процедура регрессивного тестирования | В начало главы | Замечания по выпускам |
This is basically a cleanup release for 6.5. We have fixed a variety of problems reported by 6.5 users.
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)
Предыдущий | Начало | Следующий |
Регрессивный анализ | Выпуск 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:
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.
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.
We now have a true numeric data type, with user-specified precision.
Temporary tables are guaranteed to have unique names within a database session, and are destroyed on session exit.
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.
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.
Most interfaces have new versions, and existing functionality has been improved.
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.
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.
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)
Предыдущий | Начало | Следующий |
Замечания по выпускам | В начало главы | Выпуск 6.4.2 |
Релиз 6.4.1 был неправильно упакован. Также был добавлен одно дополнительное исправление бага.
A dump/restore не нужны для запуска 6.4.*.
Исправление проблемы с константами дат/времени на некоторых платформах(Thomas)
Предыдущий | Начало | Следующий |
Выпуск 6.5 | В начало главы | Выпуск 6.4.1 |
В основном, чистка после релиза 6.4. Мы исправили различные проблемы, отмеченные пользователями 6.4.
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)
Предыдущий | Начало | Следующий |
Выпуск 6.4.2 | В начало главы | Выпуск 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:
Views and rules are now functional thanks to extensive new code in the rewrite rules system from Jan Wieck. He also wrote a chapter on it for the Руководство программиста.
Jan also contributed a second procedural language, PL/pgSQL, to go with the original PL/pgTCL procedural language he contributed last release.
We have optional multiple-byte character set support from Tatsuo Iishi to complement our existing locale support.
Client/server communications has been cleaned up, with better support for asynchronous messages and interrupts thanks to Tom Lane.
The parser will now perform automatic type coersion to match arguments to available operators and functions, and to match columns and expressions with target columns. This uses a generic mechanism which supports the type extensibility features of Postgres. There is a new chapter in the Руководство пользователя which covers this topic.
Three new data types have been added. Two types, inet and cidr, support various forms of IP network, subnet, and machine addressing. There is now an 8-byte integer type available on some platforms. See the chapter on data types in the Руководство пользователя for details. A fourth type, serial, is now supported by the parser as an amalgam of the int4 type, a sequence, and a unique index.
Several more SQL92-compatible syntax features have been added, including INSERT DEFAULT VALUES
The automatic configuration and installation system has received some attention, and should be more robust for more platforms than it has ever been.
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)
Предыдущий | Начало | Следующий |
Выпуск 6.4.1 | В начало главы | Выпуск 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:
Repairs automatic configuration support for some platforms, including Linux, from breakage inadvertently introduced in v6.3.1.
Correctly handles function calls on the left side of BETWEEN and LIKE clauses.
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)
Предыдущий | Начало | Следующий |
Выпуск 6.4 | В начало главы | Выпуск 6.3.1 |
Summary:
Additional support for multi-byte character sets.
Repair byte ordering for mixed-endian clients and servers.
Minor updates to allowed SQL syntax.
Improvements to the configuration autodetection for installation.
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)
Предыдущий | Начало | Следующий |
Выпуск 6.3.2 | В начало главы | Выпуск 6.3 |
There are many new features and improvements in this release. Here is a brief, incomplete summary:
Many new SQL features, including full SQL92 subselect capability (everything is here but target-list subselects).
Support for client-side environment variables to specify time zone and date style.
Socket interface for client/server connection. This is the default now so you may need to start postmaster with the “-i” flag.
Better password authorization mechanisms. Default table permissions have changed.
Old-style “time travel” has been removed. Performance has been improved.
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.
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)
Предыдущий | Начало | Следующий |
Выпуск 6.3.1 | В начало главы | Выпуск 6.2.1 |
v6.2.1 is a bug-fix and usability release on v6.2.
Summary:
Allow strings to span lines, per SQL92.
Include example trigger function for inserting user names on table updates.
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.
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)
Предыдущий | Начало | Следующий |
Выпуск 6.3 | В начало главы | Выпуск 6.2 |
A dump/restore is required for those wishing to migrate data from previous releases of Postgres.
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.
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)
Предыдущий | Начало | Следующий |
Выпуск 6.2.1 | В начало главы | Выпуск 6.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)
Предыдущий | Начало | Следующий |
Выпуск 6.2 | В начало главы | Выпуск 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).
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
Предыдущий | Начало | Следующий |
Выпуск 6.1.1 | В начало главы | Выпуск v6.0 |
A dump/restore is required for those wishing to migrate data from previous releases of Postgres.
This migration requires a complete dump of the 1.09 database and a restore of the database in 6.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
Предыдущий | Начало | Следующий |
Выпуск 6.1 | В начало главы | Выпуск v1.09 |
Извините, мы бросили вести список изменений с 1.02 по 1.09. Некоторые изменения внесены с список 6.0, который на самом деле включают с 1.02.1 по 1.09 releases.
Предыдущий | Начало | Следующий |
Выпуск v6.0 | В начало главы | Выпуск v1.02 |
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:
Start up a new 1.02.1 postmaster
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.sqlThose 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.
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
Предыдущий | Начало | Следующий |
Выпуск v1.09 | В начало главы | Выпуск 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:
Set the definition of NAMEDATALEN in src/Makefile.global to 16 and OIDNAMELEN to 20.
Decide whether you want to use Host based authentication.
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.
If you do not want host-based authentication, you can comment out the line
HBA = 1in 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.
Compile and install 1.01, but DO NOT do the initdb step.
Before doing anything else, terminate your 1.0 postmaster, and backup your existing $PGDATA directory.
Set your PGDATA environment variable to your 1.0 databases, but set up path up so that 1.01 binaries are being used.
Modify the file $PGDATA/PG_VERSION from 5.0 to 5.1
Start up a new 1.01 postmaster
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.sqland 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
Предыдущий | Начало | Следующий |
Выпуск v1.02 | В начало главы | Выпуск 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 с несколькими индексами никогда не работали,
теперь мы говорим, что они не работают, при попытки использовать их
Предыдущий | Начало | Следующий |
Выпуск v1.01 | В начало главы | 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.
Предыдущий | Начало | Следующий |
Выпуск v1.0 | В начало главы | 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
Предыдущий | Начало | Следующий |
Postgres95 Beta 0.03 | В начало главы | Postgres95 Beta 0.01 |
Начальный выпуск.
Предыдущий | Начало | Следующий |
Postgres95 Beta 0.02 | В начало главы | Расчёт времени результатов |
Здесь находится расчёт времени результатов работы регрессивного теста с помощью команды
% cd src/test/regress % make all % time make runtest
Расчёт времени под Linux 2.0.27 кажется меняется приблизительно на 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.4 должна быть немного быстрее чем предыдущий релиз (спасибо, Bruce!).
Время Система 02:26 Dual Pentium Pro 180, 96MB, UW-SCSI, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
Расчёт времени для этого релиза не связан напрямую из-за включения дополнительных регрессивных тестов и удаления некоторых устаревших тестов. В общем, однако, 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
Время Система 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
Предыдущий | Начало | Следующий |
Postgres95 Beta 0.01 | В начало главы | Библиография |
Эта глава обрисовывает в общих чертах взаимодействие между Postgres и операционной системой.
Все команды Postgres, которые исполняются напрямую из Unix shell находятся в каталоге “.../bin”. Включение этого каталога в путь поиска, облегчит выполнение команд.
Совокупность системных каталогов существует на каждом сайте. Они включают класс (pg_user), который содержит экземпляр каждого правильного пользователя Postgres. Экземпляр состоит из набора привилегий Postgres, типа действовать в качестве суперпользователя Postgres, создавать/удалять базы данных, и обновлять системные каталоги. Пользователь Unix ничего не сможет делать с Postgres, пока соответствующий экземпляр не установлен в этом классе. Дальнейшая информация системных каталогов доступна из работы запросов над соответствующими классами.
Предыдущий | Начало | Следующий |
Использование библиотек | Запуск postmaster |
Безопасность базы данных распределена по нескольким уровням:
Защита файлов баз данных. Все файлы, хранящиеся внутри базы данных, защищены от чтения из любого бюджета, отличного от бюджета суперпользователя Postgres.
Подключение клиента к серверу базы данных, по умолчанию, разрешено только через локальные гнезда Unix, а не через гнезда TCP/IP. Сервер должен запускаться с опцией -i, чтобы разрешить подключаться нелокальным клиентам.
Подключения клиентов могут бы ограничены по IP адресу и/или имени пользователя, через файл pg_hba.conf в PG_DATA.
Подключаемые клиенты могут быть аутентифицированы посредством внешних пакетов.
Каждому пользователю Postgres назначается имя пользователя(username) и (необязательно) пароль. По умолчанию, пользователи не имеют право на запись в базу данных, которую создали не они.
Пользователи могут образовывать группы, и доступ к таблицам может ограничиваться на основании привилегий группs.
Аутентификация - это процесс, с помощью которого серверу и postmaster гарантируется, что запрашиваемый пользователем доступ к данным получит такой, кем фактически он/она себя заявил. Все пользователи, которые вызывают Postgres, проверяются на содержание в pg_user классе, чтобы удостовериться что они уполномочены это делать. Однако, проверка подлинности пользователя выполняется различными путями:
Клиент запускается из пользовательского shell, пользовательский (эффективный) user-id которого перед выполнением setuid заменяется на user-id пользователя postgres. Эффективный user-id используется как основа для проверки контроля доступа. Других аутентификаций не проводится.
Если система Postgres собрана как рапспределённая, то доступ к порту Internet TCP процесса postmaster доступен для всех. DBA настраивает файл pg_hba.conf в каталоге PGDATA чтобы указать какая система аутентификации будет использоваться в зависимости от того какой хост установил соединение и к какой базе данных он хочет подключиться. Смотри pg_hba.conf(5), который описывает доступные системы аутентификации. Конечно, аутентификация, основанная на хосте, также небезопасна для Unix. Конечно, возможно определить захватчиков выдающих себя на первоначальный хост. Эти проблемы безопасности лежат вне пределов Postgres.
Предыдущий | Начало | Следующий |
Использование pg_options | Имена пользователей и группы |
Для определения нового пользователя, запусти программную утилиту 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[].
Предыдущий | Начало | Следующий |
Безопасность | В начало главы | Контроль доступа |
Postgres обеспечивает механизмы, позволяющие ограничивать права доступа пользователей к данным, которые могут быть доступны другим пользователям.
Суперпользователи базы данных (т.е., у которых установлен pg_user.usesuper), бесшумно проходят все контроль доступа, описанные ниже, за исключением двух случаев: обновление вручную системного каталога не разрешается, если пользователь не имеет установленного pg_user.usecatupd, и уничтожение системных каталогов (или изменение их схем) никогда не разрешается.
Использование привилегий доступа ограничивает чтение, запись и установку правил на классы, описываемые в grant/revoke(l).
Командами, которые уничтожают или модифицируют структуру существующего класса, такие как alter, drop table, и drop index, оперирует только владелец класса. Как отмечалось выше, эти операции никогда не позволено производить над системными каталогами.
Предыдущий | Начало | Следующий |
Имена пользователей и группы | В начало главы | Функции и правила |
Функции и правила позволяют пользователям вставлять код в сервер, который могут выполнять другие пользователи не зная об этом. Следовательно, оба механизма дают пользователям троянского коня, с относительной безнаказанностью создателей. Существует только одна реальная защита - это аккуратный контроль над тем кто определяет функции (например, записывать в отношения с полями SQL) и правила. Проверять следы и изменения в pg_class, pg_user and pg_group также рекомендуется.
Функции пишутся на любом языке, кроме SQL, работают внутри процесса сервера, с правами пользователя postgres (сервер работает с своим реальным и эффективным user-id установленным в postgres. Это даёт возможность пользователям изменять внутренние структуры данных сервера изнутри доверенных функций. Следовательно, помимо прочих вещей, такие функции могут обмануть любую систему контроля доступа. Это врождённая проблема определяемых пользователем функций на C.
Подобно функциям SQL, правила всегда работают с идентификатором и правами пользователя, который вызвал сервер.
Не планируется явной поддержки шифрования данных внутри Postgres (хотя, ничего не удерживает пользователей от шифрования данных с помощью функций, определяемых пользователем). Не планируется явной поддержки шифрования сетевых соединений, до принятия решения по полной переписи протокола клиент/сервере.
Имена пользователей, групп и идентификаторы связанных систем (например, содержащиеся в pg_user.usesysid) предполагается сделать уникальными в всей базы данных. Могут случаться непредсказуемые результаты, если этого нет.
Предыдущий | Начало | Следующий |
Контроль доступа | В начало главы | Добавление и удаление пользователей |
В последующем тексте, термин сайт означает хост машину, на которой установлен Postgres. Т.к. возможно установить более одной базы данных Postgres на один хост, то этот термин более точно указывает на любой отдельный набор установленных исполняемых файлов и баз данных Postgres.
Суперпользователь Postgres - это имя пользователя postgres, которому принадлежат исполняемые и файлы баз данных Postgres. Для суперпользователя, все механизмы защиты пропускаются и доступны любые произвольные данные. К тому же, суперпользователю Postgres позволено запускать некоторые программы поддержки, которые, в основном, недоступны для всех пользователей. Заметим, что суперпользователь Postgres - это не суперпользователь Unix (на который будем ссылаться как на root). Суперпользователь должен иметь не нулевой идентификатор пользователя (UID) по причинам безопасности.
Администратор базы данных или DBA - это человек, который отвечает за установку механизмов Postgres в соответствии с политикой безопасности сайта. DBA может добавлять новых пользователей по методике, описанной ниже и поддерживать набор шаблонов баз данных для использования с createdb.
postmaster - это процесс, который работает как расчётная палата для запросов к системе Postgres. Клиентские приложения подключаются к postmaster, который отслеживает любые системные ошибки и взаимодействие с процессами сервера. postmaster может принимать некоторые аргументы из командной строки для настройки своего поведения. Однако, указывать аргументы необходимо только если ты намереваешься запускаться на нескольких сайтах или не на сайте по умолчанию.
Сервер Postgres (т.е. исполняемая программа postgres) может быть запущена прямо из пользовательского shell суперпользователем Postgres (с именем базы данных в качестве аргумента). Однако, из-за этого не принимается во внимание разделяемый буферный пул и блокировка таблиц, связанных с 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 переключатель), но в конце концов, ты захочешь увеличить предел ядра.
Предыдущий | Начало | Следующий |
Резервное копирование и восстановление | Проблемы подключения клиента |
После запуска 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, которое может быть, а может и нет нужным тебе.
Предыдущий | Начало | Следующий |
Поиск неисправностей | В начало главы | Сообщения отладки |
postmaster изредка выводит сообщения, которые бывают часто полезными при поиске неисправностей. Если ты хочешь видеть сообщения отладки postmaster, то ты можешь запустить его с опцией -d и перенаправить выводи в log файл:
% postmaster -d >& pm.log &Если ты не хочешь видеть эти сообщения, то можешь набрать
% postmaster -Sи postmaster будет безмолвен. Заметим, что нет амперсанда ("&") в конце строки последнего примера, поэтому postmaster будет работать в интерактивном режиме.
Замечание: При содействии 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 полный список опций ключевых слов и возможных значений.
Предыдущий | Начало | Следующий |
Проблемы подключения клиента | В начало главы | Восстановление базы данных |
Автор: Написано Thomas Lockhart в 1998-10-22.
PostgreSQL Global Development Team предоставляет код программного обеспечения Postgres в общее пользование, без гарантий и без ответственности за его поведение и производительность. Однако, за время написания:
Автор этого заявления, доброволец из команды поддержки Postgres с ноября 1996 года, не нашёл каких либо проблем в базовом коде Postgres при переходе на 1 января 2000 года (Y2K).
Автор этого заявления не нашёл во всех отчётах проблемы Y2K в проведёных регрессивных тестах или при использовании других полей в новых или текущих версиях Postgres. Мы ожидаем услышать о проблемах, и если они существуют, то пришли установленную базу и активных участвовавших пользователей на список рассылки поддержки.
Лучше автора, о том какие выводы делает Postgres о датах, указанных двумя цифрами в годе, описано в текущем Руководстве пользователя в главе про типы данных. Для двузначных годов, значимым переходным годом является 1970, а не 2000; т.е. “70-01-01” интерпретируется как “1970-01-01”, тогда как “69-01-01” интерпретируется как “2069-01-01”.
Любая проблема Y2K, лежащая в OS, относительно получения "текущего времени", может превратиться в явную проблему Y2K в Postgres.
Обратись к Проект Gnu и Институт Perl за дальнейшим обсуждением проблемы Y2K, в особенности что касается открытых исходных текстов, бесплатного программного обеспечения.
Предыдущий | Начало | Следующий |
Нотация | В начало главы | Авторские права и торговые марки |