Mysql, win32 - API 2 | Самая распространённая база данных

DLL библиотека для работы с базой данных MySQL 5.

Версия lua: 5.1
Версия API: 2
Разрядность ОС: 32
Протестировано на PtokaX 0.4.1.1

Копирайт: Copyright © 2003-2007 Kepler Project
LuaSQL is a simple interface from Lua to a DBMS
Версия: LuaSQL 2.1.1


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


Теперь о содержимом библиотеки.
Я прикладываю rar архив. В нём dll файл libmysql.dll и папка luasql с dll файлом mysql.dll. Обе эти дллелки нужны для работы бд.
Распаковываем архив в папку, где лежит файл ptokax.exe (или в папку libs), и ничего никуда не перемещаем.
После этого запускаем скрипт для тестирования.




Основные функции для работы с mysql в lua

• Подключение драйвера (библиотеки):
  Код
  require"luasql.mysql"
  
  
• Инициализация драйвера (библиотеки):
  Код
  env = luasql.mysql()
  
  
• Деинициализация драйвера (библиотеки):
  Код
  env:close()
  Возвращает true в случае успешного закрытия, false в случае, если закрытие уже было сделано до этого.

Объект - соединение (conn)

• Метод вызова соединения с базой данных:
  Код
  conn = env:connect([имя_базы], [имя_пользователя], [пароль], [хост], [порт])
  Обязательным является только первый параметр, остальные параметры в случае отсутствия берутся по умолчанию: [имя_пользователя] = "root", [пароль] = "", [хост] = "localhost", [порт] = 3306
  
  
• Метод закрытия соединения с базой данных:
  Код
  conn:close()
  Закрытие может быть успешным только в случае если все курсоры закрыты. Возвращает true в случае успеха, false - в случае неудачи.
  
  
• Метод выполнения (завершения, совершения) текущей транзакции:
  Код
  conn:commit()
  Возвращает true в случае успеха, false - в случае, когда транзакция не может быть завершина или база данных не поддерживает транзакции (поддержка транзакции в mysql осуществляется с версии 4.0).
  
  
• Метод выполнения SQL запроса к базе данных:
  Код
  conn:execute("запрос")
  В случае правильности запроса, для запросов типа SELECT возвращает курсор, для остальных запросов возвращает число столбцов или строк, успешно обработанных запросом. В случае неверного синтаксиса, или несуществующих таблиц, или несуществующих полей возвращается два значения: первое - nil, второе - сообщение с содержанием ошибки.
  
  
• Метод отката на предыдущую транзакцию:
  Код
  conn:rollback()
  Возвращает true в случае успеха, false - в случае, когда операция не может быть выполнена или база данных не поддерживает транзакции (поддержка транзакции в mysql осуществляется с версии 4.0).
  
  
• Метод включения/отключения автоматических транзакций:
  Код
  conn:setautocommit(boolean)
  Эта функция не может работать на базах, на которых не осуществляются транзакции. На базах данных, на которых нет понятия режима автоматических транзакций, этот механизм осуществляется драйвером. Метод возвращает true в случае успеха, и false - в случае невыполнимости или неосуществимости (поддержка транзакции в mysql осуществляется с версии 4.0).

Объект - курсор (cur)

• Метод закрытия курсора:
  Код
  cur:close()
  Возвращает true в случае успешного закрытия, false - в случае, если этот курсор уже закрыт.
  
  
• Метод извлечения результатов:
  Код
  cur:fetch([table[,modestring]])
  Извлекает следующий столбец с результатами. Если метод вызывается без параметров, то результаты возвращаются непосредственно вызывающему оператору. Если в первом параметре метода указана таблица, то результаты помещаются в эту таблицу, и методом возвращается эта таблица, при этом может быть использован второй параметр. Второй параметр - это строка, которая указывает на то, как создавать результирующую таблицу:
  "n" - результирующая таблица будет содержать целочисленные индексы (это значение по умолчанию);
  "a" - результирующая таблица будет содержать словесные индексы.
  Целочисленные индексы являются номерами полей в SELECT запросе. Словесные индексы являются названиями полей в SELECT запросе. Дополнительный табличный параметр является таблицей, которую нужно использовать для сохранения следующей строки запроса. В частности, это допускает использование одной уникальной таблицы для всех выборок, и такой механизм может улучшить общее выполнение выборки в целом. Нет гарантии того, что извлечённые результаты будут преобразовываться в нужные в lua типы (в зависимости от содержания), то есть это говорит о том, что возвращаемые результаты всегда представляются в виде строковых значений будь это строка или число. Метод возвращает результирующую таблицу или nil, в случае если достигнута конечная строка. Здесь нужно отметить, что этот метод может возвращать nil, но тем не менее запрос будет выполнен правильно.
  
  
• Метод, возвращающий таблицу с именами столбцов для данного курсора:
  Код
  cur:getcolnames()
  
  
• Метод, возвращающий таблицу с типами столбцов для данного курсора:
  Код
  cur:getcoltypes()
  
  
• Метод, возвращающий число строк, полученных в результате запроса:
  Код
  cur:numrows()

Как работать с таблицами для достижения большей производительности

