Файл: Коды ошибок Postgresql.docx

Скачать файл
Заказать решение

ВУЗ: Не указан

Категория: Не указан

Дисциплина: Не указана

Добавлен: 17.10.2024

Просмотров: 70

Скачиваний: 0

ВНИМАНИЕ! Если данный файл нарушает Ваши авторские права, то обязательно сообщите нам.

СОДЕРЖАНИЕ

Коды ошибок PostgreSQL.

Поддержка даты и времени.

1. Интерпретация данных даты и времени.

2. Ключевые слова для обозначения даты и времени.

3. Файлы конфигурации даты/времени.

4. История единиц измерения времени.

Ключевые слова SQL.

Соответствие стандарту SQL.

Замечания к выпуску.

 Дополнительно поставляемые модули.

Дополнительно поставляемые программы.

1. Клиентские приложения

2. Серверные приложения.

Внешние проекты.

Репозиторий исходного кода.

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

DocBook

Инструментарий

Сборка документации Завершив все подготовительные действия, перейдите в каталог doc/src/sgml и запустите одну из команд сборки, описанных в следующих подразделах. (Помните, что для сборки нужно использовать GNU make.)HTMLЧтобы собрать HTML-версию документации:doc/src/sgml$ make htmlЭта цель сборки также выбирается по умолчанию. Результат помещается в подкаталог html.Чтобы получить HTML-документацию со стилем оформления, используемым на сайте postgresql.org, вместо простого стандартного стиля, выполните:doc/src/sgml$ make STYLE=website htmlСтраницы man Для преобразования страниц DocBook refentry в формат *roff, подходящий для страниц man, мы используем стили DocBook XSL. Страницы man также распространяются в архиве tar, подобно HTML-версии. Чтобы создать страницы man, выполните:doc/src/sgml$ make manPDFЧтобы получить документацию в формате PDF, используя FOP, выполните одну из следующих команд, в зависимости от предпочитаемого размера бумаги:Для формата A4: doc/src/sgml$ make postgres-A4.pdf Для формата U.S. letter: doc/src/sgml$ make postgres-US.pdf Так как документация PostgreSQL весьма объёмна, процессору FOP для её обработки требуется много памяти. Поэтому в некоторых системах сборка может прерваться ошибкой, связанной с памятью. Обычно это можно исправить, увеличив объём области кучи Java в файле конфигурации /.foprc, например:# Бинарный пакет FOPFOP_OPTS='-Xmx1500m'# DebianJAVA_ARGS='-Xmx1500m'# Red HatADDITIONAL_FLAGS='-Xmx1500m'Некоторый объём памяти является минимально необходимым, а если задать больший объём, возможно даже некоторое ускорение сборки. В системах с очень маленьким объёмом памяти (меньше 1 ГБ) сборка либо будет слишком медленной из-за подкачки, либо вообще не будет осуществляться.Также можно воспользоваться другими процессорами XSL-FO, запуская их вручную, но автоматическая процедура сборки поддерживает только FOP.Простые текстовые файлы Инструкции по установке также распространяются в виде обычного текста, на случай, если они понадобятся в ситуации, когда под рукой не окажется средств просмотра более удобного формата. Файл INSTALL соответствует Главе 16, с небольшими изменениями, внесёнными с учётом другого контекста. Чтобы пересоздать этот файл, перейдите в каталог doc/src/sgml и введите make INSTALL.В прошлом примечания к выпуску и инструкции по регрессионному тестированию также распространялись в виде простых текстовых файлов, но эта практика была прекращена.Проверка синтаксиса Сборка всей документации может занять много времени. Но если нужно проверить только синтаксис файлов документации, это можно сделать всего за несколько секунд:doc/src/sgml$ make checkНаписание документации Форматы SGML и DocBook не страдают от обилия средств их редактирования с открытым исходным кодом. Чаще всего для написания документации используется редактор Emacs/XEmacs в подходящем режиме. В некоторых системах эти редакторы устанавливаются при типичной полной установке.Emacs/PSGMLРежим PSGML — наиболее популярный и мощный режим редактирования документов SGML. При правильной настройке в Emacs он позволяет вставлять теги и проверять корректность разметки. Его также можно использовать для редактирования HTML. Загружаемые файлы, инструкции по установке и подробную документацию вы можете найти на сайте PSGML.Необходимо отметить важный момент относительно PSGML: его автор предполагал, что вашим основным каталогом с DTD SGML будет /usr/local/lib/sgml. Если же у вас это каталог /usr/local/share/sgml, вам нужно дополнительно скорректировать предопределённый путь, либо воспользовавшись переменной окружения SGML_CATALOG_FILES, либо настроив соответственно вашу инсталляцию PSGML (как это сделать, можно узнать из его описания).Поместите следующие строки в файл 

