WikiDer > ECPG

ECPG

ECPG стандарт, в PostgreSQL встроенная база данных, клиентский программный интерфейс для встраивания SQL в программах, написанных на C язык программирования.[1] Он предоставляет возможность доступа к базе данных PostgreSQL непосредственно из кода C в приложении с помощью команд SQL.

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

Использование можно разделить на 2 этапа. Сначала необходимо создать файл .pgc, состоящий из C код со встроенным SQL код. В таком файле SQL-код будет вставлен непосредственно в C-код приложения. Команды SQL должны быть вставлены в код C следующим образом:

// ... C код ...EXEC SQL <sql-заявления>;// ... C код ...

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

EXEC SQL СОЕДИНЯТЬ К имя базы данных[@имя хоста][:порт] [В КАЧЕСТВЕ название соединения] [ПОЛЬЗОВАТЕЛЬ имя пользователя];

Часть встроенного SQL будет обработана препроцессором ECPG, в котором код SQL будет заменен вызовами библиотеки ecpg (libecpg.a или libecpg.so). Файл .pcg также будет предварительно обработан с помощью ecpg, который преобразует его в файл .c в соответствии со стандартами ANSI. Следовательно, на втором этапе сгенерированный файл .c можно напрямую скомпилировать с помощью стандартного компилятора C.[2]

Следующая команда создаст из my_c_file_with_embedded_sql_commands.pcg подать my_c_file_with_embedded_sql_commands.c файл, который может быть обработан в дальнейшем как чистый код C.

$ ecpg my_c_file_with_embedded_sql_commands.pcg

Также имеется исходный код ecpg, доступный в Исходный код PostgreSQL git репозиторий.

Примечание. При компиляции предварительно обработанного кода .c не забудьте связать библиотека ecpg (libepcg), чтобы сгенерированные вызовы могли найти связанные с ними методы.

Использование переменных хоста

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

Предполагая, что существует переменная с именем имя переменной в вашем коде C:

EXEC SQL ВСТАВЛЯТЬ В имя таблицы ЗНАЧЕНИЯ (:имя переменной);

Это можно использовать в любом заявлении, ВСТАВЛЯТЬ Заявление было выбрано просто как простой пример для иллюстрации.

В приведенном выше примере показано, как передать переменную C в SQL, но данные могут передаваться и в обратном направлении: обратно в приложение. В следующем примере показано, как передать значение из SQL обратно в переменную C.

EXEC SQL НАЧИНАТЬ ЗАЯВИТЬ РАЗДЕЛ;VARCHAR имя переменной;EXEC SQL КОНЕЦ ЗАЯВИТЬ РАЗДЕЛ;EXEC SQL ВЫБРАТЬ имя столбца В :имя переменной ИЗ имя таблицы;

Для простоты предположим, что в таблице всего одна строка имя таблицы. Этот оператор вставит значение столбца имя столбца в переменную Переменная. Каждая команда, поддерживающая В предложение может использоваться таким образом, например ПРИНЕСТИ команда.

Обработка ошибок

Для лучшей обработки ошибок ECPG также предоставляет структуру под названием Коммуникационная область SQL (sqlca). Эта структура будет заполняться после каждого выполнения оператора sql (каждый поток имеет свой собственный sqlca[3]) и содержит информацию о предупреждениях и ошибках, например код возврата. Данные в sqlca будут заполнены в соответствии с ответом базы данных и могут быть использованы для отладки.

Прочие интерфейсы

Поскольку ECPG поддерживает встраивание SQL в C язык программирования, он также косвенно поддерживает встраивание в C ++ язык программирования. В SQL части переведены в вызовы библиотеки C. Они генерируются внутри внешний "C" пункт, который обеспечивает связь между модулями, написанными на разных языках программирования.[4] Использование ECPG с кодом C ++ имеет некоторые ограничения, так как препроцессор ECPG не понимает специфический синтаксис и зарезервированные слова в языке программирования C ++. Использование такого синтаксиса и слов может привести к неожиданному поведению приложения. Рекомендуется разделить встроенные команды SQL в связанном модуле C, который будет связан и вызываться из приложения C ++.[5]

Помимо внутреннего ECPG, существуют также различные внешние интерфейсы для C ++, Ява, Lua, .СЕТЬ, Node.js, Python, PHP и другие, доступные для PostgreSQL база данных, которую можно добавить, чтобы расширить возможности встроенного SQL. Существуют также другие базы данных, поддерживающие встроенный SQL, также на других языках, кроме C, таких как Java, .NET, Фортран, КОБОЛ, PL / I.

Рекомендации

  1. ^ "Домашняя страница PostgreSQL". PostgreSQL. Группа глобального развития PostgreSQL. Получено 2015-06-06.
  2. ^ Ахмед, Ибрар, Файяз, Асиф и Шахзад, Амджад (27 февраля 2015 г.). Руководство разработчика PostgreSQL. Packt Publishing Ltd, 2015. с. 197. ISBN 978-1783989034. Получено 6 июн 2015.CS1 maint: несколько имен: список авторов (связь)
  3. ^ «SQLCA». PostgreSQL. Группа глобального развития PostgreSQL. Получено 2018-01-23.
  4. ^ "Связь с CPP". Ссылка CPP. Ссылка CPP. Получено 2015-06-06.
  5. ^ «Приложения C ++». PostgreSQL. Группа глобального развития PostgreSQL. Получено 2018-01-23.

внешняя ссылка