Интерфейс DBI
Портируемые методы DBI
| connect | Устанавливает подключение к серверу. |
| disconnect | Закрывает подключение к серверу. |
| prepare | Готовит инструкцию SQL для выполнения. |
| execute | Выполняет подготовленные инструкции. |
| do | Готовит и выполняет инструкцию SQL. |
| quote | Цитирует строку или значения BLOB, которые будут вставлены. |
| fetchrow_array | Выбирает следующую строку как массив полей. |
| fetchrow_arrayref | Выбирает следующую строку как массив ссылок на поля. |
| fetchrow_hashref | Выбирает следующую строку как ссылку на hashtable. |
| fetchall_arrayref | Выбирает все данные как массив массивов. |
| finish | Заканчивает инструкцию и позволяет системе освободить ресурсы. |
| rows | Возвращается число строк, на которые воздействовал данный запрос. |
| data_sources | Возвращает массив баз данных, доступных на localhost. |
| ChopBlanks | Указывает методам fetchrow_* урезать ли пробелы. |
| NUM_OF_PARAMS | Число параметров в подготовленной инструкции. |
| NULLABLE | Которые столбцы могут быть NULL. |
| trace | Выполнить трассировку для отладки. |
MySQL-специфичные методы
| insertid | Последнее занчение AUTO_INCREMENT. |
| is_blob | Которые столбцы являются значениями BLOB. |
| is_key | Которые столбцы являются ключами. |
| is_num | Которые столбцы являются числовыми. |
| is_pri_key | Которые столбцы являются первичными ключами в данной таблице. |
| is_not_null | Которые столбцы не могут быть NULL. |
| length | Максимально возможные размеры столбца. |
| max_length | Максимальные размеры столбца, фактически представленные в результате. |
| NAME | Имена столбцов. |
| NUM_OF_FIELDS | Число возвращенных полей. |
| table | Имена таблицы в возвращенном наборе. |
| type | Все типы столбцов. |
Методы Perl описаны более подробно в следующих разделах. Переменные, используемые для значений возврата метода, имеют эти значения:
$dbh Дескриптор базы данных $sth Дескриптор оператора Statement handle $rc Код возврата (часто состояние) $rv Значение возврата (часто число строк)
Портируемые методы DBI
connect($data_source, $username, $password) Используйте метод connect, чтобы сделать подключение к базе с источником данных. Значение $data_source должно начинаться с DBI:driver_name:. Пример connect с драйвером DBD::mysql: $dbh = DBI->connect("DBI:mysql:$database", $user, $password); $dbh = DBI->connect("DBI:mysql:$database:$hostname", $user, $password); $dbh = DBI->connect("DBI:mysql:$database:$hostname:$port", $user, $password); Если имя пользователя и/или пароль не определены, DBI использует значения системных переменных DBI_USER и DBI_PASS соответственно. Если Вы не определяете hostname, по умолчанию берется localhost. Если Вы не определяете номер порта, это выставляется в порт MySQL по умолчанию (3306). Начиная с Msql-Mysql-modules Version 1.2009, значение $data_source позволяет модификаторы:
