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
Nativní klient SQL Serveru (často zkracovaný jako SNAC) byl odebrán z SQL Serveru 2022 (16.x) a SQL Server Management Studio 19 (SSMS). Pro nový vývoj se nedoporučuje zprostředkovatele SQL Server Native Client OLE DB (SQLNCLI nebo SQLNCLI11) ani starší verze zprostředkovatele Microsoft OLE DB pro SQL Server (SQLOLEDB). Přejděte na nový ovladač Microsoft OLE DB (MSOLEDBSQL) pro SQL Server do budoucna.
Poskytovatel nativního klienta OLE DB pro SQL Server interpretuje inicializační a autorizační vlastnosti OLE DB následovně:
| ID nemovitosti | Description |
|---|---|
| DBPROP_AUTH_CACHE_AUTHINFO | Poskytovatel SQL Server Native Client OLE DB neukládá do mezipaměti autentizační informace. Poskytovatel SQL Server Native Client OLE DB vrací DB_S_ERRORSOCCURRED při pokusu nastavit hodnotu nemovitosti. Člen dwStatus struktury DBPROP označuje DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_ENCRYPT_PASSWORD | Poskytovatel SQL Server Native Client OLE DB používá standardní bezpečnostní mechanismy Microsoft SQL Server k ukrytí hesel. Poskytovatel SQL Server Native Client OLE DB vrací DB_S_ERRORSOCCURRED při pokusu nastavit hodnotu nemovitosti. Člen dwStatus struktury DBPROP označuje DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_INTEGRATED | Pokud je DBPROP_AUTH_INTEGRATED nastaveno na NULL ukazatel, nulový řetězec nebo hodnotu 'SSPI' VT_BSTR hodnotu, poskytovatel SQL Server Native Client OLE DB použije Windows autentizační režim k autorizaci uživatelského přístupu k databázi SQL Server specifikované vlastnostmi DBPROP_INIT_DATASOURCE a DBPROP_INIT_CATALOG. Pokud je nastaveno na VT_EMPTY (výchozí), používá se bezpečnost SQL Serveru. Přihlášení a heslo SQL Serveru jsou specifikovány ve vlastnostech DBPROP_AUTH_USERID a DBPROP_AUTH_PASSWORD. |
| DBPROP_AUTH_MASK_PASSWORD | Poskytovatel SQL Server Native Client OLE DB používá standardní bezpečnostní mechanismy SQL Server pro skrytí hesel. Poskytovatel SQL Server Native Client OLE DB vrací DB_S_ERRORSOCCURRED při pokusu nastavit hodnotu nemovitosti. Člen dwStatus struktury DBPROP označuje DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_PASSWORD | Heslo přiřazeno k přihlášení k SQL Serveru. Tato vlastnost se používá, když je zvolena SQL Server Authentication pro autorizaci přístupu k databázi SQL Server. |
| DBPROP_AUTH_PERSIST_ENCRYPTED | Poskytovatel SQL Server Native Client OLE DB nešifruje autentizační informace, pokud jsou uloženy. Poskytovatel SQL Server Native Client OLE DB vrací DB_S_ERRORSOCCURRED při pokusu nastavit hodnotu nemovitosti. Člen dwStatus struktury DBPROP označuje DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Poskytovatel SQL Server Native Client OLE DB uchovává autentizační hodnoty, včetně obrázku hesla, pokud je o to požádán. Není zde žádné šifrování. |
| DBPROP_AUTH_USERID | Přihlášení do SQL Serveru. Tato vlastnost se používá, když je zvolena SQL Server Authentication pro autorizaci přístupu k databázi SQL Server. |
| DBPROP_INIT_ASYNCH | Poskytovatel SQL Server Native Client OLE DB podporuje asynchronní iniciaci. Nastavení DBPROPVAL_ASYNCH_INITIALIZE bitu ve vlastnosti DBPROP_INIT_ASYNCH způsobí, že IDBInitialize::Initialize se stane neblokujícím voláním. Pro více informací viz Provádění asynchronních operací. |
| DBPROP_INIT_CATALOG | Název existující databáze SQL Serveru, ke které se připojit (PO). |
| DBPROP_INIT_DATASOURCE | Síťové jméno serveru běžícího na instanci Microsoft SQL Server. Pokud je na počítači více instancí SQL Serveru, pro připojení ke konkrétní instanci SQL Serveru je hodnota DBPROP_INIT_DATASOURCE zadána jako \\ServerName\InstanceName. Escape sekvence \\ se používá pro samotný backslash. |
| DBPROP_INIT_GENERALTIMEOUT | Označuje počet sekund před vypršením požadavku, kromě inicializace datového zdroje a provedení příkazu. Hodnota 0 znamená nekonečný časový limit. Poskytovatelé, kteří pracují přes síťová připojení nebo v distribuovaných či transakcích, mohou tuto vlastnost podporovat a upozornit zařazenou komponentu na časový limit v případě dlouhodobého požadavku. Časové limity pro inicializaci datového zdroje a provádění příkazů zůstávají řízeny DBPROP_INIT_TIMEOUT a DBPROP_COMMANDTIMEOUT. DBPROP_INIT_GENERALTIMEOUT je pouze pro čtení, a pokud se ho někdo pokusí nastavit, chyba dwstatus DBPROPSTATUS_NOTSETTABLE se vrátí. |
| DBPROP_INIT_HWND | Windows handle z volané aplikace. Pro inicializační dialogové okno, které se zobrazí při výzvě k inicializačním vlastnostem, je vyžadován platný ovládací oklika okna. |
| DBPROP_INIT_IMPERSONATION_LEVEL | Poskytovatel SQL Server Native Client OLE DB nepodporuje úpravu úrovně imitace. Poskytovatel SQL Server Native Client OLE DB vrací DB_S_ERRORSOCCURRED při pokusu nastavit hodnotu nemovitosti. Člen dwStatus struktury DBPROP označuje DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_LCID | Poskytovatel SQL Server Native Client OLE DB ověří locale ID a vrátí chybu, pokud locale ID není podporováno nebo není na klientovi nainstalováno. |
| DBPROP_INIT_LOCATION | Poskytovatel SQL Server Native Client OLE DB vrací DB_S_ERRORSOCCURRED při pokusu nastavit hodnotu nemovitosti. Člen dwStatus struktury DBPROP označuje DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_MODE | Poskytovatel SQL Server Native Client OLE DB vrací DB_S_ERRORSOCCURRED při pokusu nastavit hodnotu nemovitosti. Člen dwStatus struktury DBPROP označuje DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_PROMPT | Poskytovatel SQL Server Native Client OLE DB podporuje všechny režimy promptingu pro inicializaci datových zdrojů. Poskytovatel SQL Server Native Client OLE DB používá DBPROMPT_NOPROMPT jako výchozí nastavení pro tuto vlastnost. |
| DBPROP_INIT_PROTECTION_LEVEL | Poskytovatel SQL Server Native Client OLE DB nepodporuje úroveň ochrany u připojení k instancím SQL Server. Poskytovatel SQL Server Native Client OLE DB vrací DB_S_ERRORSOCCURRED při pokusu nastavit hodnotu nemovitosti. Člen dwStatus struktury DBPROP označuje DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_PROVIDERSTRING | Viz provider provider SQL Server Native Client OLE DB provider string později v tomto tématu. |
| DBPROP_INIT_TIMEOUT | Poskytovatel nativní klientské OLE databáze SQL Server vrací chybu při inicializaci, pokud nelze navázat spojení s instancí SQL Server během stanoveného počtu sekund. |
V souboru vlastností specifických pro poskytovatele DBPROPSET_SQLSERVERDBINIT definuje poskytovatel SQL Server Native Client OLE DB tyto další inicializační vlastnosti.
| ID nemovitosti | Description |
|---|---|
| SSPROP_AUTH_OLD_PASSWORD | Typ: VT_BSTR R/W: Piš Výchozí: VT_EMPTY Popis: Aktuální nebo vypršené heslo. Pro více informací viz Programová změna hesel. |
| SSPROP_INIT_APPNAME | Typ: VT_BSTR R/W: Čtení/zápis Popis: Název klientské aplikace. |
| SSPROP_INIT_AUTOTRANSLATE | Typ: VT_BOOL R/W: Čtení/zápis Výchozí nastavení: VARIANT_TRUE Popis: Převod znaků OEM/ANSI. VARIANT_TRUE: Poskytovatel OLE DB SQL Server Native Client překládá řetězce znaků ANSI odesílané mezi klientem a serverem převodem přes Unicode, aby minimalizoval problémy s porovnávání rozšířených znaků mezi kódovými stránkami na klientovi a serveru: Klientská DBTYPE_STR data odeslaná instanci 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) a poté převedena z Unicode do znaku pomocí ACP serveru. SQL Server char, varchar nebo textová data zaslaná klientské DBTYPE_STR proměnné jsou převedena ze znaku do Unicode pomocí serverového ACP a poté z Unicode na znak pomocí ACP klienta. Tyto převody jsou prováděny na klientovi poskytovatelem SQL Server Native Client OLE DB. To vyžaduje, aby stejný ACP použitý na serveru byl dostupný i na klientovi. Tato nastavení nemají vliv na konverze, které se u těchto převodů odehrají: Unicode DBTYPE_WSTR data klienta odesílaná na char, varchar nebo text na server. char, varcharnebo data textového serveru odesílaná do proměnné Unicode DBTYPE_WSTR na klientovi. ANSI DBTYPE_STR klientská data odesílaná na Unicode nchar, nvarchar nebo ntext na server. Unicode char, varcharnebo textová data serveru odeslaná do ANSI DBTYPE_STR proměnné na klientovi. VARIANT_FALSE: Poskytovatel OLE DB SQL Server Native Client neprovádí překlady znaků. Poskytovatel OLE DB SQL Server Native Client nepřekládá klientský ANSI znak DBTYPE_STR data odesílaná na proměnné, parametry či sloupce char, varchar nebo textové proměnné, parametry či sloupce na serveru. Na char,varchar nebo textová data odesílaná ze serveru na DBTYPE_STR proměnné na klientovi se neprovádí žádný překlad. Pokud klient a instance SQL Serveru používají různé ACP, mohou být rozšířené znaky špatně interpretovány. |
| SSPROP_INIT_CURRENTLANGUAGE | Typ: VT_BSTR R/W: Čtení/zápis Popis: Název jazyka SQL Server. Identifikuje jazyk používaný pro výběr systémových zpráv a formátování. Jazyk musí být nainstalován na počítači běžící instanci SQL Serveru, jinak selže inicializace datového zdroje. |
| SSPROP_INIT_DATATYPECOMPATIBILITY | Typ: VT_UI2 R/W: Čtení/zápis Výchozí hodnota: 0 Popis: Umožňuje kompatibilitu datových typů mezi SQL Server a aplikacemi ActiveX Data Object (ADO). Pokud je použita výchozí hodnota 0, zpracování datových typů se automaticky nastaví na ten, který používá poskytovatel. Pokud je použita hodnota 80, zpracování datových typů používá pouze SQL Server 2000 (8.x) datové typy. Pro více informací viz Použití ADO s nativním klientem SQL Server. |
| SSPROP_INIT_ENCRYPT | Typ: VT_BOOL R/W: Čtení/Zápis Výchozí: VARIANT_FALSE Popis: Pro zašifrování dat přecházejících sítí je SSPROP_INIT_ENCRYPT vlastnost nastavena na VARIANT_TRUE. Pokud je zapnuté Povolit šifrování protokolu, šifrování proběhne vždy, bez ohledu na nastavení SSPROP_INIT_ENCRYPT. Pokud je vypnutý a SSPROP_INIT_ENCRYPT nastaveno na VARIANT_TRUE, šifrování dojde k dalšímu. Pokud je Enable Protocol Encryption vypnuté a SSPROP_INIT_ENCRYPT nastaveno na VARIANT_FALSE, šifrování neprobíhá. |
| SSPROP_INIT_FAILOVERPARTNER | Typ: VT_BSTR R/W: Čtení/zápis Popis: Specifikuje název partnera pro failover pro zrcadlení databáze. Jedná se o inicializační vlastnost a lze ji nastavit pouze před inicializací. Po inicializaci vrátí případného failover partnera, který je vrácen primárním serverem. To umožňuje chytré aplikaci uložit do mezipaměti nejnověji určený záložní server, ale takové aplikace by měly vědět, že informace se aktualizují pouze při navázání spojení (nebo resetování, pokud je ve skupině) a mohou být zastaralé pro dlouhodobá spojení. Po navázání spojení může aplikace tento atribut vyhledat a určit identitu failover partnera. Pokud primární server nemá partnera pro failover, tato vlastnost vrátí prázdný řetězec. Pro více informací viz Používání zrcadlení databází. |
| SSPROP_INIT_FILENAME | Typ: VT_BSTR R/W: Čtení/zápis Popis: Specifikuje primární název souboru připojitelné databáze. Tato databáze je připojena a stává se výchozí databází pro připojení. Pro použití SSPROP_INIT_FILENAME musíte zadat název databáze jako hodnotu inicializační vlastnosti DBPROP_INIT_CATALOG. Pokud název databáze neexistuje, hledá primární název souboru specifikovaný v SSPROP_INIT_FILENAME a připojí k němu název uvedený v DBPROP_INIT_CATALOG. Pokud byla databáze dříve připojena, SQL Server ji znovu nepřipojuje. |
| SSPROP_INIT_MARSCONNECTION | Typ: VT_BOOL R/W: Čtení/zápis Výchozí: VARIANT_FALSE Popis: Specifikuje, zda je pro spojení povoleno více aktivních sad výsledků (MARS). Tato možnost musí být nastavena na true, než je navázáno spojení s databází. Další informace naleznete v tématu Použití více aktivních sad výsledků (MARS). |
| SSPROP_INIT_NETWORKADDRESS | Typ: VT_BSTR R/W: Čtení/zápis Popis: Síťová adresa serveru, na kterém běží instance SQL Serveru specifikovaná vlastností DBPROP_INIT_DATASOURCE. |
| SSPROP_INIT_NETWORKLIBRARY | Typ: VT_BSTR R/W: Čtení/zápis Popis: Název síťové knihovny (DLL) používané ke komunikaci s instancí SQL Serveru. Název by neměl obsahovat cestu ani příponu .dll názvu souboru. Výchozí nastavení lze přizpůsobit pomocí SQL Server Client Configuration Utility. Poznámka: Tato vlastnost podporuje pouze TCP a pojmenované potrubí. Pokud tuto vlastnost použijete s prefixem, skončíte s dvojitou předponou, což vede k chybě, protože tato vlastnost se používá k internímu generování prefixu. |
| SSPROP_INIT_PACKETSIZE | Typ: VT_I4 R/W: Čtení/zápis Popis: Velikost síťového paketu v bajtech. Hodnota velikosti balíčku musí být mezi 512 a 32 767. Výchozí velikost síťového paketu pro poskytovatele OLE DB pro nativního klienta SQL Server je 4 096. |
| SSPROP_INIT_TAGCOLUMNCOLLATION | Typ: BOOL R/W: Piš Výchozí: FALSE Popis: Používá se při aktualizaci databáze, když jsou použity kurzory na straně serveru. Tato vlastnost označuje data pomocí kolačních informací získaných ze serveru místo kódové stránky klienta. V současnosti tuto vlastnost používá pouze distribuovaný dotazovací proces, protože zná střídání cílových dat a správně je převádí. |
| SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Typ: VT_BOOL R/W: Čtení/zápis Výchozí: VARIANT_FALSE Popis: Používá se k povolení nebo zakázání ověřování serverových certifikátů. Tato vlastnost je čtení/zápis, ale pokus o její nastavení po navázání spojení povede k chybě. Tato vlastnost je ignorována, pokud je klient nastaven tak, aby vyžadoval ověření certifikátu. Aplikace jej však může použít společně s SSPROP_INIT_ENCRYPT k zajištění šifrování svého připojení k serveru, i když je klient nastaven tak, aby nepotřeboval šifrování, a na klientovi není přidán žádný certifikát. Klientské aplikace mohou tuto vlastnost dotazovat po otevření připojení, aby zjistily skutečná pravidla šifrování a validace, která se používají. Poznámka: Použití šifrování bez ověření certifikátů poskytuje částečnou ochranu proti odposlechu paketů, ale nechrání před útoky typu man-in-the-middle. Jednoduše umožňuje šifrovat přihlášení a data odeslaná serveru bez ověřování certifikátu serveru. Další informace naleznete v tématu Použití šifrování bez ověření. |
| SSPROP_INIT_USEPROCFORPREP | Typ: VT_I4 R/W: Čtení/zápis Výchozí nastavení: SSPROPVAL_USEPROCFORPREP_ON Popis: Použití uložených procedur SQL Serveru. Definuje použití dočasných uložených procedur SQL Server pro podporu rozhraní ICommandPrepree . Tato vlastnost měla smysl pouze při připojení k SQL Server 6.5. Tato vlastnost je v pozdějších verzích opomenuta. SSPROPVAL_USEPROCFORPREP_OFF: Dočasná uložená procedura se nevytváří při přípravě příkazu. SSPROPVAL_USEPROCFORPREP_ON: Dočasná uložená procedura se vytvoří při přípravě příkazu. Dočasné uložené procedury jsou při uvolnění relace zrušeny. SSPROPVAL_USEPROCFORPREP_ON_DROP: Dočasná uložená procedura se vytvoří při přípravě příkazu. Procedura je ukončena, když příkaz není připraven pomocí ICommandPrepare::Unpreprepare, když je pro objekt příkazu specifikován nový příkaz pomocí ICommandText::SetCommandText, nebo když jsou všechny aplikační odkazy na příkaz uvolněny. |
| SSPROP_INIT_WSID | Typ: VT_BSTR R/W: Čtení/zápis Popis: Řetězec identifikující pracovní stanici. |
V souboru vlastností specifických pro poskytovatele DBPROPSET_SQLSERVERDATASOURCEINFO poskytuje poskytovatel OLE DB SQL Server Native Client tyto další vlastnosti; více informací viz Data Source Information Properties.
Provider string The SQL Server Native Client OLE DB
Poskytovatel OLE DB pro nativního klienta SQL Server rozpoznává syntaxi podobnou ODBC v hodnotách vlastností řetězců poskytovatele. Vlastnost řetězce poskytovatele je uvedena jako hodnota inicializační vlastnosti OLE DB DBPROP_INIT_PROVIDERSTRING při navázání spojení se zdrojem dat OLE DB. Tato vlastnost specifikuje data o připojení specifická pro poskytovatele OLE DB, která jsou potřeba k implementaci spojení se zdrojem dat OLE DB. Uvnitř řetězce jsou prvky vymezeny středníkem. Poslední prvek v řetězci musí být zakončen středníkem. Každý prvek se skládá z klíčového slova, znaku rovnosti a hodnoty předané při inicializaci. Příklady:
Server=MyServer;UID=MyUserName;
U poskytovatele SQL Server Native Client OLE DB uživatel nikdy nemusí používat vlastnost řetězce provider. Spotřebitel může nastavit jakoukoli inicializační vlastnost zobrazenou v řetězci poskytovatele pomocí specifických inicializačních vlastností OLE DB v OLE DB nebo SQL Server Native Client OLE DB.
Pro seznam klíčových slov dostupných u poskytovatele SQL Server Native Client OLE DB viz Používání klíčových slov s connection string Keywords with SQL Server Native Client.