Słowa kluczowe i atrybuty DSN oraz parametrów połączenia

Ten artykuł zawiera listę słów kluczowych, które sterownik Microsoft ODBC dla SQL Server akceptuje w nazwach źródeł danych (DSN) i łańcuchach połączeń. Zawiera również atrybuty połączenia dla SQLSetConnectAttr i SQLGetConnectAttr.

Wybierz połączenie DSN lub bez DSN

Aby uzyskać wskazówki dotyczące wyboru metod połączenia, uwierzytelniania, szyfrowania, routingu, ponowień i ustawień aplikacji, zobacz Konfigurowanie połączeń ODBC z Microsoft SQL. Użyj tego artykułu, aby sprawdzić dokładne słowa kluczowe i atrybuty połączenia.

Obsługiwane słowa kluczowe DSN i parametrów połączenia oraz atrybuty połączenia

Poniższa tabela zawiera dostępne słowa kluczowe i atrybuty dla każdej platformy (L: Linux; M: macOS; W: Windows). Wybierz słowo kluczowe lub atrybut, aby uzyskać więcej szczegółów.

słowo kluczowe DSN / parametry połączenia Atrybut połączenia Platforma
Addr LMW
Adres LMW
AnsiNPW SQL_COPT_SS_ANSI_NPW LMW
APLIKACJA LMW
ApplicationIntent SQL_COPT_SS_APPLICATION_INTENT LMW
AttachDBFileName SQL_COPT_SS_ATTACHDBFILENAME LMW
Authentication SQL_COPT_SS_AUTHENTICATION LMW
AutoTranslate SQL_COPT_SS_TRANSLATE LMW
ClientCertificate LMW
ClientKey LMW
ColumnEncryption SQL_COPT_SS_COLUMN_ENCRYPTION LMW
ConcatNullYieldsNull (wersja 18.6 i nowsze) SQL_COPT_SS_CONCAT_NULL LMW
ConnectRetryCount SQL_COPT_SS_CONNECT_RETRY_COUNT LMW
ConnectRetryInterval SQL_COPT_SS_CONNECT_RETRY_INTERVAL LMW
ConnectTimeout (od wersji 18.7) SQL_ATTR_LOGIN_TIMEOUT LMW
Baza danych SQL_ATTR_CURRENT_CATALOG LMW
Description LMW
Kierowca LMW
DSN LMW
Szyfruj SQL_COPT_SS_ENCRYPT LMW
Failover_Partner SQL_COPT_SS_FAILOVER_PARTNER W
FailoverPartner (wersja v18.7 i nowsze) SQL_COPT_SS_FAILOVER_PARTNER W
FailoverPartnerSPN SQL_COPT_SS_FAILOVER_PARTNER_SPN W
FileDSN LMW
GetDataExtensions (wersja 18.0 i nowsze) SQL_COPT_SS_GETDATA_EXTENSIONS LMW
HostnameInCertificate (wersja v18.0 i nowsze) LMW
IpAddressPreference (wersja v18.1 i nowsze) LMW
KeepAlive (wersja 17.4 i nowsze; DSN tylko przed 17.8) LMW
KeepAliveInterval (wersja 17.4 i nowsze; DSN tylko przed 17.8) LMW
KeystoreAuthentication LMW
KeystorePrincipalId LMW
KeystoreSecret LMW
Język LMW
LongAsMax (wersja 18.0 i nowsze) SQL_COPT_SS_LONGASMAX LMW
MARS_Connection SQL_COPT_SS_MARS_ENABLED LMW
MultipleActiveResultSets (wersja 18.7 i nowsze) SQL_COPT_SS_MARS_ENABLED LMW
MultiSubnetFailover SQL_COPT_SS_MULTISUBNET_FAILOVER LMW
Net LMW
Network LMW
PacketSize (Driver 18.7) SQL_ATTR_PACKET_SIZE LMW
PWD LMW
QueryLog_On SQL_COPT_SS_PERF_QUERY W
QueryLogFile SQL_COPT_SS_PERF_QUERY_LOG W
QueryLogTime SQL_COPT_SS_PERF_QUERY_INTERVAL W
QuotedId SQL_COPT_SS_QUOTED_IDENT LMW
Regionalny LMW
Replication LMW
RetryExec (wersje 18.1 i nowsze) LMW
SaveFile LMW
Server LMW
ServerCertificate (wersja v18.1 i nowsze) LMW
ServerSPN SQL_COPT_SS_SERVER_SPN LMW
StatsLog_On SQL_COPT_SS_PERF_DATA W
StatsLogFile SQL_COPT_SS_PERF_DATA_LOG W
TransparentNetworkIPResolution SQL_COPT_SS_TNIR LMW
Trusted_Connection SQL_COPT_SS_INTEGRATED_SECURITY LMW
TrustServerCertificate SQL_COPT_SS_TRUST_SERVER_CERTIFICATE LMW
UID LMW
UseFMTONLY LMW
vectorTypeSupport (wersja 18.6.1.1 i nowsze) SQL_COPT_SS_VECTOR_TYPE_SUPPORT LMW
WorkstationID (wersja 18.7 i nowsze wersje) LMW
WSID LMW
SQL_ATTR_ACCESS_MODE
(SQL_ACCESS_MODE)
LMW
SQL_ATTR_ASYNC_DBC_EVENT W
SQL_ATTR_ASYNC_DBC_FUNCTIONS_ENABLE W
SQL_ATTR_ASYNC_DBC_PCALLBACK W
SQL_ATTR_ASYNC_DBC_PCONTEXT W
SQL_ATTR_ASYNC_ENABLE W
SQL_ATTR_AUTO_IPD LMW
SQL_ATTR_AUTOCOMMIT
(SQL_AUTOCOMMIT)
LMW
SQL_ATTR_CONNECTION_DEAD LMW
SQL_ATTR_CONNECTION_TIMEOUT LMW
SQL_ATTR_DBC_INFO_TOKEN W
SQL_ATTR_LOGIN_TIMEOUT
(SQL_LOGIN_TIMEOUT)
LMW
SQL_ATTR_METADATA_ID LMW
SQL_ATTR_ODBC_CURSORS
(SQL_ODBC_CURSORS)
LMW
SQL_ATTR_PACKET_SIZE
(SQL_PACKET_SIZE)
LMW
SQL_ATTR_QUIET_MODE
(SQL_QUIET_MODE)
LMW
SQL_ATTR_RESET_CONNECTION
(SQL_COPT_SS_RESET_CONNECTION)
LMW
SQL_ATTR_TRACE
(SQL_OPT_TRACE)
LMW
SQL_ATTR_TRACEFILE
(SQL_OPT_TRACEFILE)
LMW
SQL_ATTR_TRANSLATE_LIB
(SQL_TRANSLATE_DLL)
LMW
SQL_ATTR_TRANSLATE_OPTION
(SQL_TRANSLATE_OPTION)
LMW
SQL_ATTR_TXN_ISOLATION
(SQL_TXN_ISOLATION)
LMW
SQL_COPT_SS_ACCESS_TOKEN LMW
SQL_COPT_SS_ANSI_OEM W
SQL_COPT_SS_AUTOBEGINTXN LMW
SQL_COPT_SS_BCP LMW
SQL_COPT_SS_BROWSE_CACHE_DATA LMW
SQL_COPT_SS_BROWSE_CONNECT LMW
SQL_COPT_SS_BROWSE_SERVER LMW
SQL_COPT_SS_CEKEYSTOREDATA LMW
SQL_COPT_SS_CEKEYSTOREPROVIDER LMW
SQL_COPT_SS_CLIENT_CONNECTION_ID LMW
SQL_COPT_SS_CONNECTION_DEAD LMW
SQL_COPT_SS_DATACLASSIFICATION_VERSION (wersja 17.4.2 i nowsze) LMW
SQL_COPT_SS_ENLIST_IN_DTC W
SQL_COPT_SS_ENLIST_IN_XA LMW
SQL_COPT_SS_FALLBACK_CONNECT LMW
SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD LMW
SQL_COPT_SS_MUTUALLY_AUTHENTICATED LMW
SQL_COPT_SS_OLDPWD LMW
SQL_COPT_SS_PERF_DATA_LOG_NOW W
SQL_COPT_SS_PRESERVE_CURSORS LMW
SQL_COPT_SS_SPID (wersja 17.5 i nowsze) LMW
SQL_COPT_SS_TXN_ISOLATION LMW
SQL_COPT_SS_USER_DATA LMW
SQL_COPT_SS_WARN_ON_CP_ERROR LMW

