Použití klíčových slov připojovacího řetězce s ovladačem OLE DB pro SQL Server

Platí pro:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytický platformový systém (PDW)SQL databáze v Microsoft Fabric

Stáhnout ovladač OLE DB

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 jednoznačnost kvůli zachování zpětné kompatibility v připojovacích řetězcích (například některá klíčová slova lze zadat více než jednou a konfliktní klíčová slova mohou být povolena pomocí řešení 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. Ve druhém případě lze inicializační řetězec předat 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, která IDataInitialize::GetDataSource používá, 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 prostřednictvím DBPROP_INIT_PROVIDERSTRING hodnot jsou nastaveny pomocí hodnot yes a no. Logické vlastnosti nastavené v inicializačních řetězcích pomocí IDataInitialize::GetDataSource jsou nastaveny pomocí hodnot true a false.

Aplikace, které používají IDataInitialize::GetDataSource , mohou také používat klíčová slova používaná uživatelem IDBInitialize::Initialize, ale pouze pro vlastnosti, které nemají výchozí hodnotu. Pokud aplikace používá klíčová slova IDataInitialize::GetDataSource a IDBInitialize::Initialize v inicializačním řetězci, použije se nastavení klíčového slova IDataInitialize::GetDataSource. Doporučuje se, aby aplikace v připojovacích řetězcích nepoužívají IDBInitialize::Initialize klíčová slova IDataInitialize:GetDataSource , protože toto chování nemusí být v budoucích verzích zachováno.

Poznámka:

Připojovací řetězec předaný prostřednictvím IDataInitialize::GetDataSource se převede na vlastnosti a aplikuje pomocí 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 DBPROP_PROVIDERSTRING vlastnosti. Pokud například zadáte připojovací řetězec Data Source=server1;Server=server2, Data Source nastaví se 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, které používají DBPROP_INIT_PROVIDERSTRING , IDBInitialize::Initialize mají následující syntaxi:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=[{]attribute-value[}]
attribute-value ::= character-string
attribute-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á lze použít s DBPROP_INIT_PROVIDERSTRING.

Keyword	Inicializační vlastnost	Description
`Addr`	`SSPROP_INIT_NETWORKADDRESS`	Synonymum pro `Address`.
`Address`	`SSPROP_INIT_NETWORKADDRESS`	Síťová adresa serveru, na kterém běží instance SQL Serveru. `Address` je obvykle síťový název serveru, ale může to být i jiné názvy, jako je 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 `Address` má přednost před hodnotou předanou `Server` v připojovacích řetězcích při použití ovladače OLE DB pro SQL Server. `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 `Address` slova 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í zadaný žádný protokol ani `Network` klíčové slovo, 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`.
`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 Databáze 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í).
`Authentication` ¹	`SSPROP_AUTH_MODE`	Určuje použité ověřování SQL nebo Microsoft Entra. Platné hodnoty jsou: `(not set)`: Režim ověřování určený jinými klíčovými slovy. `ActiveDirectoryPassword`: ID uživatele a autentizace pomocí hesla s identitou Microsoft Entra. `ActiveDirectoryIntegrated`: Integrované ověřování s ID Microsoft Entra. Poznámka: Klíčové `ActiveDirectoryIntegrated` slovo lze také použít pro autentizaci Windows vůči SQL Serveru. Nahradí `Integrated Security` (nebo `Trusted_Connection`) ověřovací klíčová slova. Aplikace používající `Integrated Security` (nebo `Trusted_Connection`) klíčová slova či jejich odpovídající vlastnosti by měly nastavit hodnotu `Authentication` klíčového slova (nebo jeho odpovídající vlastnosti), `ActiveDirectoryIntegrated` aby umožnily nové chování šifrování a ověřování certifikátů. `ActiveDirectoryInteractive`: Interaktivní autentizace s identitou Microsoft Entra. Tato metoda podporuje vícefaktorové ověřování Microsoft Entra. `ActiveDirectoryMSI`: Ověření spravované identity . Pro identitu přiřazenou uživatelem by mělo být ID uživatele nastaveno na ID objektu identity uživatele. `ActiveDirectoryServicePrincipal`: Ověřování pomocí principála služby Microsoft Entra. ID uživatele by mělo být nastaveno na ID aplikace (klienta). Heslo by mělo být nastavené na tajný klíč aplikace (klienta). `SqlPassword`: Autentizace pomocí uživatelského ID a hesla. Poznámka: Aplikace využívající autentizaci SQL Server by měly nastavit hodnotu `Authentication` klíčového slova (nebo jeho odpovídající vlastnosti) tak, aby umožnily `SqlPassword`nové šifrování a ověřování certifikátů.
`Auto Translate`	`SSPROP_INIT_AUTOTRANSLATE`	Synonymum pro `AutoTranslate`.
`AutoTranslate`	`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 nevedla k žádnému pokusu o opětovné připojení. Další informace naleznete v tématu Odolnost nečinných připojení v ovladači OLE DB.
`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 naleznete v tématu Odolnost nečinných připojení v ovladači OLE DB.
`Database`	`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` pro datové typy zprostředkovatele a `80` pro datové typy SQL Serveru 2000 (8.x).
`Encrypt` ¹	`SSPROP_INIT_ENCRYPT`	Určuje, jestli se mají data před odesláním přes síť šifrovat. Možné hodnoty jsou `Optional`, `Mandatory`a `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. `HostNameInCertificate` Pokud klíčové slovo není nastavené, ovladač použije `Server` hodnotu klíčového slova 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 `Encrypt` je nastavená hodnota `Strict`, certifikát se vždy ověří.
`Language`	`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 SQL Serveru nebo instanci clusteru SQL Serveru s podporou převzetí služeb při selhání vždy zadejte `MultiSubnetFailover=Yes`. `MultiSubnetFailover=Yes` nakonfiguruje 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=Yes` 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.
`Net`	`SSPROP_INIT_NETWORKLIBRARY`	Synonymum pro `Network`.
`Network`	`SSPROP_INIT_NETWORKLIBRARY`	Síťová knihovna používaná k navázání připojení k instanci SQL Serveru v organizaci.
`Network Library`	`SSPROP_INIT_NETWORKLIBRARY`	Synonymum pro `Network`.
`PacketSize`	`SSPROP_INIT_PACKETSIZE`	Velikost paketů TDS (Tabular Data Stream). Výchozí hodnota je `0` (skutečná hodnota bude určena serverem).
`PersistSensitive`	`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 `Address` přepíše klíčové slovo `Server`. 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=(local);` `Server=(local);` `Server=(localhost);` `Server=(localdb)\<instancename>;` Další informace o podpoře LocalDB naleznete v tématu OLE DB Driver for SQL Server Support for LocalDB. Chcete-li zadat pojmenovanou instanci SYSTÉMU SQL Server, 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 `Server` slova je následující: [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\query` Výš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 `Network` klíčové slovo, 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 ignorují na začátku hodnoty předané `Server` v připojovacích řetězcích při použití ovladače OLE DB pro SQL Server.
`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.
`Timeout`	`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 `yes`tato 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.
`TrustServerCertificate` ¹	`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` na `yes` dává 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.

¹ Chcete-li zlepšit 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žijte IDataInitialize::GetDataSource

Připojovací řetězce používané aplikacemi IDataInitialize::GetDataSource OLE DB mají následující syntaxi:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=[quote]attribute-value[quote]
attribute-value ::= character-string
attribute-keyword ::= identifier
quote ::= " | '

Použití vlastnosti musí odpovídat syntaxi povolené v daném kontextu. WSID Například používá složené závorky ({}) uvozovky a Application Name 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, se kterými se můžou používat IDataInitialize::GetDataSource:

Keyword	Inicializační vlastnost	Description
`Access Token` ¹	`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 a také `UID`, `PWD`, `Trusted_Connection` nebo klíčových slov připojovacího řetězce, či jejich odpovídajících vlastností a klíčových slov `Authentication`.
`Application Name`	`SSPROP_INIT_APPNAME`	Řetězec identifikující aplikaci.
`Application Intent`	`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.
`Authentication` ¹	`SSPROP_AUTH_MODE`	Určuje použité ověřování SQL nebo Microsoft Entra. Platné hodnoty jsou: `(not set)`: Režim ověřování určený jinými klíčovými slovy. `ActiveDirectoryPassword`: ID uživatele a autentizace pomocí hesla s identitou Microsoft Entra. `ActiveDirectoryIntegrated`: Integrované ověřování s ID Microsoft Entra. Poznámka: Klíčové `ActiveDirectoryIntegrated` slovo lze také použít pro autentizaci Windows vůči SQL Serveru. Nahradí `Integrated Security` (nebo `Trusted_Connection`) ověřovací klíčová slova. Aplikace používající `Integrated Security` (nebo `Trusted_Connection`) klíčová slova či jejich odpovídající vlastnosti by měly nastavit hodnotu `Authentication` klíčového slova (nebo jeho odpovídající vlastnosti), `ActiveDirectoryIntegrated` aby umožnily nové chování šifrování a ověřování certifikátů. `ActiveDirectoryInteractive`: Interaktivní autentizace s identitou Microsoft Entra. Tato metoda podporuje vícefaktorové ověřování Microsoft Entra. `ActiveDirectoryMSI`: Ověření spravované identity . Pro identitu přiřazenou uživatelem by mělo být ID uživatele nastaveno na ID objektu identity uživatele. `ActiveDirectoryServicePrincipal`: Ověřování pomocí principála služby Microsoft Entra. ID uživatele by mělo být nastaveno na ID aplikace (klienta). Heslo by mělo být nastavené na tajný klíč aplikace (klienta). `SqlPassword`: Autentizace pomocí uživatelského ID a hesla. Poznámka: Aplikace využívající autentizaci SQL Server by měly nastavit hodnotu `Authentication` klíčového slova (nebo jeho odpovídající vlastnosti) tak, aby umožnily `SqlPassword`nové šifrování a ověřování certifikátů.
`Auto Translate`	`SSPROP_INIT_AUTOTRANSLATE`	Nakonfiguruje překlad znaků OEM/ANSI. Rozpoznané hodnoty jsou `true` a `false`.
`Connect Timeout`	`DBPROP_INIT_TIMEOUT`	Doba čekání na dokončení inicializace zdroje dat (v sekundách).
`Connect Retry Count`	`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 znamenala, že by nedošlo k žádnému pokusu o opětovné připojení. Další informace naleznete v tématu Odolnost nečinných připojení v ovladači OLE DB.
`Connect Retry Interval`	`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 naleznete v tématu Odolnost nečinných připojení v ovladači OLE DB.
`Current Language`	`SSPROPT_INIT_CURRENTLANGUAGE`	Název jazyka SQL Serveru.
`Data Source`	`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 `Server` slova 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).
`Failover Partner`	`SSPROP_INIT_FAILOVERPARTNER`	Název serveru převzetí služeb při selhání, který se používá pro zrcadlení databáze.
`Failover Partner SPN`	`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.
`Host Name In Certificate`	`SSPROP_INIT_HOST_NAME_CERTIFICATE`	Název hostitele, který se má použít při ověřování certifikátu TLS/SSL SQL Serveru. `Host Name In Certificate` Pokud klíčové slovo není nastavené, ovladač použije `Data Source` hodnotu klíčového slova 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 `Use Encryption for Data` je nastavená hodnota `Strict`, certifikát se vždy ověří.
`Initial Catalog`	`DBPROP_INIT_CATALOG`	Název databáze.
`Initial File Name`	`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 poskytovatele 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í).
`Integrated Security`	`DBPROP_AUTH_INTEGRATED`	Přijímá hodnotu `SSPI` pro ověřování systému Windows.
`MARS Connection`	`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 posluchači skupiny dostupnosti SQL Serveru nebo instanci clusteru SQL Serveru s podporou převzetí služeb při selhání vždy zadejte `MultiSubnetFailover=True`. `MultiSubnetFailover=True` nakonfiguruje 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=True` 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.
`Network Address`	`SSPROP_INIT_NETWORKADDRESS`	Síťová adresa instance SQL Serveru v organizaci. Další informace o platné syntaxi adresy najdete v popisu klíčového `Address` slova v tomto článku.
`Network Library`	`SSPROP_INIT_NETWORKLIBRARY`	Síťová knihovna používaná k navázání připojení k instanci SQL Serveru v organizaci.
`Packet Size`	`SSPROP_INIT_PACKETSIZE`	Velikost paketů TDS (Tabular Data Stream). Výchozí hodnota je `0` (skutečná hodnota bude určena serverem).
`Password`	`DBPROP_AUTH_PASSWORD`	Přihlašovací heslo SQL Serveru.
`Persist Security Info`	`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.
`Provider`		Pro ovladač OLE DB pro SQL Server je hodnota `MSOLEDBSQL19` nebo `MSOLEDBSQL`.
`Server Certificate`	`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.
`Trust Server Certificate` ¹	`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.
`Use Encryption for Data` ¹	`SSPROP_INIT_ENCRYPT`	Určuje, jestli se mají data před odesláním přes síť šifrovat. Možné hodnoty jsou `Optional`, `Mandatory`a `Strict`. Výchozí hodnota je `Mandatory`. Informace o verzích 18.x.x najdete v tématu Hlavní rozdíly ve verzi MSOLEDBSQL.
`Use 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í hodnoty `Use FMTONLY` na `true` pokynuje ovladači, aby místo toho použil SET FMTONLY pro načítání metadat.
`User ID`	`DBPROP_AUTH_USERID`	Přihlašovací jméno SQL Serveru.
`Workstation ID`	`SSPROP_INIT_WSID`	Identifikátor pracovní stanice.

