# PDO_SQLSRV DSN

(PECL pdo_sqlsrv >= 2.0.1)

PDO_SQLSRV DSN — Connecting to MS SQL Server and SQL Azure databases

### Description

The PDO_SQLSRV Data Source Name (DSN) is composed of the following elements:

DSN prefix

  The DSN prefix is `sqlsrv:`.

`APP`

  The application name used in tracing.

`ConnectionPooling`

  Specifies whether the connection is assigned from a connection pool (1 or `TRUE`) or not (0 or `FALSE`).

`Database`

  The name of the database.

`Encrypt`

  Specifies whether the communication with SQL Server is encrypted (1 or `TRUE`) or unencrypted (0 or `FALSE`).

`Failover_Partner`

  Specifies the server and instance of the database's mirror (if enabled and configured) to use when the primary server is unavailable.

`LoginTimeout`

  Specifies the number of seconds to wait before failing the connection attempt.

`MultipleActiveResultSets`

  Disables or explicitly enables support for multiple active Result sets (MARS).

`QuotedId`

  Specifies whether to use SQL-92 rules for quoted identifiers (1 or `TRUE`) or to use legacy Transact-SQL rules (0 or `FALSE`).

`Server`

  The name of the database server.

`TraceFile`

  Specifies the path for the file used for trace data.

`TraceOn`

  Specifies whether ODBC tracing is enabled (1 or `TRUE`) or disabled (0 or `FALSE`) for the connection being established.

`TransactionIsolation`

  Specifies the transaction isolation level. The accepted values for this option are PDO::SQLSRV_TXN_READ_UNCOMMITTED, PDO::SQLSRV_TXN_READ_COMMITTED, PDO::SQLSRV_TXN_REPEATABLE_READ, PDO::SQLSRV_TXN_SNAPSHOT, and PDO::SQLSRV_TXN_SERIALIZABLE.

`TrustServerCertificate`

  Specifies whether the client should trust (1 or `TRUE`) or reject (0 or `FALSE`) a self-signed server certificate.

`WSID`

  Specifies the name of the computer for tracing.

### Examples

Example #1 PDO_SQLSRV DSN examples

The following example shows how to connecto to a specified MS SQL Server database:

    $c = new PDO("sqlsrv:Server=localhost;Database=testdb", "UserName", "Password");

The following example shows how to connect to a MS SQL Server database on a specified port:

    $c = new PDO("sqlsrv:Server=localhost,1521;Database=testdb", "UserName", "Password");

The following example shows how to connecto to a SQL Azure database with server ID 12345abcde. Note that when you connect to SQL Azure with PDO, your username will be UserName@12345abcde (UserName@ServerId).

    $c = new PDO("sqlsrv:Server=12345abcde.database.windows.net;Database=testdb", "UserName@12345abcde", "Password");