DsN a připojovací řetězec – klíčová slova a atributy

Na této stránce jsou uvedena klíčová slova pro připojovací řetězce a sítě DSN a atributy připojení pro SQLSetConnectAttr a SQLGetConnectAttr, které jsou k dispozici v ovladači ODBC pro SQL Server.

Podporovaná klíčová slova DSN a připojovacího řetězce a atributy připojení

Následující tabulka uvádí dostupná klíčová slova a atributy pro každou platformu (L: Linux; M: macOS; W: Windows). Další podrobnosti zobrazíte výběrem klíčového slova nebo atributu.

Zde jsou některá klíčová slova připojovacího řetězce a atributy připojení, které nejsou zdokumentovány v Použití klíčových slov připojovacího řetězce s SQL Server Native Client, SQLSetConnectAttr a funkci SQLSetConnectAttr.

Description

Používá se k popisu zdroje dat.

SQL_COPT_SS_ANSI_OEM

Řídí převod dat pomocí ANSI na OEM.

SQL_COPT_SS_AUTOBEGINTXN

Verze 17.6+ Pokud je režim autocommit vypnutý, určuje automatické spuštění BEGIN TRANSACTION po příkazu ROLLBACK nebo COMMIT.

SQL_COPT_SS_FALLBACK_CONNECT

Řídí použití náhradních připojení SQL Serveru. Tato funkce se už nepodporuje.

Nová klíčová slova připojovacího řetězce a atributy připojení

Ověřování – SQL_COPT_SS_AUTHENTICATION

Nastaví režim ověřování, který se použije při připojování k SQL Serveru. Další informace naleznete v tématu Použití Microsoft Entra ID.

ColumnEncryption – SQL_COPT_SS_COLUMN_ENCRYPTION

Řídí transparentní šifrování sloupců (Always Encrypted). Další informace naleznete v tématu Použití funkce Always Encrypted (ODBC).

ConcatNullYieldsNull - SQL_COPT_SS_CONCAT_NULL

Řídí použití ISO zpracování NULL při spojování řetězců. Další informace najdete v tématu SET CONCAT_NULL_YIELDS_NULL (Transact-SQL).

Zašifrovat

Určuje, jestli připojení používají šifrování TLS přes síť. Možné hodnoty jsou yes/mandatory(18,0+),no/optional (18,0+) a strict(18,0+). Výchozí hodnota je yes ve verzi 18.0+ a no v předchozích verzích.

Bez ohledu na nastavení Encryptjsou přihlašovací údaje serveru (uživatelské jméno a heslo) vždy zašifrované.

Encrypt, TrustServerCertificatea nastavení na straně Force Encryption serveru hrají roli v tom, zda jsou připojení šifrovaná přes síť. Následující tabulky ukazují účinek těchto nastavení.

Ovladač ODBC 18 a novější

ODBC Driver 17 a starší verze

TransparentNetworkIPResolution – SQL_COPT_SS_TNIR

Řídí funkci transparentního překladu IP adres sítě, která komunikuje s MultiSubnetFailover a umožňuje rychlejší pokusy o opětovné připojení. Další informace najdete v tématu Použití transparentního síťového překladu IP adres.

UseFMTONLY

Řídí použití SET FMTONLY metadat při připojování k SQL Server 2012 a novějším.

Replication

Určuje se použití přihlášení pro replikaci v ovladači ODBC verze 17.8 a novějších.

RetryExec

Konfigurovatelná logika opakování je dostupná od verze 18.1. Automaticky znovu spustí konkrétní volání funkce ODBC na základě konfigurovatelných podmínek. Tuto funkci lze povolit prostřednictvím připojovacího řetězce pomocí klíčového slova RetryExec spolu se seznamem pravidel opakování. Každé pravidlo opakování má tři komponenty oddělené dvojtečkami: shodu chyby, zásadu opakování a shodu dotazu.

