Tipi di cursore (driver SQLSRV)
Il driver SQLSRV consente di creare un set di risultati con righe a cui si può accedere in qualsiasi ordine, a seconda del tipo di cursore. In questo argomento vengono illustrati i cursori lato client (memorizzati nel buffer) e lato server (senza buffer).
Tipi di cursore
Quando si crea un set di risultati con sqlsrv_query o con sqlsrv_prepare, è possibile specificare il tipo di cursore. Per impostazione predefinita viene usato un cursore forward-only, che consente di spostarsi di una riga alla volta a partire dalla prima riga del set di risultati fino a raggiungere la fine del set di risultati.
È possibile creare un set di risultati con un cursore scorrevole, che consente di accedere a qualsiasi riga del set di risultati in qualsiasi ordine. Nella tabella seguente sono elencati i valori che è possibile passare all'opzione Scrollable in sqlsrv_query o sqlsrv_prepare.
| Opzione | Descrizione |
|---|---|
| SQLSRV_CURSOR_FORWARD | Consente di spostarsi di una riga alla volta a partire dalla prima riga del set di risultati fino a raggiungere la fine del set di risultati. È il tipo di cursore predefinito. sqlsrv_num_rows restituisce un errore per i set di risultati creati con questo tipo di cursore. forward è la forma abbreviata di SQLSRV_CURSOR_FORWARD. |
| SQLSRV_CURSOR_STATIC | Consente di accedere alle righe in qualsiasi ordine ma non riflette le modifiche nel database. static è la forma abbreviata di SQLSRV_CURSOR_STATIC. |
| SQLSRV_CURSOR_DYNAMIC | Consente di accedere alle righe in qualsiasi ordine e riflette le modifiche nel database. sqlsrv_num_rows restituisce un errore per i set di risultati creati con questo tipo di cursore. dynamic è la forma abbreviata di SQLSRV_CURSOR_DYNAMIC. |
| SQLSRV_CURSOR_KEYSET | Consente di accedere alle righe in qualsiasi ordine. Tuttavia un cursore keyset non aggiorna il conteggio delle righe se dalla tabella viene eliminata una riga (una riga eliminata viene restituita senza alcun valore). keyset è la forma abbreviata di SQLSRV_CURSOR_KEYSET. |
| SQLSRV_CURSOR_CLIENT_BUFFERED | Consente di accedere alle righe in qualsiasi ordine. Crea una query basata sul cursore sul lato client. buffered è la forma abbreviata di SQLSRV_CURSOR_CLIENT_BUFFERED. |
Se una query genera più set di risultati, l'opzione Scrollable viene applicata a tutti i set di risultati.
Selezione di righe in un set di risultati
Dopo aver creato un set di risultati, è possibile usare sqlsrv_fetch, sqlsrv_fetch_array o sqlsrv_fetch_object per specificare una riga.
Nella tabella seguente sono descritti i valori che è possibile specificare nel parametro row.
| Parametro | Descrizione |
|---|---|
| SQLSRV_SCROLL_NEXT | Specifica la riga successiva. Si tratta del valore predefinito se non si specifica il parametro row per un set di risultati scorrevole. |
| SQLSRV_SCROLL_PRIOR | Specifica la riga precedente a quella corrente. |
| SQLSRV_SCROLL_FIRST | Specifica la prima riga del set di risultati. |
| SQLSRV_SCROLL_LAST | Specifica l'ultima riga del set di risultati. |
| SQLSRV_SCROLL_ABSOLUTE | Indica la riga specificata con il parametro offset. |
| SQLSRV_SCROLL_RELATIVE | Indica la riga specificata con il parametro offset della riga corrente. |
Cursori lato server e driver SQLSRV
Nell'esempio seguente viene illustrato l'effetto dei diversi cursori. Alla riga 33 dell'esempio si può osservare la prima delle tre istruzioni di query che specificano cursori diversi. A due delle istruzioni di query è stato aggiunto un commento. Ogni volta che si esegue il programma, usare un tipo di cursore diverso per vedere l'effetto dell'aggiornamento del database alla riga 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 );
?>
Cursori lato client e driver SQLSRV
I cursori lato client sono una funzionalità aggiunta nella versione 3.0 dei driver Microsoft per PHP per SQL Server che consente di memorizzare nella cache un intero set di risultati in memoria. Il conteggio delle righe è disponibile dopo l'esecuzione della query quando si usa un cursore lato client.
È consigliabile usare i cursori lato client per set di risultati di piccole e medie dimensioni. Per set di risultati di grandi dimensioni, usare i cursori lato server.
Se le dimensioni del buffer non sono sufficienti a contenere l'intero set di risultati, una query restituirà false. Si possono aumentare le dimensioni del buffer fino al limite di memoria di PHP.
Con il driver SQLSRV è possibile configurare le dimensioni del buffer che contiene il set di risultati con l'impostazione ClientBufferMaxKBSize per sqlsrv_configure. sqlsrv_get_config restituisce il valore di ClientBufferMaxKBSize. Le dimensioni massime del buffer possono anche essere impostate nel file php.ini con sqlsrv.ClientBufferMaxKBSize (ad esempio, sqlsrv.ClientBufferMaxKBSize = 1024).
L'esempio seguente mostra:
Il conteggio delle righe è sempre disponibile con un cursore lato client.
Uso di cursori e istruzioni batch lato client.
<?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";
?>
Nell'esempio seguente viene illustrato un cursore lato client che usa sqlsrv_prepare e una dimensione del buffer client diversa.
<?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.Employee";
$stmt = sqlsrv_prepare( $conn, $tsql, array(), array("Scrollable" => SQLSRV_CURSOR_CLIENT_BUFFERED, "ClientBufferMaxKBSize" => 51200));
if (! $stmt ) {
echo "Statement could not be prepared.\n";
die( print_r( sqlsrv_errors(), true));
}
sqlsrv_execute( $stmt);
$row_count = sqlsrv_num_rows( $stmt );
if ($row_count)
echo "\nRow count = $row_count\n";
$row = sqlsrv_fetch($stmt, SQLSRV_SCROLL_FIRST);
if ($row ) {
$EmployeeID = sqlsrv_get_field( $stmt, 0);
echo "Employee ID = $EmployeeID \n";
}
?>
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per