方法:SQLSRV ドライバーを使用して文字データをストリームとして取得する

PHP ドライバーのダウンロード

ストリームとしてのデータの取得は、Microsoft SQL Server 用 Drivers for PHP の SQLSRV ドライバーでのみ使用でき、PDO_SQLSRV ドライバーでは使用できません。

SQLSRV ドライバーは、サーバーから大量のデータの取得に PHP ストリームを利用します。 このトピックの例では、ストリームとして文字データを取得する方法を示します。

例

次の例では、AdventureWorks データベースの Production.ProductReview テーブルから行を取得します。 返された行の Comments フィールドはストリームとして取得され、PHP fpassthru 関数を使用して表示されます。

ストリームとしてのデータの取得は、戻り値の型を文字ストリームとして指定した sqlsrv_fetch および sqlsrv_get_field を使用して行われます。 戻り値の型は、定数 SQLSRV_PHPTYPE_STREAM を使用して指定します。 sqlsrv 定数の詳細については、「定数 (Microsoft Drivers for PHP for SQL Server)」を参照してください。

この例では、ローカル コンピューターに 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));  
}  
  
/* Set up the Transact-SQL query. */  
$tsql = "SELECT ReviewerName,   
               CONVERT(varchar(32), ReviewDate, 107) AS [ReviewDate],  
               Rating,   
               Comments   
         FROM Production.ProductReview   
         WHERE ProductReviewID = ? ";  
  
/* Set the parameter value. */  
$productReviewID = 1;  
$params = array( $productReviewID);  
  
/* Execute the query. */  
$stmt = sqlsrv_query($conn, $tsql, $params);  
if( $stmt === false )  
{  
     echo "Error in statement execution.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Retrieve and display the data. The first three fields are retrieved  
as strings and the fourth as a stream with character encoding. */  
if(sqlsrv_fetch( $stmt ) === false )  
{  
     echo "Error in retrieving row.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
echo "Name: ".sqlsrv_get_field( $stmt, 0 )."\n";  
echo "Date: ".sqlsrv_get_field( $stmt, 1 )."\n";  
echo "Rating: ".sqlsrv_get_field( $stmt, 2 )."\n";  
echo "Comments: ";  
$comments = sqlsrv_get_field( $stmt, 3,   
                             SQLSRV_PHPTYPE_STREAM(SQLSRV_ENC_CHAR));  
fpassthru($comments);  
  
/* Free the statement and connection resources. */  
sqlsrv_free_stmt( $stmt);  
sqlsrv_close( $conn);  
?>  

最初の 3 つのフィールドには PHP の戻り値の型が指定されていないので、各フィールドの既定の PHP の型で返されます。 既定の PHP データ型の詳細については、「 Default PHP Data Types」を参照してください。 PHP の戻り値の型の指定方法の詳細については、「 How to: Specify PHP Data Types」を参照してください。

参照

データの取得

SQLSRV ドライバーを使用してデータをストリームとして取得する

ドキュメントのコード例について