1. По возможности все поля декларировать как NOT NULL. Это сделает работу с таблицами более быстрой и сохранит 1 бит на каждое такое поле.
2. Применять значения по умолчанию (DEFAULT). При вызове запроса INSERT в таблицу будут записываться только те поля, значения которых отличаются от DEFAULT.
3. Используйте настолько малые типы INT, насколько это возможно. Например, применять MEDIUMINT намного лучше, чем обычный INT.
4. Если у вас нет записей с переменной длиной ( ни одного поля с типом VARCHAR, BLOB или TEXT), то таблица сохраняется в формате " постоянной длиной записи ". Это несколько расходует память, но намного повышает скорость работы.
5. При использовании нескольких последовательных INSERT запросов, лучше все данные указать в одном INSERT, чем делать несколько INSERT.
6. При загрузке данных в таблицу лучше использовать LOAD DATA INFILE, чем INSERT, такой метод в 20 раз быстрее.
7. Для увеличения скорости LOAD DATA INFILE и INSERT нужно увеличить значение переменной key_buffer.
8. Если ожидается много запросов INSERT или UPDATE, работающих одновременно, то для большей скорости рекомендуется приметь LOCK TABLES.
9. Время от времени нужно дефрагметировать таблицы. Это делается утилитой isamchk с опциями - evi.

--------------------

Если у вас нет mysql сервера, то качаем его, например отсюда: http://www.mysql.ru/download/ (файл mysql-5.0.67-win32.zip)
Для удобного администрирования там же можно скачать утилиту mysqlgui-win32-static
MySQL распространяется под GNU General Public License и под собственной коммерческой лицензией, на выбор.


Архив с библиотеками под PtokaX 0.4.*.*:  mysql.rar ( 541.42 килобайт ) Кол-во скачиваний: 1673

Скрипт примера работы с MySQL в LUA:  mysql_test.lua ( 1.63 килобайт ) Кол-во скачиваний: 458

Угу, а где архив? И есть ли хотя бы справка по функциям?

кстати, Илья (Я к сетаперу) - я так думаю, что тем же способом, что и sqlite, в линукс подрубается mysql! У меня require "luasql.mysql" без ошибок пашет ) PS пора делать скрипты с SQLite и MySQl!

надо токо пока не получается

Простите, забыл приложить архив - исправлено

mariner: я не сомневаюсь в этом. Именно эту самую библиотеку я и скомпилил под винду. Поэтому скрипты можно писать кроссплатформенные.

всё таки SQLite в каком то роде предпочтительнее, не все же имеют MySQL сервер....

Поверь, "мускул" имеет гораздо большие возможности по сравнения со "скулой". Sqlite многие даже не считают за базу данных)))
Когда-то давно (2 года назад) я писал базы данных под MSSQL и под mysql и не знал, что существует какой-то там sqlite, потому как он не очень широко распространён среди программистов, которые пишут большие и стабильные программы на базе взаимодействия клиент-сервер.
Неужели так сложно поставить мускул? Инструкцию по установки что ли накатать?

думаю их полно в инете. Хотелось бы увидеть несколько скриптов с открытым кодом работающих с базой данных! Например простенький топ сообщений! Накидаешь Илюх?

Постараюсь в ближайшее время что-то подобного рода изобразить

Тестовый скрипт удачно запущен совместно с Денвером! Единственное базу пришлось создавать ручками.

PS: есть ли сайты повещённые взаимодействию MySQL и Lua?

Базу естественно надо создавать вручную, а потом только к ней коннектиться. Для создания базы лучше всего использовать утилиту mysqlgui-win32-static (см. первый пост).

Всё что нужно знать по взаимодействию mysql и lua написано в первом посте.

упс не глянул пардон! я создал через phpMyAdmin

кстати mysqlgui-win32-static скачал ещё вчера. не работает она у меня(((

Хм... странно из-за чего бы это ей не работать?
В общем базу можно создать многими способами, хоть через командную строку))))

да, командная строка наше фсио ) (я думаю ты уже догадался, что я console user) PS я готов выложить обновленные пакеты )

При выборке данных из таблицы числовые значения возвращаются как строки. Так и должно быть, или я что-то не так делаю?

да. Преобразование в нужные типы нужно делать самому, я об этом писал в первом посту (читай "Метод извлечения результатов")

Свистопляска с кодировками MySQL

Начиная с версии 4.1 появилась возможность устанавливать кодировку на уровне сервера, базы данных, таблицы, столбца. Также появились переменные, которые определяют кодировку клиента (character_set_client), соединения (character_set_connection) и результата (character_set_results).

Например, когда вы добавляете данные в таблицу, MySQL проверяет кодировку клиента (вы можете посмотреть ее, проверив значение переменной character_set_client) и использует ее для определения того, в какой кодировке вы передаете серверу данные.

Переменная character_set_connection используется для определения кодировки для литералов, у которых она не определена и при преобразовании числа в строку.

Это значит, что если у вас данные в кодировке cp1251, то для корректной передачи данных необходимо чтобы character_set_client и character_set_connection были установлены в cp1251.

Во все три выше перечисленные параметры можно установить кодировку одним запросом к MySQL: Это эквивалентно трём следующим командам:

Однако, этой всей свистопляски можно и не делать если установить кодировки по умолчанию. Кодировки по умолчанию устанавливаются в файле my.ini, который находится в директории установленного вами мускула. В данном файле, в соответствующих "разделах", дописывается следующее:






Внимание! Прописанная настройка init-connect, позволяет не прописывать каждый раз при коннекте к базе данных команду "SET NAMES cp1251", о которой говорилось выше, НО эта настройка не будет выполняться для пользователей, у которых есть привилегия SUPER.

Команда для просмотра кодировок:
Использование:

И последнее...

При создании базы данных нужно также указывать кодировку создаваемой базы:


Соблюдая все вышеизложенные факты, корректная работа базы данных обеспечена!

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

Исходники есть у PPK. Но он скорее всего пошлёт тебя если попросишь.

Если хорошо постараться, то можно и без исходников прикрутить к птоке MySQL.

и будет обычная птока только с плагином мускуля...
может кто нить напишет PPK что бы вышла птока которая не только как сервис, но как сервис с самостоятельным доступом к БД. а не через(пусть и хорошо написанный) плагин.