RussianLDP Рейтинг@Mail.ru
WebMoney: 
WMZ Z294115950220 
WMR R409981405661 
WME E134003968233 
YandexMoney: 
41001198119846 
E-gold:
5128052

10 MySQL Ruby API

MySQL Ruby Module ver 2.4.2

Это MySQL Ruby API. Он отвечает за реализацию ряда функций, аналогичных MySQL C API.

Для исправной работы интерфейса требуются, как минимум:

  • MySQL 3.23.10+
  • Ruby 1.4.5+

Автор: TOMITA Masahiro (tommy@tmtm.org, http://www.tmtm.org/mysql).

Порядок установки интерфейса

Сначала введите команды:

# ruby extconf.rb
# make

Скрипт extconf.rb понимает следующие опции:

  • --with-mysql-include=dir
    Каталог заголовков MySQL. По умолчанию это /usr/local/include.
  • --with-mysql-lib=dir
    Каталог библиотек MySQL. По умолчанию это /usr/local/lib.
  • --with-mysql-dir=dir
    Аналогично заданию параметров --with-mysql-include=dir/include и --with-mysql-lib=dir/lib

Теперь введите команду:

# ruby -I. ./test.rb hostname user passwd

Скрипт test.rb имеет несколько аргументов: имя хоста сервера MySQL, имя пользователя MySQL и его пароль.

Теперь введите команду:

# make install

Если Вы получили ошибку, например, libmysqlclient not found, при тестировании, следует в явном виде задать каталог библиотек в вызове make:

# env LD_RUN_PATH=каталог_с_libmysqlclient.so
# make

Если используется статическая библиотека libmysqlclient.a, понадобятся некоторые дополнительные библиотеки. Подправьте скрипт extconf.rb и включите в нем "have_library('m')" и "have_library('z')".

Использование данного интерфейса

Имена методов базируются на C API без префикса mysql_. Если метод породил некую ошибку, возникает исключительная ситуация MysqlError. Загрузка модуля mysql выполняется указанием require "mysql".

Класс Mysql. Методы:

  • init()
    Используется для Mysql#options()
  • real_connect(host=nil, user=nil, passwd=nil, db=nil, port=nil, sock=nil, flag=nil)
    Псевдонимы: connect(), new()
  • escape_string(str)
    Псевдоним: quote()
  • get_client_info()
    Псевдоним: client_info()
  • debug(str)

Объектные методы:

  • options(opt, val=nil)
  • real_connect(host=nil, user=nil, passwd=nil, db=nil, port=nil, sock=nil, flag=nil)
    Псевдоним: connect()
  • affected_rows()
  • change_user(user=nil, passwd=nil, db=nil)
  • character_set_name()
  • close()
  • create_db(db)
  • dump_debug_info()
  • drop_db(db)
  • errno()
  • error()
  • escape_string(str)
    Псевдоним: quote()
  • field_count()
  • get_host_info()
    Псевдоним: host_info()
  • get_proto_info()
    Псевдоним: proto_info()
  • get_server_info()
    Псевдоним: server_info()
  • info()
  • insert_id()
  • kill(id)
  • list_dbs(db=nil)
  • list_fields(table, field=nil)
  • list_processes()
  • list_tables(table=nil)
  • ping()
  • query(q)
  • refresh(r)
  • reload()
  • select_db(db)
  • shutdown()
  • stat()
  • store_result()
  • thread_id()
  • use_result()

Объектные переменные:

  • query_with_result
    Если true, query() действует как store_result() и возвращает объект MysqlRes. Значение по умолчанию: true.

Класс MysqlRes. Методы:

  • free()
  • data_seek(offset)
  • fetch_field()
  • fetch_fields()
  • fetch_field_direct(fieldnr)
  • fetch_lengths()
  • fetch_row()
  • fetch_hash(with_table=false)
  • field_seek(offset)
  • field_tell()
  • num_fields()
  • num_rows()
  • row_seek(offset)
  • row_tell()

Итераторы:

  • each() {|x| ...}
    x представляет собой массив значений столбца.
  • each_hash(with_table=false) {|x| ...}
    x представляет собой хэш значений столбца, а ключ является именем столбца.

Класс MysqlField. Объектные переменные (только для чтения):

  • name
  • table
  • def
  • type
  • length
  • max_length
  • flags
  • decimals

Объектные методы в классе:

  • hash(),
  • inspect()
    Возвращает строку в формате "#".

Класс MysqlError. Объектные переменные (только для чтения):

  • error,
  • errno

Поиск

 

Найди своих коллег!