PDO_SQLSRV 驱动程序中的直接语句执行和预定语句执行

  • 项目

下载 PHP 驱动程序

本主题讨论如何使用 PDO::SQLSRV_ATTR_DIRECT_QUERY 属性指定直接语句执行而非默认执行，即已准备的语句执行。 如果使用参数绑定多次执行准备的语句，那么使用此语句可以提升性能。

注解

若要将 Transact-SQL 语句直接发送到服务器，而无需由驱动程序进行语句准备，可以使用 PDO::setAttribute 或在调用 PDO::prepare 时设置 PDO::SQLSRV_ATTR_DIRECT_QUERY 属性（或作为传递到 PDO::__construct 的驱动程序选项）。 PDO::SQLSRV_ATTR_DIRECT_QUERY 的默认值为 False（即使用准备的语句执行）。

如果使用 PDO::query，不妨设置直接语句执行。 调用 PDO::query 前，请先调用 PDO::setAttribute，并将 PDO::SQLSRV_ATTR_DIRECT_QUERY 设置为 True。 每次调用 PDO::query 都可以使用不同的 PDO::SQLSRV_ATTR_DIRECT_QUERY 设置来执行。

如果你使用 PDO::prepare 和 PDOStatement::execute 通过绑定参数多次执行查询，准备的语句执行会优化重复查询的执行。 在这种情况下，调用 PDO::prepare，同时在驱动程序选项数组参数中将 PDO::SQLSRV_ATTR_DIRECT_QUERY 设置为 False。 必要时，可以通过将 PDO::SQLSRV_ATTR_DIRECT_QUERY 设置为 False 来执行准备的语句。

调用 PDO::prepare 后，不能在执行准备的查询时更改 PDO::SQLSRV_ATTR_DIRECT_QUERY 的值。

如果查询需要在上一个查询中设置的上下文，请通过将 PDO::SQLSRV_ATTR_DIRECT_QUERY 设置为 True 来执行查询。 例如，如果在查询中使用临时表，必须将 PDO::SQLSRV_ATTR_DIRECT_QUERY 设置为 True。

下面的示例表明，如果需要上一个语句中的上下文，必须将 PDO::SQLSRV_ATTR_DIRECT_QUERY 设置为 True。 此示例使用临时表，这些表仅在直接执行查询时对程序中的后续语句可用。

注意

如果查询用于调用存储过程，且此存储过程中使用了临时表，请改用 PDO::exec。

<?php  
   $conn = new PDO('sqlsrv:Server=(local)', '', '');  
   $conn->setAttribute(constant('PDO::SQLSRV_ATTR_DIRECT_QUERY'), true);  
  
   $stmt1 = $conn->query("DROP TABLE #php_test_table");  
  
   $stmt2 = $conn->query("CREATE TABLE #php_test_table ([c1_int] int, [c2_int] int)");  
  
   $v1 = 1;  
   $v2 = 2;  
  
   $stmt3 = $conn->prepare("INSERT INTO #php_test_table (c1_int, c2_int) VALUES (:var1, :var2)");  
  
   if ($stmt3) {  
      $stmt3->bindValue(1, $v1);  
      $stmt3->bindValue(2, $v2);  
  
      if ($stmt3->execute())  
         echo "Execution succeeded\n";       
      else  
         echo "Execution failed\n";  
   }  
   else  
      var_dump($conn->errorInfo());  
  
   $stmt4 = $conn->query("DROP TABLE #php_test_table");  
?>

另请参阅

Microsoft Drivers for PHP for SQL Server 编程指南