array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.sqlsrv-query.php', 1 => 'sqlsrv_query', 2 => 'Prepara e executa uma consulta', ), 'up' => array ( 0 => 'ref.sqlsrv.php', 1 => 'Funções SQLSRV', ), 'prev' => array ( 0 => 'function.sqlsrv-prepare.php', 1 => 'sqlsrv_prepare', ), 'next' => array ( 0 => 'function.sqlsrv-rollback.php', 1 => 'sqlsrv_rollback', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/sqlsrv/functions/sqlsrv-query.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

sqlsrv_query

(No version information available, might only be in Git)

sqlsrv_query — Prepara e executa uma consulta

Descrição

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

Prepara e executa uma consulta.

Parâmetros

conn
Um recurso de conexão retornado por sqlsrv_connect().
sql
A string que define a consulta a ser preparada e executada.
params

Um array especificando informações de parâmetro ao executar uma consulta parametrizada. Os elementos do array podem ser um dos seguintes:

  • Um valor literal
  • Uma variável PHP
  • Um array com esta estrutura: array($valor [, $direção [, $tipoPHP [, $tipoSQL]]])
A tabela a seguir descreve os elementos na estrutura do array acima:

Estrutura do array
Elemento Descrição
$value Um valor literal, uma variável PHP ou uma variável PHP por referência.
$direction (opcional) Uma das constantes SQLSRV usadas para indicar a direção do parâmetro: SQLSRV_PARAM_IN, SQLSRV_PARAM_OUT, SQLSRV_PARAM_INOUT. O valor padrão é SQLSRV_PARAM_IN.
$phpType (opcional) Uma constante SQLSRV_PHPTYPE_* que especifica o tipo de dado PHP do valor retornado.
$sqlType (opcional) Uma constante SQLSRV_SQLTYPE_* que especifica o tipo de dado do SQL Server do valor de entrada.
options
Um array especificando opções de propriedade da consulta. As chaves suportadas são descritas na tabela a seguir:
Opções de Consulta
Chave Valores Descrição
QueryTimeout Um valor inteiro positivo. Define o tempo limite da consulta em segundos. Por padrão, o driver aguardará indefinidamente por resultados.
SendStreamParamsAtExec true ou false (o padrão é true) Configura o driver para enviar todos os dados de fluxo na execução (true), ou para enviar os dados de fluxo em blocos (false). Por padrão, o valor é true. Para mais informações, consulte sqlsrv_send_stream_data().
Scrollable SQLSRV_CURSOR_FORWARD, SQLSRV_CURSOR_STATIC, SQLSRV_CURSOR_DYNAMIC, ou SQLSRV_CURSOR_KEYSET Veja » Especificar um Tipo de Cursor e Selecionar Linhas na documentação do Microsoft SQLSRV.

Valor Retornado

Retorna um recurso de declaração em caso de sucesso e false se ocorrer um erro.

Exemplos

Exemplo #1 Exemplo de 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));
}
?>

Notas

Para declarações que você planeja executar apenas uma vez, use sqlsrv_query(). Se você pretende reexecutar uma declaração com diferentes valores de parâmetro, use a combinação de sqlsrv_prepare() e sqlsrv_execute().

Veja Também