SQL_ATTR_DBC_INFO_TOKEN jest zarezerwowany dla puli połączeń świadomych sterowników Windows Driver Manager. Aplikacje nie ustawiają tego atrybutu.

Oto kilka słów kluczowych parametrów połączenia i atrybutów połączenia, które nie są udokumentowane w Using Connection String Keywords with SQL Server Native Client, SQLSetConnectAttr i SQLSetConnectAttr Function.

Description

Opisuje źródło danych.

SQL_COPT_SS_ANSI_OEM

Kontroluje konwersję między stronami kodowymi Windows i OEM.

Wartość atrybutu Description
SQL_AO_OFF (domyślnie) Tłumaczenie nie jest gotowe.
SQL_AO_ON Tłumaczenie zostało wykonane.

SQL_COPT_SS_AUTOBEGINTXN

Począwszy od wersji 17.6, gdy autocommit jest wyłączony, użyj tej opcji do sterowania automatycznym BEGIN TRANSACTION po ROLLBACK lub COMMIT.

Wartość atrybutu Description
SQL_AUTOBEGINTXN_ON (domyślnie) Automatyczne BEGIN TRANSACTION po ROLLBACK lub COMMIT.
SQL_AUTOBEGINTXN_OFF Brak automatycznego BEGIN TRANSACTION po ROLLBACK lub COMMIT.

