<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/pdo.drivers.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'ref.pdo-sqlsrv.php',
    1 => 'Driver PDO do Microsoft SQL Server',
    2 => 'Driver PDO do Microsoft SQL Server (PDO_SQLSRV)',
  ),
  'up' => 
  array (
    0 => 'pdo.drivers.php',
    1 => 'Drivers do PDO',
  ),
  'prev' => 
  array (
    0 => 'pdo-mysql.getwarningcount.php',
    1 => 'Pdo\\Mysql::getWarningCount',
  ),
  'next' => 
  array (
    0 => 'ref.pdo-sqlsrv.connection.php',
    1 => 'PDO_SQLSRV DSN',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/pdo_sqlsrv/reference.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/ref.pdo-sqlsrv.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="ref.pdo-sqlsrv" class="reference">
 
  <h1 class="title">Driver PDO do Microsoft SQL Server (PDO_SQLSRV)</h1>
  
  <div class="partintro">

   <div class="section" id="pdo-sqlsrv.intro">
   <h2 class="title">Introdução</h2>
    <p class="simpara">
     PDO_SQLSRV é um driver que implementa a interface aos <a href="book.pdo.php#intro.pdo" class="link"> Objetos
     de Dados PHP (PDO)</a>
     para permitir acesso do PHP a bancos de dados MS SQL Server (iniciando com o SQL Server 2005)
     e SQL Azure.
    </p>
   </div>
   

<div class="section" id="ref.pdo-sqlsrv.installation">
 <h2 class="title">Instalação</h2>
 <p class="simpara">
  A versão mais recente do driver está disponível aqui:
  <a href="http://msdn.microsoft.com/en-us/sqlserver/ff657782.aspx" class="link external">&raquo;&nbsp;SQLSRV</a>.
  O código-fonte do driver está hospedado em um <a href="https://github.com/microsoft/msphpsql" class="link external">&raquo;&nbsp;repositório público</a>.
 </p>
 <p class="simpara">
  Para mais informações sobre requisitos do sistema, consulte
  <a href="http://msdn.microsoft.com/en-us/library/cc296170.aspx" class="link external">&raquo;&nbsp;Requisitos de Sistema para o SQLSRV</a>.
 </p>
 <p class="simpara">
  No Windows, a extensão PDO_SQLSRV é habilitado pela adição dos
  arquivos DLL apropriados ao diretório de extensões do PHP e da entrada
  correspondente no arquivo <var class="filename">php.ini</var>.
 </p>
 <p class="simpara">
  No Linux e no macOS, a extensão PDO_SQLSRV pode ser instalada usando o
  <a href="https://pecl.php.net/" class="link external">&raquo;&nbsp;PECL</a>.
  Consulte o <a href="https://docs.microsoft.com/en-us/sql/connect/php/installation-tutorial-linux-mac" class="link external">&raquo;&nbsp;tutorial de instalação</a>
  para detalhes.
 </p>
</div>


   

<div class="section" id="pdo-sqlsrv.constants">
 <h2 class="title">Constantes predefinidas</h2>
 <p class="simpara">As constantes abaixo são definidas por
este driver e só estarão disponíveis quando a extensão tiver sido
compilada no PHP ou tiver sido carregada dinamicamente em tempo de execução. Além disso, estas
constantes específicas do driver só devem ser usadas se este driver estiver sendo usado.
Usar atributos específicos de um driver com outro driver pode resultar em
comportamento inesperado. <span class="function"><a href="pdo.getattribute.php" class="function">PDO::getAttribute()</a></span> pode ser usada para
obter o atributo <strong><code><a href="pdo.constants.php#pdo.constants.attr-driver-name">PDO::ATTR_DRIVER_NAME</a></code></strong> para verificar o
driver, se o código puder ser executado com vários drivers.</p>
 <dl>
  
   <dt id="pdo.constants.sqlsrv-txn-read-uncommitted">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-txn-read-uncommitted">PDO::SQLSRV_TXN_READ_UNCOMMITTED</a></code></strong>
     (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Essa constante é um valor aceitável para a chave TransactionIsolation do DSN SQLSRV.
     Esta constante define o nível de isolamento da transação para a conexão como
     Read Uncommitted.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-txn-read-committed">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-txn-read-committed">PDO::SQLSRV_TXN_READ_COMMITTED</a></code></strong>
     (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Essa constante é um valor aceitável para a chave TransactionIsolation do DSN SQLSRV.
     Esta constante define o nível de isolamento da transação para a conexão como
     Leitura Confirmada.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-txn-repeatable-read">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-txn-repeatable-read">PDO::SQLSRV_TXN_REPEATABLE_READ</a></code></strong>
     (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Essa constante é um valor aceitável para a chave TransactionIsolation do DSN SQLSRV.
     Esta constante define o nível de isolamento da transação para a conexão como
     Leitura Repetível.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-txn-snapshot">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-txn-snapshot">PDO::SQLSRV_TXN_SNAPSHOT</a></code></strong>
     (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Essa constante é um valor aceitável para a chave TransactionIsolation do DSN SQLSRV.
     Esta constante define o nível de isolamento da transação para a conexão como Snapshot.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-txn-serializable">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-txn-serializable">PDO::SQLSRV_TXN_SERIALIZABLE</a></code></strong>
     (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Essa constante é um valor aceitável para a chave TransactionIsolation do DSN SQLSRV.
     Esta constante define o nível de isolamento da transação para a conexão como
     Serializável.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-encoding-binary">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-encoding-binary">PDO::SQLSRV_ENCODING_BINARY</a></code></strong>
     (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Especifica que os dados são enviados/recuperados como um fluxo de bytes brutos de/para o servidor
     sem realizar codificação ou tradução. Essa constante pode ser passada para
     PDOStatement::setAttribute, PDO::prepare, PDOStatement::bindColumn e
     PDOStatement::bindParam.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-encoding-system">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-encoding-system">PDO::SQLSRV_ENCODING_SYSTEM</a></code></strong>
     (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Especifica que os dados são enviados/recuperados de/para o servidor como caracteres de 8 bits,
     conforme especificado na página de código da localidade do Windows definida no sistema.
     Quaisquer caracteres multibyte ou caracteres que não sejam mapeados nesta página de códigos
     serão substituídos por um caractere de ponto de interrogação (?) de byte único. Essa constante
     pode ser passada para PDOStatement::setAttribute, PDO::setAttribute, PDO::prepare,
     PDOStatement::bindColumn e PDOStatement::bindParam.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-encoding-utf8">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-encoding-utf8">PDO::SQLSRV_ENCODING_UTF8</a></code></strong>
     (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Especifica que os dados são enviados/recuperados de/para o servidor na codificação UTF-8.
     Esta é a codificação padrão. Essa constante pode ser passada para
     PDOStatement::setAttribute, PDO::setAttribute, PDO::prepare,
     PDOStatement::bindColumn e PDOStatement::bindParam.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-encoding-default">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-encoding-default">PDO::SQLSRV_ENCODING_DEFAULT</a></code></strong>
     (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Especifica que os dados são enviados/recuperados de/para o servidor de acordo com
     PDO::SQLSRV_ENCODING_SYSTEM se especificado durante a conexão. A codificação da
     conexão é usada se especificada em uma instrução de preparação. Essa constante pode ser
     passada para PDOStatement::setAttribute, PDO::setAttribute, PDO::prepare,
     PDOStatement::bindColumn e PDOStatement::bindParam.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-attr-query-timeout">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-attr-query-timeout">PDO::SQLSRV_ATTR_QUERY_TIMEOUT</a></code></strong>
     (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Um número inteiro não negativo que representa o período de tempo limite, em segundos. Zero (0)
     é o padrão e significa que não há tempo limite. Essa constante pode ser passada para
     PDOStatement::setAttribute, PDO::setAttribute e PDO::prepare.
    </span>
   </dd>
  
  
   <dt id="pdo.constants.sqlsrv-attr-direct-query">
    <strong><code><a href="ref.pdo-sqlsrv.php#pdo.constants.sqlsrv-attr-direct-query">PDO::SQLSRV_ATTR_DIRECT_QUERY</a></code></strong>
     (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Indica que uma instrução deve ser executada diretamente, sem estar preparada.
     Essa constante pode ser passada para PDO::setAttribute e PDO::prepare. Para obter mais
     informações, consulte
     <a href="http://msdn.microsoft.com/en-us/library/ff754356.aspx" class="link external">&raquo;&nbsp;Execução de instrução direta e preparada</a>.
    </span>
   </dd>
  
 </dl>
</div>



  </div>

  

 <h2>Índice</h2><ul class="chunklist chunklist_reference"><li><a href="ref.pdo-sqlsrv.connection.php">PDO_SQLSRV DSN</a> — Conectando-se aos bancos de dados MS SQL Server e SQL Azure</li></ul>
</div>
<?php manual_footer($setup); ?>