LXF89:PostgreSQL - История изменений

Lockal: восстановление кавычек в коде AWB

Lockal — Sun, 27 Apr 2008 14:07:52 GMT

восстановление кавычек в коде AWB

← Предыдущая		Версия 14:07, 27 апреля 2008
Строка 28:		Строка 28:

	<source lang="c">		<source lang="c">
-	#include ~~“libpq~~-fe.h”	+	#include "libpq-fe.h"
	</source>		</source>

Строка 35:		Строка 35:
	<source lang="bash">		<source lang="bash">
	> #сборка программы		> #сборка программы
-	> gcc -o ~~“бинарник” “исходник”~~.c -I`pg_config --includedir` \	+	> gcc -o "бинарник" "исходник".c -I'pg_config --includedir' \
-	-lpq `/usr/bin/libpq3-config`	+	-lpq '/usr/bin/libpq3-config'
	> cat /usr/bin/libpq3-config		> cat /usr/bin/libpq3-config
	#!/bin/bash		#!/bin/bash
Строка 62:		Строка 62:

	<source lang="c">		<source lang="c">
-	const char *conninfo= ~~“dbname~~ = test host=~~localhost”~~;	+	const char *conninfo= "dbname = test host=localhost";
	PGconn *conn=PQconnectdb(conninfo);		PGconn *conn=PQconnectdb(conninfo);
	if (PQstatus(conn) != CONNECTION_OK) {		if (PQstatus(conn) != CONNECTION_OK) {
-	fprintf(stderr, ~~“Не~~ удалось соединиться с базой данных: %s”,	+	fprintf(stderr, "Не удалось соединиться с базой данных: %s",
	PQerrorMessage(conn));		PQerrorMessage(conn));
	/завершаем работу/ …}		/завершаем работу/ …}
	</source>		</source>

