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ý platformní systém (PDW)
Important
SQL Server Native Client (SNAC) není dodáván s:
- SQL Server 2022 (16.x) a novější verze
- SQL Server Management Studio 19 a novější verze
Pro vývoj nových aplikací se nedoporučuje nativní klient SQL Serveru (SQLNCLI nebo SQLNCLI11) a starší zprostředkovatel Microsoft OLE DB pro SQL Server (SQLOLEDB).
Pro nové projekty použijte jeden z následujících ovladačů:
Informace o SQLNCLI, které se dodává jako součást databázového stroje SQL Serveru (verze 2012 až 2019), naleznete v tomto support lifecycle exception.
Některá nativní klientská API SQL Server používají k určení atributů spojení řetězce spojů. Spojovací řetězce jsou seznamy klíčových slov a přidružených hodnot; Každé klíčové slovo identifikuje konkrétní atribut spojení.
Pro více informací viz Používání klíčových slov spojovacích řetězců s OLE DB Driver for SQL Server.
Poznámka:
SQL Server Native Client umožňuje nejednoznačnost v řetězcích spojení pro zachování zpětné kompatibility (například některá klíčová slova mohou být zadána vícekrát, a konfliktní klíčová slova mohou být povolena s řešením podle pozice nebo přednosti). Je dobrou praxí při úpravě aplikací tak, aby používaly SQL Server Native Client, aby se odstranila jakákoli závislost na nejednoznačnosti připojovací řetězec.
Následující sekce popisují klíčová slova, která lze použít s poskytovatelem SQL Server Native Client OLE DB, ovladačem SQL Server Native Client ODBC a ActiveX Data Objects (ADO) při použití SQL Server Native Client jako poskytovatele dat.
Klíčová slova pro ODBC driver připojovací řetězec
ODBC aplikace používají spojovací řetězce jako parametry funkcí SQLDriverConnect a SQLBrowseConnect .
Spojovací řetězce používané ODBC 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 závorek, což je dobrá praxe. Tím se předchází problémům, když hodnoty atributů obsahují nealfanumerické znaky. Předpokládá se, že první uzavírací závorka v hodnotě končí hodnotu, takže hodnoty nemohou obsahovat uzavírací závorkové znaky.
Následující tabulka popisuje klíčová slova, která lze použít s ODBC připojovací řetězec.
| Keyword | Description |
|---|---|
| Addr | Synonymum pro "adresa". |
| Adresa | 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 adresy má přednost před hodnotou předávanou serveru v řetězcích spojení ODBC při použití SQL Server Native Client. 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í specifikován ani protokol, ani síťové klíčové slovo, SQL Server Native Client použije pořadí protokolů uvedené v 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. |
| AnsiNPW | Když je "ano", ovladač používá chování definované ANSI pro zpracování NULL porovnání, vyplňování znakových dat, varování a konkatenace NULL. Když "ne", chování definované ANSI se neodhaluje. Pro více informací o chování ANSI NPW viz Účinky ISO možností. |
| APP | Název aplikace volající SQLDriverConnect (volitelné). Pokud je tato hodnota specifikována, je uložena ve sloupci master.dbo.sysprocessesprogram_name a vrací ji sp_who a APP_NAME funkce. |
| ApplicationIntent | Deklaruje typ úlohy aplikace při připojování k serveru. Možné hodnoty jsou readOnly a ReadWrite. Výchozí je ReadWrite. Příklad:ApplicationIntent=ReadOnlyPro více informací o podpoře skupin Always On Availability ze strany SQL Server Native klienta viz SQL Server Native Client Support for High Availability, Disaster Recovery. |
| AttachDBFileName | Název primárního souboru připojitelné databáze. Zahrňte celou cestu a uskutečněte libovolné \ znaky, pokud používáte proměnnou řetězce znaků C:AttachDBFileName=c:\\MyFolder\\MyDB.mdfTato databáze je připojena a stává se výchozí databází pro připojení. Pro použití AttachDBFileName musíte také zadat název databáze buď v parametru SQLDriverConnectDATABASE, nebo v atributu SQL_COPT_CURRENT_CATALOG connection. Pokud byla databáze dříve připojena, SQL Server ji znovu nepřipojuje; používá připojenou databázi jako výchozí pro připojení. |
| Automatický přenos | Když je "ano", řetězce znaků ANSI posílané mezi klientem a serverem jsou překládány převodem přes Unicode, aby se minimalizovaly problémy s porovnávání rozšířených znaků mezi kódovými stránkami na klientovi a serveru. Klientská SQL_C_CHAR data odeslaná do SQL Server char, varchar nebo textová proměnná, parametr či sloupec jsou převedena ze znaku do Unicode pomocí klientské ANSI kódové stránky (ACP), poté převedena z Unicode na znak pomocí ACP serveru. SQL Server char,varcharnebo textová data zaslaná klientské SQL_C_CHAR proměnné jsou převedena ze znaku do Unicode pomocí serverového ACP a poté z Unicode na znak pomocí klientského ACP. Tyto převody jsou prováděny na klientovi pomocí nativního ODBC ovladače SQL Server Client. To vyžaduje, aby stejná ANSI kódová stránka (ACP), která se používá na serveru, byla dostupná i na klientovi. Tato nastavení nemají vliv na konverze, které se u těchto převodů odehrají: * Unicode SQL_C_WCHAR klientská data odesílaná na server, char nebo text . * char, varcharnebo data textového serveru odesílaná do proměnné Unicode SQL_C_WCHAR na klientovi. * ANSI SQL_C_CHAR klientská data odesílaná na Unicode nchar, nvarchar nebo ntext na serveru. * Unicode nchar, nvarchar nebo ntext serverová data odesílaná ANSI SQL_C_CHAR proměnné na klientovi. Když "ne", překlad znaků se neprovádí. Nativní ODBC ovladač SQL Server klienta nepřekládá klientské znaky ANSI SQL_C_CHAR data odeslaná do proměnných, parametrů nebo sloupců char, varchar nebo textových proměnných, parametrů či sloupců na serveru. Na char,varchar nebo textová data odesílaná ze serveru na SQL_C_CHAR proměnné na klientovi se neprovádí žádný překlad. Pokud klient a SQL Server používají různé ACP, mohou být rozšířené znaky špatně interpretovány. |
| Databáze | Název výchozí databáze SQL Server pro toto připojení. Pokud není specifikována databáze , použije se výchozí databáze definovaná pro přihlášení. Výchozí databáze ze zdroje ODBC přepisuje výchozí databázi definovanou pro přihlášení. Databáze musí být existující databází, pokud není také specifikováno AttachDBFileName . Pokud je také specifikován AttachDBFileName , je připojen primární soubor, na který odkazuje, a je mu přidělen název databáze určený Database. |
| Ovladač | Název ovladače vrácený SQLDrivers. Klíčová hodnota pro ovladač SQL Server Native Client ODBC je "{SQL Server Native Client 11.0}". Klíčové slovo serveru je vyžadováno, pokud je specifikován Driver a DriverCompletion je nastaveno na SQL_DRIVER_NOPROMPT. Pro více informací o názvech ovladačů viz Použití nativní klientské hlavičky a knihovny SQL Server. |
| DSN | Název existujícího uživatele ODBC nebo systémového zdroje dat. Toto klíčové slovo přepisuje jakékoli hodnoty, které mohou být specifikovány v klíčových slovech Server, Network a Address . |
| Zašifrovat | Určuje, jestli se mají data před odesláním přes síť šifrovat. Možné hodnoty jsou "ano"/"povinné" (18,0+), "ne"/"volitelné" (18,0+) a "přísné" (18,0+). Výchozí hodnota je ve verzi 18.0+ "ano" a v předchozích verzích "ne". |
| Náhradní téma | Toto klíčové slovo je zastaralé a jeho nastavení ignoruje ovladač SQL Server Native Client ODBC. |
| Failover_Partner | Název partnerského serveru pro převzetí služeb při selhání, který se použije, pokud nemůže být vytvořeno připojení k primárnímu serveru. |
| 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 nativní klient SQL Server použije výchozí SPN generované ovladačem. |
| FileDSN | Název existujícího souborového zdroje dat ODBC. |
| Language | Název jazyka SQL Server (volitelné). SQL Server může ukládat zprávy pro více jazyků v sysmessages. Pokud se připojuje k SQL Server s více jazyky, Language specifikuje, která sada zpráv se pro spojení použije. |
| MARS_Connection | Povolí nebo zakáže v připojení několik aktivních sad výsledků (MARS). Uznávané hodnoty jsou "ano" a "ne". Výchozí je "ne". |
| MultiSubnetFailover | Při připojování k skupinovému posluchači skupiny SQL Server nebo instance clusteru SQL Server Failover vždy uveďte multiSubnetFailover=Yes.
multiSubnetFailover=Yes konfiguruje SQL Server Native Client tak, aby poskytl rychlejší detekci a připojení k (aktuálně) aktivnímu serveru. Možné hodnoty jsou Ano a Ne. Výchozí hodnota je Ne. Příklad:MultiSubnetFailover=YesPro více informací o podpoře skupin Always On Availability ze strany SQL Server Native klienta viz SQL Server Native Client Support for High Availability, Disaster Recovery. |
| Net | Synonymum pro "síť". |
| Network | Platné hodnoty jsou dbnmpntw (pojmenované potrubí) a dbmssocn (TCP/IP). Je chybou zadat jak hodnotu klíčového slova Síť, tak protokolovou předponu na klíčovém slově serveru . |
| PWD | Heslo k přihlašovacímu účtu SQL Server je specifikováno v parametru UID.
PWD nemusí být specifikováno, pokud má přihlášení NULL heslo nebo při použití Windows Authentication (Trusted_Connection = yes). |
| QueryLog_On | Když je "ano", je na spojení povoleno zaznamenávání dlouhodobě běžících dotazovacích dat. Když "ne", dlouhodobě běžící dotazová data nejsou zaznamenávána. |
| QueryLogFile | Úplná cesta a název souboru, který se má použít k protokolování dat na dlouho běžících dotazech. |
| QueryLogTime | Řetězec numerických znaků určující mezní hodnotu (v milisekundách) pro protokolování dlouho běžících dotazů. Každý dotaz, který nedostane odpověď v určeném čase, je zapsán do dlouho běžícího záznamu dotazů. |
| QuotedId | Když je pro spojení nastaveno "ano" QUOTED_IDENTIFIER ZAPNUTO, SQL Server používá ISO pravidla týkající se použití uvozovek v SQL příkazech. Když ne, QUOTED_IDENTIFIER je pro spojení vypnuto. SQL Server pak následuje pravidla legacy Transact-SQL týkající se používání uvozovek v SQL příkazech. Pro více informací viz Účinky ISO možností. |
| Regionální | Když je "ano", ovladač SQL Server Native Client ODBC používá nastavení klienta při převodu měn, dat a času na data znaků. Konverze je pouze jednosměrná; ovladač nerozpoznává nestandardní formáty pro datové řetězce nebo hodnoty měn v nich; například parametr použitý v příkazu INSERT OR UPDATE . Když je "ne", ovladač používá standardní řetězce ODBC k reprezentaci měny, data a času, která jsou převedena na znaková data. |
| Uložit soubor | Název souboru zdroje dat ODBC, do kterého jsou uloženy atributy aktuálního připojení, pokud je připojení úspěšné. |
| Server | 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. Klíčové slovo Adresa přepíše klíčové slovo serveru . K výchozí instanci na lokálním serveru se můžete připojit zadáním jedné z následujících podmínek: Server=; Server=.; Server=(místní); Server=(místní); Server=(localhost); Server=(localdb)\instancename; Pro více informací o podpoře LocalDB viz SQL Server Native Client 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ásleduje příklad specifikace pojmenovaného potrubí: np:\\.\pipe\MSSQL$MYINST01\sql\queryTento řádek specifikuje pojmenovaný protokol potrubí, pojmenované potrubí na lokálním počítači ( \\.\pipe), název instance SQL Server (MSSQL$MYINST01), a výchozí název pojmenovaného potrubí (sql/query).Pokud není specifikován ani protokol, ani síťové klíčové slovo, SQL Server Native Client použije pořadí protokolů uvedené v 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 jsou ignorovány na začátku hodnoty předané serveru v řetězcích spojení ODBC při použití SQL Server Native Client. |
| ServerSPN | Hlavní název služby (SPN) pro server. Výchozí hodnota je prázdný řetězec. Prázdný řetězec způsobí, že nativní klient SQL Server použije výchozí SPN generované ovladačem. |
| StatsLog_On | Když "ano" umožňuje zachycení dat o výkonu ovladačů SQL Server Native Client ODBC. Pokud "ne", data o výkonu ovladačů SQL Server Native Client ODBC nejsou na připojení dostupná. |
| StatsLogFile | Úplná cesta a název souboru, který se používá k zaznamenávání statistik výkonu ovladače ODBC SQL Server Native Client. |
| Trusted_Connection | Když "ano" nařídí ovladači SQL Server Native Client ODBC použít Windows Authentication Mode pro ověření přihlášení. Jinak instruuje ovladač ODBC pro nativního klienta SQL Server, aby použil uživatelské jméno a heslo ze SQL Server pro ověření přihlášení a klíčová slova UID a PWD musí být specifikována. |
| TrustServerCertificate | Při použití s Encrypt umožňuje šifrování pomocí samopodepsaného serverového certifikátu. |
| UID | Platný přihlašovací účet pro SQL Server. UID nemusí být při použití Windows Authentication specifikováno. |
| UseProcForPrepare | Toto klíčové slovo je zastaralé a jeho nastavení je ignorováno nativním klientským ODBC ovladačem SQL Server. |
| WSID | ID pracovní stanice. Obvykle je to síťový název počítače, na kterém aplikace sídlí (volitelné). Pokud je tato hodnota uvedena, je uložena ve sloupcimaster.dbo.sysprocesses a vrací ji sp_who a funkce HOST_NAME. |
Poznámka:
Regionální konverzní nastavení se vztahují na měnové, číselné, datové a časové typy. Nastavení konverze se vztahuje pouze na výstupní konverzi a je viditelné pouze při převodu měny, čísel, data nebo času na znakové řetězce.
Nativní klientský ODBC ovladač SQL Server používá nastavení registru pro aktuální uživatele. Ovladač nerespektuje aktuální lokalitu vlákna, pokud ji aplikace nastaví po připojení například voláním SetThreadLocale.
Změna regionálního chování datového zdroje může způsobit selhání aplikace. Aplikace, která analyzuje řetězce dat a očekává, že řetězce budou vypadat podle definice ODBC, by mohla být změnou této hodnoty negativně ovlivněna.
Klíčová slova pro spojovací řetězce poskytovatelů 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.
Booleovské vlastnosti nastavené v řetězcích poskytovatele pomocí DBPROP_INIT_PROVIDERSTRING hodnot jsou nastaveny pomocí hodnot "ano" a "ne". Booleovské vlastnosti nastavené v inicializačních řetězcích pomocí IDataInitialize::GetDataSource se nastavují pomocí hodnot "true" a "false".
Aplikace využívající IDataInitialize::GetDataSource mohou také používat klíčová slova 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 . Důrazně se doporučuje, aby aplikace nepoužívaly klíčová slova IDBInitialize::Initialize v řetězcích spojení 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 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. Například pokud zadáte připojovací řetězec Data Source=server1; Server=server2, Data Source bude nastaven jako vlastnost, ale Server půjde do provider stringu.
Pokud zadáte více instancí stejné vlastnosti specifické pro zprostředkovatele, použije se první hodnota první vlastnosti.
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-string
empty-string ::=
attribute ::= attribute-keyword=[{]attribute-value[}]
attribute-value ::= character-string
attribute-keyword ::= identifier
Hodnoty atributů lze volitelně uzavřít do závorek, což je dobrá praxe. Tím se předchází problémům, když hodnoty atributů obsahují nealfanumerické znaky. Předpokládá se, že první uzavírací závorka v hodnotě končí hodnotu, takže hodnoty nemohou obsahovat uzavírací závorkové znaky.
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.
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 "adresa". |
| Adresa | SSPROP_INIT_NETWORKADDRESS | Síťová adresa instance SQL Serveru v organizaci. Pro více informací o platné syntaxi adres viz popis klíčového slova Adresa ODBC později v tomto tématu. |
| 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í je ReadWrite. Pro více informací o podpoře skupin Always On Availability ze strany SQL Server Native klienta viz SQL Server Native Client Support for High Availability, Disaster Recovery. |
| 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řipojena, SQL Server ji znovu nepřipojí (používá připojenou databázi jako výchozí pro připojení). |
| Automatický překlad | SSPROP_INIT_AUTOTRANSLATE | Synonymum pro "AutoTranslate". |
| Automatický přenos | SSPROP_INIT_AUTOTRANSLATE | Nakonfiguruje překlad znaků OEM/ANSI. Uznávané hodnoty jsou "ano" a "ne". |
| 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" pro typy dat poskytovatelů a "80" pro datové typy SQL Server 2000. |
| Zašifrovat | SSPROP_INIT_ENCRYPT | Určuje, jestli se mají data před odesláním přes síť šifrovat. Možné hodnoty jsou "ano" a "ne". Výchozí hodnota je "ne". |
| 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 SQL Server Native Client použije výchozí, poskytovatelem generované SPN. |
| 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 "ano" a "ne". Výchozí hodnota je "ne". |
| 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 síťového paketu. Výchozí hodnota je 4096. |
| Zachovat citlivé | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Přijímá řetězce "ano" a "ne" jako hodnoty. Pokud "ne", objekt zdrojového data nesmí uchovávat citlivé autentizační informace |
| PWD | DBPROP_AUTH_PASSWORD | Přihlašovací heslo SQL Serveru. |
| Server | 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. Pro více informací o platné syntaxi adres viz popis klíčového slova Server ODBC v tomto tématu. |
| 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 SQL Server Native Client použije výchozí, poskytovatelem generované SPN. |
| Přerušení zápasu | DBPROP_INIT_TIMEOUT | Doba čekání na dokončení inicializace zdroje dat (v sekundách). |
| Trusted_Connection | DBPROP_AUTH_INTEGRATED | Když "ano" nařídí poskytovateli SQL Server Native Client OLE DB použít Windows Authentication Mode pro ověření přihlášení. Jinak instruuje poskytovatele SQL Server Native Client OLE DB, aby pro ověření přihlášení použil uživatelské jméno a heslo ze SQL Server, přičemž klíčová slova UID a PWD musí být specifikována. |
| TrustServerCertificate | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Přijímá řetězce "ano" a "ne" jako hodnoty. Výchozí hodnota je "ne", což znamená, že certifikát serveru bude ověřen. |
| UID | DBPROP_AUTH_USERID | Přihlašovací jméno SQL Serveru. |
| UseProcForPrepare | SSPROP_INIT_USEPROCFORPREP | Toto klíčové slovo je zastaralé a jeho nastavení ignoruje poskytovatel SQL Server Native Client OLE DB. |
| WSID | SSPROP_INIT_WSID | Identifikátor pracovní stanice. |
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-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. 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. Pokus o citaci celočíselné nebo enumerované vlastnosti povede k chybě "Connection String neodpovídá specifikaci OLE DB".
Hodnoty atributů lze volitelně uzavřít do jednoduchých nebo dvojitých uvozovek, což je dobrá praxe. Tím se předchází problémům, když hodnoty obsahují nealfanumerické znaky. Použitý uvozovkový znak se může také objevit v hodnotách, pokud je zdvojený.
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 |
|---|---|---|
| Název aplikace | SSPROP_INIT_APPNAME | Řetězec identifikující aplikaci. |
| Záměr aplikace | SSPROP_INIT_APPLICATIONINTENT | Synonymum pro "ApplicationIntent". |
| ApplicationIntent | SSPROP_INIT_APPLICATIONINTENT | Deklaruje typ úlohy aplikace při připojování k serveru. Možné hodnoty jsou readOnly a ReadWrite. Výchozí je ReadWrite. Pro více informací o podpoře skupin Always On Availability ze strany SQL Server Native klienta viz SQL Server Native Client Support for High Availability, Disaster Recovery. |
| Automatický překlad | SSPROP_INIT_AUTOTRANSLATE | Synonymum pro "AutoTranslate". |
| Automatický přenos | SSPROP_INIT_AUTOTRANSLATE | Nakonfiguruje překlad znaků OEM/ANSI. Uznávané hodnoty jsou "pravda" a "nepravda". |
| Časový limit připojení | DBPROP_INIT_TIMEOUT | Doba čekání na dokončení inicializace zdroje dat (v sekundách). |
| Aktuální jazyk | SSPROP_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. Pro více informací o platné syntaxi adres viz popis klíčového slova Server ODBC, později v tomto tématu. |
| 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 poskytovatelů a "80" pro datové typy SQL Server 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 SQL Server Native Client použije výchozí, poskytovatelem generované SPN. |
| 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. Pro použití AttachDBFileName musíte také zadat název databáze pomocí klíčového slova provider stringDATABASE. Pokud byla databáze dříve připojena, SQL Server ji znovu nepřipojí (používá připojenou databázi jako výchozí pro připojení). |
| Integrované zabezpečení | DBPROP_AUTH_INTEGRATED | Přijímá hodnotu "SSPI" pro autentizaci Windows. |
| Připojení MARS | SSPROP_INIT_MARSCONNECTION | Povolí nebo zakáže v připojení několik aktivních sad výsledků (MARS). Uznávané hodnoty jsou "pravda" a "nepravda". Výchozí nastavení je "nepravdivé". |
| Síťová adresa | SSPROP_INIT_NETWORKADDRESS | Síťová adresa instance SQL Serveru v organizaci. Pro více informací o platné syntaxi adres viz popis klíčového slova Adresa ODBC později v tomto tématu. |
| 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 síťového paketu. Výchozí hodnota je 4096. |
| 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 je "nepravda", objekt zdrojového data nesmí uchovávat citlivé autentizační informace |
| Poskytovatel | Pro SQL Server Native Client by to mělo být "SQLNCLI11". | |
| 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 SQL Server Native Client použije výchozí, poskytovatelem generované SPN. |
| Důvěřovat certifikátu serveru | 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 data | SSPROP_INIT_ENCRYPT | Určuje, jestli se mají data před odesláním přes síť šifrovat. Možné hodnoty jsou "pravda" a "nepravda". Výchozí hodnota je false. |
| ID uživatele | DBPROP_AUTH_USERID | Přihlašovací jméno SQL Serveru. |
| ID pracovní stanice | SSPROP_INIT_WSID | Identifikátor pracovní stanice. |
Poznámka V připojovací řetězec vlastnost "Old Password" nastavuje SSPROP_AUTH_OLD_PASSWORD, což je aktuální (možná expirované) heslo, které není dostupné přes vlastnost ř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 .
ADO aplikace 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. Důrazně se doporučuje, aby aplikace používaly pouze ADO klíčová slova pro připojovací řetězec.
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 uvozovek, což je dobrá praxe. Tím se předchází problémům, když hodnoty obsahují nealfanumerické znaky. Hodnoty atributů nesmí 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 |
|---|---|---|
| Záměr aplikace | SSPROP_INIT_APPLICATIONINTENT | Synonymum pro "ApplicationIntent". |
| ApplicationIntent | SSPROP_INIT_APPLICATIONINTENT | Deklaruje typ úlohy aplikace při připojování k serveru. Možné hodnoty jsou readOnly a ReadWrite. Výchozí je ReadWrite. Pro více informací o podpoře skupin Always On Availability ze strany SQL Server Native klienta viz SQL Server Native Client Support for High Availability, Disaster Recovery. |
| Název aplikace | SSPROP_INIT_APPNAME | Řetězec identifikující aplikaci. |
| Automatický překlad | SSPROP_INIT_AUTOTRANSLATE | Synonymum pro "AutoTranslate". |
| Automatický přenos | SSPROP_INIT_AUTOTRANSLATE | Nakonfiguruje překlad znaků OEM/ANSI. Uznávané hodnoty jsou "pravda" a "nepravda". |
| Časový limit připojení | DBPROP_INIT_TIMEOUT | Doba čekání na dokončení inicializace zdroje dat (v sekundách). |
| Aktuální jazyk | SSPROP_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. Pro více informací o platné syntaxi adres viz popis klíčového slova Server ODBC v tomto tématu. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Určuje režim zpracování datového typu, který se použije. Rozpoznané hodnoty jsou "0" pro typy dat poskytovatelů a "80" pro datové typy SQL Server 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 SQL Server Native Client použije výchozí, poskytovatelem generované SPN. |
| 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. Pro použití AttachDBFileName musíte také zadat název databáze pomocí klíčového slova provider stringDATABASE. Pokud byla databáze dříve připojena, SQL Server ji znovu nepřipojí (používá připojenou databázi jako výchozí pro připojení). |
| Integrované zabezpečení | DBPROP_AUTH_INTEGRATED | Přijímá hodnotu "SSPI" pro autentizaci 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ší. Uznávané hodnoty jsou "pravda" a "nepravda". Výchozí nastavení je "nepravdivé". |
| Síťová adresa | SSPROP_INIT_NETWORKADDRESS | Síťová adresa instance SQL Serveru v organizaci. Pro více informací o platné syntaxi adres viz popis klíčového slova Adresa ODBC v tomto tématu. |
| 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 síťového paketu. Výchozí hodnota je 4096. |
| 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 je "nepravda", objekt zdrojového data nesmí uchovávat citlivé autentizační informace. |
| Poskytovatel | Pro SQL Server Native Client by to mělo být "SQLNCLI11". | |
| 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 SQL Server Native Client použije výchozí, poskytovatelem generované SPN. |
| Důvěřovat certifikátu serveru | 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 data | SSPROP_INIT_ENCRYPT | Určuje, jestli se mají data před odesláním přes síť šifrovat. Možné hodnoty jsou "pravda" a "nepravda". Výchozí hodnota je false. |
| ID uživatele | DBPROP_AUTH_USERID | Přihlašovací jméno SQL Serveru. |
| ID pracovní stanice | SSPROP_INIT_WSID | Identifikátor pracovní stanice. |
Poznámka:
V připojovací řetězec vlastnost "Old Password" nastavuje SSPROP_AUTH_OLD_PASSWORD, což je aktuální (možná expirované) heslo, které není dostupné přes vlastnost řetězce poskytovatele.