Другие режимы Emacs.

Сокращения.

Недокументированные возможности.

Индексы.

Типы индексов.

Функциональные индексы.

Нетривиальное использование таблиц.

Ограничения полей.

Добавление ограничений в существующую таблицу.

Использование производных таблиц.

Модификация производных таблиц.

Массивы.

Создание полей со значениями-массивами.

Вставка значений в поля-массивы.

Выборка из полей-массивов.

Индексы элементов

Определение количества элементов.

Обновление данных в полях-массивах

Автоматизация стандартных процедур.

Операции с последовательностями.

Удаление последовательности.

Создание триггера.

Получение информации о триггерах.

Транзакции и курсоры

Транзакционные блоки.

Использование курсоров.

Выборка из курсора. Выборка записей из курсора производится командой FETCH. Синтаксис команды FETCH:FETCH [ FORWARD BACKWARD | RELATIVE ][ число ALL | NEXT | PRIOR ]{ IN | FROM } курсорВ этом объявлении курсор – имя курсора, из которого производится выборка записей. Курсор всегда указывает па "текущую" позицию итогового набора выполненной команды, а в выборке могут участвовать записи, находящиеся до или после текущей позиции. Направление выборки определяется ключевыми словами FORWARD и BACKUARD, но умолчанию используется прямая выборка (FORWARD). Ключевое слово RELATIVE не обязательно и поддерживается лишь для совместимости со стандартом SQL92.ВниманиеВ команде также может использоваться ключевое слово ABSOLUTE, но в PostgreSQL 7.1.x возможности абсолютного позиционирования и выборки в курсорах не реализованы. Курсор использует относительное позиционирование и выводит сообщение о том, что абсолютное позиционирование не поддерживается.За ключевым словом, идентифицирующим направление, может указываться следующий аргумент – количество записей. Допускается указание конкретного числа записей (в виде целочисленной константы) или одного из нескольких ключевых слов. Ключевое слово ALL означает, что команда возвращает все записи, начиная с текущей позиции курсора. С ключевым словом NEXT (используется по умолчанию) команда возвращает следующую запись от текущей позиции курсора. С ключевым словом PRIOR возвращается запись, находящаяся перед текущей позицией курсора.Ключевые слова IN и FROM эквивалентны, из них в команде должно присутствовать одно.Перемещение курсора. Курсор поддерживает информацию о текущей позиции в итоговом наборе команды SELECT. Перемещение курсора к заданной записи выполняется командой MOVE. Синтаксис команды MOVE:MOVE [ FORWARD | BACKWARD | RELATIVE ][ число ALL | NEXT | PRIOR ]{ IN | FROM } курсорКак видно из приведенного объявления, синтаксис команды MOVE очень близок к синтаксису команды FETCH. Впрочем, команда MOVE никаких записей не возвращает и лишь перемещает текущую позицию курсора. Смещение задается целочисленной константой или ключевым словом ALL (перемещение в заданном направлении на максимально возможное расстояние), NEXT или PRIOR. Закрытие курсора. Команда CLOSE закрывает ранее открытый курсор. Курсор также автоматически закрывается при выходе из транзакционного блока, в котором он находится, при фиксации транзакции командой COMMIT или ее откате командой ROLLBACK. Синтаксис команды CLOSE (курсор – имя закрываемого курсора):CLOSE курсор.Расширение PostgreSQL. PostgreSQL не ограничивает пользователя встроенными функциями и операторами, позволяя ему создавать собственные расширения. Если вам приходится часто выполнять некоторую стандартную последовательность команд SQL или программных операций, пользовательские функции помогут решить эту задачу более надежно и эффективно. Также в PostgreSQL предусмотрена возможность определения операторов для вызова пользовательских (или встроенных) функций, что делает команды SQL понятнее и эффективнее.Функции и операторы тоже существуют как объекты базы данных и поэтому связываются с конкретной базой. Например, функция, созданная при подключении к базе данных booktown, доступна только для пользователей, также подключившихся к этой базе.Если некоторые общие функции или операторы должны использоваться в разных базах данных, создайте их в базе данных template 1. В этом случае объекты функций и операторов будут автоматически копироваться из шаблона template 1 при создании новой базы данных.В следующих подразделах рассматриваются операции создания, использования и удаления нестандартных функций и операторов.Создание новых функций Разновидность команды SQL99 CREATE FUNCTION, поддерживаемая в PostgreSQL, не обладает прямой совместимостью со стандартом, но зато обеспечивает широкие возможности для расширения PostgreSQL за счет создания пользовательских функций (за информацией о встроенных операторах и функциях обращайтесь к главе 5).Синтаксис команды CREATE FUNCTION:CREATE FUNCTION имя ([ тип_аргумента [….] ])RETURNS тип_возвращаемого_значенияAS 'определение'LANGUAGE 'язык'[ WITH (атрибут [….]) ]Здесь: CREATE FUNCTION имя ([ тпип_аргумента [,…] ]). После ключевых слов CREATE FUNCTION указывается имя создаваемой функции, после чего в круглых скобках перечисляются типы аргументов, разделенные запятыми. Если список в круглых скобках пуст, функция вызывается без аргументов (хотя сами круглые скобки обязательно должны присутствовать как в определении функции, так и при ее использовании). RETURNS тип_возвращаемого_значения. Тип данных, возвращаемый функцией. AS ' определение'. Программное определение функции. В процедурных языках (таких, как PL/pgSQL) оно состоит из кода функции. Для откомпилированных функций С указывается абсолютный системный путь к файлу, содержащему объектный код. LANGUAGE 'язык'. Название языка, на котором написана функция. В аргументе может передаваться имя любого процедурного языка (такого, как plpgsql или plperl, если соответствующая поддержка была установлена при компиляции), С или SQL. [ WITH (атрибут [….]) ]. В PostgreSQL 7.1.x аргумент атрибут может принимать два значения: iscachablen isstrict. iscachable. Оптимизатор может использовать предыдущие вызовы функций для ускоренной обработки будущих вызовов с тем же набором аргументов. Кэширование обычно применяется при работе с функциями, сопряженными с большими затратами ресурсов, но возвращающими один и тот же результат при одинаковых значениях аргументов. isstrict. Функция всегда возвращает NULL в случае, если хотя бы один из ее аргументов равен NULL. При передаче атрибута isstrict результат возвращается сразу, без фактического выполнения функции. ПримечаниеPostgreSQL позволяет перегружать функции, то есть присваивать одно имя нескольким функциям, отличающимся по типу аргументов. Перегрузка позволяет связать с одним именем функции несколько выполняемых операций в зависимости от количества и типа аргументов.Создание функций SQL. Из всех разновидностей функций в PostgreSQL проще всего создаются "чистые" функции SQL, поскольку их создание не требует ни знания других языков, ни серьезного опыта программирования. Функция SQL определяется как обычная команда с позиционными параметрами.Позиционный параметр представляет собой ссылку на один из аргументов, переданных при вызове функции SQL. Он называется позиционным, поскольку в ссылке указывается его позиция в списке переданных аргументов. Позиционный параметр состоит из знака $, за которым следует номер (нумерация начинается с 1). Например, $1 означает первый аргумент в переданном списке.Сообщение CREATE означает, что создание функции прошло успешно. Созданная функция доступна для всех пользователей, обладающих соответствующими правами. Создание функций на языке С. СУБД PostgreSQL, написанная на языке С, может динамически подгружать откомпилированный код С без перекомпиляции пакета. Использование команды CREATE FUNCTION для компоновки с функциями С разрешено только суперпользователям, поскольку эти функции могут содержать системные вызовы, представляющие потенциальную угрозу для безопасности системы.Документирование всего интерфейса API системы PostgreSQL выходит за рамки книги. Впрочем, опытный программист сможет очень легко написать, откомпилировать и скомпоновать простейшие функции С с использованием загружаемых общих модулей.У компилятора gcc (GNU С Compiler) имеется ключ – shared, предназначенный для создания динамически загружаемых модулей. В простейшем случае загружаемый модуль создается командой следующего вида:$ gcc – shared input.с – о output.soЗдесь input.с – имя файла, содержащего компилируемый код С, a output.so – файл общего загружаемого модуля.ВниманиеВ этот простейший пример не были включены заголовочные файлы PostgreSQL. В данном случае они не нужны из-за очевидного соответствия между типами данных С и SQL. Более реальные примеры с использованием внутреннего интерфейса API PostgreSQL и структур данных находятся во вложенном каталоге contrib исходного каталога PostgreSQL.По умолчанию PostgreSQL ищет в общем модуле функцию с тем же именем, с которым она создается в PostgreSQL. Такой способ подходит для функции is_zero(integer), имя которой соответствует откомпилированному символическому имени функции is_zero(int) в файле is_zero.so. Для предотвращения конфликтов имен вторая функция в общем объектном модуле определяется с сигнатурой is_zero_two(int.int). Чтобы ассоциировать ее с перегруженной функцией PostgreSQL, получающей два аргумента вместо одного, имя функции С в виде строковой константы передастся после пути к файлу общего модуля.Имя указывается без круглых скобок и без перечисления аргументов, а от пути к файлу оно отделяется запятой.Уничтожение функций. Функции уничтожаются владельцем или суперпользователем при помощи команды SQL DROP FUNCTION. Синтаксис команды DROP FUNCTION:DELETE FUNCTION имя ([ тип_аргумента [….] ]):Сообщение сервера DROP означает, что функция была успешно удалена. Команда DROP FUNCTION, как и большинство команд DROP, необратима, поэтому перед ее выполнением убедитесь в том, что функцию действительно требуется удалить.Создание новых операторов. Кроме пользовательских функций PoslgreSQL позволяет создавать пользовательские операторы. С технической точки зрения операторы всего лишь обеспечивают альтернативный синтаксис для вызова функций. Например, оператор сложения (+) в действительности вызывает одну из встроенных функций (numeri c_add() и т. д.). Пример:booktown=# SELECT I + 2 AS by_operator .numeric_add(l,2) AS by_function;by_operator [ by_function3 | 3(1 row)Определение оператора сообщает, к какому типу данных относятся левый и правый операнды. Кроме того, в определении указывается функция, которой при вызове в качестве аргументов передаются операнды.Создание оператора. Новые операторы создаются командой SQL CREATE OPERATOR. Синтаксис команды CREATE OPERATOR:CREATE OPERATOR оператор (PROCEDURE = функция[. LEFTARG = тип1 ][. RIGHTARG = тип2 ][. COMMUTATOR = коммутатор ][. NEGATOR = инвертор ][. RESTRICT = функция ограничения ][. JOIN = функция_обьединения ][. HASHES ][. SORT1 = левдя_сортировкд ][. SORT2 = правая_сортировка ])В этом определении оператор – символ нового оператора, а функция – имя функции, вызываемой этим оператором. Остальные секции не обязательны, хотя в определении должна присутствовать хотя бы одна из секций LEFTARG или RIGHTARG. Оператор может состоять из следующих символов:*-*/<>=

