Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.
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
multipleactiveresultsetszachowuje się tak samo jakMultipleActiveResultSets. - 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
MultipleActiveResultSetsiWorkstationIDna Windows, Linux oraz macOS. Sterownik obsługujeFailoverPartneriFailover_Partnertylko 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
15sekundy. -
Brak limitu czasu: Wartość od
0mó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żywa65534. Jeśli sterownik zablokuje wartość, a połączenie w inny sposób się powiedzie, sterownik zwracaSQL_SUCCESS_WITH_INFOz ostrzeżeniem01S02(Wartość opcji zmieniona). - Walidacja: Sterownik odrzuca wartości puste i nienumeryczne.
-
Obsługa DSN: W systemie Windows aplikacje mogą przechowywać i pobierać
ConnectTimeoutw 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+7na 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
SELECTdopasowuje polecenia zaczynające się odSELECT.
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. |