sqlsrv_query

项目
06/02/2023

准备并执行语句。

语法

  
sqlsrv_query(resource $conn, string $tsql [, array $params [, array $options]])

参数

$conn：与已准备的语句相关联的连接资源。

$tsql：对应于已准备的语句的 Transact-SQL 表达式。

$params [可选]：对应于参数化查询中参数的值的阵列。该阵列的每个元素可以是以下项之一：

文字值。
PHP 变量。

具有以下结构的阵列：

array($value [, $direction [, $phpType [, $sqlType]]])

下表提供对阵列的每个元素的描述：

元素	说明
$value	参数值、PHP 变量或通过引用传递的 PHP 变量。
$direction[可选]	用于指示参数方向的以下 SQLSRV_PARAM_* 常量之一：_SQLSRV_PARAM_IN、SQLSRV_PARAM_OUT、SQLSRV_PARAM_INOUT。默认值为 SQLSRV_PARAM_IN 。有关 PHP 常量的详细信息，请参阅常量 (Microsoft Drivers for PHP for SQL Server)。
$phpType[可选]	SQLSRV_PHPTYPE_* 常量，用于指定返回的值的 PHP 数据类型。有关 PHP 常量的详细信息，请参阅常量 (Microsoft Drivers for PHP for SQL Server)。
$sqlType[可选]	SQLSRV_SQLTYPE_* 常量，用于指定输入值的 SQL Server 数据类型。有关 PHP 常量的详细信息，请参阅常量 (Microsoft Drivers for PHP for SQL Server)。

$options [可选]：设置查询属性的关联阵列。它是也受 sqlsrv_prepare 支持的相同键列表。

返回值

语句资源。如果无法创建和/或执行语句，将返回 false 。

备注

sqlsrv_query 函数非常适合一次性查询，并且应该是执行查询的默认选项，除非出现特殊情况。此函数提供了一个简化的方法，以便使用最少的代码来执行查询。 sqlsrv_query 函数可用于语句准备和语句执行，还可用于执行参数化查询。

有关详细信息，请参阅操作说明：使用 SQLSRV 驱动程序检索输出参数。

示例 1

在下面的示例中，向 AdventureWorks 数据库的 Sales.SalesOrderDetail 表格中插入单个行。该示例假定已在本地计算机上安装了 SQL Server 和 AdventureWorks 数据库。从命令行运行该示例时，所有输出都将写入控制台。

注意

尽管下面的示例使用 INSERT 语句来演示将 sqlsrv_query 用于执行一次性语句，但是上述概念适用于所有 Transact-SQL 语句。

<?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 parameterized query. */  
$tsql = "INSERT INTO Sales.SalesOrderDetail   
        (SalesOrderID,   
         OrderQty,   
         ProductID,   
         SpecialOfferID,   
         UnitPrice,   
         UnitPriceDiscount)  
        VALUES   
        (?, ?, ?, ?, ?, ?)";  
  
/* Set parameter values. */  
$params = array(75123, 5, 741, 1, 818.70, 0.00);  
  
/* Prepare and execute the query. */  
$stmt = sqlsrv_query($conn, $tsql, $params);  
if ($stmt) {  
    echo "Row successfully inserted.\n";  
} else {  
    echo "Row insertion failed.\n";  
    die(print_r(sqlsrv_errors(), true));  
}  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt($stmt);  
sqlsrv_close($conn);  
?>

示例 2

下面的示例将更新 AdventureWorks 数据库的 Sales.SalesOrderDetail 表格中的字段。该示例假定已在本地计算机上安装了 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 parameterized query. */  
$tsql = "UPDATE Sales.SalesOrderDetail   
         SET OrderQty = (?)   
         WHERE SalesOrderDetailID = (?)";  
  
/* Assign literal parameter values. */  
$params = array(5, 10);  
  
/* Execute the query. */  
if (sqlsrv_query($conn, $tsql, $params)) {  
    echo "Statement executed.\n";  
} else {  
    echo "Error in statement execution.\n";  
    die(print_r(sqlsrv_errors(), true));  
}  
  
/* Free connection resources. */  
sqlsrv_close($conn);  
?>

注意

当由于 PHP 的浮点数具有有限精确度而将值绑定到十进制或数值列以确保精确度和准确度时，建议将字符串用作输入。这同样适用于 bigint 列，尤其是在值超出整数范围的情况下。

示例 3

此代码示例演示如何将十进制值作为输入参数进行绑定。

<?php
$serverName = "(local)";
$connectionInfo = array("Database"=>"YourTestDB");  
$conn = sqlsrv_connect($serverName, $connectionInfo);  
if ($conn === false) {  
     echo "Could not connect.\n";  
     die(print_r(sqlsrv_errors(), true));  
}  

// Assume TestTable exists with a decimal field 
$input = "9223372036854.80000";
$params = array($input);
$stmt = sqlsrv_query($conn, "INSERT INTO TestTable (DecimalCol) VALUES (?)", $params);

sqlsrv_free_stmt($stmt);  
sqlsrv_close($conn);  

?>

示例 4

此代码示例演示如何创建 sql_variant 类型的表并提取插入的数据。

<?php
$server = 'serverName';
$dbName = 'databaseName';
$uid = 'yourUserName';
$pwd = 'yourPassword';

$options = array("Database"=>$dbName, "UID"=>$uid, "PWD"=>$pwd);
$conn = sqlsrv_connect($server, $options);
if($conn === false) {
    die(print_r(sqlsrv_errors(), true));
}

$tableName = 'testTable';
$query = "CREATE TABLE $tableName ([c1_int] sql_variant, [c2_varchar] sql_variant)";

$stmt = sqlsrv_query($conn, $query);
if($stmt === false) {
    die(print_r(sqlsrv_errors(), true));
}
sqlsrv_free_stmt($stmt);

$query = "INSERT INTO [$tableName] (c1_int, c2_varchar) VALUES (1, 'test_data')";
$stmt = sqlsrv_query($conn, $query);
if($stmt === false) {
    die(print_r(sqlsrv_errors(), true));
}
sqlsrv_free_stmt($stmt);

$query = "SELECT * FROM $tableName";
$stmt = sqlsrv_query($conn, $query);

if(sqlsrv_fetch($stmt) === false) {
    die(print_r(sqlsrv_errors(), true));
}

$col1 = sqlsrv_get_field($stmt, 0);
echo "First field:  $col1 \n";

$col2 = sqlsrv_get_field($stmt, 1);
echo "Second field:  $col2 \n";

sqlsrv_free_stmt($stmt);
sqlsrv_close($conn);

?>

预期的输出为：

First field:  1
Second field:  test_data

另请参阅