Перегрузка операторов

Удаление оператора



pg_isready — проверить соединение с сервером PostgreSQL

pg_receivewal — получает журналы предзаписи с сервера PostgreSQL

pg_recvlogical — управление потоками логического декодирования PostgreSQL

pg_restore — восстановить базу данных PostgreSQL из файла архива, созданного командой pg_dump

psql — интерактивный терминал PostgreSQL

reindexdb — переиндексировать базу данных PostgreSQL

vacuumdb — выполнить очистку и анализ базы данных PostgreSQL

2. Серверные приложения.


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

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

pg_standby — поддерживает создание сервера тёплого резерва PostgreSQL

initdb — создать кластер баз данных PostgreSQL

pg_archivecleanup — вычистить файлы архивов WAL PostgreSQL

pg_controldata — вывести управляющую информацию кластера баз данных PostgreSQL

pg_ctl — инициализировать, запустить, остановить или управлять сервером PostgreSQL

pg_resetwal — очистка журнала предзаписи и другой управляющей информации кластера PostgreSQL

pg_rewind — синхронизировать каталог данных PostgreSQL с другим каталогом, ответвлённым от него

pg_test_fsync — подобрать наилучший вариант wal_sync_method для PostgreSQL

pg_test_timing — определить издержки замера времени

pg_upgrade — обновить экземпляр сервера PostgreSQL