Shoda dotazu určuje pravidlo opakování, které se má použít pro dané spuštění, a odpovídá příchozímu textu příkazu (SQLExecDirect) nebo připravenému textu příkazu v objektu příkazu (SQLExecute). Pokud se shoduje více pravidel, použije se první odpovídající pravidlo v seznamu. Toto chování umožňuje uvést pravidla ve vzestupném pořadí obecnosti. Pokud žádné pravidlo neodpovídá, nepoužijí se žádné opakování.

Pokud při spuštění dojde k chybě a existuje použitelné pravidlo opakování, použije se porovnání chyby v tomto pravidle k určení, zda se má spuštění opakovat.

Hodnota klíčového slova RetryExec je seznam středník oddělených pravidel opakování.
RetryExec={rule1;rule2}

Pravidlo opakování je následující: <errormatch>:<retrypolicy>:<querymatch>

Shoda chyby: Seznam kódů chyb oddělených čárkami. Například zadání 1000,2000 určuje kódy chyb, u kterých chcete opakovat pokus.

Zásady opakování: Určuje zpoždění do dalšího opakování. Prvním parametrem bude počet opakování, zatímco druhý bude zpoždění. Například 3,10+7 by bylo 3 pokusy začínající na 10 a každé následující opakování by se zvýší o 7 sekund. Pokud není zadaná hodnota +7, každé následující opakování se exponenciálně zdvojnásobí.

Shoda dotazu: Určuje dotaz, se kterým se chcete shodovat. Pokud není zadáno nic, platí to pro všechny dotazy. Zadání příkazu SELECT by znamenalo pro všechny dotazy, které začínají výběrem.

Kombinace všech tří výše uvedených součástí pro použití v připojovacím řetězci by byla:

RetryExec={1000,2000:3,10+7:SELECT}

To by znamenalo: "V případě chyb 1000 a 2000 v dotazu, který začíná příkazem SELECT. Zkuste to dvakrát s počátečním zpožděním 10 sekund a přidejte 7 sekund pro každý následující pokus"

Examples

40501,40540:4,5

V případě chyb 40501 a 40540 zkuste opakovat až čtyřikrát, počáteční zpoždění 5 sekund a exponenciální zdvojnásobení mezi jednotlivými opakováními. Toto pravidlo platí pro všechny dotazy.

49919:2,10+:CREATE

V případě chyby 49919 v dotazu, který začíná příkazem CREATE, zkuste na začátku maximálně dvakrát, nejprve po 10 sekundách a pak 20 sekund.

49918,40501,10928:5,10+5:SELECT c1

V případě chyb 49918, 40501 a 10928 u dotazů začínajících příkazem SELECT c1 zkuste opakovat až pětkrát, při prvním opakování počkejte 10 sekund a potom se čekání zvýší o 5 sekund.

Výše uvedené tři pravidla je možné zadat společně v připojovacím řetězci následujícím způsobem:

RetryExec={49918,40501,10928:5,10+5:SELECT c1;49919:2,10+:CREATE;40501,40540:4,5}

Nejobecnější pravidlo (odpovídající všemu) se umístí na konec, aby se před ním mohla uplatnit dvě specifičtější pravidla pro své příslušné dotazy.

Klientský certifikát

Určuje certifikát, který se má použít pro ověřování identity prostřednictvím připojení loopback (k dispozici pouze v SQL Serveru v systému Linux). Možnosti jsou následující:

Pokud je certifikát ve formátu PFX a privátní klíč uvnitř certifikátu PFX je chráněný heslem, vyžaduje se klíčové slovo hesla. Pro certifikáty ve formátech PEM a DER je atribut ClientKey povinný.

ClientKey

Určuje umístění souboru privátního klíče pro certifikáty PEM nebo DER, zadané atributem ClientCertificate. Formát:

V případě, že je soubor privátního klíče chráněný heslem, je vyžadováno klíčové slovo hesla. Pokud heslo obsahuje nějaké , znaky, přidá se další , znak hned za každý z nich. Pokud je například heslo a,b,c, pak heslo po escapování uvedené v připojovacím řetězci je a,,b,,c.