SQL_COPT_SS_FALLBACK_CONNECT

Kontroluje użycie zapasowych połączeń programu SQL Server. Ta opcja nie jest już obsługiwana.

Wartość atrybutu Description
SQL_FB_OFF (domyślnie) Wyłącza połączenia zapasowe.
SQL_FB_ON Umożliwia połączenia zapasowe.

Nowe słowa kluczowe parametrów połączenia i atrybuty połączenia

Poniższe sekcje opisują zachowanie słów kluczowych, atrybuty połączenia oraz ich akceptowane wartości. Ograniczenia specyficzne dla sterownika są określone wraz z odpowiednią opcją.

Ujednolicenie słów kluczowych w łańcuchach połączeń

Począwszy od wersji 18.7 sterownik ODBC dla SQL Server obsługuje dodatkowe słowa kluczowe parametrów połączenia, które są zgodne z nazwami właściwości u dostawcy danych Microsoft.Data.SqlClient. To wsparcie zmniejsza potrzebę zmiany nazw słów kluczowych podczas przenoszenia się między dostawcami danych Microsoft SQL i sterownikami. Każdy dostawca nadal posiada własne obsługiwane słowa kluczowe i wartości.

Aliasy słów kluczowych

Każdy alias konfiguruje tę samą opcję co jego równoważne słowo kluczowe ODBC:

Alias Równoważne słowo kluczowe ODBC Description
MultipleActiveResultSets MARS_Connection Włącza lub wyłącza wiele aktywnych zestawów wyników (MARS). Akceptuje Yes lub No.
WorkstationID WSID Ustala identyfikator stacji roboczej, zazwyczaj nazwę sieciową komputera, który uruchamia aplikację. HOST_NAME() zwraca tę wartość.
FailoverPartner Failover_Partner Określa serwer partnera awaryjnego do mirrorowania baz danych. Obsługiwane tylko na Windows.

Uwaga / Notatka

W wersji 18.7, MultipleActiveResultSets akceptuje Yes lub No, ale nie True ani False.

Kierowca stosuje następujące zasady do tych aliasów:

  • Nierozróżniające wielkość liter : Sterownik dopasowuje aliasy niezależnie od wielkości liter. Na przykład multipleactiveresultsets zachowuje się tak samo jak MultipleActiveResultSets.
  • Pierwsze wystąpienie wygrywa: Alias i równoważne mu słowo kluczowe ODBC konfigurują tę samą opcję. Jeśli parametry połączenia zawiera oba te elementy, sterownik używa pierwszej wartości i ignoruje kolejne wartości dla tej opcji.
  • Tylko wejście: Sterownik akceptuje aliasy jako wejście. Gdy zwraca wyjściowy ciąg połączenia lub zapisuje ustawienie w nazwie źródła danych (DSN), używa równoważnego słowa kluczowego ODBC.
  • Wsparcie dla platform: Sterownik obsługuje MultipleActiveResultSets i WorkstationID na Windows, Linux oraz macOS. Sterownik obsługuje FailoverPartner i Failover_Partner tylko w systemie Windows.

Słowo kluczowe ConnectTimeout

ConnectTimeout słowo kluczowe konfiguruje ten sam limit czasu logowania co atrybut połączenia SQL_ATTR_LOGIN_TIMEOUT. Aplikacje mogą określić limit czasu w parametry połączenia zamiast wywoływać SQLSetConnectAttr.

