sqlsrv_query

(사용 가능한 버전 정보가 없으며 Git에만 있을 수 있음)

sqlsrv_query — 쿼리 준비 및 실행

sqlsrv_query(
    resource $conn,
    string $sql,
    array $params = ?,
    array $options = ?
): mixed
                

쿼리를 준비하고 실행합니다.


매개변수

conn
sqlsrv_connect()에서 반환된 연결 리소스입니다.
sql
준비하고 실행할 쿼리를 정의하는 문자열입니다.
params
매개변수화된 쿼리를 실행할 때 매개변수 정보를 지정하는 배열입니다. 배열 요소는 다음 중 하나일 수 있습니다.
  • 리터럴 값
  • PHP 변수
  • 다음 구조의 배열: array($value [, $direction [, $phpType [, $sqlType]]])

다음 표에서는 위의 배열 구조에 있는 요소에 대해 설명합니다.

배열 구조

Element 설명
$value 리터럴 값, PHP 변수 또는 PHP 참조 변수입니다.
$direction (optional) 매개 변수 방향을 나타내는 데 사용되는 SQLSRV 상수 중 하나: SQLSRV_PARAM_IN, SQLSRV_PARAM_OUT, SQLSRV_PARAM_INOUT. 기본값은 SQLSRV_PARAM_IN입니다.
$phpType (optional) 반환된 값의 PHP 데이터 유형을 지정하는 SQLSRV_PHPTYPE_* 상수입니다.
$sqlType (optional) 입력 값의 SQL Server 데이터 형식을 지정하는 SQLSRV_SQLTYPE_* 상수입니다.
options
쿼리 속성 옵션을 지정하는 배열입니다. 지원되는 키는 다음 표에 설명되어 있습니다.

쿼리 옵션

Key Values 설명
QueryTimeout 양의 정수 값입니다. 쿼리 시간 초과를 초 단위로 설정합니다. 기본적으로 드라이버는 결과를 무기한 기다립니다.
SendStreamParamsAtExec true 또는 false(기본값은 true) 실행 시 모든 스트림 데이터를 보내거나(true) 스트림 데이터를 청크로 보내도록(false) 드라이버를 구성합니다. 기본적으로 값은 true로 설정됩니다. 자세한 내용은 sqlsrv_send_stream_data()를 참조하십시오.
Scrollable SQLSRV_CURSOR_FORWARD, SQLSRV_CURSOR_STATIC, SQLSRV_CURSOR_DYNAMIC 또는 SQLSRV_CURSOR_KEYSET Microsoft SQLSRV 문서에서 » 커서 유형 지정 및 행 선택을 참조하세요.

반환 값

성공하면 명령문 리소스를 반환하고 오류가 발생하면 false를 반환합니다.


Examples

예제 #1 sqlsrv_query() 예제

                  
<?php
$serverName = "serverName\sqlexpress";
$connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password" );
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false ) {
     die( print_r( sqlsrv_errors(), true));
}

$sql = "INSERT INTO Table_1 (id, data) VALUES (?, ?)";
$params = array(1, "some data");

$stmt = sqlsrv_query( $conn, $sql, $params);
if( $stmt === false ) {
     die( print_r( sqlsrv_errors(), true));
}
?>
                  
                

메모

한 번만 실행하려는 명령문의 경우 sqlsrv_query()를 사용하십시오. 매개변수 값이 다른 명령문을 다시 실행하려는 경우 sqlsrv_prepare()sqlsrv_execute() 조합을 사용하십시오.


기타