<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.pdo-sqlsrv.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'ref.pdo-sqlsrv.connection.php',
    1 => 'PDO_SQLSRV DSN',
    2 => 'Conexi&oacute;n a bases de datos MS SQL Server y SQL Azure',
  ),
  'up' => 
  array (
    0 => 'ref.pdo-sqlsrv.php',
    1 => 'Controlador PDO MS SQL Server',
  ),
  'prev' => 
  array (
    0 => 'ref.pdo-sqlsrv.php',
    1 => 'Controlador PDO MS SQL Server',
  ),
  'next' => 
  array (
    0 => 'ref.pdo-oci.php',
    1 => 'Controlador PDO Oracle',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/pdo_sqlsrv/reference.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="ref.pdo-sqlsrv.connection" class="refentry">
  <div class="refnamediv">
   <h1 class="refname">PDO_SQLSRV DSN</h1>
   <p class="verinfo">(PECL pdo_sqlsrv &gt;= 2.0.1)</p><p class="refpurpose"><span class="refname">PDO_SQLSRV DSN</span> &mdash; <span class="dc-title">Conexión a bases de datos MS SQL Server y SQL Azure</span></p>

  </div>

  <div class="refsect1 description" id="refsect1-ref.pdo-sqlsrv.connection-description">
   <h3 class="title">Descripción</h3>
   <p class="para">
    El archivo DSN (Data Source Name) PDO_SQLSRV se compone de los siguientes elementos:
    <dl>
     
      <dt>prefijo DSN</dt>
      <dd>
       <p class="para">
        El prefijo DSN es <strong class="userinput"><code>sqlsrv:</code></strong>.
       </p>
      </dd>
     
     
      <dt><code class="literal">APP</code></dt>
      <dd>
       <span class="simpara">
        El nombre de la aplicación, utilizado para las trazas.
       </span>
      </dd>
     
     
      <dt><code class="literal">ConnectionPooling</code></dt>
      <dd>
       <span class="simpara">
        Especifica si la conexión está asignada a un pool de conexiones
        (1 o <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>) o no (0 o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>).
       </span>
      </dd>
     
     
      <dt><code class="literal">Database</code></dt>
      <dd>
       <span class="simpara">
        El nombre de la base de datos.
       </span>
      </dd>
     
     
      <dt><code class="literal">Encrypt</code></dt>
      <dd>
       <span class="simpara">
        Especifica si la comunicación con el servidor SQL Server está cifrada
        (1 o <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>) o no cifrada (0 o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>).
       </span>
      </dd>
     
     
      <dt><code class="literal">Failover_Partner</code></dt>
      <dd>
       <span class="simpara">
        Especifica el servidor y la instancia de la base de datos espejo (si está
        activada y configurada) a utilizar cuando el servidor principal es
        inaccesible.
       </span>
      </dd>
     
     
      <dt><code class="literal">LoginTimeout</code></dt>
      <dd>
       <span class="simpara">
        Especifica el número de segundos de espera antes de detener y poner en
        error el intento de conexión.
       </span>
      </dd>
     
     
      <dt><code class="literal">MultipleActiveResultSets</code></dt>
      <dd>
       <span class="simpara">
        Desactiva, o activa explícitamente, el soporte para juegos de resultados
        múltiples (Multiple Active Result Sets, MARS).
       </span>
      </dd>
     
     
      <dt><code class="literal">QuotedId</code></dt>
      <dd>
       <span class="simpara">
        Especifica si se deben utilizar las reglas SQL-92 para los identificadores
        entre comillas (1 o <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>) o si se deben utilizar las reglas Transact-SQL estándar (0 o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>).
       </span>
      </dd>
     
     
      <dt><code class="literal">Server</code></dt>
      <dd>
       <span class="simpara">
        El nombre del servidor de base de datos.
       </span>
      </dd>
     
     
      <dt><code class="literal">TraceFile</code></dt>
      <dd>
       <span class="simpara">
        La ruta del archivo utilizado para las trazas.
       </span>
      </dd>
     
     
      <dt><code class="literal">TraceOn</code></dt>
      <dd>
       <span class="simpara">
        Especifica si las trazas ODBC están activadas (1 o <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>) o desactivadas
        (0 o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>) al activar la conexión.
       </span>
      </dd>
     
     
      <dt><code class="literal">TransactionIsolation</code></dt>
      <dd>
       <span class="simpara">
        Especifica el nivel de aislamiento de la transacción. Los valores posibles
        para esta opción son
        PDO::SQLSRV_TXN_READ_UNCOMMITTED, PDO::SQLSRV_TXN_READ_COMMITTED,
        PDO::SQLSRV_TXN_REPEATABLE_READ, PDO::SQLSRV_TXN_SNAPSHOT, y
        PDO::SQLSRV_TXN_SERIALIZABLE.
       </span>
      </dd>
     
     
      <dt><code class="literal">TrustServerCertificate</code></dt>
      <dd>
       <span class="simpara">
        Especifica si el cliente debe confiar (1 o <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>) o rechazar
        (0 o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>) un certificado servidor autosignado.
       </span>
      </dd>
     
     
      <dt><code class="literal">WSID</code></dt>
      <dd>
       <span class="simpara">
        Especifica el nombre de la computadora para las trazas.
       </span>
      </dd>
     
    </dl>
   </p>
  </div>


  <div class="refsect1 examples" id="refsect1-ref.pdo-sqlsrv.connection-examples">
   <h3 class="title">Ejemplos</h3>
   <div class="example" id="example-1">
    <p><strong>Ejemplo #1 Ejemplos de DSN PDO_SQLSRV</strong></p>
    <div class="example-contents"><p>
     El siguiente ejemplo muestra cómo conectarse a la base de datos MS SQL Server especificada:
     <div class="example-contents">
<div class="cdata"><pre>
$c = new PDO(&quot;sqlsrv:Server=localhost;Database=bddtest&quot;, &quot;Utilisateur&quot;, &quot;MotDePasse&quot;);
</pre></div>
     </div>

    </p></div>
    <div class="example-contents"><p>
     El siguiente ejemplo muestra cómo conectarse a la base de datos MS SQL Server especificada
     en un puerto específico:
     <div class="example-contents">
<div class="cdata"><pre>
$c = new PDO(&quot;sqlsrv:Server=localhost,1521;Database=bddtest&quot;, &quot;Utilisateur&quot;, &quot;MotDePasse&quot;);
</pre></div>
     </div>

    </p></div>
    <div class="example-contents"><p>
     El siguiente ejemplo muestra cómo conectarse a una base de datos SQL Azure con
     el ID servidor 12345abcde. Tenga en cuenta que, al conectarse a Azure con PDO,
     su nombre de usuario será Utilisateur@12345abcde (Utilisateur@IdServidor).
     <div class="example-contents">
<div class="cdata"><pre>
$c = new PDO(&quot;sqlsrv:Server=12345abcde.database.windows.net;Database=bddtest&quot;, &quot;Utilisateur@12345abcde&quot;, &quot;MotDePasse&quot;);
</pre></div>
     </div>

    </p></div>
   </div>
  </div>

 </div><?php manual_footer($setup); ?>