Jeśli aplikacja jawnie ustawi SQL_ATTR_LOGIN_TIMEOUT przed wywołaniem funkcji połączenia, atrybut połączenia ma pierwszeństwo przed wartością ConnectTimeout parametrów połączenia.

  • Jednostki i wartość domyślna: Wartość określa liczbę sekund oczekiwania na zakończenie logowania. Domyślna wartość to 15 sekundy.
  • Brak limitu czasu: Wartość od 0 mówi sterownikowi, aby czekał w nieskończoność.
  • Maksimum i zaciskanie: Maksymalna wartość to 65534. Gdy podajesz wartość ujemną, większą niż 65534, lub wartość przekraczającą obsługiwany zakres liczbowy, kierowca używa 65534. Jeśli sterownik zablokuje wartość, a połączenie w inny sposób się powiedzie, sterownik zwraca SQL_SUCCESS_WITH_INFO z ostrzeżeniem 01S02 (Wartość opcji zmieniona).
  • Walidacja: Sterownik odrzuca wartości puste i nienumeryczne.
  • Obsługa DSN: W systemie Windows aplikacje mogą przechowywać i pobierać ConnectTimeout w nazwie źródła danych (DSN).
  • Wsparcie dla platform: Sterownik obsługuje systemy Windows, Linux i macOS z ConnectTimeout.

Example

Poniższy parametry połączenia używa zunifikowanej pisowni słów kluczowych. Zastąp <server>, <database>, <user_id> i <password> własnymi wartościami. Dla Azure SQL Database użyj <server>.database.windows.net jako nazwy hosta:

Driver={ODBC Driver 18 for SQL Server};Server=tcp:<server>;Database=<database>;UID=<user_id>;PWD=<password>;Encrypt=yes;TrustServerCertificate=no;MultipleActiveResultSets=Yes;WorkstationID=app-node-01;ConnectTimeout=30;

Aliasy w poprzednich parametrach połączenia ustawiają te same opcje, co oryginalne słowa kluczowe ODBC w następujących parametrach połączenia:

Driver={ODBC Driver 18 for SQL Server};Server=tcp:<server>;Database=<database>;UID=<user_id>;PWD=<password>;Encrypt=yes;TrustServerCertificate=no;MARS_Connection=Yes;WSID=app-node-01;

Oba ciągi włączają funkcję MARS i ustawiają identyfikator stacji roboczej na app-node-01. Pierwszy ciąg czeka również do 30 sekund na zakończenie logowania. ConnectTimeout nie ma równoważnego słowa kluczowego w sterowniku 17 lub we wcześniejszych wydaniach sterownika 18. Aby ustawić limit czasu logowania, wywołaj SQLSetConnectAttr za pomocą SQL_ATTR_LOGIN_TIMEOUT.

Uwierzytelnianie — SQL_COPT_SS_AUTHENTICATION

Ustawia tryb uwierzytelniania dla połączenia. Aby uzyskać więcej informacji, zobacz Używanie Microsoft Entra ID ze sterownikiem ODBC.

Wartość słowa kluczowego Wartość atrybutu Description
SQL_AU_NONE (domyślnie) Bez wyraźnie ustawionego atrybutu inne ustawienia połączenia decydują o uwierzytelnianiu. Jawne ustawienie tego atrybutu nadpisuje wybór w DSN lub w parametry połączenia Authentication.
SqlPassword SQL_AU_PASSWORD Uwierzytelnianie SQL za pomocą nazwy użytkownika i hasła.
ActiveDirectoryIntegrated SQL_AU_AD_INTEGRATED Zintegrowane uwierzytelnianie Microsoft Entra.
ActiveDirectoryInteractive SQL_AU_AD_INTERACTIVE Microsoft Entra uwierzytelnianie interaktywne.
ActiveDirectoryMsi SQL_AU_AD_MSI Uwierzytelnianie przy użyciu tożsamości zarządzanej Microsoft Entra. Dla tożsamości przypisanej przez użytkownika ustaw UID jej identyfikator klienta na Azure App Service lub Azure Container Instances; użyj jej identyfikatora obiektu na innych obsługiwanych hostach. Pomiń UID dla tożsamości przypisanej przez system.
ActiveDirectoryServicePrincipal SQL_AU_AD_SPA Uwierzytelnianie nazwy głównej usługi Microsoft Entra. UID jest ustawiony na identyfikator klienta podmiotu usługi. PWD jest ustawiony na klucz tajny klienta.
ActiveDirectoryPassword SQL_AU_AD_PASSWORD Przestarzałe uwierzytelnianie za pomocą nazwy użytkownika i hasła Microsoft Entra. Aby uzyskać więcej informacji, zobacz wycofanie ActiveDirectoryPassword.
SQL_AU_RESET Usuwa wyraźnie ustawiony atrybut uwierzytelniania, aby ustawienie w DSN lub w parametry połączenia Authentication mogło ponownie zostać zastosowane.