pg_waldump — вывести журнал предзаписи кластера БД PostgreSQL в понятном человеку виде

postgres — Сервер баз данных PostgreSQL

postmaster — Сервер баз данных PostgreSQL

Внешние проекты.


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

В базовый дистрибутив PostgreSQL включены только два клиентских интерфейса:

libpq включён, потому что это основной интерфейс языка C и многие другие клиентские интерфейсы построены на основе него.


ECPG включён, потому что он зависит от грамматики языка SQL на стороне сервера, и таким образом, очень чувствителен к изменениям в самом PostgreSQL.

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

Для PostgreSQL выпускаются различные инструменты администрирования. Наиболее популярен из них pgAdmin III, но есть и ряд других, в том числе коммерческих решений.

Базовый дистрибутив PostgreSQL включает несколько процедурных языков: PL/pgSQL, PL/Tcl, PL/Perl и PL/Python.

Кроме того, вне основного дистрибутива PostgreSQL разрабатываются и поддерживаются несколько процедурных языков

PostgreSQL проектируется так, чтобы его можно было легко расширять. Как результат, расширения, загружаемые в базу данных, могут функционировать в точности так же, как и встроенные функции. Каталог contrib/, включённый в дерево исходного кода, содержит несколько расширений, описанных в ДПМ. Другие расширения разрабатываются независимо, как например, PostGIS. PostgreSQL позволяет разрабатывать независимо даже решения по репликации. Например, Slony-I — популярное средство репликации по схеме главный/резервный, разрабатываемое отдельно от основного проекта.

