sqlsrv_query
문을 준비하고 실행합니다.
구문
sqlsrv_query(resource $conn, string $tsql [, array $params [, array $options]])
매개 변수
$conn: 준비된 문과 연결된 연결 리소스입니다.
$tsql: 준비된 문에 해당하는 Transact-SQL 식입니다.
$params [OPTIONAL]: 매개 변수가 있는 쿼리의 매개 변수에 해당하는 값 배열입니다. 배열의 각 요소는 다음 중 하나일 수 있습니다.
리터럴 값.
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[선택 사항] 반환된 값의 PHP 데이터 형식을 지정하는 SQLSRV_PHPTYPE_* 상수입니다.
PHP 상수에 대한 자세한 내용은 상수(Microsoft Drivers for PHP for SQL Server)를 참조하세요.$sqlType[선택 사항] 입력 값의 SQL Server 데이터 형식을 지정하는 SQLSRV_SQLTYPE_* 상수입니다.
PHP 상수에 대한 자세한 내용은 상수(Microsoft Drivers for PHP for SQL Server)를 참조하세요.
$options [선택 사항]: 쿼리 속성을 설정하는 결합형 배열입니다. sqlsrv_prepare 지원되는 동일한 키 목록입니다.
Return Value
문 리소스입니다. 명령문을 만들 수 없거나 실행할 수 없는 경우 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에서는 부동 소수점 숫자의 정밀도가 제한되어 있으므로 decimal 또는 numeric 열에 값을 바인딩할 때는 정밀도와 정확도를 보장하기 위해 문자열을 입력으로 사용하는 것이 좋습니다. 특히 값이 정수 범위를 벗어난 경우 bigint 열에도 동일하게 적용됩니다.
예제 3
이 코드 샘플에서는 10진수 값을 입력 매개 변수로 바인딩하는 방법을 보여줍니다.
<?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