Uwaga / Notatka

Podczas używania słowa kluczowego lub atrybutu Authentication należy jawnie ustawić Encrypt w parametry połączenia, DSN lub atrybucie połączenia. Informacje o zachowaniu i ustawieniach domyślnych znajdziesz w Encrypt.

ColumnEncryption — SQL_COPT_SS_COLUMN_ENCRYPTION

Steruje szyfrowaniem przezroczystej kolumny (Always Encrypted). Aby uzyskać więcej informacji, zobacz Using Always Encrypted with the ODBC Driver for SQL Server (Używanie funkcji Always Encrypted ze sterownikiem ODBC dla programu SQL Server).

Wartość słowa kluczowego Wartość atrybutu Description
Enabled SQL_CE_ENABLED Włącza funkcję Always Encrypted.
Disabled (domyślnie) SQL_CE_DISABLED Wyłącza funkcję Always Encrypted.
SQL_CE_RESULTSETONLY Włącza tylko odszyfrowywanie (wyniki i zwracane wartości).

ConcatNullYieldsNull — SQL_COPT_SS_CONCAT_NULL

Kontroluje obsługę Międzynarodowej Organizacji Normalizacyjnej (ISO) elementu NULL podczas łączenia ciągów znaków. Aby uzyskać więcej informacji, zobacz SET CONCAT_NULL_YIELDS_NULL.

Wartość słowa kluczowego Wartość atrybutu Description
Yes (domyślnie) SQL_CN_ON NULL konkatenacja daje NULL.
No SQL_CN_OFF NULL łączenie powoduje powstanie ciągu znaków.

Szyfrować

Określa, czy połączenia korzystają z szyfrowania Transport Layer Security (TLS) w sieci. Sterownik 17 akceptuje yes i no. Sterownik 18 akceptuje również mandatory jako synonim dla yes, optional jako synonim dla no oraz strict, który wybiera szyfrowanie Tabular Data Stream (TDS) 8.0 i nie ma odpowiednika w sterowniku 17.

Sterownik 18 ma domyślnie ustawione yes. Sterownik 17 zazwyczaj domyślnie ustawia wartość no, ale domyślnie ustawia wartość yes, gdy podano niepuste ustawienie Authentication lub token dostępu. Ustaw Encrypt to jawnie, zamiast polegać na tych domyślnych ustawieniach zależnych od uwierzytelniania.

Niezależnie od ustawienia dla Encryptparametru poświadczenia logowania serwera (nazwa użytkownika i hasło) są zawsze szyfrowane.

Ustawienia Encrypt, TrustServerCertificate, oraz serwera Force Encryption decydują, czy połączenia są szyfrowane w sieci. W poniższych tabelach przedstawiono efekt tych ustawień.

Sterownik ODBC 18 i nowsze wersje

Ustawienie szyfrowania Ufaj certyfikatowi serwera Wymuszenie szyfrowania serwera Result
Nie. Nie. Nie. Certyfikat serwera nie jest sprawdzany.
Dane wysyłane między klientem a serwerem nie są szyfrowane.
Nie. Tak Nie. Certyfikat serwera nie jest sprawdzany.
Dane wysyłane między klientem a serwerem nie są szyfrowane.
Tak Nie. Nie. Certyfikat serwera jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.
Tak Tak Nie. Certyfikat serwera nie jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.
Nie. Nie. Tak Certyfikat serwera jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.
Nie. Tak Tak Certyfikat serwera nie jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.
Tak Nie. Tak Certyfikat serwera jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.
Tak Tak Tak Certyfikat serwera nie jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.
Ścisły - - TrustServerCertificate jest ignorowany. Certyfikat serwera jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.

Uwaga / Notatka

Wartość Strict jest dostępna tylko w przypadku serwerów obsługujących połączenia TDS 8.0.

Sterownik ODBC 17 i wcześniejsze wersje

Ustawienie szyfrowania Ufaj certyfikatowi serwera Wymuszenie szyfrowania serwera Result
Nie. Nie. Nie. Certyfikat serwera nie jest sprawdzany.
Dane wysyłane między klientem a serwerem nie są szyfrowane.
Nie. Tak Nie. Certyfikat serwera nie jest sprawdzany.
Dane wysyłane między klientem a serwerem nie są szyfrowane.
Tak Nie. Nie. Certyfikat serwera jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.
Tak Tak Nie. Certyfikat serwera nie jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.
Nie. Nie. Tak Certyfikat serwera nie jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.
Nie. Tak Tak Certyfikat serwera nie jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.
Tak Nie. Tak Certyfikat serwera jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.
Tak Tak Tak Certyfikat serwera nie jest sprawdzany.
Dane wysyłane między klientem a serwerem są szyfrowane.

