sqlsrv_send_stream_data

Статья
06/02/2023

Отправляет данные из потоков параметров на сервер. С каждым вызовом sqlsrv_send_stream_data отправляется до 8 килобайт (8 КБ) данных.

Примечание

По умолчанию все потоковые данные передаются на сервер при выполнении запроса. Если это поведение по умолчанию не изменялось, использовать sqlsrv_send_stream_data для отправки потоковых данных на сервер не нужно. Сведения об изменении такого поведения по умолчанию см. разделе "Параметры" статьи sqlsrv_query или sqlsrv_prepare.

Синтаксис

  
sqlsrv_send_stream_data( resource $stmt)

Параметры

$stmt: ресурс инструкции, соответствующий выполненной инструкции.

Возвращаемое значение

Логическое значение: true при наличии дополнительных данных для отправки. В противном случае — false.

Пример

Следующий пример открывает обзор продукта в качестве потока и отправляет его на сервер. Поведение по умолчанию, заключающееся в отправке всех потоковых данных во время выполнения, отключено. В примере предполагается, что SQL Server и базы данных AdventureWorks установлены на локальном компьютере. При выполнении примера из командной строки все выходные данные выводятся в консоль.

<?php  
/* Connect to the local server using Windows Authentication and  
specify the AdventureWorks database as the database in use. */  
$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));  
}  
  
/* Define the query. */  
$tsql = "UPDATE Production.ProductReview   
         SET Comments = (?)   
         WHERE ProductReviewID = 3";  
  
/* Open parameter data as a stream and put it in the $params array. */
$data = 'Insert any lengthy comment here.';
$comment = fopen('data:text/plain,'.urlencode($data), 'r');
$params = array(&$comment);
  
/* Prepare the statement. Use the $options array to turn off the  
default behavior, which is to send all stream data at the time of query  
execution. */  
$options = array("SendStreamParamsAtExec"=>0);  
$stmt = sqlsrv_prepare($conn, $tsql, $params, $options);
  
/* Execute the statement. */  
sqlsrv_execute( $stmt);  
  
/* Send up to 8K of parameter data to the server with each call to  
sqlsrv_send_stream_data. Count the calls. */  
$i = 1;  
while (sqlsrv_send_stream_data($stmt)) {
      echo "$i call(s) made.\n";  
      $i++;  
}  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt( $stmt);  
sqlsrv_close( $conn);  
?>

См. также:

Справочник по API для драйвера SQLSRV

Обновление данных (драйверы Майкрософт для PHP для SQL Server)

Информация о примерах кода в документации

Share via