PDO_SQLSRV DSN
(PECL pdo_sqlsrv >= 2.0.1)
PDO_SQLSRV DSN — Connecting to MS SQL Server and SQL Azure databases
Beschreibung
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 orfalse
). -
Database
-
The name of the database.
-
Encrypt
-
Specifies whether the communication with SQL Server is encrypted (1 or
true
) or unencrypted (0 orfalse
). -
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 orfalse
). -
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 orfalse
) 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 orfalse
) a self-signed server certificate. -
WSID
-
Specifies the name of the computer for tracing.
Beispiele
Beispiel #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");