TransparentNetworkIPResolution — SQL_COPT_SS_TNIR

Steruje funkcją Transparent Network IP Resolution, starszym zapasowym mechanizmem obsługi wielu adresów IP dla sterownika ODBC. To ustawienie nie wpływa na sekwencję nawiązywania połączenia, gdy MultiSubnetFailover=Yes, co jest zalecanym ustawieniem dla Azure SQL Database, Azure SQL Managed Instance, bazy danych SQL w usłudze Microsoft Fabric, detektorów grup dostępności oraz wystąpień klastra trybu failover. Więcej informacji można znaleźć w artykule Używaj przezroczystej rozdzielczości IP sieci z sterownikiem ODBC lub Wysoka dostępność i odzyskiwanie po awarii.

Wartość słowa kluczowego Wartość atrybutu Description
Enabled (domyślnie) SQL_IS_ON Umożliwia przejrzystą rozdzielczość IP sieci.
Disabled SQL_IS_OFF Wyłącza przezroczyste rozpoznawanie adresów IP sieci.

Korzystanie z narzędziaFMTONLY

Kontroluje użycie SET FMTONLY do metadanych podczas łączenia z SQL Server 2012 i nowszymi wersjami.

Wartość słowa kluczowego Description
No (domyślnie) Użyj sp_describe_first_result_set w przypadku metadanych, jeśli są dostępne.
Yes Użyj SET FMTONLY do metadanych.

Replication

Określa użycie konta replikacji w sterownikach ODBC w wersji 17.8 i nowszych.

Wartość słowa kluczowego Description
No (domyślnie) Logowanie replikacyjne nie jest używane.
Yes Wyzwalacze z opcją NOT FOR REPLICATION nie uruchamiają połączenia.

PacketSize

Sterownik 18.7 obsługuje PacketSize, aby zażądać rozmiaru pakietu sieciowego w bajtach. Negocjowany rozmiar może różnić się od żądanej wartości. Użyj SQL_ATTR_PACKET_SIZE do ustawienia odpowiadającego atrybutu połączenia lub pobrania negocjowanego rozmiaru. Informacje o ograniczeniach atrybutów i ich działaniu znajdziesz w SQLSetConnectAttr. Aplikacje Driver 17 używają atrybutu zamiast słowa kluczowego PacketSize.

RetryExec

Konfigurowalna logika ponawiania prób jest dostępna w Driver 18.1 i nowszych wersjach. Sterownik 17 nie obsługuje RetryExec. Włącz go za pomocą RetryExec słowa kluczowego parametry połączenia oraz listy reguł kontrolujących ponowne wykonanie SQLExecDirect i SQLExecute.

Po błędzie wykonania sterownik wybiera pierwszą regułę, której lista błędów zawiera ten kod błędu. Następnie sprawdza, czy prefiks zapytania tej reguły pasuje do przychodzącego tekstu polecenia dla SQLExecDirect lub przygotowanego tekstu dla SQLExecute. Jeśli prefiks się nie zgadza, sterownik nie próbuje ponownie wykonać polecenia ani nie przechodzi do późniejszych reguł. Późniejsza reguła dopasowująca wszystko nie jest rozwiązaniem awaryjnym dla kodu błędu już wymienionego we wcześniejszej regule.

Spróbuj ponownie wykonać tylko operacje, które można bezpiecznie powtórzyć. Ponawianie może wykonać polecenie więcej niż raz, a awaria połączenia nie dowodzi, że poprzedni zapis nie został ukończony.

Wartość RetryExec słowa kluczowego to lista reguł powtórek oddzielonych średnikami.
RetryExec={rule1;rule2}

Reguła ponawiania prób jest następująca: <errormatch>:<retrypolicy>:<querymatch>

  • Dopasowanie błędu: Lista kodów błędów oddzielona przecinkami, taka jak 1000,2000.

  • Polityka ponowienia: Liczba ponowień, a następnie początkowe opóźnienie w sekundach. Na przykład pozwala 3,10+7 na trzy powtórki po początkowym wykonaniu, z opóźnieniami 10, 17 i 24 sekund: łącznie cztery uruchomienia, jeśli każda próba się nie powiedzie. Bez +, opóźnienie podwaja się przy każdej ponownej próbie. Końcowy element + bez przyrostu używa początkowego opóźnienia jako przyrostu.

  • Dopasowanie zapytania: Prefiks tekstu polecenia. Pusty prefiks dotyczy wszystkich poleceń. Na przykład SELECT dopasowuje polecenia zaczynające się od SELECT.

