<?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 => 'ru',
  ),
  'this' => 
  array (
    0 => 'ref.pdo-sqlsrv.connection.php',
    1 => 'DSN-строка подключения через драйвер PDO_SQLSRV',
    2 => 'Подключение к базам данных MS SQL Server и SQL Azure',
  ),
  'up' => 
  array (
    0 => 'ref.pdo-sqlsrv.php',
    1 => 'PDO-драйвер СУБД MS SQL Server',
  ),
  'prev' => 
  array (
    0 => 'ref.pdo-sqlsrv.php',
    1 => 'PDO-драйвер СУБД MS SQL Server',
  ),
  'next' => 
  array (
    0 => 'ref.pdo-oci.php',
    1 => 'PDO-драйвер СУБД Oracle',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    '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">DSN-строка подключения через драйвер PDO_SQLSRV</h1>
   <p class="verinfo">(No version information available, might only be in Git)</p><p class="refpurpose"><span class="refname">DSN-строка подключения через драйвер PDO_SQLSRV</span> &mdash; <span class="dc-title">Подключение к базам данных MS SQL Server и SQL Azure</span></p>

  </div>

  <div class="refsect1 description" id="refsect1-ref.pdo-sqlsrv.connection-description">
   <h3 class="title">Описание</h3>
   <p class="para">
    DSN-строка подключения (англ. сокр.: Data Source Name — имя источника данных)
    для драйвера PDO_SQLSRV состоит из следующих элементов:
    <dl>
     
      <dt>DSN-префикс</dt>
      <dd>
       <p class="para">
        DSN-префикс — строка <strong class="userinput"><code>sqlsrv:</code></strong>.
       </p>
      </dd>
     
     
      <dt><code class="literal">APP</code></dt>
      <dd>
       <span class="simpara">
        Имя приложения для трассировки.
       </span>
      </dd>
     
     
      <dt><code class="literal">ConnectionPooling</code></dt>
      <dd>
       <span class="simpara">
        Определяет, назначается ли соединение из пула соединений:
        1 или <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>, если да, 0 или <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">
        Название базы данных.
       </span>
      </dd>
     
     
      <dt><code class="literal">Encrypt</code></dt>
      <dd>
       <span class="simpara">
        Определяет, шифруются ли соединение с SQL Server:
        1 или <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>, если да, 0 или <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">
        Определяет сервер и экземпляр зеркала базы данных (если включили и настроили)
        при недоступности первичного сервера.
       </span>
      </dd>
     
     
      <dt><code class="literal">LoginTimeout</code></dt>
      <dd>
       <span class="simpara">
        Время ожидания подключения в секундах.
       </span>
      </dd>
     
     
      <dt><code class="literal">MultipleActiveResultSets</code></dt>
      <dd>
       <span class="simpara">
        Отключает или явно включает режим MARS (англ. сокр.: Multiple Active Result Sets),
        который поддерживает множественные активные результирующие наборы.
       </span>
      </dd>
     
     
      <dt><code class="literal">QuotedId</code></dt>
      <dd>
       <span class="simpara">
        Определяет, применять ли к идентификаторам в кавычках
        правила стандарта SQL-92: 1 или <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>, или применять устаревшие
        правила стандарта Transact-SQL: 0 или <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">
        Имя сервера базы данных.
       </span>
      </dd>
     
     
      <dt><code class="literal">TraceFile</code></dt>
      <dd>
       <span class="simpara">
        Путь до файла для данных трассировки.
       </span>
      </dd>
     
     
      <dt><code class="literal">TraceOn</code></dt>
      <dd>
       <span class="simpara">
        Определяет, включается ли для соединения, которое устанавливает драйвер,
        функция ODBC-трассировки: 1 или <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>, если да, 0 или <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>, если нет.
       </span>
      </dd>
     
     
      <dt><code class="literal">TransactionIsolation</code></dt>
      <dd>
       <span class="simpara">
        Уровень изоляции транзакций. Опция принимает следующие значения:
        PDO::SQLSRV_TXN_READ_UNCOMMITTED, PDO::SQLSRV_TXN_READ_COMMITTED,
        PDO::SQLSRV_TXN_REPEATABLE_READ, PDO::SQLSRV_TXN_SNAPSHOT
        и PDO::SQLSRV_TXN_SERIALIZABLE.
       </span>
      </dd>
     
     
      <dt><code class="literal">TrustServerCertificate</code></dt>
      <dd>
       <span class="simpara">
        Опредяляет, примет ли клиент самоподписанный сертификат сервера или отклонит:
        1 или <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> — доверять, 0 или <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> — отклонять.
       </span>
      </dd>
     
     
      <dt><code class="literal">WSID</code></dt>
      <dd>
       <span class="simpara">
        Имя компьютера для трассировки.
       </span>
      </dd>
     
    </dl>
   </p>
  </div>


  <div class="refsect1 examples" id="refsect1-ref.pdo-sqlsrv.connection-examples">
   <h3 class="title">Примеры</h3>
   <div class="example" id="example-1">
    <p><strong>Пример #1 Примеры DSN-строки подключения через драйвер PDO_SQLSRV</strong></p>
    <div class="example-contents"><p>
     Следующий пример показывает, как подключаться к конкретной базе данных MS SQL Server:
     <div class="example-contents">
<div class="cdata"><pre>
$c = new PDO(&quot;sqlsrv:Server=localhost;Database=testdb&quot;, &quot;UserName&quot;, &quot;Password&quot;);
</pre></div>
     </div>

    </p></div>
    <div class="example-contents"><p>
     Следующий пример показывает, как подключаться к базе данных MS SQL Server
     на конкретном порте:
     <div class="example-contents">
<div class="cdata"><pre>
$c = new PDO(&quot;sqlsrv:Server=localhost,1521;Database=testdb&quot;, &quot;UserName&quot;, &quot;Password&quot;);
</pre></div>
     </div>

    </p></div>
    <div class="example-contents"><p>
     Следующий пример показывает, как подключиться к базе данных SQL Azure с идентификатором
     сервера 12345abcde. Примечание: при соединении к БД SQL Azure через модуль PDO
     имя пользователя передают в формате UserName@ServerId: UserName@12345abcde.
     <div class="example-contents">
<div class="cdata"><pre>
$c = new PDO(&quot;sqlsrv:Server=12345abcde.database.windows.net;Database=testdb&quot;, &quot;UserName@12345abcde&quot;, &quot;Password&quot;);
</pre></div>
     </div>

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

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