Репозиторий исходного кода.


Исходный код PostgreSQL хранится и управляется системой управления версиями Git. В Интернете доступно открытое зеркало главного репозитория, которое обновляется в течение минуты после изменения в главном репозитории.

Заметьте, что для сборки PostgreSQL из репозитория исходного кода требуются достаточно современные версии программ bison, flex и Perl. Эти программы не требуются для сборки из дистрибутивного архива, так как в этот архив уже включены файлы, создаваемые указанными программами.

Получение исходного кода из Git

С Git вы получаете на своём компьютере копию всего репозитория кода, так что вы будете иметь автономный доступ ко всем ветвям и истории разработки. Это позволяет максимально быстро и гибко разрабатывать или тестировать правки кода.

Git

Вам потребуется установленная версия Git (её можно получить, обратившись к сайту https://git-scm.com). Во многих системах последняя версия Git устанавливается по умолчанию, либо имеется в системе распространения пакетов.

Чтобы начать работу с репозиторием Git, сделайте копию официального зеркала:

git clone https://git.postgresql.org/git/postgresql.git

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

К зеркалу Git также можно обратиться по протоколу Git. Просто смените префикс в адресе на git:

git clone git://git.postgresql.org/git/postgresql.git

Когда вы захотите получить последние обновления, перейдите в каталог репозитория (выполнив cd) и запустите:

git fetch

Git может гораздо больше, нежели просто получить исходный код. За дополнительными сведениями обратитесь к страницам руководства man Git или к сайту https://git-scm.com.

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


Документация PostgreSQL публикуется в четырёх основных форматах:

  1. Простой текст, для информации перед установкой

  2. HTML, для справки, поиска и просмотра в Интернете

  3. PDF, для печати

  4. Страницы руководства man, для быстрой справки.

Кроме того, в дереве исходного кода PostgreSQL можно найти несколько простых текстовых файлов README, освещающих различные вопросы реализации.

Документация в HTML и страницы man входят в состав стандартного дистрибутива и устанавливаются по умолчанию. Документацию в формате PDF можно загрузить отдельно.

DocBook


Исходный материал документации пишется на языке разметки DocBook, который отдалённо напоминает HTML. Оба эти языка являются приложениями SGML (Standard Generalized Markup Language, Стандартного обобщённого языка разметки), который по сути является языком описания других языков. В следующем описании используется как термин DocBook, так и SGML, но технически они не взаимозаменяемы.

Документация PostgreSQL в настоящее время переводится с формата DocBook SGML со стилями DSSSL в формат DocBook XML со стилями XSLT. Убедитесь, что вы читаете инструкции к той версии PostgreSQL, с которой имеете дело, так как процедуры и набор инструментов будут меняться.

Формат DocBook позволяет авторам определять структуру и содержимое технического документа, не заботясь о деталях представления. Как это содержимое будет представлено в различных конечных формах, определяет стиль документа. DocBook поддерживается группой OASIS. На официальном сайте DocBook имеется хорошая вводная и справочная документация, а также полная книга издательства О'Рейли для чтения в электронном виде. Новичкам будет очень полезно руководство NewbieDoc Docbook Guide. Кроме того, в Проекте документации FreeBSD (FreeBSD Documentation Project) так же применяется формат DocBook и даются полезные сведения, включая ряд замечаний по стилю, которые стоит принять во внимание.

Инструментарий


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

DTD для DocBook

Это полное определение самого формата DocBook. В настоящее время мы применяем версию 4.2; более ранняя или более поздняя версия не подойдёт. Использовать нужно вариации SGML и XML формата DocBook этой же версии. Обычно они распространяются в отдельных пакетах.

Сущности символов ISO 8879

Они требуются форматом DocBook SGML, но распространяются отдельно, так как поддерживаются комитетом ISO.


Таблицы стилей DocBook XSL

Они содержат инструкции обработки для преобразования исходных материалов DocBook в другие форматы, например, в HTML.

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

OpenSP

Это базовый пакет для обработки SGML. Заметьте, что мы более не нуждаемся в OpenJade, процессоре DSSSL, а пакет OpenSP используем только для преобразования SGML в XML.

Libxml2 для xmllint

Эта библиотека и включённая в неё утилита xmllint применяются для обработки XML. У многих разработчиков библиотека Libxml2 уже установлена, потому что она также используются при сборке кода PostgreSQL. Заметьте, однако, что xmllint может потребоваться установить из отдельного пакета.

Libxslt для xsltproc

xsltproc — процессор XSLT, то есть программа, преобразующая XML в другие форматы с применением таблиц стилей XSLT.

FOP

Это программа для преобразования, в том числе и XML в PDF.

Вы можете обойтись без локальной установки файлов DocBook XML и таблиц стилей DocBook XSLT, так как необходимые файлы будут загружены из Интернета и помещены в локальный кеш. Этот вариант на самом деле может быть предпочтительным, если в пакетах вашей операционной системы предоставляются только старые версии файлов (особенно стилей) или если таких пакетов нет вовсе. Дополнительную информацию вы можете получить, ознакомившись с параметром --nonet программ xmllint и xsltproc.

Смотрите также файлы