-	Параметры передаются в форме '''«ключевое слово»=«значение»'''. Пары разделяются обычным пробелом. Пробелы вокруг знака равенства можно опустить. Если необходимо передать значение с пробелами, то его необходимо заключить в одинарные кавычки '''~~‘«составное» «значение»’~~'''. Для передачи одинарной кавычки ее необходимо экранировать с помощью обратной косой черты '''\’'''. При отсутствии какого-либо параметра в строке '''conninfo''' его значение берется из соответствующей переменной окружения, если таковая определена. Если нет, то при открытии соединения используется значение по умолчанию.	+	Параметры передаются в форме '''«ключевое слово»=«значение»'''. Пары разделяются обычным пробелом. Пробелы вокруг знака равенства можно опустить. Если необходимо передать значение с пробелами, то его необходимо заключить в одинарные кавычки ''''«составное» «значение»''''. Для передачи одинарной кавычки ее необходимо экранировать с помощью обратной косой черты '''\''''. При отсутствии какого-либо параметра в строке '''conninfo''' его значение берется из соответствующей переменной окружения, если таковая определена. Если нет, то при открытии соединения используется значение по умолчанию.

	Функции открытия соединения распознают следующие параметры и переменные окружения (кое-какие особенности опущены):		Функции открытия соединения распознают следующие параметры и переменные окружения (кое-какие особенности опущены):
Строка 132:		Строка 132:
	Рабочей частью пакета является исполняемый файл '''bondfrontend''', который осуществляет связь с базой данных и может «прикинуться» любой формой. Описание формы хранится в обычном XML-файле. Используемый диалект XML подробно описан в документации.		Рабочей частью пакета является исполняемый файл '''bondfrontend''', который осуществляет связь с базой данных и может «прикинуться» любой формой. Описание формы хранится в обычном XML-файле. Используемый диалект XML подробно описан в документации.

-	[[Изображение:~~Img_89_87_1~~.jpg\|thumb\|center\|300px\|Формочки, XML (правда на заднем фоне и без подсветки) и связь с базой данных — это ''bond''.]]	+	[[Изображение:Img 89 87 1.jpg\|thumb\|center\|300px\|Формочки, XML (правда на заднем фоне и без подсветки) и связь с базой данных — это ''bond''.]]

	История пакета насчитывает уже пять лет. Программа доступна по дуальной лицензии: GPL – для использования со свободным ПО и коммерческой – для использования в проприетарном. Существует версия и для Windows.		История пакета насчитывает уже пять лет. Программа доступна по дуальной лицензии: GPL – для использования со свободным ПО и коммерческой – для использования в проприетарном. Существует версия и для Windows.
Строка 197:		Строка 197:

	===== Асинхронные сигналы =====		===== Асинхронные сигналы =====
-	Стандартный ''SQL'' не предполагает взаимодействия разных пользователей, кроме как через изменение данных в таблицах. ''PostgreSQL'' позволяет посылать асинхронные сигналы с помощью команд '''LISTEN''' и '''NOTIFY'''. '''LISTEN ~~“имя сигнала”~~''' передается серверу как обычная ''SQL''- команда. Если статус запроса становится равным '''PGRES_COMMAND_OK''', то это означает, что ранее был выполнен запрос '''NOTIFY ~~“имя сигнала”~~'''. Если же инициализация сигнала ('''NOTIFY''') ожидается позже регистрации ('''LISTEN'''), то функция '''PQnotifies''' позволяет вновь проверить наличие сигнала после любого запроса.	+	Стандартный ''SQL'' не предполагает взаимодействия разных пользователей, кроме как через изменение данных в таблицах. ''PostgreSQL'' позволяет посылать асинхронные сигналы с помощью команд '''LISTEN''' и '''NOTIFY'''. '''LISTEN "имя сигнала"''' передается серверу как обычная ''SQL''- команда. Если статус запроса становится равным '''PGRES_COMMAND_OK''', то это означает, что ранее был выполнен запрос '''NOTIFY "имя сигнала"'''. Если же инициализация сигнала ('''NOTIFY''') ожидается позже регистрации ('''LISTEN'''), то функция '''PQnotifies''' позволяет вновь проверить наличие сигнала после любого запроса.

	===== Сборка «мусора» =====		===== Сборка «мусора» =====
Строка 232:		Строка 232:
	EXEC SQL whenever sqlerror do ExitForError();		EXEC SQL whenever sqlerror do ExitForError();
	void ExitForError() {		void ExitForError() {
-	fprintf(stderr,~~”Все~~, конец - это фатально.\n”);	+	fprintf(stderr,"Все, конец - это фатально.\n");
	sqlprint();		sqlprint();
	exit(1);		exit(1);
Строка 242:		Строка 242:
	// инструкциях ECPG		// инструкциях ECPG
	EXEC SQL BEGIN DECLARE SECTION;		EXEC SQL BEGIN DECLARE SECTION;
-	const char *dbname = ~~“test”~~;	+	const char *dbname = "test";
-	const char *user = ~~“baldin”~~;	+	const char *user = "baldin";
	VARCHAR FIO[128];		VARCHAR FIO[128];
	VARCHAR NUMBER[128];		VARCHAR NUMBER[128];
Строка 258:		Строка 258:
	EXEC SQL FETCH NEXT FROM mycursor INTO :FIO,:NUMBER;		EXEC SQL FETCH NEXT FROM mycursor INTO :FIO,:NUMBER;
	while (sqlca.sqlcode == 0) { // не 0, если данные больше нет		while (sqlca.sqlcode == 0) { // не 0, если данные больше нет
-	printf(~~“ФИО~~: %s номер: %s\n”,FIO.arr,NUMBER.arr);	+	printf("ФИО: %s номер: %s\n",FIO.arr,NUMBER.arr);
	EXEC SQL FETCH NEXT FROM mycursor INTO :FIO, :NUMBER;		EXEC SQL FETCH NEXT FROM mycursor INTO :FIO, :NUMBER;
	}		}
Строка 287:		Строка 287:
	\| valign="top" \|		\| valign="top" \|
	{{Врезка\|Заголовок=PostgreSQL в лицах: Сергей Копосов\|Содержание=		{{Врезка\|Заголовок=PostgreSQL в лицах: Сергей Копосов\|Содержание=
-	[[Изображение:~~Img_89_89_1~~.jpg\|thumb\|left\|100px]]	+	[[Изображение:Img 89 89 1.jpg\|thumb\|left\|100px]]
	'''Визитка LXF:'''<br>Дипломированный физик. Профессиональный астроном. Участник программы Google Summer of Code 2006. Домашняя страница: http://lnfm1.sai.msu.ru/~math/.<br><br><br><br><br>		'''Визитка LXF:'''<br>Дипломированный физик. Профессиональный астроном. Участник программы Google Summer of Code 2006. Домашняя страница: http://lnfm1.sai.msu.ru/~math/.<br><br><br><br><br>

Yaleks: шаблон

Yaleks — Thu, 20 Mar 2008 07:51:05 GMT

шаблон

← Предыдущая		Версия 07:51, 20 марта 2008
Строка 1:		Строка 1:
		+	{{Цикл/PostgreSQL}}
	'''История PostgreSQL''' Изучаем самый мощный из открытых серверов баз данных		'''История PostgreSQL''' Изучаем самый мощный из открытых серверов баз данных

Interlace в 14:07, 18 марта 2008

Interlace — Tue, 18 Mar 2008 14:07:21 GMT

(Различия между версиями)

PonElA: /* Открытие и закрытие соединения */

PonElA — Wed, 12 Mar 2008 12:40:12 GMT

Открытие и закрытие соединения

← Предыдущая		Версия 12:40, 12 марта 2008
Строка 73:		Строка 73:
	Для того чтобы разорвать соединение используется функция:		Для того чтобы разорвать соединение используется функция:
	void P Q f i n i s h ( PGconn ∗ conn ) ;		void P Q f i n i s h ( PGconn ∗ conn ) ;
-	{{ВНИМАНИЕ\| Всегда следует закрывать соединения, когда в них отпадает нужда.}}	+
		+	ВНИМАНИЕ! Всегда следует закрывать соединения, когда в них отпадает нужда.
		+
	Число соединений которые поддерживает POSTMASTER ограничено очень легко парализовать работу базы данных только открывая новые соединения.		Число соединений которые поддерживает POSTMASTER ограничено очень легко парализовать работу базы данных только открывая новые соединения.

PonElA: Новая: '''PostgreSQL. ЧАСТЬ 4: Интерфейсы''' :В институте им очень дорожили, так как :попутно он использовался для нек...

PonElA — Wed, 12 Mar 2008 12:39:02 GMT

Новая: '''PostgreSQL. ЧАСТЬ 4: Интерфейсы''' :В институте им очень дорожили, так как :попутно он использовался для нек...

Новая статья

'''PostgreSQL. ЧАСТЬ 4: Интерфейсы'''

:В институте им очень дорожили, так как
:попутно он использовался для некоторых
:уникальных экспериментов и как переводчик
:при общении со Змеем Горынычем.
::АБС о Кощее Бессмертном

==libpq==
Чтобы общаться с базой данных много функций не надо: одна функция для открытия соединения, одна для посылки запроса, одна для получения ответа и одна для закрытия соединения. В реальности всё немного сложнее, но суть остаётся.

К вопросу о переносимости Библиотека libpq написана на чистом C, поэтому практически везде, где есть gcc, можно организовать связь с PostgreSQL. Мне както пришлось это делать для VAX/VMS всё решилось методом тыка, даже думать почти не потребовалось. Все данные текст, поэтому вопрос бинарной совместимости платформ попросту отсутствует.

С чего начать Для того чтобы воспользоваться вызовами libpq, необходимо для начала установить её. В Debian (Etch) для этого надо установить пакет postgresql-dev:
> sudo apt−g e t i n s t a l l p o s t g r e s q l −dev
Для доступа к функциям libpq необходимо включить в исходник include-файл:
#include "libpq−f e . h"

Скрипт pg_conﬁg (man pg_conﬁg) позволяет получить информацию куда помещаются include-файлы, библиотеки и тому подобное:
> #сборка программы
> g cc −o "бинарник" "исходник" . c −I ‘ pg _ co nf i g −−i n c l u d e d i r ‘ \
−l p q ‘ pg _ co nf i g −−l i b s ‘

===Открытие и закрытие соединения===

Даже открывать соединение с PostgreSQL можно двумя способами:
// открыть соединение
PGconn ∗ PQconnectdb ( const char ∗ c o n n i n f o ) ;
// то же , но не блокируя программу
PGconn ∗ PQconnectStart ( const char ∗ c o n n i n f o ) ;
// проверка ст а т уса соединения ( после PQconnectStart )
P o s t g r e s P o l l i n g S t a t u s T y p e PQconnectPoll ( PGconn ∗ conn ) ;
PQconnectdb обычная функция, где на вход подаём текстовую строку conninfo с параметрами для соединения с сервером, а на выходе получаем структуру типа PGconn с информацией о сделанном соединении и на сколько операция по соединению прошла удачно. В дальнейшем при передача данных эта переменная будет использоваться в качестве параметра.

Передача информации о серевере в качестве строки (conninfo) позволяет в случае появления дополнительных параметров не менять внешний интерфейс вызова и легко добавлять дополнительные опции. Пример открытия соединения:
const char ∗ c o n n i n f o= "dbname = t est host=lo c alho st " ;
PGconn ∗ conn=PQconnectdb ( c o n n i n f o ) ;
i f ( PQstatus ( conn ) != CONNECTION_OK) {
f p r i n t f ( s t d e r r , "Не удалось соединиться с базой данных: %s" ,
PQerrorMessage ( conn ) ) ;
/∗ завершаем работу ∗/ . . . }
Параметры передаются в форме ключевое слово = значение. Пары разделяются обычным пробелом. Пробелы вокруг знака равенства можно опустить. Если необходимо передать значение с пробелами, то его необходимо заключить в одинарные кавычки ’ составное значение ’. Для передачи одинарной кавычки её необходимо экранировать с помощью обратной косой черты \’. При отсутствии какого-либо параметра в строке conninfo его значение берётся из соответствующей переменной окружения, если такая определена. Если нет, то при открытии соединения используется значение по умолчанию.

Функции открытия соединения распознают следующие параметры и переменные окружения (кое-какие особенности опущены):
* '''host TCP/IP''' имя узла на котором находится сервер PostgreSQL. Соответствует переменной окружения PGHOST. Значение по умолчанию localhost.
* '''hostaddr''' Числовой адрес узла на котором находится PostgreSQL (альтернатива host). Соответствует переменной окружения PGHOSTADDR. Значение по умолчанию эквивалентно localhost.
* '''port''' Номер порта, который слушает POSTMASTER. Соответствует переменной окружения PGPORT. Значение по умолчанию обычно 5432.
* '''dbname''' Имя базы данных. Соответствует переменной окружения PGDATABASE. Значение по умолчанию совпадает с системной учётной записью пользователя.
* '''user''' Имя пользователя базы данных. Соответствует переменной окружения PGUSER. Значение по умолчанию совпадает с системной учётной записью пользователя.
* '''password''' Поле пароля, если для аутентификации требуется пароль. Соответствует переменной окружения PGPASSWORD. Если аутентификация требуется, а поле неопределенно, то для доступа используется информация в файле ~/.pgpass. Переменная окружения PGPASSFILE может указать другой файл для проведения аутентификации.
* '''connect_timeout''' Устанавливает максимальное время ожидания соединения в секундах. С сервером и сетью всякое может случиться. Соответствует переменной окружения PGCONNECT_TIMEOUT. Значение по умолчанию равно 0, что означает что время ожидания равно бесконечности. Не рекомендуется устанавливать значение на ожидание меньше 2 секунд.
* '''options''' Опции, посылаемые непосредственно серверу, коли такое потребуется. Соответствует переменной окружения PGOPTIONS.
* '''sslmode''' Определяет порядок действий при SSL-соединении. Принимает четыре возможных значения:
** '''disable''' без шифрации,
** '''allow''' сначала попробовать соединиться без шифрации, а в случае неудачи постараться установить защищённое соединение,
** '''prefer''' сначала попробовать установить защищённое соединения, а в случае неудачи повторить соединение без шифрации,
** '''require''' выполнять только защищённое соединение.

Соответствует переменной окружения PGSSLMODE. Значение по умолчанию prefer.
* '''krbsrvname''' Имя Kerberos-сервиса. используется для аутентификации с помощью Kerberos-5<ref>
Kerberos промышленный стандарт для аутентификации и взаимодействия в условиях незащищённого окружения. Алгоритмы Kerberos основаны на шифровании с использованием симметричного криптографического ключа и требует наличие доверенного агента.
</ref>. Это совершенно отдельная тема для беседы. Соответствует переменной окружения PGKRBSRVNAME.

PGDATESTYLE Переменная окружения, позволяющая установить представление времени и даты по умолчанию. Соответствует SQL-команде SET datestyle TO. . .
PGTZ Переменная окружения, позволяющая установить текущий часовой пояс. Соответствует SQL-команде SET timezone TO. . .
PGCLIENTENCODING Переменная окружения, позволяющая установить кодировку клиента. Соответствует SQL-команде SET client_encoding TO. . .

Существует целый класс функций, которые позволяют получить информацию о соединении. Для подробностей следует обратиться к документации. Для начала полезно знать о двух из них:
ConnStatusType PQstatus ( const PGconn ∗ conn ) ;
char ∗ PQerrorMessage ( const PGconn ∗ conn ) ;
PQstatus возвращает информацию о том, как прошло соединение. Интересны состояния CONNECTION_OK всё хорошо и CONNECTION_BAD ничего не вышло. Функция PQerrorMessage позволяет получить текстовую строку с описанием последней возникшей проблемы.

Для того чтобы разорвать соединение используется функция:
void P Q f i n i s h ( PGconn ∗ conn ) ;
{{ВНИМАНИЕ| Всегда следует закрывать соединения, когда в них отпадает нужда.}}
Число соединений которые поддерживает POSTMASTER ограничено очень легко парализовать работу базы данных только открывая новые соединения.

===SQL запросы===
Что ж, до сервера уже дозвонились , теперь пора с ним поговорить.

'''Посылка запросов''' Простейший способ выполнить SQL-запрос, это воспользоваться функцией PQexec:
PG r esul t ∗PQexec ( PGconn ∗ conn , const char ∗command ) ;
В качестве параметров передаётся структура соединения conn и строка с SQL-командой command. Возвращается указатель на структуру типа PGresult, где сохраняется информация полученная от СУБД в ответ на запрос. При желании можно в одном запросе отсылать сразу несколько SQL-команд, разделённых точкой с запятой ; , но в этом случае информация сохранённая в структуре PGresult будет относиться только к последнему запросу.

По умолчанию каждый PQexec считается за отдельную транзакцию, если явно не начать транзакцию с помощью команды BEGIN, которая будет продолжаться либо до COMMIT, либо до ROLLBACK.

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

В некоторых случаях для увеличения скорости выполнения часто встречающихся запросов полезно обратить внимание на парочку PQprepare и PQexecPrepared. Эти команды эквивалентны своим SQL-аналогам PREPARE и EXECUTE. Идея оптимизации состоит в том, что прежде чем выполнить запрос, PostgreSQL сначала анализирует его, затем планирует порядок действий и только потом, собственно, выполняет запрос. Первые два этапа для похожих запросов с разными условиями отбора можно выполнить заранее с помощью команды PREPARE. Затем, с помощью команды EXECUTE, можно выполнять подобные уже подготовленные (prepared)
запросы.

Все упомянутые выше команды работают с сервером БД синхронным образом, то есть посылают запрос и ждут ответа. Клиентское приложение на это время засыпает (suspended). В libpq предусмотрен целый класс функций предназначенный для асинхронных операций, не блокирующих клиентское приложение. Их применение усложняет код и логику программы, хотя всё в пределах допустимого. С моей точки зрения лучше организовать всё так, чтобы время использованное на ожидание результатов запроса фатально не влияло на внешние процессы и обеспечить бесперебойную работу сети и сервера базы данных.

'''Информация о состоянии запроса''' После выполнения запроса всегда интересно узнать каково его состояние:
ExecStatusType P Q r e s u l t S t a t u s ( const PG r esul t ∗ r e s ) ;
На вход подаётся структура PGresult, создаваемая в результате работы PQexec подобных функций, а на выходе получаем информацию о состоянии в виде числа, значение которого можно сравнить со следующими константами:
PGRES_COMMAND_OK всё прошло хорошо (для запросов, которые не возвращают данные, например, INSERT),
PGRES_TUPLES_OK всё прошло хорошо, плюс получены данные в ответ на запрос (для запросов типа SELECT или SHOW),
PGRES_EMPTY_QUERY строка запроса была почему-то пустой,
PGRES_COPY_OUT идёт передача данных от сервера,
PGRES_COPY_IN идёт передача данных на сервер,
PGRES_BAD_RESPONSE ошибка, ответ сервера не разборчив,
PGRES_NONFATAL_ERROR ошибка, не смертельно: предупреждение (notice) или информация к сведению (warning),
PGRES_FATAL_ERROR при выполнении запроса произошла серьёзная ошибка.

Для получения более подробной информации об ошибке следует воспользоваться функцией
char ∗ PQ r esul t Er r o r Messa g e ( const PG r esul t ∗ r e s ) ;
При вызове этой функции в качестве результата будет сформирована строка с информацией об ошибке или пустая строка если всё прошло хорошо.

'''Получение данных''' При получении данных предполагается, что статус запроса соответствует PGRES_TUPLES_OK. Теперь, если примерно известно что хочется получить в результате запроса, то для получения данных достаточно четырёх функций:
int PQntuples ( const PG r esul t ∗ r e s ) ;
int P Q n f i e l d s ( const PG r esul t ∗ r e s ) ;
char ∗ PQgetvalue ( const PG r esul t ∗ r e s ,
int row_number , int column_number ) ;
int P Q g e t i s n u l l ( const PG r esul t ∗ r e s ,
int row_number , int column_number ) ;
Первые две функции являются информационными и позволяют узнать сколько в результате запроса получено строк (PQntuples) и сколько колонок в каждой такой строке (PQnﬁelds). Возьмите на заметку, что 0 строк это тоже хороший результат.

Функция PQgetvalue позволяет получить доступ к полученным данным. В качестве параметров кроме структуры соединения (res) передаётся номер строки (column_number) и номер колонки (column_number). Все данные возвращаются так же в виде текстовой строки, как и посылаются, то есть, эти данные необходимо перевести в привычный формат. Например, в случае целых чисел можно восполь-
зоваться функцией atoi.

Следует помнить, что данные SQL могут иметь неопределённое значение (NULL). Если подобная возможность существует, то перед получением значения проверить, а определено ли оно. PQgetisnull позволяет разобраться с этой проблемой. По передаваемым параметрам эта функция эквивалентна PQgetvalue, а в качестве результата возвращает 1, если значение не определено и 0, если опеределено.

Кроме упомянутых существует целый ряд функций, позволяющих получить информацию о полученных данных, как то: имя колонки (PQfname), размер передаваемых данных в байтах (PQgetlength) и тому подобное. Для экранирования специальных символов при операции с бинарными или текстовыми данными есть набор сервисных функций PQescape∗.

'''COPY''' SQL команда COPY является расширением специфичным для PostgreSQL.

Основное преимущество SQL всё есть понятный текст, в некоторых случаях, когда надо передавать большие объёмы данных, оборачивается недостатком.
Функции PQputCopyData и PQgetCopyData позволяют под час значительно ускорить передачу данных между сервером и клиентом.

'''Асинхронные сигналы''' Стандартный SQL не предполагает взаимодействия разных пользователей, кроме как через изменение данных в таблицах. PostgreSQL позволяет посылать асинхронные сигналы с помощью команд LISTEN и NOTIFY. LISTEN "имя сигнала" передаётся серверу как обычная SQL-команда. Если статус запроса становится равным PGRES_COMMAND_OK, то это означает, что ранее был выполнен запрос NOTIFY "имя сигнала". Если же инициализация сигнала (NOTIFY) ожидается позже регистрации (LISTEN), то функция PQnotiﬁes позволяет после любого запроса проверить наличие сигнала вновь.

'''Сборка мусора''' Мусор убирать придётся руками. Каждая функция типа PQexec создаёт объект типа PGresult. После того как вся необходимая информация о результатах запроса получена, следует освободить память, занимаемую этим объектом с помощью команды:
void PQclear ( PG r esul t ∗ r e s ) ;
Если утечки памяти Вас не волнуют, то можно этого и не делать. В этом случае следует побеспокоиться о том: Почему Вас не беспокоят утечки памяти?

===Большие объекты===
Ещё один способ сохранять неструктурированные данные в PostgreSQL это пихать их как большие объекты (Large Objects). PostgreSQL предоставляет интерфейс схожим с файловым интерфейсом Unix: open (lo_open), read (lo_read), write (lo_write), lseek (lo_lseek) и так далее. Все lo_∗ команды работают со значениями полученными из колонки с типом oid. oid это специальный тип данных, который является ссылкой на объект произвольного типа. То есть последовательность работы с большим объектом следующая: создаётся большой объект (lo_create). Далее возвращаемый lo_create указатель Oid используется для записи данных в большой объект (lo_import/lo_write), а затем этот указатель вставляется в таблицу с помощью стандартных SQL операторов. Чтение происходит в обратном порядке (lo_export/lo_read). Все операции с большими объектами должны происходить внутри транзакции.

'''P.S.''' Необходимость интерфейса больших объектов на текущий момент не так уж и очевидна. Стандартными средствами в PostgreSQL можно сохранять бинарные данные размером вплоть до 1 Гб, что вполне может соперничать с максимальным размером для большого объекта в 2 Гб.

==ECPG==
Чтобы не отставать от коммерческих баз данных PostgreSQL имеет свой собственный вариант встроенного SQL . Эта технология позволяет смешивать обычный язык C с SQL-структурами, примерно следующим образом:

// файл test.pgc
#include <stdio.h>
#include <stdlib.h>
// структура для обработки ошибок
EXEC SQL i n c l u d e s q l c a ;
// реакция в случае ошибки/ предупреждения
EXEC SQL whenever s q l w a r n i n g s q l p r i n t ;
EXEC SQL whenever s q l e r r o r do E x i t F o r E r r o r ( ) ;
void E x i t F o r E r r o r ( ) {
f p r i n t f ( s t d e r r , "Всё , конец − это фатально .\n" ) ;
sqlprint ();
exit (1);
}
int main ( int argc , char ∗∗ argv )
{
// определение переменных , чтобы их можно было использовать
// инструкциях ECPG
EXEC SQL BEGIN DECLARE SECTION;
const char ∗dbname = " t est " ;
const char ∗ u s e r = "baldin" ;
VARCHAR FIO [ 1 2 8 ] ;
VARCHAR NUMBER[ 1 2 8 ] ;
EXEC SQL END DECLARE SECTION ;
// соединение с базой данных
// внешние переменные предваряются двоеточием
EXEC SQL CONNECT TO : dbname USER : u s e r ;
// определение курсора через SELECT
EXEC SQL DECLARE mycursor CURSOR FOR
SELECT f i o , number FROM f i o d a t a , phonedata
WHERE f i o d a t a . i d=phonedata . i d ;
EXEC SQL open mycursor ;
// чтение данных из курсора
EXEC SQL FETCH NEXT FROM mycursor INTO : FIO , :NUMBER;
while ( s q l c a . s q l c o d e == 0 ) { // не 0 , если данные больше нет
p r i n t f ( " И %s номер : %s\n" , FIO . a r r ,NUMBER. a r r ) ;
Ф О:
EXEC SQL FETCH NEXT FROM mycursor INTO : FIO , :NUMBER;
}
// разъединение с базой данных
EXEC SQL DISCONNECT;
}

Все SQL-команды начинаются с метки EXEC SQL. Эта метка позволяет затем препроцессору ecpg обработать и произвести C-исходник. Внутри SQL-команд можно использовать C-переменные. Для этого переменным в начале добавляется двоеточие : .

Для компиляции выше процитированного исходника (файл test1.pgc) необходимо выполнить следующие действия:
> # установить ecpg
> sudo apt−g e t i n s t a l l l i b e c p g −dev
> # запустить препроцессор
> ecpg t e s t 1 . pgc
> # скомпилировать получившийся исходник
> g cc −o t e s t 1 t e s t 1 . c −I ‘ pg _ co nf i g −−i n c l u d e d i r ‘ −l e c p g
> # проверка работоспособности программы
> ./ test1
ФИО: Иванов И.П. номер : 555−32−23
ФИО: Балдин Е .М. номер : 555−41−37
ФИО: Балдин Е .М. номер : (+7)5559323919

Удобно это или нет решайте сами.

==Всё остальное==
Статья называется Интерфейсы , а большая часть посвящена только одному из них. Дело в том, что этот один является родным и наиболее полным, а всё остальное лишь подмножество. В простейшем случае все интерфейсы одинаковы: открыл соединение, послал запрос, обработал результаты запроса, закрыл соединение. Так же заметна энергосберегающая тенденция везде делать ровно один интерфейс на все типы СУБД.

* '''bash''' Да, да к bash тоже есть свой интерфейс, правда для этого надо патчить его исходники. Возни, конечно, не мало зато прямо в shell-скриптах можно обращать к базе данных. [http://www.psn.co.jp/PostgreSQL/pgbash/index-e.html Страничка проекта].

* '''Java''' Совершенно ожидаемо, что Java общается с PostgreSQL стандартным образом, а именно через JDBC. Поэтому если знаком с Java, то достаточно добыть драйвер JDBC для PostgreSQL, например [http://jdbc.postgresql.org/ отсюда] или в Debian (Sarge) набрать
> sudo apt−g e t i n s t a l l l i b p g j a v a
и, прочитав README к пакету, приступить к работе.

* '''lisp''' Точнее Common Lisp. Скорее всего эти драйвера подойдут и для других диалектов:
> sudo apt−g e t i n s t a l l c l −pg
#или
> sudo apt−g e t i n s t a l l c l −s q l −p o s t g r e s q l
Второй вариант является драйвером для единого интерфейса доступа к SQL-базам данных из Common Lisp [http://clsql.b9.com/ CLSQL].

* '''perl''' Интерфейс для связи с PostgreSQL DBD-Pg используется в perl через DBI<ref>DBI унифицированный интерфейс для доступа к данным. Подробнее об этом пакете можно посмотреть на CTAN: http://search.cpan.org/~timb/DBI-1.52/DBI.pm</ref>. Все подробности на [http://search.cpan.org/~dbdpg/DBD-Pg/Pg.pm CTAN].
> l i bdbd −pg−p e r l
DBD-Pg охватывает фактически все имеющиеся на сегодня возможности PostgreSQL от больших объектов (large objects), до точек сохранения (savepoints).

* '''PHP''' О том как использовать PostgreSQL в PHP-проектах можно прочитать [http://www.php.net/manual/en/ref.pgsql.php здесь]. Установить драйвер можно, например, так:
> sudo apt−g e t i n s t a l l php5−p g s q l
Говорят, почти единственной причиной, по которой PHP-разработчики предпочитают MySQL является то, что раньше не было родной версии PostgreSQL под альтернативную операционную систему. С версии 8.0 PostgreSQL конкретно этот довод против уже не работает.

* '''Python''' Модуль для Python существует уже больше десяти лет. Подробности выясняются [http://www.druid.net/pygresql/ здесь]. Установка модуля:
> sudo apt−g e t i n s t a l l python−p y g r e s q l
Более молодая и по утверждениям пользователей более стабильная библиотека для связи с PostgreSQL psycopg2 (http://initd.org/projects/psycopg2) так же устанавливается из коробки:
> sudo apt−g e t i n s t a l l python−psycopg2

* '''Ruby''' Что-то есть [http://ruby.scripting.ca/postgres/ здесь]. Установка, как обычно:
> sudo apt−g e t i n s t a l l l i bdbd −pg−ruby

* '''ODBC''' Разработка драйвера идёт на pgFoundry, аскетичная страничка проекта [http://pgfoundry.org/projects/psqlodbc/ здесь]. Установка:
> sudo apt−g e t i n s t a l l odbc−p o s t g r e s q l

==Послесловие==
Очевидно, что есть много чего ещё. При желании можно самому написать, благо родной C-интерфейс уже знаком, а логика достаточно прозрачна: открыл соединение, обменялся [SQL]-запросами и обязательно закрыл соединение. С другой стороны не стоит изобретать велосипеда и лучше для начала посмотреть, что было уже сделано, например, [http://techdocs.postgresql.org/oresources.php здесь].
===Врезка про bond===
Лень писать всё самому? Но не лень изучать XML? Тогда BOND это программа для Вас. [http://www.treshna.com/bond/ Сайт проекта].

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

Рис. 4.1. Формочки, XML (правда на заднем фоне и без подсветки) и связь с базой данных это bond

История пакета насчитывает уже пять лет. Программа доступна под GPL, то есть исходники производных продуктов надо открывать, а если хочется пожадничать, то есть версия и для такого случая, но за деньги. Доступна версия и под win32.

Внимательно читаем README и устанавливаем всё что там перечисляется. Сборка осуществляется с помощью scons, который позиционируется как замена make с функциональность automake/autoconf и синтаксисом от Python. Установка по умолчанию производится /usr/local/. Для установки (scons install ) необходимы привилегии системного администратора. Далее читаем документацию и изучаем директорию examples.

==Примечания==
<references />