Рис. 8.6
Если вы хотите управлять сервером MySQL из программы-клиента в ОС Windows, можно загрузить Windows-версию MySQL Administrator из раздела Web-сайта MySQL, посвященного средствам GUI. Когда писалась эта книга, в загрузку были включены администратор, обозреватель запросов и утилита переноса базы данных. На рис. 8.7 показан экран состояния, как видите, он почти идентичен версии Linux,
Примечание
Напоминаем, что если вы до сих пор следовали инструкциям, то защитили свой сервер MySQL так, что пользователь root может подключиться к нему только с локальной машины и ни с какой другой машины в сети.
После запуска MySQL Administrator вы сможете провести наблюдения при разной настройке и отслеживаемых параметрах. Это очень легкое в использовании средство, но у нас нет возможности в этой единственной главе вдаваться в подробности.
Рис. 8.7
Доступ к данным MySQL из программ на С
Теперь, когда основы СУРБД MySQL остались в стороне, давайте рассмотрим, как, не применяя графические средства или программу-клиент mysql, получить доступ к СУРБД MySQL из вашего приложения.
К MySQL можно получить доступ из программ на разных языках, включая следующие:
□ С;
□ Eiffel;
□ С++;
□ Tcl;
□ Java;
□ Ruby;
□ Perl;
□ Python;
□ PHP.
Есть и драйвер ODBC для доступа к MySQL из приложений ОС Windows, таких как Access. Существует даже драйвер ODBC для ОС Linux, но в его применении мало смысла.
В этой главе мы ограничились интерфейсом языка С, потому что в первую очередь этому языку программирования посвящена книга и потому что одни и те же библиотеки обеспечивают подключение из ряда других языков.
Подпрограммы подключения
Подключение к базе данных MySQL из программы на языке С состоит из двух шагов:
□ инициализации структуры идентификации подключения или дескриптора подключения;
□ выполнения физического подключения.
Сначала примените
mysql_init
для инициализации дескриптора вашего подключения:
<b>#include <mysql.h></b>
<b>MYSQL *mysql_init(MYSQL*);</b>
Обычно в подпрограмму передается
NULL
и возвращается указатель на вновь выделяемую память для структуры дескриптора подключения. Если вы пересылаете указатель на существующую структуру, она инициализируется заново. В случае ошибки возвращается
NULL
.
К этому моменту вы просто выделили память и инициализировали структуру дескриптора. Но вы еще должны предложить параметры подключения с помощью подпрограммы
mysql_real_connect
:
<b>MYSQL *mysql_real_connect(MYSQL *connection, </b>
<b> const char *server host, const char *sql_user_name,</b>
<b> const char *sql_password, const char *db_name,</b>
<b> unsigned int port_number, const char *unix_socket_name,</b>
<b> unsigned int<b> flags)</b>;</b>
Указатель подключения должен указывать на структуру дескриптора, уже инициализированную подпрограммой
mysql_init
. Параметры в большинстве своем очевидны; но следует отметить, что
server_host
может задаваться именем компьютера или IP-адресом. При подключении только к локальной машине вы можете оптимизировать тип подключения, указав в качестве этого параметра
localhost
.
Параметры
sql_user_name
и
sql_password
соответствуют своим именам. Если регистрационное имя равно
NULL
, предполагается идентификатор текущего пользователя ОС Linux. Если пароль —
NULL
, вы сможете обратиться к данным только на том сервере, который доступен без пароля. Перед отправкой по сети пароль шифруется.
Параметры
port_number
и
unix_socket_name
должны быть равны 0 и
NULL
соответственно, если вы не меняли стандартных настроек в вашей установке MySQL. Эти параметры примут соответствующие значения по умолчанию.
И наконец, параметр
flags
позволяет с помощью операции
OR
объединить несколько определений битовых масок, изменяя тем самым определенные характеристики применяемого протокола. Ни один из этих флагов не важен в данной вводной главе; все они подробно описаны в руководстве.
Если подключиться невозможно, возвращается
NULL
. В этом случае полезную информацию может предоставить подпрограмма
mysql_error
.
Когда вы прекращаете использовать подключение, обычно при завершении программы, вызовите подпрограмму
mysql_close
, как показано далее:
<b>void mysql_close(MYSQL * connection);</b>
Эта подпрограмма разорвет соединение с сервером. Если подключение устанавливалось с помощью
mysql_init
, память, отведенная под структуру дескриптора, освободится. Указатель станет неопределенным, и его нельзя будет применять в дальнейшем. Открытое ненужное подключение означает расточительное использование ресурсов, но повторное открытие подключения сопряжено с дополнительными накладными расходами, поэтому решайте сами, когда применять описанные подпрограммы.
Подпрограмма
mysql_options
(которую можно вызвать только между вызовами
mysql_init
и
mysql_real_connect
) позволит настроить некоторые параметры.
<b>int mysql_options(MYSQL* connection, enum option_to_set, const char *argument);</b>
Поскольку при каждом вызове
mysql_options
способна настроить только один параметр, ее следует вызывать отдельно для каждого параметра, который нужно задать. Вы можете применять эту подпрограмму необходимое количество раз, но все вызовы должны находиться между вызовами подпрограмм
mysql_init
и
mysql_real_connect
. Не все параметры подпрограммы имеют тип
char
, который следует приводить как
const char*
. Три самых часто используемых параметра приведены в табл. 8.11. И как всегда в расширенном интерактивном руководстве приведен полный список параметров.
Таблица 8.11
Enum -параметр | Действительный тип аргумента | Описание |
MYSQL_ОРТ_CONNECT_TIMEOUT
| const unsigned int*
| Количество секунд ожидания перед закрытием подключения из-за простоя |
MYSQL_ОРТ_COMPRESS
| Нет, используйте NULL
| Применять сжатие при сетевом подключении |
MYSQL_INIT_COMMAND
| const char*
| Команда, отправляемая при каждом установлении подключения |