sqlsrv_send_stream_data
パラメータ ストリームからサーバーにデータを送信します。sqlsrv_send_stream_data を呼び出すたびに、最大 8 KB のデータが送信されます。
注意
既定では、クエリの実行時にすべてのストリーム データがサーバーに送信されます。この既定の動作を変更しない限り、ストリーム データをサーバーに送信するために 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. */
$comment = fopen( "data://text/plain,[ Insert lengthy comment.]", "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 リファレンス (SQL Server Driver for PHP)
データの更新 (SQL Server Driver for PHP)