Połączenie wszystkich trzech komponentów do użycia w parametry połączenia:

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

Dla błędów 1000 i 2000 dla polecenia rozpoczynającego się od SELECT, reguła ta pozwala na trzy próby po 10, 17 i 24 sekundach.

Examples

40501,40540:4,5

Dla błędów 40501 i 40540, próbuj ponownie do czterech razy, z początkowym opóźnieniem 5 sekund i wykładniczym podwajaniem między kolejnymi próbami. Ta reguła ma zastosowanie do wszystkich zapytań.

49919:2,10+:CREATE

Dla błędu 49919 zapytania zaczynającego się od CREATE, spróbuj co najwyżej dwa razy, najpierw po 10 sekundach, a potem po 20 sekundach.

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

Dla błędów 49918, 40501, oraz 10928 przy zapytaniach zaczynających się od SELECT c1, próbuj ponownie do pięciu razy, czekając 10 sekund przy pierwszym powtórzeniu i wydłużając czas oczekiwania o 5 sekund.

Określ trzy powyższe reguły razem w parametry połączenia w następujący sposób:

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

W tej kombinacji błąd 40501 wybiera pierwszą regułę i ponawia tylko polecenia zaczynające się od SELECT c1. Ostateczna reguła nie zapewnia rozwiązania awaryjnego dla innych poleceń, które kończą się niepowodzeniem z 40501. Aby zastosować ostateczną politykę do wszystkich poleceń z tym błędem, usuń 40501 z listy błędów pierwszej reguły. Preferuj nienakładające się listy błędów, gdy każdy kod wymaga jednej polityki.

Certyfikat Klienta

Określa certyfikat używany do uwierzytelniania dla połączeń loopback. Ta opcja jest dostępna tylko w SQL Server on Linux. Dostępne opcje:

Wartość opcji Description
sha1:<hash_value> Sterownik ODBC używa hasha Secure Hash Algorithm 1 (SHA-1) do lokalizacji certyfikatu w Magazynie Certyfikatów Windows.
subject:<subject> Sterownik ODBC wykorzystuje ten podmiot do zlokalizowania certyfikatu w Magazynie Certyfikatów Windows.
file:<file_location>[,password:<password>] Sterownik ODBC używa pliku certyfikatu.

Jeśli certyfikat jest w formacie Personal Information Exchange (PFX), a jego klucz prywatny jest chroniony hasłem, podaj password słowo kluczowe. Dla certyfikatów w formatach Privacy Enhanced Mail (PEM) i Distinguished Encoding Rules (DER) dołącz słowo kluczowe ClientKey.

Klucz klienta

Określa lokalizację pliku klucza prywatnego dla certyfikatów PEM lub DER określonych przez atrybut ClientCertificate. Format:

Wartość opcji Description
file:<file_location>[,password:<password>] Określa lokalizację pliku klucza prywatnego.

Jeśli plik klucza prywatnego jest chroniony hasłem, należy dodać password słowo kluczowe. Jeśli hasło zawiera znaki , , natychmiast po każdym dodaj dodatkowy , znak. Na przykład jeśli hasło to a,b,c, to hasło z poprzedzonymi znakami specjalnymi w parametrach połączenia ma postać a,,b,,c.

Nazwa hosta w certyfikacie

Określa nazwę hosta, której można się spodziewać w certyfikacie serwera podczas negocjowania szyfrowania , jeśli różni się od wartości domyślnej pochodzącej z Addr, Address, lub Server. Opcja HostnameInCertificate jest ignorowana, gdy używasz opcji ServerCertificate.

Preferencja adresu IP

Począwszy od wersji 18.1, użyj tej opcji, aby określić typ adresu IP, który należy priorytetyzować dla połączeń.

Możliwe opcje to IPv4First, IPv6First, oraz UsePlatformDefault. UsePlatformDefault łączy się z adresami w kolejności, w jakiej są podawane przez wywołanie systemowe, aby rozwiązać nazwę serwera. Domyślna wartość to IPv4First, co odpowiada zachowaniu w poprzednich wersjach.

ServerCertificate

