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

=) для меня линукс тёмный лес ))
щас на Win7 x64 =)
может кто-нить наваяет библиотеку на 64 разрядные системы...? =)

Подскажите пожалуйста, что делать делать с такого рода ошибкой:



Вылазиет, когда хочу запустить тестовый скрипт.

а сервер баз MySQL есть? работает? а база для хаба и юзер для подключения есть?

Cтоит денвер. Стоят серваки. Созданы базы через пхп май админ. Всё работает.



Создал через пхп май админ нового юзера и базу со всеми привелегиями. А как теперь эту базу подсоединить к хабу?

помогите пожалуйста.

в шапке скрипта нормально заданы параметра подключения в mysql?

во, вроде заработало, потыкал потыкал и заработало ^^

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

В очередной раз затрагиваю тему экранирования в mysql.

Символы, которые обязательно должны экранироваться: ' " \
Символы, которые могут экранироваться в LIKE запросе: % _ \ (при этом символ \ должен экранироваться так: \\\\)
Прочие экранированные символы в sql формате:
\0 - символ 0 (NUL) в ASCII коде;
\b - возврат на один символ;
\n - символ новой строки (перевода строки);
\r - символ перевода каретки;
\t - символ табуляции;
\z - символ (Control-Z) таблицы ASCII(26). Данный символ можно закодировать, чтобы обойти проблему, заключающуюся в том, что под Windows ASCII(26) означает конец файла (проблемы возникают при использовании ASCII(26) в выражении mysql database < filename).


Дабы скрипты никогда не падали из-за случайно некорректных запросов, модифицируем ранее описанный мною метод dbformat:



Кроме этого, для запросов типа LIKE, кроме метода dbformat, нужно будет применить ещё один метод:

Как я понимаю эта библиотека только для Mysql 5? т.е с с 4 версией она работать не будет?
Придется переводить сервер под MySQL 5?

Не обязательно. Попробуйте.

Благодарю.
Пересмотрел все темы, связанные с запуском скриптов с использованием MySQL и нигде не нашел указанных библиотек для Линукса.

Выложите, плиз, а лучше покажите способ компиляции библиотек вообще, поскольку такой урок я еще не находил.

Подскажите где косяк
сервер win 2003, ptokax 0.4.1.1, использую удаленный сервер MySQL
при попытке подключить mysql_test.lua в логе:

Собственно библиотека лежит там где надо и хаб перезапускал

А какая разрядность ОС? Эти либсы собраны под 32 бита...

х86, т.е. 32 бита

запустилось, положил библиотеку в корень хаба

если есть необходимость класть библиотеку в корень, то это может означать, что не запущен mysql сервер.

mysql сервер запущен на удаленной машине.
а до этого момента лог все выдавал при запуске тестового скрипта:

Разрядность ОС: 32 а подружиться с x64 не как? :((

Чебурашка, а ты пробовать пробовал?

Конечно пробовал!
как и у других хабов библиотеки подключить нельзя! так как они на х32