sqlsrv_fetch_array

[アーティクル]
06/02/2023

次のデータ行を数値インデックス配列、連想配列、またはその両方として取得します。

構文

  
sqlsrv_fetch_array( resource $stmt[, int $fetchType [, row[, ]offset]])

パラメーター

$stmt: 実行されたステートメントに対応するステートメントリソース。

$fetchType [省略可能]: 定義済みの定数。このパラメーターには、次の表に示すいずれかの値を指定できます。

値	説明
SQLSRV_FETCH_NUMERIC	次のデータ行は数値の配列として返されます。
SQLSRV_FETCH_ASSOC	次のデータ行は連想配列として返されます。配列キーは、結果セットの列名です。
SQLSRV_FETCH_BOTH	次のデータ行は数値配列と連想配列の両方として返されます。これが既定値です。

row [省略可能]: バージョン 1.1 で追加されました。次の値のいずれかで、スクロール可能なカーソルを使用して結果セットにアクセスする行を指定します (row を指定するときは、既定値を指定した場合でも、fetchtype を明示的に指定する必要があります。)

SQLSRV_SCROLL_NEXT
SQLSRV_SCROLL_PRIOR
SQLSRV_SCROLL_FIRST
SQLSRV_SCROLL_LAST
SQLSRV_SCROLL_ABSOLUTE
SQLSRV_SCROLL_RELATIVE

これらの値の詳細については、「カーソルの種類を指定し、行を選択する」を参照してください。 Microsoft SQL Server 用 Drivers for PHPのバージョン 1.1 に、スクロール可能なカーソルのサポートが追加されました。

offset [省略可能]: SQLSRV_SCROLL_ABSOLUTE および SQLSRV_SCROLL_RELATIVE と共に使用して、取得する行を指定します。結果セットの最初のレコードは 0 です。

戻り値

データ行が取得された場合は、配列が返されます。取得する行がなくなった場合、 null が返されます。エラーが発生した場合は、 false が返されます。

$fetchType パラメーターの値に基づき、返される配列は数値インデックス配列、連想配列、またはその両方になる可能性があります。既定では、数値キーと連想キーの両方の配列が返されます。返される配列の値のデータ型は、既定の PHP データ型になります。既定の PHP データ型の詳細については、「 Default PHP Data Types」を参照してください。

解説

名前のない列が返された場合、配列要素の連想キーは空の文字列 ("") になります。たとえば、データベーステーブルに値を挿入し、サーバーが生成したプライマリキーを取得する、この Transact-SQL ステートメントがあります。

INSERT INTO Production.ProductPhoto (LargePhoto) VALUES (?);  
SELECT SCOPE_IDENTITY()

このステートメントの SELECT SCOPE_IDENTITY() 部分によって返される結果セットが連想配列として取得される場合、返される列には名前がないので、返される値のキーは空の文字列 ("") になります。これを回避するには、結果を数値配列として取得するか、または返される列の名前を Transact-SQL ステートメントに指定します。次のステートメントは、Transact-SQL に列名を指定する方法の 1 つです。

SELECT SCOPE_IDENTITY() AS PictureID

結果セットに名前のない複数の列が含まれている場合は、名前のない最後の列の値が、空の文字列 ("") キーに割り当てられます。

連想配列の例

次の例では、結果セットの各行を連想配列として取得します。この例では、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 and execute the query. */  
$tsql = "SELECT FirstName, LastName  
         FROM Person.Contact  
         WHERE LastName='Alan'";  
$stmt = sqlsrv_query( $conn, $tsql);  
if( $stmt === false)  
{  
     echo "Error in query preparation/execution.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Retrieve each row as an associative array and display the results.*/  
while( $row = sqlsrv_fetch_array( $stmt, SQLSRV_FETCH_ASSOC))  
{  
      echo $row['LastName'].", ".$row['FirstName']."\n";  
}  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt( $stmt);  
sqlsrv_close( $conn);  
?>

インデックス付き配列の例

次の例では、結果セットの各行を数値インデックス配列として取得します。

この例では、指定日で在庫数 (StockQty) が指定値より少ない製品の情報を AdventureWorks データベースの Purchasing.PurchaseOrderDetail テーブルから取得します。

この例では、ローカルコンピューターに 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 = "SELECT ProductID,  
                UnitPrice,  
                StockedQty   
         FROM Purchasing.PurchaseOrderDetail  
         WHERE StockedQty < 3   
         AND DueDate='2002-01-29'";  
  
/* Execute the query. */  
$stmt = sqlsrv_query( $conn, $tsql);  
if ( $stmt )  
{  
     echo "Statement executed.\n";  
}   
else   
{  
     echo "Error in statement execution.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Iterate through the result set printing a row of data upon each  
iteration.*/  
while( $row = sqlsrv_fetch_array( $stmt, SQLSRV_FETCH_NUMERIC))  
{  
     echo "ProdID: ".$row[0]."\n";  
     echo "UnitPrice: ".$row[1]."\n";  
     echo "StockedQty: ".$row[2]."\n";  
     echo "-----------------\n";  
}  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt( $stmt);  
sqlsrv_close( $conn);  
?>

sqlsrv_fetch_array 関数は、常に Default PHP Data Types パラメーターに基づいてデータを返します。 PHP データ型を指定する方法については、「方法: PHP データ型を指定する」を参照してください。

名前のないフィールドが取得された場合、配列要素の連想キーは空の文字列 ("") になります。詳細については、「 sqlsrv_fetch_array」を参照してください。