Název hostitele v certifikátu

Určuje název hostitele, který se má v certifikátu serveru očekávat při vyjednání šifrování , pokud se liší od výchozí hodnoty odvozené od addr/address/Server. Možnost HostnameInCertificate se při použití možnosti ServerCertificate ignoruje.

IpAddressPreference

Tato možnost je dostupná od verze 18.1. Umožňuje uživateli zadat typ IP adresy, u které chce určit prioritu připojení. Možné hodnoty jsou „IpAddress= [ IPv4First | IPv6First | UsePlatformDefault].“ UsePlatformDefault se připojuje k adresám v pořadí, v jakém je vrací systémové volání pro překlad názvu serveru. Výchozí hodnota je IPv4First, která odpovídá chování v předchozích verzích.

ServerCertificate

Tato možnost je dostupná od verze 18.1. Tato možnost se dá použít v přísném režimu šifrování. Klíčové slovo ServerCertificate slouží k určení cesty k souboru certifikátu, který se má shodovat s certifikátem TLS/SSL SQL Serveru. Porovnání se provádí namísto standardního ověřování certifikátu (platnost, název hostitele, řetězec důvěryhodnosti atd.). Podporované formáty certifikátů jsou PEM, DER a CER. Pokud je zadán, certifikát SQL Serveru se zkontroluje ověřením, zda zadaný ServerCertificate přesně odpovídá.

SQL_COPT_SS_ACCESS_TOKEN

Povolí použití přístupového tokenu Microsoft Entra k ověřování. Další informace naleznete v tématu Použití Microsoft Entra ID.

SQL_COPT_SS_CEKEYSTOREDATA

Komunikuje s načtenou knihovnou zprostředkovatele úložiště klíčů. Viz Ovládací prvky transparentního šifrování sloupců (Always Encrypted). Tento atribut nemá výchozí hodnotu. Další informace viz Vlastní poskytovatelé úložiště klíčů.

SQL_COPT_SS_CEKEYSTOREPROVIDER

Načte knihovnu zprostředkovatele úložiště klíčů pro Always Encrypted nebo získá názvy načtených knihoven zprostředkovatelů úložiště klíčů. Další informace naleznete v tématu Vlastní zprostředkovatelé úložiště klíčů. Tento atribut nemá výchozí hodnotu.

SQL_COPT_SS_ENLIST_IN_XA

Chce-li aplikace povolit transakce XA pomocí procesoru transakcí (TP) kompatibilního se standardem XA, musí volat SQLSetConnectAttr s parametrem SQL_COPT_SS_ENLIST_IN_XA a ukazatelem na objekt XACALLPARAM. Tato možnost je podporovaná ve Windows (17.3+), Linuxu a macOS.

SQLSetConnectAttr(hdbc, SQL_COPT_SS_ENLIST_IN_XA, param, SQL_IS_POINTER);  // XACALLPARAM *param

Chcete-li přidružit XA transakce pouze k připojení ODBC, zadejte hodnotu TRUE nebo FALSE s SQL_COPT_SS_ENLIST_IN_XA místo ukazatele při volání SQLSetConnectAttr. Toto nastavení je platné jenom ve Windows a nejde ho použít k určení operací XA prostřednictvím klientské aplikace.

SQLSetConnectAttr(hdbc, SQL_COPT_SS_ENLIST_IN_XA, (SQLPOINTER)TRUE, 0);

Další informace o transakcích XA naleznete v tématu Použití transakcí XA.

SQL_COPT_SS_LONGASMAX

Umožňuje odesílání dlouhých dat typu na servery jako maximálních dat typu.

SQL_COPT_SS_SPID

Vrátí ID relace tohoto připojení. Tato vlastnost odpovídá proměnné T-SQL @@SPID, s tím rozdílem, že nevyžaduje další komunikaci se serverem.