mysql_unbuffered_query
(PHP 4 >= 4.0.6, PHP 5)
mysql_unbuffered_query — Посылает запрос MySQL без авто-обработки результата и его буферизации
Данное расширение устарело, начиная с версии PHP 5.5.0, и будет удалено в будущем. Используйте вместо него MySQLi или PDO_MySQL. Смотрите также инструкцию MySQL: выбор API и соответствующий FAQ для получения более подробной информации. Альтернативы для данной функции:
Описание
$query
[, resource $link_identifier = NULL
] )
mysql_unbuffered_query() посылает запрос MySQL
query без автоматической обработки и буферизации
её результата, в отличие от функции mysql_query().
Это позволяет сохранить достаточно большое количество памяти для
SQL-запросов, возвращающих большое количество данных. Кроме того, вы
можете начать работу с полученными данными сразу после того, как первый
ряд был получен: вам не приходится ждать до конца SQL-запроса. При
использовании mysql_unbuffered_query() с несколькими
соединениями MySQL, вы должны указать необязательный параметр
link_identifier.
Список параметров
-
query -
Запускаемый SQL-запрос.
Данные в запросе должны быть корректно проэкранированы.
-
link_identifier -
Соединение MySQL. Если идентификатор соединения не был указан, используется последнее соединение, открытое mysql_connect(). Если такое соединение не было найдено, функция попытается создать таковое, как если бы mysql_connect() была вызвана без параметров. Если соединение не было найдено и не смогло быть создано, генерируется ошибка уровня
E_WARNING.
Возвращаемые значения
Для SELECT, SHOW, DESCRIBE и EXPLAIN запросов
mysql_unbuffered_query()
возвращает resource в случае успеха, или FALSE
в случае ошибки.
Для остальных типов SQL-запросов, UPDATE, DELETE, DROP и т.д.,
mysql_unbuffered_query() возвращает TRUE в случае
успеха и FALSE в случае ошибки.
Примечания
Замечание:
Однако, плюсы использования mysql_unbuffered_query() имеют свою цену: вы не можете использовать функции mysql_num_rows() и mysql_data_seek() с результатом запроса, возвращённым этой функцией, пока не будут получены все ряды. Кроме того, вы должны будете обработать все ряды запроса до отправки нового запроса, используя тот же
link_identifier.
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Расширения для работы с базами данных
- Расширения для работы с базами данных отдельных производителей
- MySQL Drivers and Plugins
- Оригинальное API MySQL
- mysql_affected_rows
- mysql_client_encoding
- mysql_close
- mysql_connect
- mysql_create_db
- mysql_data_seek
- mysql_db_name
- mysql_db_query
- mysql_drop_db
- mysql_errno
- mysql_error
- mysql_escape_string
- mysql_fetch_array
- mysql_fetch_assoc
- mysql_fetch_field
- mysql_fetch_lengths
- mysql_fetch_object
- mysql_fetch_row
- mysql_field_flags
- mysql_field_len
- mysql_field_name
- mysql_field_seek
- mysql_field_table
- mysql_field_type
- mysql_free_result
- mysql_get_client_info
- mysql_get_host_info
- mysql_get_proto_info
- mysql_get_server_info
- mysql_info
- mysql_insert_id
- mysql_list_dbs
- mysql_list_fields
- mysql_list_processes
- mysql_list_tables
- mysql_num_fields
- mysql_num_rows
- mysql_pconnect
- mysql_ping
- mysql_query
- mysql_real_escape_string
- mysql_result
- mysql_select_db
- mysql_set_charset
- mysql_stat
- mysql_tablename
- mysql_thread_id
- mysql_unbuffered_query
Коментарии
Don't let the two hands confuse you, these are both advantages (they should really be on the same hand):
On the one hand, this saves a considerable amount of memory with SQL queries that produce large result sets.
On the other hand, you can start working on the result set immediately ...
If using optimized MyISAM tables I guess there is a big advantage with this function as it is possible to do selects and inserts on the same time as long as no rows in the table gets updated.You are NOT required to read all rows from the resultset when using unbuffered query, you may opt out at any time and use mysql_free_result. Imagine looking at 1 million row when the first 50 suffice? Just free the result and you are good to go again.