Począwszy od wersji 18.1, używaj tej opcji tylko w trybie ścisłego szyfrowania. Użyj ServerCertificate słowa kluczowego, aby określić ścieżkę do pliku certyfikatu, która ma być dopasowana do certyfikatu TLS serwera. Dopasowanie względem pliku zastępuje normalną walidację nazw hosta i łańcucha zaufania, ale sterownik nadal sprawdza daty ważności certyfikatu serwera. Użyj pliku certyfikatu zakodowanego w formacie PEM lub DER. Pliki z rozszerzeniem .cer są akceptowane, jeśli są zakodowane przy użyciu jednego z tych kodowań. Certyfikat serwera musi być dokładnie taki sam jak certyfikat w określonym pliku.

SQL_COPT_SS_ACCESS_TOKEN

Użyj tokenu dostępu Microsoft Entra ID do uwierzytelniania. Aby uzyskać więcej informacji, zobacz Używanie Microsoft Entra ID ze sterownikiem ODBC.

Wartość atrybutu Description
NULL (domyślnie) Nie podano tokenu dostępu.
ACCESSTOKEN* Wskaźnik do tokenu dostępu.

SQL_COPT_SS_CEKEYSTOREDATA

Komunikuje się z załadowaną biblioteką dostawcy magazynu kluczy. Steruje szyfrowaniem przezroczystej kolumny (Always Encrypted). Ten atrybut nie ma wartości domyślnej. Aby uzyskać więcej informacji, zobacz Niestandardowe dostawcy magazynu kluczy.

Wartość atrybutu Description
CEKEYSTOREDATA * Struktura danych komunikacyjnych dla biblioteki dostawcy keystore.

SQL_COPT_SS_CEKEYSTOREPROVIDER

Ładuje bibliotekę dostawcy magazynu kluczy dla funkcji Always Encrypted lub pobiera nazwy załadowanych bibliotek dostawcy magazynu kluczy. Aby uzyskać więcej informacji, zobacz Niestandardowe dostawcy magazynu kluczy. Ten atrybut nie ma wartości domyślnej.

Wartość atrybutu Description
char * Ścieżka do biblioteki dostawcy keystore.

SQL_COPT_SS_ENLIST_IN_XA

Aby przyłączyć połączenie do rozproszonych transakcji XA, wywołaj SQLSetConnectAttr z SQL_COPT_SS_ENLIST_IN_XA oraz wskaźnikiem do obiektu XACALLPARAM. Ta opcja jest obsługiwana na Windows (wersje 17.3 i nowsze), Linuksie oraz macOS.

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

Aby powiązać transakcję XA wyłącznie z połączeniem ODBC, należy podać TRUE lub FALSE z SQL_COPT_SS_ENLIST_IN_XA zamiast wskaźnika podczas wywoływania SQLSetConnectAttr. To ustawienie jest prawidłowe tylko w systemie Windows i nie może służyć do określania operacji XA za pośrednictwem aplikacji klienckiej.

SQLSetConnectAttr(hdbc, SQL_COPT_SS_ENLIST_IN_XA, (SQLPOINTER)TRUE, 0);
Wartość Description Platformy
XACALLPARAM obiekt* Wskaźnik do XACALLPARAM obiektu. Windows, Linux i macOS
TRUE Kojarzy transakcję XA z połączeniem ODBC. Wszystkie powiązane działania bazy danych są wykonywane w ramach ochrony transakcji XA. Windows
FALSE Usuwa skojarzenie transakcji z połączeniem ODBC. Windows

Aby uzyskać więcej informacji na temat transakcji XA, zobacz Using XA Transactions (Używanie transakcji XA).

SQL_COPT_SS_LONGASMAX

Kontroluje, czy sterownik wysyła długie parametry znakowe i binarne jako varchar(max), nvarchar(max) oraz varbinary(max). Sterownik 18 obsługuje tę opcję; Sterownik 17 nie.

Wartość atrybutu Description
SQL_XL_OFF (0, domyślnie) Nie konwertuj typów o dużej długości na typy max podczas wysyłania danych.
SQL_XL_ON (1) Konwertuj typy long na typy max podczas wysyłania.

Są to wartości numeryczne typu SQLSetConnectAttr. Odpowiadające LongAsMax mu słowo kluczowe parametry połączenia używa No oraz Yes.

SQL_COPT_SS_SPID

Pobiera identyfikator sesji połączenia. Ta właściwość jest równoważna Transact-SQL (T-SQL) @@SPID zmiennej, z tą różnicą, że nie powoduje dodatkowego kursu w obie strony do serwera.

Wartość atrybutu Description
DWORD Identyfikator sesji.