Kapcsolati beállítások

PHP-illesztőprogram letöltése

Ez a témakör felsorolja az asszociatív tömbben engedélyezett opciókat (amikor a sqlsrv_connect parancsot használja az SQLSRV-illesztőben), vagy az adatforrásnév (dsn) engedélyezett kulcsszavait (amikor a PDO::__construct-t alkalmazza a PDO_SQLSRV-illesztőben).

Kapcsolati beállítások táblázata

Key	Érték	Description	Alapértelmezett
AccessToken	Lánc	Az OAuth JSON-válaszból kinyert Microsoft Entra hozzáférési jogkivonat bájtkarakterlánca. A kapcsolati sztring nem tartalmazhat felhasználói azonosítót, jelszót vagy kulcsszót Authentication . További információ: Csatlakozás Microsoft Entra-hitelesítéssel	Nincs beállítva.
alkalmazás	Lánc	A nyomkövetésben használt alkalmazásnevet adja meg.	Nincs beállítva.
Alkalmazási szándék	Lánc	Deklarálja az alkalmazás számítási feladatainak típusát a kiszolgálóhoz való csatlakozáskor. A lehetséges értékek ReadOnly és ReadWrite. További információ a Microsoft Drivers for PHP for SQL Server Always On rendelkezésre állási csoportokhoz való támogatásáról: Magas rendelkezésre állás támogatása, Vészhelyreállítás.	OlvasásÍrás
AttachDBFileName	Lánc	Megadja, hogy a kiszolgáló melyik adatbázisfájlt csatolja.	Nincs beállítva.
Authentication	Az alábbi karakterláncok egyike: SqlPassword ActiveDirectoryPassword ActiveDirectoryMsi Active Directory Szolgáltatás Főszereplő	Megadja a hitelesítési módot. További információ: Csatlakozás Microsoft Entra-hitelesítéssel	Nincs beállítva.
Karakterkészlet (a PDO_SQLSRV illesztőprogram nem támogatja)	Lánc	Megadja az adatok kiszolgálónak való küldéséhez használt karakterkészletet. A lehetséges értékek a SQLSRV_ENC_CHAR és az UTF-8. További információért lásd: Útmutató: UTF-8-adatok küldése és lekérése beépített UTF-8-támogatással.	SQLSRV_ENC_CHAR
Oszlopenkódolás	Az alábbiak közül egy szöveg: Engedélyezett Disabled Az igazolási protokollt azonosító sztring és az enklávé igazolásának URL-címe	Megadja, hogy az Always Encrypted funkció engedélyezve van-e. Ha igazolási protokoll és URL-cím van megadva, az Always Encrypted biztonságos enklávékkal engedélyezve van, feltéve, hogy a többi követelmény teljesül az Always Encrypted használata biztonságos enklávékkal az SQL Server PHP-illesztőprogramjaival című cikkben leírtak szerint.	Disabled
ConnectionPooling	1 vagy aktív a kapcsolatkészlet-kezeléshez. 0 vagy hamis a kapcsolatkészletezés kikapcsolása esetén.	Megadja, hogy a kapcsolat egy kapcsolatkészletből van-e hozzárendelve (1 vagy igaz), vagy nem (0 vagy hamis). 1	igaz (1)
ConnectRetryCount	Egész szám 0 és 255 között (beleértve)	A megszakadt kapcsolat újbóli létesítésére tett kísérletek maximális száma a feladás előtt. Alapértelmezés szerint a rendszer egyetlen kísérletet tesz egy kapcsolat újbóli létesítésére, ha megszakadt. A 0 érték azt jelenti, hogy a rendszer nem kísérel meg újracsatlakozást.	1
Újrakapcsolódási intervallum	Egész szám 1 és 60 között (beleértve)	A kapcsolat újbóli létesítésére tett kísérletek közötti idő másodpercben. Az alkalmazás a megszakadt kapcsolat észlelésekor azonnal megkísérli az újracsatlakozást, majd másodperceket vár ConnectRetryInterval , mielőtt újra próbálkozna. Ez a kulcsszó figyelmen kívül lesz hagyva, ha ConnectRetryCount 0-nak felel meg.	10
Adatbázis	Lánc	A2. kapcsolathoz használt adatbázis nevét adja meg.	A használt bejelentkezés alapértelmezett adatbázisa.
Decimális hely (a PDO_SQLSRV illesztőprogram nem támogatja)	Egész szám 0 és 4 között (beleértve)	A beolvasott pénzértékek formázásakor megadja a tizedeshelyek számát. Ez a beállítás csak akkor működik, ha FormatDecimals igaz. A rendszer figyelmen kívül hagyja a 4-nél nagyobb negatív egész számokat vagy értékeket.	Alapértelmezett pontosság és skálázás
Driver	Lánc	Az SQL Serverrel való kommunikációhoz használt Microsoft ODBC-illesztőt adja meg. A lehetséges értékek a következők: ODBC Driver 18 for SQL Server ODBC Driver 17 for SQL Server ODBC Driver 13 for SQL Server ODBC Driver 11 for SQL Server (csak Windows rendszeren).	Ha az illesztőprogram kulcsszó nincs megadva, az SQL Serverhez készült PHP-hez készült Microsoft Drivers megkísérli megkeresni a támogatott Microsoft ODBC-illesztőprogramokat a rendszerben, kezdve az ODBC legújabb verziójával, és így tovább.
Titkosít	1 vagy igaz a bekapcsolva lévő titkosításhoz. 0 vagy hamis a titkosítás kikapcsolásához.	Megadja, hogy az SQL Serverrel folytatott kommunikáció titkosított (1 vagy igaz) vagy titkosítatlan (0 vagy hamis)3.	hamis (0)
Átállási_Partner	Lánc	Megadja az adatbázis tükrözésének kiszolgálóját és példányát arra az esetre, ha az elsődleges kiszolgáló nem érhető el, feltéve, hogy a tükrözés engedélyezve és konfigurálva van. Failover_Partner használata korlátozásokkal jár MultiSubnetFailover. További információ: Magas rendelkezésre állás támogatása, Vészhelyreállítás. Ez a beállítás linuxos vagy macOS rendszeren nem támogatott, mert az adatbázis-tükrözést az ODBC-illesztő linuxos vagy macOS rendszeren nem támogatja. Ehelyett használja az Always On rendelkezésre állási csoportokat, és adja meg a MultiSubnetFailover és TransparentNetworkIPResolution beállításokat.	Nincs beállítva.
FormatDecimals (a PDO_SQLSRV illesztőprogram nem támogatja)	1 vagy true a beolvasott decimális sztringek formázásához. Az alapértelmezett decimális formázási viselkedés esetén 0 vagy hamis .	Megadja, hogy szükség esetén hozzá kell-e adni kezdő nullákat a decimális sztringekhez, és lehetővé teszi-e a DecimalPlaces pénztípusok formázását. Ha hamis marad, a rendszer az alapértelmezett viselkedést követi, amely a pontos értékvisszaadást alkalmazza, és 1-nél kisebb értékeknél elhagyja a kezdő nullákat. További információ: Decimális sztringek és pénzértékek formázása.	hamis (0)
KeyStoreAuthentication	KeyVaultPassword KeyVaultClientSecret	Hitelesítési módszer az Azure Key Vault eléréséhez. Azt szabályozza, hogy milyen típusú hitelesítő adatokkal használható a KeyStorePrincipalId és a KeyStoreSecret. További információ: Az Azure Key Vault használata.	Nincs beállítva.
KeyStorePrincipalId	Lánc	Az Azure Key Vault eléréséhez szükséges fiók azonosítója. Ha KeyStoreAuthenticationKeyVaultPassword, ennek az értéknek Microsoft Entra-felhasználónévnek kell lennie. Ha KeyStoreAuthenticationKeyVaultClientSecret, akkor ennek az értéknek egy alkalmazásügyfél-azonosítónak kell lennie.	Nincs beállítva.
KeyStoreSecret	Lánc	Az Azure Key Vaulthoz hozzáférni kívánó fiók hitelesítőadat-titkos kódja. Ha KeyStoreAuthenticationKeyVaultPassword, ennek az értéknek Microsoft Entra-jelszónak kell lennie. Ha KeyStoreAuthenticationa KeyVaultClientSecret érték, ennek az értéknek alkalmazás-ügyfél titkos kódnak kell lennie.	Nincs beállítva.
Nyelv	Lánc	A kiszolgáló által visszaadott üzenetek nyelvét adja meg. Az elérhető nyelvek szerepelnek a sys.syslanguages táblázatban. Ez a beállítás nem érinti az illesztőprogramok által használt nyelvet, mivel jelenleg csak angol nyelven érhetők el, és nincs hatással az alapul szolgáló ODBC-illesztőprogram nyelvére, amelynek nyelvét az ügyfélrendszerre telepített honosított verzió határozza meg. Ennek a beállításnak a módosítása miatt az üzenetek különböző nyelveken érkezhetnek, attól függően, hogy a PHP-illesztőprogramból, az ODBC-illesztőprogramból vagy az SQL Serverről származnak-e.	Az alapértelmezett az SQL Serverben beállított nyelv.
LoginTimeout	Egész szám (SQLSRV-illesztő) Karakterlánc (PDO_SQLSRV illesztő)	Megadja, hogy hány másodpercig kell várni a csatlakozási kísérlet meghiúsulása előtt.	Nincs időtúllépés.
Többszörös Aktív Eredménykészletek (MultipleActiveResultSets)	1 vagy igaz , ha több aktív eredményhalmazt használ. 0 vagy hamis több aktív eredményhalmaz letiltásához.	Letiltja vagy explicit módon engedélyezi több aktív eredményhalmaz (MARS) támogatását. További információért lásd: Hogyan letilthatja a több aktív eredményhalmazt (MARS).	igaz (1)
MultiSubnetFailover	Lánc	Mindig adja meg a multiSubnetFailover=yes paramétert, amikor az SQL Server 2012 (11.x) rendelkezésre állási csoport figyelőjéhez vagy egy SQL Server 2012 (11.x) feladatátvevő fürtpéldány figyelőjéhez csatlakozik. multiSubnetFailover=yes A Microsoft Drivers for PHP for SQL Server konfigurálja, hogy gyorsabb észlelést és kapcsolatot biztosítson az (jelenleg) aktív kiszolgálóhoz. Lehetséges értékek: Igen és Nem. További információ a Microsoft Drivers for PHP for SQL Server Always On rendelkezésre állási csoportokhoz való támogatásáról: Magas rendelkezésre állás támogatása, Vészhelyreállítás.	Nem
PWD (a PDO_SQLSRV illesztőprogram nem támogatja)	Lánc	Megadja az SQL ServerAuthentication 4-hez való csatlakozáskor használandó felhasználói azonosítóhoz társított jelszót.	Nincs beállítva.
QuotedId	SQL-92 szabályok használatához 1-et vagy igaz-at adjon meg. 0 vagy false a régi szabályok használatához.	Megadja, hogy az SQL-92-szabályokat idézőjeles azonosítókhoz (1 vagy igaz) vagy régi Transact-SQL (0 vagy hamis) szabályokhoz használja-e.	igaz (1)
ReturnDatesAsStrings (a PDO_SQLSRV illesztőprogram nem támogatja)	1 vagy igaz a dátum- és időtípusokat sztringként visszaadni. 0 vagy hamis ha a dátum- és időtípusokat PHP DateTime típusokként adja vissza.	A dátum- és időtípusokat (datetime, smalldatetime, date, time, datetime2 és datetimeoffset) sztringekként vagy PHP-típusokként kéri le. További információkért lásd Hogyan: Dátum- és időtípusok lekérése sztringként az SQLSRV-illesztőprogram használatával. Ha a PDO_SQLSRV illesztőt használja, a dátumok sztringként lesznek visszaadva, kivéve, ha másként van megadva. További információ : Dátum- és időtípusok lekérése PHP DateTime-objektumként az PDO_SQLSRV illesztőprogram használatával.	téves
Görgethető	Lánc	A "pufferelt" azt jelzi, hogy ügyféloldali (pufferelt) kurzort kíván használni, amely lehetővé teszi egy teljes eredménykészlet tárolását a memóriában. További információ: Kurzortípusok (SQLSRV-illesztő).	Csak előre mutató kurzor
Server (az SQLSRV-illesztő nem támogatja)	Lánc	A csatlakozáshoz használt SQL Server-példány. Megadhatja a virtuális hálózat nevét is, ha egy Always On rendelkezésre állási csoporthoz szeretne csatlakozni. További információ a Microsoft Drivers for PHP for SQL Server Always On rendelkezésre állási csoportokhoz való támogatásáról: Magas rendelkezésre állás támogatása, Vészhelyreállítás.	A kiszolgáló egy kötelező kulcsszó (bár nem kell az első kulcsszónak lennie a kapcsolati sztringben). Ha nem ad meg kiszolgálónevet a kulcsszó számára, a rendszer megpróbál csatlakozni a helyi példányhoz. A kiszolgálónak átadott érték lehet egy SQL Server-példány neve vagy a példány IP-címe. Megadhat egy portszámot (például sqlsrv:server=(local),1033). Az SQL Serverhez készült Microsoft Drivers for PHP 3.0-s verziójától kezdve megadhatja a LocalDB-példányt is.server=(localdb)\instancename További információ: LocalDB támogatása.
Nyomkövetési Fájl	Lánc	Megadja a nyomkövetési adatokhoz használt fájl elérési útját.	Nincs beállítva.
TraceOn	1 vagy igaz a nyomkövetés engedélyezéséhez. 0 vagy hamis a nyomkövetés letiltásához.	Megadja, hogy az ODBC-nyomkövetés engedélyezve van-e (1 vagy igaz), vagy letiltva (0 vagy hamis) a létesített kapcsolathoz.	hamis (0)
Tranzakcióizoláció	Az SQLSRV-illesztő a következő értékeket használja: SQLSRV_TXN_READ_UNCOMMITTED SQLSRV_TXN_READ_COMMITTED SQLSRV_TXN_REPEATABLE_READ SQLSRV_TXN_SNAPSHOT SQLSRV_TXN_SERIALIZABLE A PDO_SQLSRV illesztőprogram a következő értékeket használja: Oem::SQLSRV_TXN_READ_UNCOMMITTED Oem::SQLSRV_TXN_READ_COMMITTED PDO::SQLSRV_TXN_REPEATABLE_READ PDO::SQLSRV_TXN_SNAPSHOT PDO::SQLSRV_TXN_SERIALIZABLE	A tranzakcióelkülönítés szintjét adja meg. A tranzakcióelkülönítésről további információt az SQL Server dokumentációjában, a SET TRANSACTION ISOLATION LEVEL (TRANZAKCIÓELKÜLÖNÍTÉSI SZINT BEÁLLÍTÁSA ) című témakörben talál.	SQLSRV_TXN_READ_COMMITTED vagy Oem::SQLSRV_TXN_READ_COMMITTED
ÁtlátszóHálózatiIPFeloldás	Engedélyezve vagy letiltva	Hatással van a csatlakozási sorrendre, ha a gazdagépnév első feloldott IP-címe nem válaszol, és a gazdagépnévhez több IP-cím tartozik. A MultiSubnetFailover eszközzel kölcsönhatásba lépve különböző kapcsolatütemezéseket biztosít. További információ: Transzparens hálózati IP-felbontás vagy transzparens hálózati IP-felbontás használata.	Enabled
MegbízhatóSzerverTanúsítvány	1 vagy igaz a tanúsítvány megbízhatóságára. 0 vagy hamis, ha nem akarjuk megbízni a tanúsítványban.	Megadja, hogy az ügyfélnek megbízhatónak kell-e lennie (1 vagy igaz), vagy elutasítja (0 vagy hamis) az önaláírt kiszolgálótanúsítványt.	hamis (0)
Egyedi Azonosító (a PDO_SQLSRV illesztőprogram nem támogatja)	Lánc	Megadja az SQL ServerAuthentication 4-hez való csatlakozáshoz használandó felhasználói azonosítót.	Nincs beállítva.
WSID	Lánc	Megadja a számítógép nevét a nyomkövetéshez.	Nincs beállítva.

