sybase_unbuffered_query

説明

resource sybase_unbuffered_query ( string query, resource link_identifier [, bool store_result] )

成功時に正の Sybase 結果 ID 、エラー時に FALSE を返します。

sybase_unbuffered_query() は、指定したリンク ID に 関連付けられたサーバ上の現在アクティブなデータベースにクエリを送信します。 リンク ID が指定されていない場合は、直近にオープンされたリンクが 指定されたものと仮定します。リンクがオープンされていない場合は、 sybase_connect() がコールされた場合と同様の手順で リンクのオープンを試み、それを使用します。

sybase_query() とは異なり、 sybase_unbuffered_query() は結果セットの最初の 行のみを読み込みます。それ以降の行は、必要に応じて sybase_fetch_array() またはそれに類する関数で 読み込みます。sybase_data_seek() は指定した 行を読み込みます。この挙動により、大きな結果セットを扱う際に よりよいパフォーマンスを確保できます。

sybase_num_rows() が正確な行数を返すのは、結果セット 全体が読み込まれた場合のみです。Sybase は行数を知ることができず、 クライアントの実装によって行数を計算しています。

結果セットをメモリ中に読み込む必要がないことを指示するため、 オプションの store_result に FALSE を 指定することが可能です。これによってメモリの使用量を抑えることができ、 大きな結果セットを扱う場合に有用です。

例 1. sybase_unbuffered_query() の例 <?php $dbh = sybase_connect('SYBASE', '', ''); $q = sybase_unbuffered_query('select firstname, lastname from huge_table', $dbh, false); sybase_data_seek($q, 10000); $i = 0; while ($row = sybase_fetch_row($q)) {     echo $row[0], ' ', $row[1], '<br />';     if ($i++ > 40000) {         break;     } } sybase_free_result($q); sybase_close($dbh); ?>

sybase_query() も参照ください。