libmysqld, встраиваемая библиотека сервера MySQL Обзор библиотеки встраиваемого сервера MySQL Компиляция программ с libmysqld Ограничения при использовании встраиваемого сервера MySQL Использование файлов опций с встраиваемым сервером Что осталось сделать по встраиваемомуому серверу (TODO) Пример простого встраиваемого сервера Лицензирование встраиваемого сервера Обзор библиотеки встраиваемого сервера MySQL Библиотека встраиваемого сервера MySQL обеспечивает возможность запуска полнофункционального сервера MySQL внутри клиентского приложения. Основные преимущества, которые дает ее использование, - увеличение скорости и более простое управление для встраиваемых приложений. Интерфейсы API для встраиваемой версии MySQL и для версии клиент/сервер идентичны. Чтобы реализовать возможность использования встраиваемого сервера в старом приложении с потоками, обычно необходимо только добавить вызовы следующих функций: Функция Когда вызывается mysql_server_init() Должна вызываться перед любой другой функцией MySQL, предпочтительно раньше, чем функция main(). mysql_server_end() Должна вызываться перед выходом из данной программы. mysql_thread_init() Должна вызываться в каждом создаваемом потоке, который будет работать с MySQL. mysql_thread_end() Должна вызываться перед вызовом pthread_exit() После добавления функций необходимо связать данный код с библиотекой 'libmysqld.a' вместо 'libmysqlclient.a'. Вышеприведенные функции типа mysql_server_xxx также включены в 'libmysqlclient.a' - таким образом обеспечивается возможность переключаться между встраиваемой и клиент-серверной версиями просто линкованием конкретного приложения с соответствующей библиотекой. См. раздел 1 mysql_server_init(). Компиляция программ с libmysqld Чтобы получить библиотеку libmysqld, необходимо сконфигурировать (при помощи configure) сборку MySQL с опцией --with-embedded-server. При связывании программы с libmysqld необходимо также включать специфические для данной системы библиотеки pthread и другие библиотеки, используемые сервером MySQL. Полный список библиотек можно получить, выполнив mysql_config --libmysqld-libs. Для компиляции и связывания должны использоваться флаги компиляции потоковой программы, даже если никакие потоковые функции в данном коде явно не вызываются. Ограничения при использовании встраиваемого сервера MySQL Bстраиваемый сервер имеет следующие ограничения: Не поддерживает таблицы ISAM (это сделано главным образом для уменьшения размеров библиотеки) Не поддерживает функции UDF (функции, определяемые пользователем). Не отслеживаются стеки на дампе оперативной памяти. Нет внутренней поддержки RAID (обычно этого не требуется, так как большинство операционных систем в настоящее время имеют поддержку для больших файлов). встраиваемый сервер MySQL нельзя установить как головной или подчиненный сервер репликации К встраиваемому серверу нельзя подсоединиться из внешнего процесса через сокеты или по протоколу TCP/IP. Некоторые из этих ограничений могут быть изменены путем редактирования включаемого файла 'mysql_embed.h' и перекомпилирования MySQL. Использование файлов опций с встраиваемым сервером Ниже приводятся рекомендации по использованию файлов опций для облегчения перехода между клиент-серверным приложением и приложением с встраиваемым MySQL (см. раздел Файлы параметров 'my.cnf'). Следует помещать общие опции в раздел [server]. Они будут читаться обеими версиями MySQL. Следует помещать специфические клиент-серверные опции в раздел [mysqld]. Следует помещать специфические опции встраиваемого MySQL в раздел [embedded]. Следует помещать специфические опции приложения в раздел [ApplicationName_SERVER]. Что осталось сделать по встраиваемомуому серверу (TODO) В настоящее время поставляется только статическая версия библиотеки mysqld, в будущем будет поставляться также и динамическая библиотека. Предполагается обеспечить возможность не включать некоторые части MySQL, чтобы сделать библиотеку меньше. Многое еще нужно сделать для оптимизации скорости. Ошибки записываются в stderr. Предполагается добавить возможность указывать для них имя файла. Необходимо изменить InnoDB, чтобы вывод этого обработчика не был бы настолько подробным во встраиваемой версии. Пример простого встраиваемого сервера Этот пример программы и сборочного файла должен работать без каких-либо изменений под операционными системами Linux или FreeBSD. Для других операционных систем потребуются небольшие изменения. При разработке данного примера мы ставили перед собой цель предоставить достаточно информации для понимания рассматриваемой темы и в то же время не перегружать текст руководства лишними деталями, специфическими для реального приложения. Чтобы запустить этот пример, создайте каталог 'test_libmysqld' там же, где находится каталог исходного кода mysql-4.0. Сохраните исходный код 'test_libmysqld.c' и 'GNUmakefile' в данном каталоге и запустите GNU 'make' в каталоге 'test_libmysqld'. 'test_libmysqld.c' /* * Клиент простого примера с использованием библиотеки встраиваемого сервера MySQL */ #include #include #include #include MYSQL *db_connect(const char *dbname); void db_disconnect(MYSQL *db); void db_do_query(MYSQL *db, const char *query); const char *server_groups[] = { "test_libmysqld_SERVER", "embedded", "server", NULL }; int main(int argc, char **argv) { MYSQL *one, *two; /* Функцию mysql_server_init() необходимо вызывать перед любыми другими * функциями mysql. * Можно задать mysql_server_init(0, NULL, NULL); тогда для * инициализации сервера будут использоваться группы "server", * "embedded", NULL *}. * * В файле $HOME/.my.cnf можно указать: [test_libmysqld_SERVER] language = /path/to/source/of/mysql/sql/share/english * Можно было бы, конечно, модифицировать argc и argv непосредственно * перед передачей их в эту функцию или создать * новые аргументы - для этого годится любой выбранный вами способ. * Однако все аргументы в argv (кроме argv[0], который * представляет собой имя программы) должны быть допустимыми опциями * для сервера MySQL. * * Если данный клиент линкуется с нормальной библиотекой mysqlclient, * то эта функция является просто заглушкой, ничего не делающей. */ mysql_server_init(argc, argv, (char **)server_groups); one = db_connect("test"); two = db_connect(NULL); db_do_query(one, "SHOW TABLE STATUS"); db_do_query(two, "SHOW DATABASES"); mysql_close(two); mysql_close(one); /* Эта функция должна вызываться после всех других функций mysql */ mysql_server_end(); exit(EXIT_SUCCESS); } static void die(MYSQL *db, char *fmt, ...) { va_list ap; va_start(ap, fmt); vfprintf(stderr, fmt, ap); va_end(ap); (void)putc('\n', stderr); if (db) db_disconnect(db); exit(EXIT_FAILURE); } MYSQL * db_connect(const char *dbname) { MYSQL *db = mysql_init(NULL); if (!db) die(db, "mysql_init failed: no memory"); /* * Обратите внимание: клиент и сервер используют разные имена групп. * Это обязательное условие, поскольку сервер не должен использовать опции * клиента и наоборот. */ mysql_options(db, MYSQL_READ_DEFAULT_GROUP, "test_libmysqld_CLIENT"); if (!mysql_real_connect(db, NULL, NULL, NULL, dbname, 0, NULL, 0)) die(db, "mysql_real_connect failed: %s", mysql_error(db)); return db; } void db_disconnect(MYSQL *db) { mysql_close(db); } void db_do_query(MYSQL *db, const char *query) { if (mysql_query(db, query) != 0) goto err; if (mysql_field_count(db) > 0) { MYSQL_RES *res; MYSQL_ROW row, end_row; int num_fields; if (!(res = mysql_store_result(db))) goto err; num_fields = mysql_num_fields(res); while ((row = mysql_fetch_row(res))) { (void)fputs(">> ", stdout); for (end_row = row + num_fields; row < end_row; ++row) (void)printf("%s\t", row ? (char*)*row : "NULL"); (void)fputc('\n', stdout); } (void)fputc('\n', stdout); } else (void)printf("Affected rows: %lld\n", mysql_affected_rows(db)); return; err: die(db, "db_do_query failed: %s [%s]", mysql_error(db), query); } 'GNUmakefile' # Предполагается, что программное обеспечение MySQL установлено в #/usr/local/mysql inc := /usr/local/mysql/include/mysql lib := /usr/local/mysql/lib # Если программное обеспечение MySQL еще не установлено, сделайте такую замену: #inc := $(HOME)/mysql-4.0/include #lib := $(HOME)/mysql-4.0/libmysqld CC := gcc CPPFLAGS := -I$(inc) -D_THREAD_SAFE -D_REENTRANT CFLAGS := -g -W -Wall LDFLAGS := -static # Можно изменить -lmysqld на -lmysqlclient для того, чтобы использовать # обычную клиент-серверную библиотеку LDLIBS = -L$(lib) -lmysqld -lz -lm -lcrypt ifneq (,$(shell grep FreeBSD /COPYRIGHT 2>/dev/null)) # Для FreeBSD LDFLAGS += -pthread else # Предполагается Linux LDLIBS += -lpthread endif # Это работает для простых однофайловых тестовых программ sources := $(wildcard *.c) objects := $(patsubst %c,%o,$(sources)) targets := $(basename $(sources)) all: $(targets) clean: rm -f $(targets) $(objects) *.core Лицензирование встраиваемого сервера Исходный код MySQL подпадает под действие лицензии GNU GPL. Одно из следствий этого заключается в том, что любая программа, включающая (посредством связывания с libmysqld) исходный код MySQL, должна выпускаться как открытое программное обеспечение (под лицензией, совместимой с GPL). Мы стараемся всячески способствовать всем, кто распространяет открытое программное обеспечение, выпуская код под GPL или совместимой лицензией. Для тех же, кому эти условия не подходят, существует другая возможность - покупка коммерческой лицензии для кода MySQL у компании MySQL AB. Более подробная информация об этом находится в разделе Лицензии на ПО MySQL. <<<  Назад  1  2  3  4  5  6   8  Комментарии к статье  8 8  Обсудить в чате

8  В тему Интерфейс PHP API для MySQL Интерфейс Perl API для MySQL Поддержка ODBC в MySQL Интерфейс C для MySQL Интерфейсы C++ и не только