1. Az ConnectionPooling attribútum nem használható a linuxos és macOS rendszerű kapcsolatok készletezésének engedélyezésére/letiltására. Lásd: Kapcsolatkészletezés (MICROSOFT Drivers for PHP for SQL Server).

2. A létrehozott kapcsolaton végrehajtott összes lekérdezés az attribútum által Database megadott adatbázishoz lesz végrehajtva. Ha azonban a felhasználó rendelkezik a megfelelő engedélyekkel, a többi adatbázisban lévő adatok teljes névvel érhetők el. Ha például a főadatbázis a kapcsolatattribútummal Database van beállítva, akkor is végrehajthat egy Transact-SQL lekérdezést, amely a teljes név használatával hozzáfér az AdventureWorks.HumanResources.Employee táblához.

3. Az Encryption engedélyezés hatással lehet egyes alkalmazások teljesítményére az adatok titkosításához szükséges számítási többletterhelés miatt.

4. SQL Server-hitelesítés esetén a UID és PWD attribútumokat is be kell állítani.

A támogatott kulcsok közül sok ODBC kapcsolati sztringattribútum. Az ODBC kapcsolati sztringjeiről további információt a Kapcsolati sztring kulcsszavak használata natív SQL-ügyféllel című témakörben talál.

Lásd még:

Csatlakozás a kiszolgálóhoz