使用游标进行PHP SQLSRV查询的方法与注意事项

游标类型

您可以使用Scrollable来指定结果集的游标，以实现各种以顺序访问结果集中的任何行。下表列出了可以传递给Scrollable的选项。

OptionDescriptionSQLSRV_CURSOR_FORWARD允许您从结果集的第一行开始一次移动一行，直到到达结果集的末尾。这是默认的游标类型。 sqlsrv_num_rows将返回一个错误。 forward;是SQLSRV_CURSOR_FORWARD的缩写形式。SQLSRV_CURSOR_STATIC允许您以任何顺序访问行，但不会反映数据库中的更改。 static;是SQLSRV_CURSOR_STATIC的缩写形式。SQLSRV_CURSOR_DYNAMIC允许您以任何顺序访问行，并反映数据库中的更改。 sqlsrv_num_rows将返回一个错误。 dynamic;是SQLSRV_CURSOR_DYNAMIC的缩写形式。SQLSRV_CURSOR_KEYSET允许您以任何顺序访问行。但是，如果从表中删除了一行，键集游标不会更新行计数（删除的行返回时没有值）。 keyset;是SQLSRV_CURSOR_KEYSET的缩写形式。SQLSRV_CURSOR_CLIENT_BUFFERED允许您以任何顺序访问行。创建客户端游标查询。 buffered;是SQLSRV_CURSOR_CLIENT_BUFFERED的缩写形式。

如果查询生成多个结果集，则Scrollable选项应用于所有结果集。

选择结果集中的行

创建结果集后，就可以使用sqlsrv_fetch、sqlsrv_fetch_array或sqlsrv_fetch_object来指定行了。

下表说明了可以对行进行的操作。

参数描述SQLSRV_SCROLL_NEXT指定下一行。SQLSRV_SCROLL_PRIOR指定当前行之前的行。SQLSRV_SCROLL_FIRST指定结果集中的第一行。SQLSRV_SCROLL_LAST指定结果集中的最后一行。SQLSRV_SCROLL_ABSOLUTE指定指定的行抵消参数。SQLSRV_SCROLL_RELATIVE指定指定的行抵消当前行中的参数。

SQLSRV Driver之服务端游标

以下示例显示了各种游标的效果。在示例的第33行，您可以看到指定不同游标的三条查询语句中的第一条。其中两个查询语句被注释。每次运行程序时，使用不同的游标类型查看第47行上的数据库更新效果。

<?php
$server = \”server_name\”;
$conn = sqlsrv_connect( $server, array( \’Database\’ => \’test\’ ));
if ( $conn === false ) {
die( print_r( sqlsrv_errors(), true ));
}
$stmt = sqlsrv_query( $conn, \”DROP TABLE dbo.ScrollTest\” );
if ( $stmt !== false ) {
sqlsrv_free_stmt( $stmt );
}
$stmt = sqlsrv_query( $conn, \”CREATE TABLE ScrollTest (id int, value char(10))\” );
if ( $stmt === false ) {
die( print_r( sqlsrv_errors(), true ));
}
$stmt = sqlsrv_query( $conn, \”INSERT INTO ScrollTest (id, value) VALUES(?,?)\”, array( 1, \”Row 1\” ));
if ( $stmt === false ) {
die( print_r( sqlsrv_errors(), true ));
}
$stmt = sqlsrv_query( $conn, \”INSERT INTO ScrollTest (id, value) VALUES(?,?)\”, array( 2, \”Row 2\” ));
if ( $stmt === false ) {
die( print_r( sqlsrv_errors(), true ));
}
$stmt = sqlsrv_query( $conn, \”INSERT INTO ScrollTest (id, value) VALUES(?,?)\”, array( 3, \”Row 3\” ));
if ( $stmt === false ) {
die( print_r( sqlsrv_errors(), true ));
}
$stmt = sqlsrv_query( $conn, \”SELECT * FROM ScrollTest\”, array(), array( \”Scrollable\” => \’keyset\’ ));
// $stmt = sqlsrv_query( $conn, \”SELECT * FROM ScrollTest\”, array(), array( \”Scrollable\” => \’dynamic\’ ));
// $stmt = sqlsrv_query( $conn, \”SELECT * FROM ScrollTest\”, array(), array( \”Scrollable\” => \’static\’ ));
$rows = sqlsrv_has_rows( $stmt );
if ( $rows != true ) {
die( \”Should have rows\” );
}
$result = sqlsrv_fetch( $stmt, SQLSRV_SCROLL_LAST );
$field1 = sqlsrv_get_field( $stmt, 0 );
$field2 = sqlsrv_get_field( $stmt, 1 );
echo \”\\n$field1 $field2\\n\”;
$stmt2 = sqlsrv_query( $conn, \”delete from ScrollTest where id = 3\” );
// or
// $stmt2 = sqlsrv_query( $conn, \”UPDATE ScrollTest SET id = 4 WHERE id = 3\” );
if ( $stmt2 !== false ) {
sqlsrv_free_stmt( $stmt2 );
}
$result = sqlsrv_fetch( $stmt, SQLSRV_SCROLL_LAST );
$field1 = sqlsrv_get_field( $stmt, 0 );
$field2 = sqlsrv_get_field( $stmt, 1 );
echo \”\\n$field1 $field2\\n\”;
sqlsrv_free_stmt( $stmt );
sqlsrv_close( $conn );
?>

