如何：在使用 SQLSRV 驱动程序时指定 SQL Server 数据类型

项目
06/02/2023

本主题演示如何使用 SQLSRV 驱动程序为发送到服务器的数据指定 SQL Server 数据类型。本主题不适用于使用 PDO_SQLSRV 驱动程序的情况。

若要指定 SQL Server 数据类型，必须在准备或执行可插入或更新数据的查询时使用可选的 $params 数组。有关 $params 数组的结构和语法的详细信息，请参阅 sqlsrv_query 或 sqlsrv_prepare。

以下步骤总结了如何在将数据发送到服务器时指定 SQL Server 数据类型：

注意

如果没有指定任何 SQL Server 数据类型，将使用默认类型。有关默认 SQL Server 数据类型的信息，请参阅 Default SQL Server Data Types。

定义可插入或更新数据的 Transact-SQL 查询。将作为占位符的问号 (?) 用于查询中的参数值。
初始化或更新对应于 Transact-SQL 查询中的占位符的 PHP 变量。
构建要在准备或执行查询时使用的 $params 数组。请注意，在指定 SQL Server 数据类型时， $params 数组的每个元素必须也是一个数组。
通过将相应的 SQLSRV_SQLTYPE_* 常量用作 $params 数组的每个子数组中的第四个参数，指定所需的 SQL Server 数据类型。有关 SQLSRV_SQLTYPE_* 常量的完整列表，请参阅常量 (Microsoft Drivers for PHP for SQL Server) 的 SQLTYPE 部分。例如，在下列代码中， $changeDate、 $rate和 $payFrequency 分别指定为 $params数组中的 SQL Server 类型 datetime、 money 和 tinyint 。因为没有为 $employeeId 指定任何 SQL Server 类型，并且该类型初始化为一个整数，所以将使用默认的 SQL Server 类型 integer 。
```
$employeeId = 5;  
$changeDate = "2005-06-07";  
$rate = 30;  
$payFrequency = 2;  
$params = array(  
            array($employeeId, null),  
            array($changeDate, null, null, SQLSRV_SQLTYPE_DATETIME),  
            array($rate, null, null, SQLSRV_SQLTYPE_MONEY),  
            array($payFrequency, null, null, SQLSRV_SQLTYPE_TINYINT)  
          );  
```

示例

以下示例将数据插入 AdventureWorks 数据库的 HumanResources.EmployeePayHistory 表中。为 $changeDate、 $rate和 $payFrequency 参数指定 SQL Server 类型。将默认 SQL Server 类型用于 $employeeId 参数。若要验证数据是否已成功插入，请检索和显示相同的数据。

该示例假定已在本地计算机上安装了 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. */  
$tsql1 = "INSERT INTO HumanResources.EmployeePayHistory (EmployeeID,  
                                                        RateChangeDate,  
                                                        Rate,  
                                                        PayFrequency)  
           VALUES (?, ?, ?, ?)";  
  
/* Construct the parameter array. */  
$employeeId = 5;  
$changeDate = "2005-06-07";  
$rate = 30;  
$payFrequency = 2;  
$params1 = array(  
               array($employeeId, null),  
               array($changeDate, null, null, SQLSRV_SQLTYPE_DATETIME),  
               array($rate, null, null, SQLSRV_SQLTYPE_MONEY),  
               array($payFrequency, null, null, SQLSRV_SQLTYPE_TINYINT)  
           );  
  
/* Execute the INSERT query. */  
$stmt1 = sqlsrv_query($conn, $tsql1, $params1);  
if( $stmt1 === false )  
{  
     echo "Error in execution of INSERT.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Retrieve the newly inserted data. */  
/* Define the query. */  
$tsql2 = "SELECT EmployeeID, RateChangeDate, Rate, PayFrequency  
          FROM HumanResources.EmployeePayHistory  
          WHERE EmployeeID = ? AND RateChangeDate = ?";  
  
/* Construct the parameter array. */  
$params2 = array($employeeId, $changeDate);  
  
/*Execute the SELECT query. */  
$stmt2 = sqlsrv_query($conn, $tsql2, $params2);  
if( $stmt2 === false )  
{  
     echo "Error in execution of SELECT.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Retrieve and display the results. */  
$row = sqlsrv_fetch_array( $stmt2 );  
if( $row === false )  
{  
     echo "Error in fetching data.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
echo "EmployeeID: ".$row['EmployeeID']."\n";  
echo "Change Date: ".date_format($row['RateChangeDate'], "Y-m-d")."\n";  
echo "Rate: ".$row['Rate']."\n";  
echo "PayFrequency: ".$row['PayFrequency']."\n";  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt($stmt1);  
sqlsrv_free_stmt($stmt2);  
sqlsrv_close($conn);  
?>

另请参阅

如何：使用内置 UTF-8 支持发送和检索 UTF-8 数据

通过

如何：在使用 SQLSRV 驱动程序时指定 SQL Server 数据类型

示例

另请参阅

反馈

反馈

其他资源