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 Ha engedélyezve van a kapcsolatkészletezés, az illesztőprogram kivonatozza a jogkivonat tartalmát, és hozzáfűzi a APP kulcsszóhoz, hogy jogkivonatonként különböztesse meg a készletkulcsokat (az 5.13.1-es verziótól kezdve). Ha az alkalmazás nem adja meg az APP értékét, akkor ez a kivonat a program_name oszlopban sys.dm_exec_sessions jelenik meg.	Nincs beállítva.
alkalmazás	Lánc	A nyomkövetésben használt alkalmazásnevet adja meg. Ha a AccessToken meg van határozva és engedélyezve van a kapcsolatkészletezés, az illesztőprogram hozzáfűz egy belső kivonatot a APP készletkulcs megkülönböztetéséhez. Egy érték APP beállítása felülbírálja a AccessToken kivonatot, amely a(z) program_name oszlopban sys.dm_exec_sessions jelenik 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 [ELAVULT] 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ábbi karakterláncok egyike: 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 az SQL Server számára ODBC Illesztőprogram 17 SQL Serverhez ODBC Driver 13 a(z) SQL Serverhez 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 az opció nem támogatott Linuxon vagy macOS-en, mert az adatbázis tükrözését az ODBC driver nem támogatja Linuxon vagy macOS-en. Ehelyett használja az Always On rendelkezésre állási csoportokat, és állítsa be a következőt: MultiSubnetFailover=Yes.	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. Ha az automatikus szüneteltetés engedélyezve van a Azure SQL Database kiszolgáló nélküli esetén, és beállítod a(z) LoginTimeout értéket, használj legalább 60 másodpercet. Az automatikusan szüneteltetett adatbázis az első csatlakozási kísérletkor újraindul, és ez a kísérlet 40613-as hibával meghiúsulhat, miközben az adatbázis újraindul, ezért az alkalmazásnak újra kell próbálkoznia. További információkért lásd: Automatikus szüneteltetés és automatikus folytatás.	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	Állítsa be a(z) MultiSubnetFailover=Yes értéket, ha a cél Azure SQL Database, Azure SQL Managed Instance, a Microsoft Fabricben található SQL-adatbázis, rendelkezésreállási csoport figyelője vagy feladatátvételi fürt példánya. Az illezőprogram párhuzamosan próbál TCP kapcsolatot indítani az összes megoldott IP-címhez, és az első sikeres kapcsolatot használja. A funkció engedélyezéséhez állítsa Yes, True vagy 1 értékre; az illesztőprogram minden más értéket No értékként kezel anélkül, hogy hibát jelezne. Amikor a DNS egyetlen címre oldódik, MultiSubnetFailover=Yes nem hoz létre további párhuzamos kapcsolati próbálkozásokat, így biztonságos az egy-IP célpontokon. Nem használhatod más protokollon kívül, mint TCP-n, és egy SQL Server példányhoz való csatlakozás, amely több mint 64 IP-címmel konfigurált, meghibás. Ne állítsa be akkor sem, ha a kapcsolati karakterlánc is tartalmazza a Failover_Partner elemet, vagy ha rendelkezésre állási csoport figyelője helyett egy elsődleges replikához csatlakozik. 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 a SQL Server dokumentációjában találSET TRANSACTION ISOLATION LEVEL.	SQLSRV_TXN_READ_COMMITTED vagy Oem::SQLSRV_TXN_READ_COMMITTED
ÁtlátszóHálózatiIPFeloldás	Engedélyezve vagy letiltva	Örökölt több IP-címes visszaállási lehetőség az ODBC illesztőprogramhoz. Ez a beállítás nem befolyásolja a kapcsolódási sorrendet, ha MultiSubnetFailover=Yes, amely a MultiSubnetFailover sorban felsorolt célpontokhoz ajánlott beállítás. További információkért lásd: A magas rendelkezésre állás és a katasztrófa utáni helyreállítás támogatása vagy Az átlátszó hálózati IP-feloldá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 engedélyezés Encryption befolyásolhatja egyes alkalmazások teljesítményét az adatok titkosításához szükséges számítási túlterhelé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 kapcsolódási stringekről szóló információkért lásd: DSN és Connection String kulcsszavak és attribútumok.

Kapcsolódó tartalom

• Csatlakozás a kiszolgálóhoz