SQLSRV Driver之客户端游标

客户端游标是Microsoft Drivers for PHP for SQL Server 3.0版中添加的一项功能，它允许您在内存中缓存整个结果集。使用客户端游标执行查询后，行计数可用。

客户端游标应该用于中小型结果集。对大型结果集使用服务器端游标。

如果缓冲区不够大，无法容纳整个结果集，则查询将返回false。您可以将缓冲区大小增加到PHP内存限制。

使用SQLSRV驱动程序，可以使用sqlsrv_configure来设置ClientBufferMaxKBSize以配置保存结果集的缓冲区的大小。

sqlsrv_get_config返回ClientBufferMaxKBSize的值。

您还可以在php.ini文件中使用sqlsrv.ClientBufferMaxKBSize来设置最大缓冲区大小（例如，sqlsrv.clientBufferMaxKBSign=1024）。

以下示例显示：

1、行计数始终可用于客户端游标。

2、使用客户端游标和批处理语句。

<?php
$serverName = \”(local)\”;
$connectionInfo = array(\”Database\”=>\”AdventureWorks\”);
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if ( $conn === false ) {
echo \”Could not connect.\\n\”;
die( print_r( sqlsrv_errors(), true));
}
$tsql = \”select * from HumanResources.Department\”;
// Execute the query with client-side cursor.
$stmt = sqlsrv_query($conn, $tsql, array(), array(\”Scrollable\”=>\”buffered\”));
if (! $stmt) {
echo \”Error in statement execution.\\n\”;
die( print_r( sqlsrv_errors(), true));
}
// row count is always available with a client-side cursor
$row_count = sqlsrv_num_rows( $stmt );
echo \”\\nRow count = $row_count\\n\”;
// Move to a specific row in the result set.
$row = sqlsrv_fetch($stmt, SQLSRV_SCROLL_FIRST);
$EmployeeID = sqlsrv_get_field( $stmt, 0);
echo \”Employee ID = $EmployeeID \\n\”;
// Client-side cursor and batch statements
$tsql = \”select top 2 * from HumanResources.Employee;Select top 3 * from HumanResources.EmployeeAddress\”;
$stmt = sqlsrv_query($conn, $tsql, array(), array(\”Scrollable\”=>\”buffered\”));
if (! $stmt) {
echo \”Error in statement execution.\\n\”;
die( print_r( sqlsrv_errors(), true));
}
$row_count = sqlsrv_num_rows( $stmt );
echo \”\\nRow count for first result set = $row_count\\n\”;
$row = sqlsrv_fetch($stmt, SQLSRV_SCROLL_FIRST);
$EmployeeID = sqlsrv_get_field( $stmt, 0);
echo \”Employee ID = $EmployeeID \\n\”;
sqlsrv_next_result($stmt);
$row_count = sqlsrv_num_rows( $stmt );
echo \”\\nRow count for second result set = $row_count\\n\”;
$row = sqlsrv_fetch($stmt, SQLSRV_SCROLL_LAST);
$EmployeeID = sqlsrv_get_field( $stmt, 0);
echo \”Employee ID = $EmployeeID \\n\”;
?>