¹ Pokud chcete zlepšit 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í jako 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 datových objektů ActiveX (ADO)

Aplikace ADO nastavují ConnectionString vlastnost ADODBConnection objektů nebo poskytují připojovací řetězec jako parametr Open metodě ADODBConnection objektů.

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ých slov 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-string
empty-string ::=
attribute ::= attribute-keyword=["]attribute-value["]
attribute-value ::= character-string
attribute-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 můžou použít s připojovacím řetězcem ADO:

Keyword	Inicializační vlastnost	Description
`Access Token` ¹	`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 spolu s klíčovými slovy připojovacího řetězce `UID`, `PWD`, `Trusted_Connection`, `Authentication` nebo jejich odpovídajícími vlastnostmi/klíčovými slovy.
`Application Intent`	`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.
`Application Name`	`SSPROP_INIT_APPNAME`	Řetězec identifikující aplikaci.
`Authentication` ¹	`SSPROP_AUTH_MODE`	Určuje použité ověřování SQL nebo Microsoft Entra. Platné hodnoty jsou: `(not set)`: Režim ověřování určený jinými klíčovými slovy. `ActiveDirectoryPassword`: ID uživatele a autentizace pomocí hesla s identitou Microsoft Entra. `ActiveDirectoryIntegrated`: Integrované ověřování s ID Microsoft Entra. Poznámka: Klíčové `ActiveDirectoryIntegrated` slovo lze také použít pro autentizaci Windows vůči SQL Serveru. Nahradí `Integrated Security` (nebo `Trusted_Connection`) ověřovací klíčová slova. Aplikace používající `Integrated Security` (nebo `Trusted_Connection`) klíčová slova či jejich odpovídající vlastnosti by měly nastavit hodnotu `Authentication` klíčového slova (nebo jeho odpovídající vlastnosti), `ActiveDirectoryIntegrated` aby umožnily nové chování šifrování a ověřování certifikátů. `ActiveDirectoryInteractive`: Interaktivní autentizace s identitou Microsoft Entra. Tato metoda podporuje vícefaktorové ověřování Microsoft Entra. `ActiveDirectoryMSI`: Ověření spravované identity . Pro identitu přiřazenou uživatelem by mělo být ID uživatele nastaveno na ID objektu identity uživatele. `ActiveDirectoryServicePrincipal`: Ověřování pomocí principála služby Microsoft Entra. ID uživatele by mělo být nastaveno na ID aplikace (klienta). Heslo by mělo být nastavené na tajný klíč aplikace (klienta). `SqlPassword`: Autentizace pomocí uživatelského ID a hesla. Poznámka: Aplikace využívající autentizaci SQL Server by měly nastavit hodnotu `Authentication` klíčového slova (nebo jeho odpovídající vlastnosti) tak, aby umožnily `SqlPassword`nové šifrování a ověřování certifikátů.
`Auto Translate`	`SSPROP_INIT_AUTOTRANSLATE`	Nakonfiguruje překlad znaků OEM/ANSI. Rozpoznané hodnoty jsou `true` a `false`.
`Connect Timeout`	`DBPROP_INIT_TIMEOUT`	Doba čekání na dokončení inicializace zdroje dat (v sekundách).
`Connect Retry Count`	`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 vedla k tomu, že by se neuskutečnil žádný pokus o opětovné připojení. Další informace naleznete v tématu Odolnost nečinných připojení v ovladači OLE DB.
`Connect Retry Interval`	`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 naleznete v tématu Odolnost nečinných připojení v ovladači OLE DB.
`Current Language`	`SSPROPT_INIT_CURRENTLANGUAGE`	Název jazyka SQL Serveru.
`Data Source`	`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 `Server` slova 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` pro datové typy zprostředkovatele a `80` pro datové typy SQL Serveru 2000 (8.x).
`Failover Partner`	`SSPROP_INIT_FAILOVERPARTNER`	Název serveru převzetí služeb při selhání, který se používá pro zrcadlení databáze.
`Failover Partner SPN`	`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.
`Host Name In Certificate`	`SSPROP_INIT_HOST_NAME_CERTIFICATE`	Název hostitele, který se má použít při ověřování certifikátu TLS/SSL SQL Serveru. `Host Name In Certificate` Pokud klíčové slovo není nastavené, ovladač použije `Data Source` hodnotu klíčového slova 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 `Use Encryption for Data` je nastavená hodnota `Strict`, certifikát se vždy ověří.
`Initial Catalog`	`DBPROP_INIT_CATALOG`	Název databáze.
`Initial File Name`	`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 zprostředkovatele řetězce `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í).
`Integrated Security`	`DBPROP_AUTH_INTEGRATED`	Přijímá hodnotu `SSPI` pro ověřování systému Windows.
`MARS Connection`	`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 posluchači skupiny dostupnosti SQL Serveru nebo instanci clusteru SQL Serveru s podporou převzetí služeb při selhání vždy zadejte `MultiSubnetFailover=True`. `MultiSubnetFailover=True` nakonfiguruje 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=True` 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.
`Network Address`	`SSPROP_INIT_NETWORKADDRESS`	Síťová adresa instance SQL Serveru v organizaci. Další informace o platné syntaxi adresy najdete v popisu klíčového `Address` slova v tomto článku.
`Network Library`	`SSPROP_INIT_NETWORKLIBRARY`	Síťová knihovna používaná k navázání připojení k instanci SQL Serveru v organizaci.
`Packet Size`	`SSPROP_INIT_PACKETSIZE`	Velikost paketů TDS (Tabular Data Stream). Výchozí hodnota je `0` (skutečná hodnota bude určena serverem).
`Password`	`DBPROP_AUTH_PASSWORD`	Přihlašovací heslo SQL Serveru.
`Persist Security Info`	`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.
`Provider`		Pro ovladač OLE DB pro SQL Server je hodnota `MSOLEDBSQL19` nebo `MSOLEDBSQL`.
`Server Certificate`	`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.
`Trust Server Certificate` ¹	`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.
`Use Encryption for Data` ¹	`SSPROP_INIT_ENCRYPT`	Určuje, jestli se mají data před odesláním přes síť šifrovat. Možné hodnoty jsou `Optional`, `Mandatory`a `Strict`. Výchozí hodnota je `Mandatory`. Informace o verzích 18.x.x najdete v tématu Hlavní rozdíly ve verzi MSOLEDBSQL.
`Use 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í `Use FMTONLY` na `true` instruuje ovladač, aby pro načítání metadat místo toho použil SET FMTONLY.
`User ID`	`DBPROP_AUTH_USERID`	Přihlašovací jméno SQL Serveru.
`Workstation ID`	`SSPROP_INIT_WSID`	Identifikátor pracovní stanice.

Poznámka:

V připojovacím řetězci nastaví SSPROP_AUTH_OLD_PASSWORDvlastnost Old Password , což je aktuální (pravděpodobně prošlé) heslo, které není dostupné prostřednictvím vlastnosti řetězce zprostředkovatele.

Vytváření aplikací pomocí ovladače OLE DB pro SQL Server

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-12-12

Sdílet prostřednictvím

Použití klíčových slov připojovacího řetězce s ovladačem OLE DB pro SQL Server

Klíčová slova připojovacího řetězce ovladače OLE DB

Použití IDBInitialize::Initialize

Použijte IDataInitialize::GetDataSource

Klíčová slova připojovacího řetězce datových objektů ActiveX (ADO)

Související obsah

Váš názor

Další materiály