Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Platí pro:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytický platformový systém (PDW)SQL databáze v Microsoft Fabric
Některá rozhraní API v ovladači OLE DB pro SQL Server používají připojovací řetězce k určení atributů připojení. Připojovací řetězce jsou seznam klíčových slov a přidružených hodnot; každé klíčové slovo identifikuje konkrétní atribut připojení.
Poznámka:
Ovladač OLE DB pro SQL Server umožňuje nejednoznačnost v připojovacích řetězcích pro zachování zpětné kompatibility (například některá klíčová slova mohou být zadána více než jednou a konfliktní klíčová slova mohou být povolena s řešením na základě pozice nebo priority). Budoucí verze OLE DB Driver pro SQL Server nemusí umožnit nejednoznačnost v řetězcích spojení. Je vhodné při úpravách aplikací použít ovladač OLE DB pro SQL Server k odstranění jakékoli závislosti na nejednoznačnosti připojovacího řetězce.
Následující části popisují klíčová slova, která lze použít s ovladačem OLE DB pro SQL Server a objekty ActiveX Data Objects (ADO) při použití ovladače OLE DB pro SQL Server jako zprostředkovatele dat.
Klíčová slova připojovacího řetězce ovladače OLE DB
Aplikace OLE DB mohou inicializovat objekty zdroje dat dvěma způsoby:
IDBInitialize::Initialize
IDataInitialize::GetDataSource
V prvním případě lze řetězec zprostředkovatele použít k inicializaci vlastností připojení nastavením vlastnosti DBPROP_INIT_PROVIDERSTRING v sadě vlastností DBPROPSET_DBINIT. V druhém případě může být inicializační řetězec předána metodě IDataInitialize::GetDataSource pro inicializaci vlastností připojení. Obě metody inicializují stejné vlastnosti připojení OLE DB, ale používají se různé sady klíčových slov. Sada klíčových slov používaných IDataInitialize::GetDataSource je minimálně popis vlastností v rámci inicializační skupiny vlastností.
Jakékoli nastavení řetězce zprostředkovatele, které má odpovídající vlastnost OLE DB nastavenou na nějakou výchozí hodnotu nebo explicitně nastavenou na hodnotu, hodnota vlastnosti OLE DB přepíše nastavení v řetězci zprostředkovatele.
Logické vlastnosti nastavené v řetězcích zprostředkovatele pomocí hodnot DBPROP_INIT_PROVIDERSTRING jsou určeny hodnotami yes a no. Logické vlastnosti nastavené v inicializačních řetězcích pomocí IDataInitialize::GetDataSource jsou nastaveny pomocí hodnot true a false.
Aplikace používající IDataInitialize::GetDataSource mohou také používat klíčová slova používaná IDBInitialize::Initialize, ale pouze pro vlastnosti, které nemají výchozí hodnotu. Pokud aplikace používá klíčové slovo IDataInitialize::GetDataSource i IDBInitialize::Initialize v inicializačním řetězci, použije se nastavení klíčového slova IDataInitialize::GetDataSource . Doporučuje se, aby aplikace nepoužívají klíčové slova IDBInitialize::Initialize v připojovacích řetězcích IDataInitialize:GetDataSource , protože toto chování nemusí být zachováno v budoucích verzích.
Poznámka:
Připojovací řetězec předaný prostřednictvím IDataInitialize::GetDataSource se převede na vlastnosti a použije se prostřednictvím IDBProperties::SetProperties. Pokud služby komponent našli popis vlastnosti v IDBProperties::GetPropertyInfo, tato vlastnost se použije jako samostatná vlastnost. V opačném případě se použije prostřednictvím vlastnosti DBPROP_PROVIDERSTRING. Pokud například zadáte připojovací řetězec Data Source=server1; Server=server2, zdroj dat bude nastaven jako vlastnost, ale Server přejde do řetězce zprostředkovatele.
Pokud zadáte více instancí stejné vlastnosti specifické pro zprostředkovatele, použije se první hodnota první vlastnosti.
Použití IDBInitialize::Initialize
Připojovací řetězce používané aplikacemi OLE DB používající DBPROP_INIT_PROVIDERSTRING s IDBInitialize::Initialize mají následující syntaxi:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[{]attribute-value[}]attribute-value ::= character-stringattribute-keyword ::= identifier
Hodnoty atributů je možné volitelně uzavřít do složených závorek a je vhodné to udělat. Tento postup zabraňuje problémům, když hodnoty atributů obsahují jiné než alfanumerické znaky. První pravá složená závorka v hodnotě je považována za ukončení hodnoty, takže hodnoty nemohou obsahovat tyto znak.
Znak mezery umístěný za znakem = v klíčovém slově připojovacího řetězce bude interpretován jako literál, i když je hodnota uvedena v uvozovkách.
Následující tabulka popisuje klíčová slova, která se dají použít s DBPROP_INIT_PROVIDERSTRING.
| Keyword | Inicializační vlastnost | Description |
|---|---|---|
| Addr | SSPROP_INIT_NETWORKADDRESS | Synonymum pro adresu |
| Adresa | SSPROP_INIT_NETWORKADDRESS | Síťová adresa serveru, na kterém běží instance SQL Serveru.
Adresa je obvykle síťový název serveru, ale může to být i jiné názvy, například kanál, IP adresa nebo port TCP/IP a adresa soketu. Pokud zadáte IP adresu, ujistěte se, že jsou v nástroji SQL Server Configuration Manager povolené protokoly TCP/IP nebo pojmenované kanály. Hodnota Adresa má přednost před hodnotou předanou serveru v připojovacích řetězcích při použití ovladače OLE DB pro SQL Server. Všimněte si také, že Address=; se připojí k serveru zadanému v klíčovém slově Server , zatímco Address= ;, Address=.;, Address=localhost;a Address=(local); všechny způsobí připojení k místnímu serveru.Úplná syntaxe klíčového slova Adresa je následující: [protokol:]Adresa[,port |\pipe\pipename] protokol může být tcp (TCP/IP), lpc (sdílená paměť) nebo np (pojmenované kanály). Další informace o protokolech naleznete v tématu Konfigurace klientských protokolů. Pokud není zadán žádný protokol ani klíčové slovo Síť , ovladač OLE DB pro SQL Server bude používat pořadí protokolu zadané v nástroji SQL Server Configuration Manager. port je port, ke kterému se chcete připojit, na zadaném serveru. SQL Server ve výchozím nastavení používá port 1433. |
| APP | SSPROP_INIT_APPNAME | Řetězec identifikující aplikaci. |
| ApplicationIntent | SSPROP_INIT_APPLICATIONINTENT | Deklaruje typ úlohy aplikace při připojování k serveru. Možné hodnoty jsou ReadOnly a ReadWrite.Výchozí hodnota je ReadWrite. Další informace o ovladači OLE DB pro podporu SQL Serveru pro skupiny dostupnosti AlwaysOn naleznete v tématu Ovladač OLE DB pro SQL Server Podpora pro vysokou dostupnost, Zotavení po havárii. |
| AttachDBFileName | SSPROP_INIT_FILENAME | Název primárního souboru (včetně úplného názvu cesty) připojitelné databáze. Chcete-li použít AttachDBFileName, musíte také zadat název databáze pomocí klíčového slova "Database" v řetězci zprostředkovatele. Pokud byla databáze dříve připojená, SQL Server ji znovu nepřipoje (použije připojenou databázi jako výchozí pro připojení). |
| Ověřování1 | SSPROP_AUTH_MODE | Určuje použité ověřování SQL nebo Microsoft Entra. Platné hodnoty jsou:
POZNÁMKA: Klíčové ActiveDirectoryIntegrated slovo lze také použít pro ověřování systému Windows na SQL Server. Nahradí Integrated Security (nebo Trusted_Connection) ověřovací klíčová slova.
Doporučuje se, aby aplikace používající Integrated Security (neboTrusted_Connection) klíčová slova nebo jejich odpovídající vlastnosti nastavily hodnotu klíčového Authentication slova (nebo její odpovídající vlastnosti) tak, aby ActiveDirectoryIntegrated umožňovaly nové chování při šifrování a ověřování certifikátů.POZNÁMKA:Doporučuje se, aby aplikace používající SQL Server ověřování nastavily hodnotu klíčového Authentication slova (nebo její odpovídající vlastnosti), aby SqlPassword umožňovaly nové chování při ověřování šifrování a certifikátu. |
| Automatický překlad | SSPROP_INIT_AUTOTRANSLATE | Synonymum pro automatický přenos |
| Automatický přenos | SSPROP_INIT_AUTOTRANSLATE | Nakonfiguruje překlad znaků OEM/ANSI. Rozpoznané hodnoty jsou yes a no. |
| ConnectRetryCount | SSPROP_INIT_CONNECT_RETRY_COUNT | Určuje počet pokusů o opětovné připojení, pokud dojde ke ztrátě připojení. Platné hodnoty jsou v rozsahu od 0 do 255. Výchozí hodnota je 1. Hodnota 0 by neměla vést k žádnému pokusu o opětovné připojení. Další informace najdete v tématu Odolnost nečinných připojení. |
| ConnectRetryInterval | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Určuje počet sekund mezi jednotlivými pokusy o opakování připojení, pokud dojde ke ztrátě připojení. Platné hodnoty jsou v rozsahu od 1 do 60. Výchozí hodnota je 10. Další informace najdete v tématu Odolnost nečinných připojení. |
| Databáze | DBPROP_INIT_CATALOG | Název databáze. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Určuje režim zpracování datového typu, který se má použít. Rozpoznané hodnoty jsou 0 určené pro datové typy zprostředkovatele a 80 pro datové typy SQL Serveru 2000. |
| Šifrování1 | SSPROP_INIT_ENCRYPT | Určuje, jestli se mají data před odesláním přes síť šifrovat. Možné hodnoty jsou Optional, Mandatorya Strict. Výchozí hodnota je Mandatory. Informace o verzích 18.x.x najdete v tématu Hlavní rozdíly ve verzi MSOLEDBSQL. |
| FailoverPartner | SSPROP_INIT_FAILOVERPARTNER | Název serveru převzetí služeb při selhání, který se používá pro zrcadlení databáze. |
| FailoverPartnerSPN | SSPROP_INIT_FAILOVERPARTNERSPN | Hlavní název služby (SPN) partnera pro převzetí služeb při selhání. Výchozí hodnota je prázdný řetězec. Prázdný řetězec způsobí, že ovladač OLE DB pro SQL Server použije výchozí hlavní název služby generované poskytovatelem. |
| HostNameInCertificate | SSPROP_INIT_HOST_NAME_CERTIFICATE | Název hostitele, který se má použít při ověřování certifikátu TLS/SSL SQL Serveru. Pokud není nastavené klíčové slovo HostNameInCertificate , ovladač použije hodnotu klíčového slova serveru na adrese URL připojení jako název hostitele k ověření certifikátu TLS/SSL SQL Serveru. POZNÁMKA: Tato vlastnost se ignoruje, pokud je certifikát serveru důvěryhodný. Pokud je funkce Encrypt nastavená na Strict, certifikát se vždy ověří. |
| Jazyk | SSPROP_INIT_CURRENTLANGUAGE | Jazyk SQL Serveru. |
| MarsConn | SSPROP_INIT_MARSCONNECTION | Povolí nebo zakáže v připojení několik aktivních sad výsledků (MARS), pokud je server SQL Server 2005 (9.x) nebo novější. Možné hodnoty jsou yes a no. Výchozí hodnota je no. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Při připojování k posluchači skupiny dostupnosti nebo instanci clusteru s převzetím služeb při selhání SQL Serveru vždy zadejte MultiSubnetFailover=Ano.
MultiSubnetFailover=Ano konfiguruje ovladač OLE DB pro SQL Server tak, aby poskytoval rychlejší detekci a připojení k (aktuálně) aktivnímu serveru. Možné hodnoty jsou Yes a No. Výchozí hodnota je No. Například:MultiSubnetFailover=YesDalší informace o ovladači OLE DB pro podporu SQL Serveru pro skupiny dostupnosti AlwaysOn naleznete v tématu Ovladač OLE DB pro SQL Server Podpora pro vysokou dostupnost, Zotavení po havárii. |
| Net | SSPROP_INIT_NETWORKLIBRARY | Synonymum pro síť. |
| Network | SSPROP_INIT_NETWORKLIBRARY | Síťová knihovna používaná k navázání připojení k instanci SQL Serveru v organizaci. |
| Síťová knihovna | SSPROP_INIT_NETWORKLIBRARY | Synonymum pro síť. |
| PacketSize | SSPROP_INIT_PACKETSIZE | Velikost paketů TDS (Tabular Data Stream). Výchozí hodnota je 0 (skutečná hodnota bude určena serverem). |
| Zachovat citlivé | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Přijímá řetězce yes a no jako hodnoty. Pokud no se používá, objekt zdroje dat nesmí uchovávat citlivé ověřovací informace. |
| PWD | DBPROP_AUTH_PASSWORD | Přihlašovací heslo SQL Serveru. |
| Server | DBPROP_INIT_DATASOURCE | Název instance SQL Serveru. Hodnota musí být buď název serveru v síti, IP adresa nebo název aliasu nástroje SQL Server Configuration Manager. Pokud není zadáno, vytvoří se připojení k výchozí instanci v místním počítači. Klíčové slovo Adresa přepíše klíčové slovo serveru . K výchozí instanci na místním serveru se můžete připojit zadáním jedné z následujících možností: Server=; Server=.; Server=(místní); Server=(místní); Server=(localhost); Server=(localdb)\instancename; Další informace o podpoře LocalDB naleznete v tématu OLE DB Driver for SQL Server Support for LocalDB. Pokud chcete zadat pojmenovanou instanci SQL Serveru, připojte \instanceName. Pokud není zadaný žádný server, vytvoří se připojení k výchozí instanci v místním počítači. Pokud zadáte IP adresu, ujistěte se, že jsou v nástroji SQL Server Configuration Manager povolené protokoly TCP/IP nebo pojmenované kanály. Úplná syntaxe klíčového slova Server je následující: Server=[protokol:]Server[,port] protokol může být tcp (TCP/IP), lpc (sdílená paměť) nebo np (pojmenované kanály). Následující příklad určuje pojmenovaný kanál: np:\\.\pipe\MSSQL$MYINST01\sql\queryVýše uvedený řádek určuje pojmenovaný kanálový protokol ( np), pojmenovaný kanál na místním počítači (\\.\pipe), název instance SQL Serveru (MSSQL$MYINST01) a výchozí název pojmenovaného kanálu (sql/query).Pokud není zadán žádný protokol ani klíčové slovo Síť , ovladač OLE DB pro SQL Server použije pořadí protokolu zadané v nástroji SQL Server Configuration Manager. port je port, ke kterému se chcete připojit, na zadaném serveru. SQL Server ve výchozím nastavení používá port 1433. Mezery se při použití ovladače OLE DB pro SQL Server ignorují na začátku hodnoty předané serveru v připojovacích řetězcích. |
| ServerCertificate | SSPROP_INIT_SERVER_CERTIFICATE | Určuje cestu k souboru certifikátu, který se má shodovat s certifikátem TLS/SSL SQL Serveru. Tuto možnost lze použít pouze v případě, že Strict je povolené šifrování. Přijaté formáty certifikátů jsou PEM, DER a CER. Pokud je zadaný, zkontroluje se certifikát SQL Serveru tak, že zjistí, jestli se zadaný certifikát přesně shoduje. |
| ServerSPN | SSPROP_INIT_SERVERSPN | Hlavní název služby (SPN) pro server. Výchozí hodnota je prázdný řetězec. Prázdný řetězec způsobí, že ovladač OLE DB pro SQL Server použije výchozí hlavní název služby generované poskytovatelem. |
| Přerušení zápasu | DBPROP_INIT_TIMEOUT | Doba čekání na dokončení inicializace zdroje dat (v sekundách). |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | 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 několik IP adres. TNIR komunikuje s MultiSubnetFailover a poskytuje různé sekvence připojení. Možné hodnoty jsou Yes a No. Výchozí hodnota je Yes. Další informace najdete v tématu Použití transparentního síťového překladu IP adres. |
| Trusted_Connection | DBPROP_AUTH_INTEGRATED | Pokud yestato možnost dává ovladači OLE DB pro SQL Server pokyn, aby pro ověření přihlášení používal ověřování systému Windows. V opačném případě bude ovladač OLE DB pro SQL Server používat pro ověření přihlášení uživatelské jméno a heslo SQL Serveru a musí být zadána klíčová slova UID a PWD. |
| TrustServerCertificate1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Přijímá řetězce yes a no jako hodnoty. Výchozí hodnota je no, což znamená, že certifikát serveru bude ověřen. |
| UID | DBPROP_AUTH_USERID | Přihlašovací jméno SQL Serveru. |
| UseFMTONLY | SSPROP_INIT_USEFMTONLY | Určuje, jak se metadata načítají při připojování k SQL Serveru 2012 (11.x) a novějšímu. Možné hodnoty jsou yes a no. Výchozí hodnota je no.Ovladač OLE DB pro SQL Server ve výchozím nastavení používá sp_describe_first_result_set a sp_describe_undeclared_parameters uložené procedury k načtení metadat. Tyto uložené procedury mají určitá omezení (například při provozu s dočasnými tabulkami selžou). Nastavení UseFMTONLY dává yes ovladači pokyn, aby místo toho použil SET FMTONLY pro načítání metadat. |
| UseProcForPrepare | SSPROP_INIT_USEPROCFORPREP | Toto klíčové slovo je zastaralé a jeho nastavení je ignorováno ovladačem OLE DB pro SQL Server. |
| WSID | SSPROP_INIT_WSID | Identifikátor pracovní stanice. |
[1]: Aby se zlepšilo zabezpečení, chování šifrování a ověření certifikátu se upraví při použití vlastností inicializace ověřovacího nebo přístupového tokenu nebo odpovídajících klíčových slov připojovacího řetězce. Další informace naleznete v tématu Šifrování a ověření certifikátu.
Použití IDataInitialize::GetDataSource
Připojovací řetězce používané aplikacemi OLE DB používající IDataInitialize::GetDataSource mají následující syntaxi:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[quote]attribute-value[quote]attribute-value ::= character-stringattribute-keyword ::= identifierquote ::= " | '
Použití vlastnosti musí odpovídat syntaxi povolené v daném kontextu. NAPŘÍKLAD WSID používá složené závorky ({}) uvozovky a název aplikace používá jednoduché (') nebo dvojité (") uvozovky. Lze uvozovat pouze řetězcové vlastnosti. Při pokusu o uvozovku celočíselné nebo výčtové vlastnosti dojde k Connection String doesn't conform to OLE DB specification chybě.
Hodnoty atributů lze volitelně uzavřít do jednoduchých nebo dvojitých uvozovek a je vhodné to udělat. Tento postup zabraňuje problémům, když hodnoty obsahují jiné než alfanumerické znaky. Použitý znak citace se může také objevit v hodnotách, pokud je v dvojitých uvozovkách.
Znak mezery za = v klíčovém slovu připojovacího řetězce bude interpretován jako literál, i když je hodnota uzavřena v uvozovkách.
Pokud připojovací řetězec obsahuje více než jednu z vlastností uvedených v následující tabulce, použije se hodnota poslední vlastnosti.
Následující tabulka popisuje klíčová slova, která lze použít s IDataInitialize::GetDataSource:
| Keyword | Inicializační vlastnost | Description |
|---|---|---|
| Přístupový token1 | SSPROP_AUTH_ACCESS_TOKEN | Přístupový token použitý k autentizaci v Microsoft Entra ID. POZNÁMKA: Jedná se o chybu při zadání tohoto klíčového slova, stejně jako klíčových slov připojovacího řetězce UID, PWD, Trusted_Connection nebo Authentication nebo jejich odpovídajících vlastností/klíčových slov. |
| Název aplikace | SSPROP_INIT_APPNAME | Řetězec identifikující aplikaci. |
| Záměr aplikace | SSPROP_INIT_APPLICATIONINTENT | Deklaruje typ úlohy aplikace při připojování k serveru. Možné hodnoty jsou ReadOnly a ReadWrite.Výchozí hodnota je ReadWrite. Další informace o ovladači OLE DB pro podporu SQL Serveru pro skupiny dostupnosti AlwaysOn naleznete v tématu Ovladač OLE DB pro SQL Server Podpora pro vysokou dostupnost, Zotavení po havárii. |
| Ověřování1 | SSPROP_AUTH_MODE | Určuje použité ověřování SQL nebo Microsoft Entra. Platné hodnoty jsou:
POZNÁMKA: Klíčové ActiveDirectoryIntegrated slovo lze také použít pro ověřování systému Windows na SQL Server. Nahradí Integrated Security (nebo Trusted_Connection) ověřovací klíčová slova.
Doporučuje se, aby aplikace používající Integrated Security (neboTrusted_Connection) klíčová slova nebo jejich odpovídající vlastnosti nastavily hodnotu klíčového Authentication slova (nebo její odpovídající vlastnosti) tak, aby ActiveDirectoryIntegrated umožňovaly nové chování při šifrování a ověřování certifikátů.POZNÁMKA:Doporučuje se, aby aplikace používající SQL Server ověřování nastavily hodnotu klíčového Authentication slova (nebo její odpovídající vlastnosti), aby SqlPassword umožňovaly nové chování při ověřování šifrování a certifikátu. |
| Automatický překlad | SSPROP_INIT_AUTOTRANSLATE | Nakonfiguruje překlad znaků OEM/ANSI. Rozpoznané hodnoty jsou true a false. |
| Časový limit připojení | DBPROP_INIT_TIMEOUT | Doba čekání na dokončení inicializace zdroje dat (v sekundách). |
| Počet opakování připojení | SSPROP_INIT_CONNECT_RETRY_COUNT | Určuje počet pokusů o opětovné připojení, pokud dojde ke ztrátě připojení. Platné hodnoty jsou v rozsahu od 0 do 255. Výchozí hodnota je 1. Hodnota 0 by neměla vést k žádnému pokusu o opětovné připojení. Další informace najdete v tématu Odolnost nečinných připojení. |
| Interval opakování připojení | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Určuje počet sekund mezi jednotlivými pokusy o opakování připojení, pokud dojde ke ztrátě připojení. Platné hodnoty jsou v rozsahu od 1 do 60. Výchozí hodnota je 10. Další informace najdete v tématu Odolnost nečinných připojení. |
| Aktuální jazyk | SSPROPT_INIT_CURRENTLANGUAGE | Název jazyka SQL Serveru. |
| Zdroj dat | DBPROP_INIT_DATASOURCE | Název instance SQL Serveru v organizaci. Pokud není zadáno, vytvoří se připojení k výchozí instanci v místním počítači. Další informace o platné syntaxi adresy najdete v popisu klíčového slova Server v tomto článku. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Určuje režim zpracování datového typu, který se má použít. Rozpoznané hodnoty jsou 0 pro datové typy zprostředkovatele a 80 pro datové typy SQL Serveru 2000 (8.x). |
| Záložní partner | SSPROP_INIT_FAILOVERPARTNER | Název serveru převzetí služeb při selhání, který se používá pro zrcadlení databáze. |
| Název SPN partnera pro převzetí služeb při selhání | SSPROP_INIT_FAILOVERPARTNERSPN | Hlavní název služby (SPN) partnera pro převzetí služeb při selhání. Výchozí hodnota je prázdný řetězec. Prázdný řetězec způsobí, že ovladač OLE DB pro SQL Server použije výchozí hlavní název služby generované poskytovatelem. |
| Název hostitele v certifikátu | SSPROP_INIT_HOST_NAME_CERTIFICATE | Název hostitele, který se má použít při ověřování certifikátu TLS/SSL SQL Serveru. Pokud není nastavené klíčové slovo Název hostitele v certifikátu , ovladač použije jako název hostitele hodnotu klíčového slova Zdroj dat na adrese URL připojení k ověření certifikátu TLS/SSL SQL Serveru. POZNÁMKA: Tato vlastnost se ignoruje, pokud je certifikát serveru důvěryhodný. Pokud je šifrování pro data nastaveno na Strict, certifikát se vždy ověří. |
| Počáteční katalog | DBPROP_INIT_CATALOG | Název databáze. |
| Počáteční název souboru | SSPROP_INIT_FILENAME | Název primárního souboru (včetně úplného názvu cesty) připojitelné databáze. Chcete-li použít AttachDBFileName, musíte také zadat název databáze v řetězci zprostředkovatele s klíčovým slovem DATABASE. Pokud byla databáze dříve připojená, SQL Server ji znovu nepřipoje (použije připojenou databázi jako výchozí pro připojení). |
| Integrované zabezpečení | DBPROP_AUTH_INTEGRATED | Přijímá hodnotu SSPI pro ověřování systému Windows. |
| Připojení MARS | SSPROP_INIT_MARSCONNECTION | Povolí nebo zakáže v připojení několik aktivních sad výsledků (MARS). Rozpoznané hodnoty jsou true a false. Výchozí hodnota je false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Při připojování k naslouchacímu procesu skupiny dostupnosti SQL Serveru nebo instance SQL Serveru s podporou převzetí služeb při selhání clusteru vždy zadejte MultiSubnetFailover=True.
MultiSubnetFailover=True konfiguruje ovladač OLE DB pro SQL Server tak, aby poskytoval rychlejší detekci a připojení k (aktuálně) aktivnímu serveru. Možné hodnoty jsou True a False. Výchozí hodnota je False. Například:MultiSubnetFailover=TrueDalší informace o ovladači OLE DB pro podporu SQL Serveru pro skupiny dostupnosti AlwaysOn naleznete v tématu Ovladač OLE DB pro SQL Server Podpora pro vysokou dostupnost, Zotavení po havárii. |
| Síťová adresa | SSPROP_INIT_NETWORKADDRESS | Síťová adresa instance SQL Serveru v organizaci. Další informace o platné syntaxi adresy najdete v popisu klíčového slova Adresa v tomto článku. |
| Síťová knihovna | SSPROP_INIT_NETWORKLIBRARY | Síťová knihovna používaná k navázání připojení k instanci SQL Serveru v organizaci. |
| Velikost paketu | SSPROP_INIT_PACKETSIZE | Velikost paketů TDS (Tabular Data Stream). Výchozí hodnota je 0 (skutečná hodnota bude určena serverem). |
| Heslo | DBPROP_AUTH_PASSWORD | Přihlašovací heslo SQL Serveru. |
| Zachování bezpečnostních údajů | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Přijímá řetězce true a false jako hodnoty. Pokud false, objekt zdroje dat nesmí uchovávat citlivé ověřovací informace. |
| Poskytovatel | Pro ovladač OLE DB pro SQL Server by tato hodnota měla být "MSOLEDBSQL19" nebo "MSOLEDBSQL". | |
| Certifikát serveru | SSPROP_INIT_SERVER_CERTIFICATE | Určuje cestu k souboru certifikátu, který se má shodovat s certifikátem TLS/SSL SQL Serveru. Tuto možnost lze použít pouze v případě, že Strict je povolené šifrování. Přijaté formáty certifikátů jsou PEM, DER a CER. Pokud je zadaný, zkontroluje se certifikát SQL Serveru tak, že zjistí, jestli se zadaný certifikát přesně shoduje. |
| Server SPN | SSPROP_INIT_SERVERSPN | Hlavní název služby (SPN) pro server. Výchozí hodnota je prázdný řetězec. Prázdný řetězec způsobí, že ovladač OLE DB pro SQL Server použije výchozí hlavní název služby generované poskytovatelem. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | 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 několik IP adres. TNIR komunikuje s MultiSubnetFailover a poskytuje různé sekvence připojení. Možné hodnoty jsou True a False. Výchozí hodnota je True. Další informace najdete v tématu Použití transparentního síťového překladu IP adres. |
| Důvěřovat certifikátu serveru1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Přijímá řetězce true a false jako hodnoty. Výchozí hodnota je false, což znamená, že certifikát serveru bude ověřen. |
| Použití šifrování pro data1 | SSPROP_INIT_ENCRYPT | Určuje, jestli se mají data před odesláním přes síť šifrovat. Možné hodnoty jsou Optional, Mandatorya Strict. Výchozí hodnota je Mandatory. Informace o verzích 18.x.x najdete v tématu Hlavní rozdíly ve verzi MSOLEDBSQL. |
| Použití FMTONLY | SSPROP_INIT_USEFMTONLY | Určuje, jak se metadata načítají při připojování k SQL Serveru 2012 (11.x) a novějšímu. Možné hodnoty jsou true a false. Výchozí hodnota je false.Ovladač OLE DB pro SQL Server ve výchozím nastavení používá sp_describe_first_result_set a sp_describe_undeclared_parameters uložené procedury k načtení metadat. Tyto uložené procedury mají určitá omezení (například při provozu s dočasnými tabulkami selžou). Nastavení Použít FMTONLY instruuje true ovladač, aby použil SET FMTONLY pro načítání metadat místo toho. |
| ID uživatele | DBPROP_AUTH_USERID | Přihlašovací jméno SQL Serveru. |
| ID pracovní stanice | SSPROP_INIT_WSID | Identifikátor pracovní stanice. |
[1]: Aby se zlepšilo zabezpečení, chování šifrování a ověření certifikátu se upraví při použití vlastností inicializace ověřovacího nebo přístupového tokenu nebo odpovídajících klíčových slov připojovacího řetězce. Podrobnosti najdete v tématu Šifrování a ověření certifikátu.
Poznámka:
V připojovacím řetězci vlastnost Old Password nastaví SSPROP_AUTH_OLD_PASSWORD, což je aktuální (pravděpodobně prošlé) heslo, které není dostupné prostřednictvím vlastnosti řetězce poskytovatele.
Klíčová slova připojovacího řetězce ADO (ActiveX Data Objects)
Aplikace ADO nastavují vlastnost ConnectionString objektů ADODBConnection nebo poskytují připojovací řetězec jako parametr metodě Open objektů ADODBConnection .
Aplikace ADO mohou také používat klíčová slova používaná metodou OLE DB IDBInitialize::Initialize , ale pouze pro vlastnosti, které nemají výchozí hodnotu. Pokud aplikace používá klíčová slova ADO i IDBInitialize::Initialize klíčová slova v inicializačním řetězci, použije se nastavení klíčového slova ADO. Doporučuje se, aby aplikace používaly pouze klíčová slova připojovacího řetězce ADO.
Připojovací řetězce používané ADO mají následující syntaxi:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=["]attribute-value["]attribute-value ::= character-stringattribute-keyword ::= identifier
Hodnoty atributů lze volitelně uzavřít do dvojitých uvozovek a je vhodné to udělat. Tento postup zabraňuje problémům, když hodnoty obsahují jiné než alfanumerické znaky. Hodnoty atributů nemohou obsahovat dvojité uvozovky.
Následující tabulka popisuje klíčová slova, která se dají použít s připojovacím řetězcem ADO:
| Keyword | Inicializační vlastnost | Description |
|---|---|---|
| Přístupový token1 | SSPROP_AUTH_ACCESS_TOKEN | Přístupový token použitý k autentizaci v Microsoft Entra ID. POZNÁMKA: Jedná se o chybu při zadání tohoto klíčového slova, stejně jako klíčových slov připojovacího řetězce UID, PWD, Trusted_Connection nebo Authentication nebo jejich odpovídajících vlastností/klíčových slov. |
| Záměr aplikace | SSPROP_INIT_APPLICATIONINTENT | Deklaruje typ úlohy aplikace při připojování k serveru. Možné hodnoty jsou ReadOnly a ReadWrite.Výchozí hodnota je ReadWrite. Další informace o ovladači OLE DB pro podporu SQL Serveru pro skupiny dostupnosti AlwaysOn naleznete v tématu Ovladač OLE DB pro SQL Server Podpora pro vysokou dostupnost, Zotavení po havárii. |
| Název aplikace | SSPROP_INIT_APPNAME | Řetězec identifikující aplikaci. |
| Ověřování1 | SSPROP_AUTH_MODE | Určuje použité ověřování SQL nebo Microsoft Entra. Platné hodnoty jsou:
POZNÁMKA: Klíčové ActiveDirectoryIntegrated slovo lze také použít pro ověřování systému Windows na SQL Server. Nahradí Integrated Security (nebo Trusted_Connection) ověřovací klíčová slova.
Doporučuje se, aby aplikace používající Integrated Security (neboTrusted_Connection) klíčová slova nebo jejich odpovídající vlastnosti nastavily hodnotu klíčového Authentication slova (nebo její odpovídající vlastnosti) tak, aby ActiveDirectoryIntegrated umožňovaly nové chování při šifrování a ověřování certifikátů.POZNÁMKA:Doporučuje se, aby aplikace používající SQL Server ověřování nastavily hodnotu klíčového Authentication slova (nebo její odpovídající vlastnosti), aby SqlPassword umožňovaly nové chování při ověřování šifrování a certifikátu. |
| Automatický překlad | SSPROP_INIT_AUTOTRANSLATE | Nakonfiguruje překlad znaků OEM/ANSI. Rozpoznané hodnoty jsou true a false. |
| Časový limit připojení | DBPROP_INIT_TIMEOUT | Doba čekání na dokončení inicializace zdroje dat (v sekundách). |
| Počet opakování připojení | SSPROP_INIT_CONNECT_RETRY_COUNT | Určuje počet pokusů o opětovné připojení, pokud dojde ke ztrátě připojení. Platné hodnoty jsou v rozsahu od 0 do 255. Výchozí hodnota je 1. Hodnota 0 by neměla vést k žádnému pokusu o opětovné připojení. Další informace najdete v tématu Odolnost nečinných připojení. |
| Interval opakování připojení | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Určuje počet sekund mezi jednotlivými pokusy o opakování připojení, pokud dojde ke ztrátě připojení. Platné hodnoty jsou v rozsahu od 1 do 60. Výchozí hodnota je 10. Další informace najdete v tématu Odolnost nečinných připojení. |
| Aktuální jazyk | SSPROPT_INIT_CURRENTLANGUAGE | Název jazyka SQL Serveru. |
| Zdroj dat | DBPROP_INIT_DATASOURCE | Název instance SQL Serveru v organizaci. Pokud není zadáno, vytvoří se připojení k výchozí instanci v místním počítači. Další informace o platné syntaxi adresy najdete v popisu klíčového slova Server v tomto článku. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Určuje režim zpracování datového typu, který se použije. Rozpoznané hodnoty jsou 0 určené pro datové typy zprostředkovatele a 80 pro datové typy SQL Serveru 2000. |
| Záložní partner | SSPROP_INIT_FAILOVERPARTNER | Název serveru převzetí služeb při selhání, který se používá pro zrcadlení databáze. |
| Název SPN partnera pro převzetí služeb při selhání | SSPROP_INIT_FAILOVERPARTNERSPN | Hlavní název služby (SPN) partnera pro převzetí služeb při selhání. Výchozí hodnota je prázdný řetězec. Prázdný řetězec způsobí, že ovladač OLE DB pro SQL Server použije výchozí hlavní název služby generované poskytovatelem. |
| Název hostitele v certifikátu | SSPROP_INIT_HOST_NAME_CERTIFICATE | Název hostitele, který se má použít při ověřování certifikátu TLS/SSL SQL Serveru. Pokud není nastavené klíčové slovo Název hostitele v certifikátu , ovladač použije jako název hostitele hodnotu klíčového slova Zdroj dat na adrese URL připojení k ověření certifikátu TLS/SSL SQL Serveru. POZNÁMKA: Tato vlastnost se ignoruje, pokud je certifikát serveru důvěryhodný. Pokud je šifrování pro data nastaveno na Strict, certifikát se vždy ověří. |
| Počáteční katalog | DBPROP_INIT_CATALOG | Název databáze. |
| Počáteční název souboru | SSPROP_INIT_FILENAME | Název primárního souboru (včetně úplného názvu cesty) připojitelné databáze. Chcete-li použít AttachDBFileName, musíte také určit název databáze pomocí klíčového slova DATABASE v řetězci poskytovatele. Pokud byla databáze dříve připojená, SQL Server ji znovu nepřipoje (použije připojenou databázi jako výchozí pro připojení). |
| Integrované zabezpečení | DBPROP_AUTH_INTEGRATED | Přijímá hodnotu SSPI pro ověřování systému Windows. |
| Připojení MARS | SSPROP_INIT_MARSCONNECTION | Povolí nebo zakáže v připojení několik aktivních sad výsledků (MARS), pokud je server SQL Server 2005 (9.x) nebo novější. Rozpoznané hodnoty jsou true a false. Výchozí hodnota je false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Při připojování k naslouchacímu procesu skupiny dostupnosti SQL Serveru nebo instance SQL Serveru s podporou převzetí služeb při selhání clusteru vždy zadejte MultiSubnetFailover=True.
MultiSubnetFailover=True konfiguruje ovladač OLE DB pro SQL Server tak, aby poskytoval rychlejší detekci a připojení k (aktuálně) aktivnímu serveru. Možné hodnoty jsou True a False. Výchozí hodnota je False. Například:MultiSubnetFailover=TrueDalší informace o ovladači OLE DB pro podporu SQL Serveru pro skupiny dostupnosti AlwaysOn naleznete v tématu Ovladač OLE DB pro SQL Server Podpora pro vysokou dostupnost, Zotavení po havárii. |
| Síťová adresa | SSPROP_INIT_NETWORKADDRESS | Síťová adresa instance SQL Serveru v organizaci. Další informace o platné syntaxi adresy najdete v popisu klíčového slova Adresa v tomto článku. |
| Síťová knihovna | SSPROP_INIT_NETWORKLIBRARY | Síťová knihovna používaná k navázání připojení k instanci SQL Serveru v organizaci. |
| Velikost paketu | SSPROP_INIT_PACKETSIZE | Velikost paketů TDS (Tabular Data Stream). Výchozí hodnota je 0 (skutečná hodnota bude určena serverem). |
| Heslo | DBPROP_AUTH_PASSWORD | Přihlašovací heslo SQL Serveru. |
| Zachování bezpečnostních údajů | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Přijímá řetězce true a false jako hodnoty. Pokud false, objekt zdroje dat nesmí ukládat citlivé ověřovací informace. |
| Poskytovatel | Pro ovladač OLE DB pro SQL Server je hodnota MSOLEDBSQL19 nebo MSOLEDBSQL. |
|
| Certifikát serveru | SSPROP_INIT_SERVER_CERTIFICATE | Určuje cestu k souboru certifikátu, který se má shodovat s certifikátem TLS/SSL SQL Serveru. Tuto možnost lze použít pouze v případě, že Strict je povolené šifrování. Přijaté formáty certifikátů jsou PEM, DER a CER. Pokud je zadaný, zkontroluje se certifikát SQL Serveru tak, že zjistí, jestli se zadaný certifikát přesně shoduje. |
| Server SPN | SSPROP_INIT_SERVERSPN | Hlavní název služby (SPN) pro server. Výchozí hodnota je prázdný řetězec. Prázdný řetězec způsobí, že ovladač OLE DB pro SQL Server použije výchozí hlavní název služby generované poskytovatelem. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | 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 několik IP adres. TNIR komunikuje s MultiSubnetFailover a poskytuje různé sekvence připojení. Možné hodnoty jsou True a False. Výchozí hodnota je True. Další informace najdete v tématu Použití transparentního síťového překladu IP adres. |
| Důvěřovat certifikátu serveru1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Přijímá řetězce true a false jako hodnoty. Výchozí hodnota je false, což znamená, že certifikát serveru bude ověřen. |
| Použití šifrování pro data1 | SSPROP_INIT_ENCRYPT | Určuje, jestli se mají data před odesláním přes síť šifrovat. Možné hodnoty jsou Optional, Mandatorya Strict. Výchozí hodnota je Mandatory. Informace o verzích 18.x.x najdete v tématu Hlavní rozdíly ve verzi MSOLEDBSQL. |
| Použití FMTONLY | SSPROP_INIT_USEFMTONLY | Určuje, jak se metadata načítají při připojování k SQL Serveru 2012 (11.x) a novějšímu. Možné hodnoty jsou true a false. Výchozí hodnota je false.Ovladač OLE DB pro SQL Server ve výchozím nastavení používá sp_describe_first_result_set a sp_describe_undeclared_parameters uložené procedury k načtení metadat. Tyto uložené procedury mají určitá omezení (například při provozu s dočasnými tabulkami selžou). Nastavení Použít FMTONLY instruuje true ovladač, aby použil SET FMTONLY pro načítání metadat místo toho. |
| ID uživatele | DBPROP_AUTH_USERID | Přihlašovací jméno SQL Serveru. |
| ID pracovní stanice | SSPROP_INIT_WSID | Identifikátor pracovní stanice. |
[1]: Aby se zlepšilo zabezpečení, chování šifrování a ověření certifikátu se upraví při použití vlastností inicializace ověřovacího nebo přístupového tokenu nebo odpovídajících klíčových slov připojovacího řetězce. Podrobnosti najdete v tématu Šifrování a ověření certifikátu.
Poznámka:
V připojovacím řetězci vlastnost Old Password nastaví SSPROP_AUTH_OLD_PASSWORD, což je aktuální (pravděpodobně prošlé) heslo, které není dostupné prostřednictvím vlastnosti řetězce zprostředkovatele.