Чтение онлайн

• 

возвращает массив объектов , соответствующих полям в следующей строке;

• 

возвращает массив значений полей в следующей строке;

• 

возвращает хэш, содержащий имена и значения полей в следующей строке;

• 

возвращает число строк в результирующем наборе;

• 

— итератор, последовательно возвращающий массив значений полей;

• 

— итератор, последовательно возвращающий хэш вида (пользуйтесь нотацией для получения значения поля).

Вот некоторые методы экземпляра, определенные в классе

:

• 

возвращает имя поля;

• 

возвращает имя таблицы, которой принадлежит поле;

• 

возвращает длину поля, заданную при определении таблицы;

• 

возвращает длину самого длинного поля в результирующем наборе;

• 

возвращает хэш с именами и значениями следующих элементов описания: , , , , , , , .

Если изложенный здесь материал противоречит онлайновой документации, предпочтение следует отдать документации. Более подробную информацию вы найдете на официальном сайте MySQL и в архиве приложений Ruby.

В архиве RAA есть также расширение, реализующее доступ к СУБД PostgreSQL (работает с версиями PostgreSQL 6.5/7.0).

В предположении, что PostgreSQL уже установлена и сконфигурирована (и в базе данных есть таблица

), нужно лишь выполнить те же шаги, что и для всех остальных интерфейсов Ruby с базами данных: загрузить модуль, установить соединение с базой данных и начать работу. Надо полагать, вам понадобится способ послать запрос, получить результаты и работать с транзакциями.

В классе

есть метод , который принимает обычные параметры для установления соединения: имя хоста, номер порта, имя базы данных, имя и пароль пользователя. Кроме того, третий и четвертый параметры — соответственно, флаги и параметры терминала. В приведенном примере мы установили соединение через сокет UNIX от имени привилегированного пользователя, поэтому не указывали ни имя пользователя, ни пароль, а имя хоста, флаги и параметры терминала оставили пустыми. Номер порта должен быть целым числом, а остальные параметры — строками. У метода есть синоним .

Для работы с таблицами нужно уметь выполнять запросы. Для этого служат методы

и .

Метод

посылает переданную ему строку — SQL-запрос — серверу PostgreSQL и получает ответ в виде объекта , если выполнение завершилось успешно. В противном случае он возбуждает исключение .

Метод

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

Имеется специальный метод

для вставки записи в указанную таблицу. Вопреки названию он не создает новую таблицу, а добавляет данные в существующую. Этот метод возвращает объект .

В этом примере в таблицу

вставляется одна строка. Для простоты мы указали только одну колонку. Отметим, что объект класса после обновления возвращает массив из двух кортежей. Чуть ниже мы рассмотрим методы, определенные в классе .

В классе

определены также следующие полезные методы:

• 

возвращает имя базы, с которой установлено соединение;

• 

возвращает имя сервера, с которым установлено соединение;

• 

возвращает имя аутентифицированного пользователя;

• 

возвращает сообщение об ошибке;

• 

, закрывают соединение;

• 

импортирует файл в большой двоичный объект (BLOB), в случае успеха возвращает объект , иначе возбуждает исключение ;

• 

выгружает BLOB с идентификатор в указанный файл;

• 

возвращает объект в случае успеха, иначе возбуждает исключение ;

• 

открывает BLOB с идентификатором . Возвращает объект в случае успеха. Аргумент задает режим работы с открытым объектом: или (если этот аргумент опущен, по умолчанию предполагается );

• 

удаляет BLOB с идентификатором .

Отметим, что пять последних методов (

, , , и ) работают с объектами класса . У этого класса есть собственные методы для доступа к объекту и его изменения. (BLOB'ы создаются в результате выполнения методов , , экземпляра.)