(No version information available, might only be in Git)
sqlsrv_query — Prepara e executa uma consulta
Prepara e executa uma consulta.
connUm recurso de conexão retornado por sqlsrv_connect().
sqlA string que define a consulta a ser preparada e executada.
paramsUm array especificando informações de parâmetro ao executar uma consulta parametrizada. Os elementos do array podem ser um dos seguintes:
| 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. |
optionsUm array especificando opções de propriedade da consulta. As chaves suportadas são descritas na tabela a seguir:
| 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. |
Retorna um recurso de declaração em caso de sucesso e false se ocorrer um erro.
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));
}
?>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().