Нейл Мэтью - Основы программирования в Linux

Для простоты начнем с рассмотрения нескольких SQL-операторов, которые не возвращают данные: UPDATE, DELETEи INSERT.

Еще одна важная функция, которую мы рассмотрим, проверяет количество строк, затронутых запросом:

my_ulonglong mysql_affected_rows(MYSQL *connection);

Первое, что вы, вероятно, заметили в этой функции, — очень необычный тип возвращаемых данных. Из соображений переносимости применяется беззнаковый (unsigned) тип. Когда используется функция printf, рекомендуется приводить его к типу unsigned long(длинное беззнаковое) со спецификатором формата %lu. Эта функция возвращает количество строк, измененных предварительно выполненным запросом UPDATE, INSERTили DELETE. Возвращаемое значение, используемое в MySQL, может вас, озадачить, если у вас есть опыт работы с другими базами данных SQL. СУРБД MySQL возвращает количество строк, действительно измененных обновлением, в то время как многие другие СУБД будут считать запись измененной просто потому, что она соответствует одному из условий WHERE.

В основном в случае функций mysql_возврат 0 означает отсутствие измененных строк, а положительное значение указывает на реальный результат, обычно количество строк, затронутых оператором.

Сначала следует создать таблицу childrenв вашей базе данных foo, если вы еще не сделали этого. Удалите (с помощью команды drop) любую существующую таблицу, чтобы быть уверенным в том, что вы имеете дело с чистым определением таблицы, и повторно отправьте идентификаторы, применяемые в столбце AUTO_INCREMENT.

$ mysql -u rick -p foo

Enter password:

Welcome to the MySQL monitor. Commands end with ; or \g.

mysql> DROP TABLE children;

Query OK, 0 rows affected (0.58 sec)

mysql> CREATE TABLE children (

-> childno int(11) AUTO_INCREMENT NOT NULL PRIMARY KEY,

-> fname varchar(30),

-> age int

-> );

Query OK, 0 rows affected (0.09 sec)

mysql>

Теперь добавьте программный код в файл connect2.c, для того чтобы вставить новую строку в вашу таблицу. Назовите эту новую программу insert1.с. Учтите, что разбиение оператора на несколько строк объясняется физической шириной страницы; обычно вы не должны разбивать реальный SQL-оператор, если он не слишком длинный, в этом случае можно применить символ /в конце строки для переноса оставшейся части SQL-оператора на следующую строку.

#include

#include

#include "mysql.h"

int main(int argc, char *argv[]) {

MYSQL my_connection;

int res;

mysql_init(&my_connection);

if (mysql_real_connect(&my_connection, "localhost",

"rick", "secret", "foo", 0, NULL, 0)) {

printf("Connection success\n");

res = mysql_query(&my_connection,

"INSERT INTO children(fname, age) VALUES('Ann', 3)");

if (!res) {

printf("Inserted %lu rows\n",

(unsigned long)mysql_affected_rows(&my_connection));

} else {

fprintf(stderr, "Insert error %d: %s\n",

mysql_errno(&my_connection), &mysql_error(&my_connection));

}

mysql_close(&my_connection);

} else {

fprintf(stderr, "Connection failed\n");

if (mysql_errno(&my_connection)) {

printf(stderr, "Connection error %d: %s\n",

mysql_errno(&my_connection), mysql_error(&my_connection));

}

}

return EXIT_SUCCESS;

}

Как и ожидалось, одна строка добавлена.

Теперь измените код, чтобы включить UPDATEвместо INSERT, и посмотрите на сообщение об измененных строках.

mysql_errno(&my_connection), mysql_error(&my_connection));

}

}

res = mysql_query(&my_connection,

"UPDATE children SET AGE = 4 WHERE fname = 'Ann'");

if (!res) {

printf("Updated %lu rows\n",

(unsigned long)mysql_affected_rows(&my_connection));

} else {

fprintf (stderr, "Update error %d: %s\n",

mysql_errno(&my_connection), mysql_error(&my_connection));

}

Назовите эту программу update1.c. Она пытается задать возраст 4 года для всех детей с именем Ann.

Предположим, что ваша таблица childrenсодержит следующие данные:

mysql> SELECT * from CHILDREN;

+---------+--------+-----+

| childno | fname | age |

+---------+--------+-----+

| 1 | Jenny | 21 |

| 2 | Andrew | 17 |

| 3 | Gavin | 9 |

| 4 | Duncan | 6 |

| 5 | Emma | 4 |

| 6 | Alex | 15 |

| 7 | Adrian | 9 |

| 8 | Ann | 3 |

| 9 | Ann | 4 |

| 10 | Ann | 3 |

| 11 | Ann | 4 |

+---------+--------+-----+

11 rows in set (0.00 sec)

В вашей таблице есть четыре ребенка с именем Ann. Вы можете рассчитывать на то, что при выполнении программы update1 количество измененных строк будет равно четырем, т.е. числу строк, отбираемых по условию WHERE. Но если вы выполните программу, то увидите отчет программы об изменении только двух строк, поскольку учитываются только те строки, данные которых действительно нуждались в корректировке. Можно выбрать более традиционный вариант отчета, используя флаг CLIENT_FOUND_ROWSв функции mysql_real_connect:

if (mysql_real_connect(&my_connection, "localhost",

"rick", "secret", "foo", 0, NULL, CLIENT_FOUND_ROWS)) {

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

Последняя странность функции mysql_affected_rowsпроявляется при удалении информации из базы данных. Если вы удаляете данные с помощью условия WHERE, mysql_affected_rowsвернет ожидаемое вами количество удаленных строк. Но если в операторе DELETEнет условия WHERE, будут удалены все строки, но в сообщении программы о количестве строк, затронутых запросом, будет указан ноль. Это происходит потому, что MySQL оптимизирует удаление всех строк, заменяя многократные построчные удаления.

На подобное поведение не влияет флаг CLIENT_FOUND_ROWS.

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

Рассмотрим определение таблицы еще раз:

CREATE TABLE children (

childno INTEGER AUTO_INCREMENT NOT NULL PRIMARY KEY,

fname VARCHAR(30),

age INTEGER

);

Как видите, столбец childno— поле типа AUTO_INCREMENT. Это замечательно, но когда вы вставили строку, как узнать, какой номер присвоен ребенку, чье имя вы только что вставили?

Можно выполнить оператор SELECTдля того чтобы извлечь данные, отобранные по имени ребенка. Но это очень неэффективный способ и не гарантирующий уникальности выбора: допустим, что у вас есть два ребенка с одним и тем же именем. Или несколько пользователей могли быстро вставить данные, и появились другие добавленные строки между вашим оператором обновления и оператором SELECT. Поскольку выяснение значения столбца типа AUTO_INCREMENT— столь распространенная проблема, MySQL предлагает специальное решение в виде функции LAST_INSERT_ID().