Možnosti připojení

Stáhnout ovladač PHP

Toto téma obsahuje seznam možností, které jsou povoleny v asociativním poli (při použití sqlsrv_connect v ovladači SQLSRV) nebo klíčových slov povolených v názvu zdroje dat (dsn) (při použití pdO::__construct v ovladači PDO_SQLSRV).

Tabulka možností připojení

Key	Hodnota	Description	Výchozí
Přístupový token	String	Řetězec bajtů přístupového tokenu Microsoft Entra extrahovaný z odpovědi JSON OAuth. Připojovací řetězec nesmí obsahovat ID uživatele, heslo ani Authentication klíčové slovo. Další informace naleznete v tématu Připojení pomocí ověřování Microsoft Entra	Nenastavil se.
Aplikace	String	Určuje název aplikace použitý v trasování.	Nenastavil se.
Záměr aplikace	String	Deklaruje typ úlohy aplikace při připojování k serveru. Možné hodnoty jsou readOnly a ReadWrite. Další informace o ovladačích Společnosti Microsoft pro PHP pro podporu SQL Serveru pro skupiny dostupnosti AlwaysOn naleznete v tématu Podpora pro vysokou dostupnost, zotavení po havárii.	Čtení a zápis
AttachDBFileName	String	Určuje, který soubor databáze má server připojit.	Není nastaveno.
Autentizace	Jeden z následujících řetězců: SqlPassword ActiveDirectoryPassword ActiveDirectoryMsi ActiveDirectoryServicePrincipal	Určuje režim ověřování. Další informace naleznete v tématu Připojení pomocí ověřování Microsoft Entra	Není nastaveno.
Znaková sada (nepodporuje se v ovladači PDO_SQLSRV)	String	Určuje znakové sady používané k odesílání dat na server. Možné hodnoty jsou SQLSRV_ENC_CHAR a UTF-8. Další informace naleznete v tématu Jak na to: Odesílání a načítání dat UTF-8 pomocí vestavěné podpory UTF-8.	SQLSRV_ENC_CHAR
Šifrování sloupců	Jeden z následujících řetězců: Enabled Disabled Řetězec identifikující protokol ověření identity a adresu URL pro ověření enklávy	Určuje, jestli je funkce Always Encrypted povolená nebo ne. Pokud je zadaný protokol ověření identity a adresa URL, je povolena funkce Always Encrypted se zabezpečenými enklávy za předpokladu, že jsou splněny další požadavky popsané v tématu Použití funkce Always Encrypted se zabezpečenými enklávy s ovladači PHP pro SQL Server.	Disabled
Sdružování připojení	1 nebo true pro zapnutí sdružování připojení. Hodnota 0 nebo false pro vypnutí sdružování připojení.	Určuje, zda je připojení přiřazeno z fondu připojení (1 nebo true), nebo ne (0 nebo false). 1	true (1)
ConnectRetryCount	Celé číslo mezi 0 a 255 (včetně)	Maximální počet pokusů o obnovení přerušeného připojení před vzdáním se. Ve výchozím nastavení se při přerušení připojení provede jeden pokus o obnovení připojení. Hodnota 0 znamená, že se nebude pokoušet o opětovné připojení.	1
ConnectRetryInterval	Celé číslo mezi 1 a 60 (včetně)	Čas v sekundách mezi pokusy o obnovení připojení. Aplikace se pokusí znovu připojit okamžitě po zjištění poškozeného připojení a pak počká ConnectRetryInterval několik sekund, než se pokusí znovu. Toto klíčové slovo se ignoruje, pokud ConnectRetryCount je rovno 0.	10
Databáze	String	Určuje název používané databáze pro navázání připojení2.	Výchozí databáze použitého přihlášení.
Desetinná místa (nepodporuje se v ovladači PDO_SQLSRV)	Celé číslo mezi 0 a 4 (včetně)	Určuje desetinná místa při formátování načtených hodnot peněz. Tato možnost funguje pouze v případě, že FormatDecimals je true. Jakékoli záporné celé číslo nebo hodnota větší než 4 budou ignorovány.	Výchozí přesnost a měřítko
Driver	String	Určuje ovladač Microsoft ODBC použitý ke komunikaci s SQL Serverem. Možné hodnoty: Ovladač ODBC 18 pro SQL Server Ovladač ODBC 17 pro SQL Server Ovladač ODBC 13 pro SQL Server Ovladač ODBC 11 pro SQL Server (jenom Windows).	Pokud není zadáno klíčové slovo Ovladač, Microsoft Drivers for PHP for SQL Server se pokusí najít podporované ovladače Microsoft ODBC v systému, počínaje nejnovější verzí ODBC a pokračuje dále.
Zašifrovat	1 nebo true pro šifrování. 0 nebo false pro šifrování vypnuto.	Určuje, jestli je komunikace s SQL Serverem šifrovaná (1 nebo true) nebo nešifrovaná (0 nebo nepravda)3.	false (0)
Failover_Partner	String	Určuje server a instanci zrcadla databáze (pokud je povoleno a nakonfigurováno), které se má použít v případě nedostupnosti primárního serveru. Existují omezení pro použití Failover_Partner s MultiSubnetFailover. Další informace najdete v tématu Podpora vysoké dostupnosti, zotavení po havárii. Tato možnost není podporována v Linuxu nebo macOS, protože ovladač ODBC v Linuxu nebo macOS nepodporuje zrcadlení databáze. Místo toho použijte skupiny dostupnosti Always On a nastavte možnosti MultiSubnetFailover a TransparentNetworkIPResolution.	Nenastavil se.
FormátDesetinnýchČísel (nepodporuje se v ovladači PDO_SQLSRV)	1 nebo true pro formátování načítaných desetinných řetězců Výchozí chování formátování desetinných míst je 0 nebo false .	Určuje, jestli se mají počáteční nuly přidat k desítkovým řetězcům, pokud je to vhodné, a povolí DecimalPlaces možnost formátování typů peněz. Pokud necháte hodnotu false, použije se výchozí chování vrácení přesné přesnosti a vynechání počátečních nul pro hodnoty menší než 1. Další informace naleznete v tématu Formátování desetinných řetězců a hodnot peněz.	false (0)
Ověřování KeyStore	KeyVaultPassword KeyVaultClientSecret	Metoda ověřování pro přístup ke službě Azure Key Vault Určuje, jaký druh přihlašovacích údajů se používá s KeyStorePrincipalId a KeyStoreSecret. Další informace najdete v tématu Použití služby Azure Key Vault.	Nenastavil se.
KeyStorePrincipalId	String	Identifikátor účtu, který hledá přístup ke službě Azure Key Vault. Pokud KeyStoreAuthentication je keyVaultPassword, tato hodnota musí být uživatelské jméno Microsoft Entra. Pokud KeyStoreAuthentication je keyVaultClientSecret, tato hodnota musí být ID klienta aplikace.	Nenastavil se.
KeyStoreSecret	String	Tajný klíč přihlašovacích údajů pro účet, který hledá přístup ke službě Azure Key Vault. Pokud KeyStoreAuthentication je keyVaultPassword, tato hodnota musí být heslo Microsoft Entra. Pokud KeyStoreAuthentication je keyVaultClientSecret, tato hodnota musí být tajný klíč klienta aplikace.	Nenastavil se.
Jazyk	String	Určuje jazyk zpráv vrácených serverem. Dostupné jazyky jsou uvedené v sys.syslanguages tabulce. Tato možnost nemá vliv na jazyk používaný samotnými ovladači, protože jsou aktuálně k dispozici pouze v angličtině a nemá vliv na jazyk základního ovladače ODBC, jehož jazyk je určen lokalizovanou verzí nainstalovanou v klientském systému. Změna tohoto nastavení proto může vést k vrácení zpráv v různých jazycích v závislosti na tom, jestli pocházejí z ovladače PHP, ovladače ODBC nebo SQL Serveru.	Výchozí hodnota je jazyk nastavený na SQL Serveru.
LoginTimeout	Celé číslo (ovladač SQLSRV) Řetězec (ovladač PDO_SQLSRV)	Určuje počet sekund, po které se má čekat, než se nepodaří pokus o připojení.	Žádný časový limit.
MultipleActiveResultSets	1 nebo true pro použití více aktivních sad výsledků. 0 nebo false, pokud chcete zakázat více aktivních sad výsledků.	Zakáže nebo explicitně povolí podporu více aktivních sad výsledků (MARS). Další informace naleznete v tématu Postupy: Zakázání více aktivních sad výsledků (MARS).	pravda (1)
MultiSubnetFailover	String	Při připojování k naslouchacímu procesu skupiny dostupnosti SQL Serveru 2012 (11.x) nebo instance clusteru s podporou převzetí služeb při selhání SQL Serveru 2012 (11.x) vždy určete multiSubnetFailover=yes . multiSubnetFailover=yes konfiguruje ovladače Microsoftu pro PHP pro SQL Server, aby poskytovaly rychlejší detekci a připojení k (aktuálně) aktivnímu serveru. Možné hodnoty jsou Ano a Ne. Další informace o ovladačích Společnosti Microsoft pro PHP pro podporu SQL Serveru pro skupiny dostupnosti AlwaysOn naleznete v tématu Podpora pro vysokou dostupnost, zotavení po havárii.	Ne
PWD (nepodporuje se v ovladači PDO_SQLSRV)	String	Určuje heslo přidružené k ID uživatele, které se má použít při připojování s ověřováním SQL Serveru4.	Není nastaveno.
QuotedId	1 nebo true pro použití pravidel SQL-92. Pokud chcete použít starší pravidla, použijte hodnotu 0 nebo false .	Určuje, jestli se mají použít pravidla SQL-92 pro uvozované identifikátory (1 nebo pravda), nebo použít starší pravidla Transact-SQL (0 nebo nepravda).	true (1)
ReturnDatesAsStrings (nepodporuje se v ovladači PDO_SQLSRV)	1 nebo true pro vrácení typů data a času jako řetězců. 0 nebo false pro vrácení typů data a času jako typu DATUM A ČAS PHP.	Načte typy data a času (datetime, smalldatetime, date, time, datetime2 a datetimeoffset) jako řetězce nebo jako typy PHP. Další informace naleznete v tématu Postupy: Načtení typů data a času jako řetězců pomocí ovladače SQLSRV. Při použití ovladače PDO_SQLSRV se data vrátí jako řetězce, pokud není uvedeno jinak. Další informace naleznete v tématu Postupy: Načtení typů data a času jako objekty PHP DateTime pomocí ovladače PDO_SQLSRV.	falešný
Scrollovatelný	String	"Vyrovnávací paměť" označuje, že chcete kurzor na straně klienta (uložený ve vyrovnávací paměti), který umožňuje ukládat do mezipaměti celou sadu výsledků v paměti. Další informace naleznete v tématu Typy kurzoru (ovladač SQLSRV).	Kurzor pouze vpřed
počítačový server (nepodporuje se v ovladači SQLSRV)	String	Instance SQL Serveru, ke které se chcete připojit. Můžete také zadat název virtuální sítě pro připojení ke skupině dostupnosti AlwaysOn. Další informace o ovladačích Společnosti Microsoft pro PHP pro podporu SQL Serveru pro skupiny dostupnosti AlwaysOn naleznete v tématu Podpora pro vysokou dostupnost, zotavení po havárii.	Server je povinné klíčové slovo (i když nemusí být prvním klíčovým slovem v připojovacím řetězci). Pokud název serveru není předán klíčovému slovu, provede se pokus o připojení k místní instanci. Hodnota předaná serveru může být název instance SQL Serveru nebo IP adresa instance. Volitelně můžete zadat číslo portu (například sqlsrv:server=(local),1033). Počínaje verzí 3.0 ovladačů Společnosti Microsoft pro PHP pro SQL Server můžete také zadat instanci LocalDB s server=(localdb)\instancename. Další informace naleznete v tématu Podpora pro LocalDB.
TraceFile	String	Určuje cestu k souboru použitému pro data trasování.	Není nastaveno.
TraceOn	1 nebo true pro povolení trasování. Pro vypnutí trasování použijte hodnotu 0 nebo false.	Určuje, jestli je pro navázání připojení povolené trasování ODBC (1 nebo true) nebo zakázáno (0 nebo nepravda).	false (0)
TransactionIsolation	Ovladač SQLSRV používá následující hodnoty: SQLSRV_TXN_READ_UNCOMMITTED SQLSRV_TXN_READ_COMMITTED SQLSRV_TXN_REPEATABLE_READ SQLSRV_TXN_SNAPSHOT SQLSRV_TXN_SERIALIZABLE Ovladač PDO_SQLSRV používá následující hodnoty: PdO::SQLSRV_TXN_READ_UNCOMMITTED PDO::SQLSRV_TXN_READ_COMMITTED PDO::SQLSRV_TXN_REPEATABLE_READ PDO::SQLSRV_TXN_SNAPSHOT PDO::SQLSRV_TXN_SERIALIZABLE	Určuje úroveň izolace transakce. Další informace o izolaci transakcí naleznete v tématu NASTAVENÍ ÚROVNĚ IZOLACE TRANSAKCÍ v dokumentaci k SQL Serveru.	SQLSRV_TXN_READ_COMMITTED nebo PDO::SQLSRV_TXN_READ_COMMITTED
Transparentní síťové IP rozlišení	Povoleno nebo zakázáno	Ovlivňuje posloupnost připojení, když první přeložená IP adresa názvu hostitele nereaguje a k názvu hostitele je přidružených více IP adres. Interaguje s MultiSubnetFailover a poskytuje různé sekvence připojení. Další informace najdete v tématu Transparentní překlad IP adres sítě nebo použití transparentního síťového překladu IP adres.	Enabled
TrustServerCertificate	1 nebo true pro důvěřování certifikátu. 0 nebo false, aby se certifikátu nedůvěřovalo.	Určuje, jestli má klient důvěřovat (1 nebo pravda) nebo odmítnout (0 nebo nepravda) certifikát serveru podepsaný svým držitelem.	false (0)
Jedinečný identifikátor (UID) (nepodporuje se v ovladači PDO_SQLSRV)	String	Určuje ID uživatele, které se má použít při připojování s ověřováním SQL Serveru4.	Není nastaveno.
WSID	String	Určuje název počítače pro trasování.	Není nastaveno.

1. Atribut ConnectionPooling nelze použít k povolení nebo zakázání sdružování připojení v Linuxu a macOS. Viz Sdružování připojení (ovladače Microsoftu pro PHP pro SQL Server).

2. Všechny dotazy provedené na založeném připojení jsou prováděny na databázi, která je určena atributem Database. Pokud má však uživatel příslušná oprávnění, mohou být data v jiných databázích přístupná pomocí plně kvalifikovaného názvu. Pokud je například hlavní databáze nastavena pomocí atributu Database připojení, je stále možné spustit Transact-SQL dotaz, který přistupuje k tabulce AdventureWorks.HumanResources.Employee pomocí plně kvalifikovaného názvu.

3. Povolení Encryption může mít vliv na výkon některých aplikací kvůli výpočetní režii vyžadované k šifrování dat.

4. Atributy UID a PWD musí být oba nastaveny při připojování pomocí ověřování SQL Serveru.

Mnohé z podporovaných klíčů jsou atributy připojovacího řetězce ODBC. Informace o připojovacích řetězcích ODBC naleznete v tématu Použití klíčových slov připojovacího řetězce s nativním klientem SQL.

Viz také

Připojení k serveru