Ustawianie właściwości połączenia
Właściwości parametrów połączenia można określić na różne sposoby:
W postaci właściwości name=value w adresie URL połączenia, kiedy nawiązujesz połączenie poprzez klasę DriverManager. Aby uzyskać informacje o składni parametrów połączenia, zobacz Tworzenie adresu URL połączenia.
Jako właściwości name=value w parametrze Properties metody Connect w klasie DriverManager.
Jako wartości w odpowiedniej metodzie ustawiania źródła danych sterownika. Na przykład:
datasource.setServerName(value) datasource.setDatabaseName(value)
Uwagi
Nazwy właściwości są niewrażliwe na wielkość liter, a zduplikowane nazwy właściwości są rozpoznawane w następującej kolejności:
- Argumenty interfejsu API (takie jak użytkownik i hasło)
- Kolekcja właściwości
- Ostatnie wystąpienie w parametrach połączenia
Nieznane wartości są dozwolone dla nazw właściwości, a sterownik JDBC nie weryfikuje czułości na wielkość liter.
Synonimy są dozwolone i są rozpoznawane w kolejności, podobnie jak zduplikowane nazwy właściwości.
Właściwości
W poniższej tabeli wymieniono wszystkie aktualnie dostępne właściwości parametrów połączenia dla sterownika JDBC.
| Własność Typ Domyślny |
Opis |
|---|---|
| accessToken Struna null |
(Wersja 6.0 lub nowsza) Użyj tej właściwości, aby nawiązać połączenie z bazą danych przy użyciu tokenu dostępu. accessToken nie można ustawić przy użyciu adresu URL połączenia. |
| klasa accessTokenCallback Struna null |
(Wersja 12.4 lub nowsza) Nazwa klasy implementowania wywołania zwrotnego, która ma być używana z wywołaniem zwrotnym tokenu dostępu. |
| intencja aplikacji Struna ReadWrite |
(Wersja 6.0 lub nowsza) Deklaruje typ obciążenia aplikacji, aby nawiązać połączenie z serwerem. Możliwe wartości to ReadOnly i ReadWrite. Aby uzyskać więcej informacji na temat odzyskiwania po awarii, zobacz wsparcie sterowników JDBC dla wysokiej dostępności i odzyskiwania po awarii. |
| nazwa aplikacji Struna [<=128 znaków] null |
Nazwa aplikacji lub "Sterownik JDBC firmy Microsoft dla programu SQL Server", jeśli nie podano nazwy. Służy do identyfikowania określonej aplikacji w różnych narzędziach profilowania i rejestrowania programu SQL Server. |
| uwierzytelnianie Struna Nieokreślony |
(Wersja 6.0 lub nowsza) Ta opcjonalna właściwość wskazuje, która metoda uwierzytelniania ma być używana na potrzeby połączenia. Możliwe wartości to ActiveDirectoryIntegrated, ActiveDirectoryPassword, ActiveDirectoryManagedIdentity (wersja 12.2 lub nowsza), ActiveDirectoryMSI (wersja 7.2 lub nowsza), ActiveDirectoryInteractive (wersja 9.2 lub nowsza), ActiveDirectoryServicePrincipal (wersja 9.2 lub nowsza), SqlPasswordi domyślny NotSpecified. Użyj ActiveDirectoryIntegrated (wersja 6.0 lub nowsza), aby nawiązać połączenie z bazą danych SQL przy użyciu zintegrowanego uwierzytelniania systemu Windows. Użyj ActiveDirectoryPassword (wersja 6.0 lub nowsza), aby nawiązać połączenie z bazą danych SQL przy użyciu głównej nazwy i hasła firmy Microsoft. Użyj ActiveDirectoryManagedIdentity (wersja 12.2 lub nowsza) lub ActiveDirectoryMSI (wersja 7.2 lub nowsza), aby nawiązać połączenie z bazą danych SQL z poziomu zasobu platformy Azure. Na przykład maszyna wirtualna platformy Azure, usługa App Service lub aplikacja funkcji korzystająca z uwierzytelniania tożsamości zarządzanej. Dwa typy tożsamości zarządzanych obsługiwanych przez sterownik podczas korzystania z ActiveDirectoryManagedIdentity lub ActiveDirectoryMSI tryb uwierzytelniania to: 1. System-Assigned tożsamości zarządzanej: służy do uzyskiwania accessToken domyślnie. 2. User-Assigned tożsamość zarządzana: używana do uzyskania "accessToken", jeśli identyfikator klienta tożsamości zarządzanej jest określony właściwością połączenia msiClientId. Użyj ActiveDirectoryInteractive, aby nawiązać połączenie z bazą danych przy użyciu przepływu uwierzytelniania interakcyjnego. Użyj ActiveDirectoryServicePrincipal (wersja 9.2 lub nowsza), aby nawiązać połączenie z bazą danych przy użyciu identyfikatora klienta i sekretu tożsamości zasadniczej usługi. Określ identyfikator klienta we właściwości userName i wpis tajny we właściwości password (10.2+). Użyj Użyj NotSpecified, jeśli żadna z tych metod uwierzytelniania nie jest potrzebna. Ważne: Jeśli uwierzytelnianie jest ustawione na ActiveDirectoryIntegrated, należy zainstalować następujące dwie biblioteki: mssql-jdbc_auth-<wersji>—<arch>.dll (dostępne w pakiecie sterowników JDBC) i Microsoft Authentication Library for SQL Server (ADAL.DLL). Bibliotekę uwierzytelniania firmy Microsoft można zainstalować z sterownika Microsoft ODBC dla programu SQL Server lub sterownika Microsoft OLE DB firmy Microsoft dla programu SQL Server. Sterownik JDBC obsługuje tylko wersję 1.0.2028.318 i nowszej dla ADAL.DLL. Uwaga: Gdy właściwość uwierzytelniania jest ustawiona na dowolną wartość inną niż NotSpecified, sterownik domyślnie używa protokołu Transport Layer Security (TLS), wcześniej znanego jako Secure Sockets Layer (SSL), szyfrowania. Aby uzyskać informacje na temat konfigurowania uwierzytelniania w usłudze Microsoft Entra, zobacz Use Microsoft Entra authentication. |
| schemat uwierzytelniania Struna NativeAuthentication |
Wskazuje, jakiego rodzaju zintegrowane zabezpieczenia mają być używane przez aplikację. Możliwe wartości to JavaKerberos, NTLM (wersja 7.4 lub nowsza) oraz domyślna NativeAuthentication. NativeAuthentication powoduje ładowanie sterownika mssql-jdbc_auth-<version>-<arch>.dll (na przykład mssql-jdbc_auth-8.2.2.x64.dll) w systemie Windows; sterownik ten służy do uzyskiwania zintegrowanych informacji uwierzytelniania. (Załadowana natywna biblioteka uwierzytelniania nosi nazwę sqljdbc_auth.dll w przypadku używania sterowników w wersji od 6.0 do 7.4). W przypadku używania authenticationScheme=JavaKerberosnależy określić w pełni kwalifikowaną nazwę domeny (FQDN) we właściwości serverName lub serverSpn. W przeciwnym razie wystąpi błąd (nie znaleziono serwera w bazie danych Kerberos). pl-PL: Aby uzyskać więcej informacji na temat używania authenticationScheme=JavaKerberos, zobacz Używanie zintegrowanego uwierzytelniania Kerberos, aby połączyć się z SQL Server. W przypadku używania authenticationScheme=NTLM, należy określić domenę systemu Windows, używając właściwości domeny lub właściwości domainName , poświadczeń systemu Windows w właściwości użytkownika lub właściwości userName oraz w właściwości hasła . W przeciwnym razie wystąpi błąd (należy określić właściwości połączenia). |
| cacheBulkCopyMetadata boolean ["prawda" | "fałsz"] fałszywy |
(Wersja 12.8 lub nowsza) W przypadku używania useBulkCopyForBatchInsert=true, ta właściwość wskazuje, czy powinna buforować metadane kolumn docelowych na poziomie połączenia. Jeśli ustawiono wartość true, upewnij się, że miejsce docelowe nie zmienia się między operacjami wstawiania zbiorczego, ponieważ sterownik nie ma sposobu obsługi tej zmiany. |
| calcBigDecimalPrecision boolean ["prawda" | "fałsz"] fałszywy |
(Wersja 12.6 lub nowsza) Flaga wskazująca, czy sterownik powinien obliczyć precyzję dla danych wejściowych BigDecimal, w przeciwieństwie do używania maksymalnej dozwolonej wartości dla precyzji (38). |
| cancelQueryTimeout Int -1 |
(Wersja 6.4 lub nowsza) Tej właściwości można użyć do anulowania queryTimeout ustalonego na połączeniu. Wykonywanie zapytania zawiesza się i nie zgłasza wyjątku, jeśli połączenie TCP z serwerem jest przerywane w trybie dyskretnym. Ta właściwość ma zastosowanie tylko wtedy, gdy właściwość "queryTimeout" jest również ustawiona na połączeniu. Sterownik czeka łączną ilość czasu cancelQueryTimeout + queryTimeout sekund, aby usunąć połączenie i zamknąć kanał. Wartość domyślna tej właściwości to -1, a zachowanie polega na oczekiwaniu na czas nieokreślony. |
| certyfikat klienta Struna null |
(Wersja 8.4 lub nowsza) Określa lokalizację certyfikatu do użycia na potrzeby uwierzytelniania certyfikatu klienta. Sterownik JDBC obsługuje rozszerzenia plików PFX, PEM, DER i CER. Aby uzyskać szczegółowe informacje, zobacz Uwierzytelnianie certyfikatu klienta dla scenariuszy sprzężenia zwrotnego. |
| clientKey Struna null |
(Wersja 8.4 lub nowsza) Określa lokalizację klucza prywatnego dla certyfikatów PEM, DER i CER określonych przez atrybut clientCertificate. Aby uzyskać szczegółowe informacje, zobacz Uwierzytelnianie certyfikatu klienta dla scenariuszy sprzężenia zwrotnego. |
| clientKeyPassword (hasło klucza klienta) Struna null |
(Wersja 8.4 lub nowsza) Określa opcjonalny ciąg hasła na potrzeby uzyskiwania dostępu do klucza prywatnego pliku clientKey. Aby uzyskać szczegółowe informacje, zobacz Uwierzytelnianie certyfikatu klienta dla scenariuszy sprzężenia zwrotnego. |
| columnEncryptionSetting Struna ["Włączone" | "Wyłączone"] Niepełnosprawny |
(Wersja 6.0 lub nowsza) Ustaw wartość "Włączone", aby używać funkcji Always Encrypted (AE). Po włączeniu usługi AE sterownik JDBC w sposób niewidoczny szyfruje i odszyfrowuje poufne dane przechowywane w zaszyfrowanych kolumnach bazy danych na serwerze. Aby uzyskać więcej informacji na temat funkcji Always Encrypted, zobacz Using Always Encrypted with the JDBC driver. Uwaga: funkcja Always Encrypted jest dostępna w programie SQL Server 2016 lub nowszym i usłudze Azure SQL Database. |
| connectRetryCount Int [0..255] 1 |
(Wersja 9.4 lub nowsza) Liczba ponownych prób nawiązania połączenia, jeśli wystąpi błąd połączenia. |
| connectRetryInterval Int [1..60] 10 |
(Wersja 9.4 lub nowsza) Liczba sekund między poszczególnymi próbami ponawiania próby nawiązania połączenia. |
| nazwaBazyDanych baza danych Struna [<=128 znaków] null |
Nazwa bazy danych do nawiązania połączenia. Jeśli nie określono, połączenie zostanie nawiązane z domyślną bazą danych. |
| datetimeParameterType Struna ["datetime" | "datetime2" | "datetimeoffset"] datetime2 |
(Wersja 12.2 lub nowsza) Typ danych SQL do użycia dla parametrów znacznika daty/godziny języka Java. W przypadku nawiązywania połączenia z programem SQL Server 2016 lub nowszym oraz pracy ze starszymi wartościami typu "datetime" klienci mogą korzystać z ustawienia właściwości na "datetime". To ustawienie ogranicza problemy z konwersją po stronie serwera między wartościami "datetime" i "datetime2". Aby uzyskać więcej informacji, zobacz Omówienie zmiany sposobu konwersji z daty/godziny na datę/godzinę2 w SQL Server 2016 |
| delayLoadingLobs boolean ["prawda" | "fałsz"] prawdziwy |
Flaga wskazująca, czy wszystkie obiekty LOB pobierane z zestawu wyników mają być przesyłane strumieniowo, czy nie. Ustawienie tej właściwości na wartość "false" powoduje załadowanie całego obiektu LOB do pamięci bez przesyłania strumieniowego. |
| nazwa_domeny, domena Struna null |
(Wersja 7.4 lub nowsza) Domena systemu Windows do uwierzytelniania w przypadku korzystania z uwierzytelniania NTLM. |
| wyłącz buforowanie zapytań boolean ["prawda" | "fałsz"] prawdziwy |
Flaga wskazuje, czy należy użyć buforowania instrukcji. |
| enablePrepareOnFirst... PreparedStatementCall boolean ["prawda" | "fałsz"] fałszywy |
Ustaw "true", aby umożliwić tworzenie uchwytu przygotowanego zapytania przez wywołanie sp_prepexec podczas pierwszego wykonania przygotowanego zapytania. Ustaw wartość "false", aby przy pierwszym wykonaniu przygotowanej instrukcji wywołać sp_executesql zamiast przygotowywać instrukcję. Jeśli wystąpi drugie wykonanie, wywołuje sp_prepexec, aby skonfigurować kursor przygotowanego zapytania. |
| enklawaAttestationUrl Struna null |
(Wersja 8.2 lub nowsza) Ta opcjonalna właściwość wskazuje adres URL punktu końcowego usługi zaświadczania do użycia dla funkcji Always Encrypted z bezpiecznymi enklawami. Aby uzyskać więcej informacji na temat funkcji Always Encrypted z bezpiecznymi enklawami, zobacz Always Encrypted z bezpiecznymi enklawami. |
| protokół atestacji enklawy Struna null |
(Wersja 8.2 lub nowsza) Ta opcjonalna właściwość wskazuje protokół zaświadczania używany dla funkcji Always Encrypted z bezpiecznymi enklawami. Obecnie jedynymi obsługiwanymi wartościami dla tego pola są HGS, AASi NONE (NONE jest obsługiwane tylko w wersji 11.2 lub nowszej). Aby uzyskać więcej informacji na temat funkcji Always Encrypted z bezpiecznymi enklawami, zobacz Always Encrypted z bezpiecznymi enklawami. |
| szyfrować Struna null |
Ustaw wartość "true", aby określić, że program SQL Server używa szyfrowania TLS dla wszystkich danych wysyłanych między klientem a serwerem, jeśli serwer ma zainstalowany certyfikat. Wartość domyślna to "true" w wersji 10.2 i nowszej oraz "false" w wersji 9.4 i starszych. W wersji 6.0 i nowszej istnieje nowe ustawienie połączenia "uwierzytelnianie", które domyślnie używa szyfrowania TLS. Aby uzyskać więcej informacji na temat tej właściwości, zobacz właściwość "authentication". W wersji 11.2.0 i nowszej szyfrowanie zostało zmienione z boolean na string , co umożliwia obsługę TDS 8.0, gdy właściwość jest ustawiona na ścisłe. |
| failoverPartner Struna null |
Nazwa serwera trybu failover używanego w konfiguracji dublowania bazy danych. Ta właściwość jest używana do początkowego niepowodzenia połączenia z serwerem głównym. Po nawiązaniu początkowego połączenia ta właściwość jest ignorowana. Musi być używany z właściwością databaseName. Uwaga: Sterownik nie obsługuje numeru portu instancji serwera dla partnera awaryjnego w ramach właściwości failoverPartner w parametrach połączenia. Sterownik obsługuje jednak określanie właściwości serverName, instanceName i portNumber wystąpienia głównego serwera oraz właściwość failoverPartner wystąpienia partnera trybu failover w tych samych parametrach połączenia. Jeśli określisz nazwę sieci wirtualnej we właściwości połączenia Server, nie można użyć funkcji dublowania bazy danych. Aby uzyskać więcej informacji na temat odzyskiwania po awarii, zobacz obsługę sterownika JDBC dla wysokiej dostępności i odzyskiwania po awarii |
fipsboolean ["prawda" | "fałsz"] fałsz |
W przypadku maszyny wirtualnej Java z obsługą protokołu FIPS (JVM) ta właściwość powinna być true. |
| fipsProvider Struna null |
Dostawca FIPS skonfigurowany w maszynie wirtualnej JVM. Na przykład BCFIPS lub SunPKCS11-NSS. Usunięto w wersji 6.4.0. Aby uzyskać więcej informacji, zobacz problem z usługą GitHub 460. |
| gsscredential org.ietf.jgss.GSSCredential null |
(Wersja 6.2 lub nowsza) Poświadczenia użytkownika, które mają być używane dla ograniczonego delegowania Protokołu Kerberos, można przekazać w tej właściwości. To ustawienie powinno być używane z integratedSecurity ustawionym na wartość true oraz JavaKerberos jako authenticationScheme. |
| nazwaHostaWCertyfikacie Struna null |
Nazwa hosta do zweryfikowania certyfikatu TLS/SSL programu SQL Server. Opcja hostNameInCertificate może służyć do określenia nazwy hosta w sytuacjach, w których nazwa lub nazwy używane w certyfikacie nie są zgodne z nazwą przekazaną do właściwości serverName. Jeśli jednak istnieje dopasowanie, nie należy używać opcji hostNameInCertificate. W sytuacjach, gdy właściwość hostNameInCertificate jest nieokreślona lub ustawiona na wartość null, sterownik JDBC firmy Microsoft dla programu SQL Server używa wartości właściwości serverName w adresie URL połączenia jako nazwy hosta w celu zweryfikowania certyfikatu TLS/SSL programu SQL Server. Uwaga: Jak opisano w poprzednim akapicie, nie zaleca się ustawiania opcji hostNameInCertificate, chyba że możesz potwierdzić, że nazwa, lub nazwy, w certyfikacie nie pasują do tych przekazanych w opcji serverName. Uwaga: Ta właściwość jest używana w połączeniu z właściwościami szyfrowania/uwierzytelniania oraz właściwością trustServerCertificate. Ta właściwość ma wpływ na walidację certyfikatu, jeśli połączenie używa szyfrowania TLS, a trustServerCertificate jest ustawiona na wartość "false". Upewnij się, że wartość przekazana do hostNameInCertificate jest zgodna z nazwą pospolitą (CN) lub nazwą DNS w alternatywnej nazwie podmiotu (SAN) w certyfikacie serwera, aby połączenie TLS powiodło się. Aby uzyskać więcej informacji na temat obsługi szyfrowania, zobacz Understanding encryption support. |
| instanceName Struna [<=128 znaków] null |
Nazwa wystąpienia bazy danych, do której należy się połączyć. Jeśli nie zostanie określony, zostanie nawiązane połączenie z wystąpieniem domyślnym. W przypadku, gdy określono zarówno nazwę wystąpienia, jak i port, zobacz uwagi dotyczące portu. Jeśli określisz nazwę sieci wirtualnej we właściwości połączenia serwera |
| zintegrowane zabezpieczenia boolean ["prawda" | "fałsz"] fałszywy |
Ustaw wartość "true", aby wskazać, że poświadczenia systemu Windows są używane przez program SQL Server w systemach operacyjnych Windows. Jeśli wartość "true", sterownik JDBC przeszukuje pamięć podręczną poświadczeń komputera lokalnego pod kątem poświadczeń podanych podczas logowania użytkownika do komputera lub sieci. Ustaw wartość "true" (z authenticationscheme=JavaKerberos), aby wskazać, że poświadczenia protokołu Kerberos są używane przez program SQL Server. Aby uzyskać więcej informacji na temat uwierzytelniania Kerberos, zobacz Korzystanie z zintegrowanego uwierzytelniania Kerberos do łączenia się z serwerem SQL. Ustaw wartość "true" (z authenticationscheme=NTLM), aby wskazać, że poświadczenia NTLM są używane przez program SQL Server. Jeśli wartość "false", należy podać nazwę użytkownika i hasło. |
| preferencje adresu IP Struna [<=128 znaków] IPv4First |
Preferencja adresu IP używana przez aplikację kliencka. Przy użyciu IPV4Firststerownik najpierw przechodzi przez adresy IPv4. Jeśli nie można pomyślnie nawiązać połączenia z adresami IPv4, sterownik kontynuuje i próbuje adresy IPv6, jeśli istnieją. W przypadku IPV6Firststerownik najpierw przechodzi przez adresy IPv6. Jeśli nie można pomyślnie nawiązać połączenia z adresami IPv6, sterownik kontynuuje i próbuje adresy IPv4, jeśli istnieją. W przypadku UsePlatformDefaultsterownik przechodzi przez wszystkie adresy IP w kolejności uzyskanej po rozpoznaniu z DNS. |
| jaasConfigurationName Struna SQLJDBCDriver |
(Wersja 6.2 lub nowsza) Każde połączenie z programem SQL Server może używać własnej nazwy konfiguracji logowania JAAS w celu nawiązania połączenia Kerberos. Nazwę wpisu w konfiguracji można przekazać poprzez tę właściwość. Ta właściwość jest przeznaczona do użycia podczas tworzenia pliku konfiguracji protokołu Kerberos. Domyślnie sterownik szuka nazwy SQLJDBCDriver.Jeśli konfiguracja zewnętrzna nie zostanie znaleziona, sterownik ustawia useDefaultCcache = true dla maszyn wirtualnych IBM JVM i useTicketCache = true dla innych maszyn JVM. |
| keyStoreAuthentication Struna null |
(Wersja 6.0 lub nowsza) Ta właściwość określa magazyn kluczy do użycia z funkcją Always Encrypted i określa mechanizm uwierzytelniania używany do uwierzytelniania w magazynie kluczy. Sterownik obsługuje bezproblemowe konfigurowanie magazynu kluczy Java, gdy ustawiszkeyStoreAuthentication=JavaKeyStorePassword. Aby użyć tej właściwości, należy również ustawić właściwości keyStoreLocation i keyStoreSecret dla magazynu kluczy Java. Aby uzyskać więcej informacji na temat funkcji Always Encrypted, zobacz Using Always Encrypted with the JDBC driver. Począwszy od sterownika JDBC firmy Microsoft 8.4, można ustawić wartość "keyStoreAuthentication=KeyVaultManagedIdentity" lub "keyStoreAuthentication=KeyVaultClientSecret" w celu uwierzytelniania w usłudze Azure Key Vault przy użyciu tożsamości zarządzanych. Aby uzyskać więcej informacji na temat funkcji Always Encrypted, zobacz Using Always Encrypted with the JDBC driver. |
| lokalizacja przechowalni kluczy Struna null |
(Wersja 6.0 lub nowsza) Podczas gdy keyStoreAuthentication=JavaKeyStorePassword, właściwość keyStoreLocation identyfikuje ścieżkę do pliku magazynu kluczy Java, który przechowuje klucz główny kolumny do użycia z funkcją Always Encrypted. Ścieżka musi zawierać nazwę pliku magazynu kluczy. Aby uzyskać więcej informacji na temat funkcji Always Encrypted, zobacz Using Always Encrypted with the JDBC driver. |
| keyStorePrincipalId Struna null |
(Wersja 8.4 lub nowsza) Gdy keyStoreAuthentication=KeyVaultManagedIdentity, właściwość keyStorePrincipalId określa prawidłowy identyfikator klienta aplikacji Microsoft Entra. Aby uzyskać więcej informacji na temat funkcji Always Encrypted, zobacz Using Always Encrypted with the JDBC driver. |
| keyStoreSecret Struna null |
(Wersja 6.0 lub nowsza) Gdy keyStoreAuthentication=JavaKeyStorePassword, właściwość keyStoreSecret określa hasło do użycia dla magazynu kluczy oraz klucza. Jeśli używasz magazynu kluczy Java, magazyn kluczy i hasło klucza muszą być takie same. Aby uzyskać więcej informacji na temat funkcji Always Encrypted, zobacz Using Always Encrypted with the JDBC driver. |
| liczbaOstatnichAktualizacji boolean ["prawda" | "fałsz"] prawdziwy |
Wartość "true" zwraca tylko ostatnią liczbę aktualizacji z instrukcji SQL przekazanej do serwera. Ponadto jest używana tylko dla pojedynczych instrukcji SELECT, INSERT lub DELETE, aby ignorować inne liczniki aktualizacji, które mogą być wyzwalane przez serwer. Ustawienie tej właściwości na wartość "false" powoduje zwrócenie wszystkich liczników aktualizacji, w tym liczby aktualizacji zwracanych przez wyzwalacze serwera. Uwaga: Ta właściwość ma zastosowanie tylko wtedy, gdy jest używana z metodami executeUpdate. Wszystkie inne metody wykonywania zwracają wszystkie wyniki i liczbę aktualizacji. Ta właściwość ma wpływ tylko na liczby aktualizacji zwracane przez wyzwalacze serwera. Nie ma to wpływu na zestawy wyników ani błędy powodowane podczas wykonywania wyzwalacza. |
| lockTimeout Int -1 |
Liczba milisekund oczekiwania, zanim baza danych zgłosi upłynięcie limitu czasu blokady. Domyślne zachowanie polega na oczekiwaniu na czas nieokreślony. Jeśli użytkownik nie określił wartości dla tej właściwości, ta wartość jest wartością domyślną dla wszystkich instrukcji w połączeniu. Alternatywnie można użyć Statement.setQueryTimeout(), aby ustawić limit czasu zapytania dla określonych instrukcji. Wartość może wynosić 0, co określa brak oczekiwania. |
| loginTimeout Int [0..65535] 30 (wersja 11.2 i nowsza) 15 (wersja 10.2 lub nowsza) |
Liczba sekund, przez które sterownik powinien czekać przed upływem limitu czasu nieudanego połączenia. Wartość zero wskazuje, że limit czasu jest domyślnym limitem czasu systemu. Ta wartość to 30 sekund (wartość domyślna w wersji 11.2 lub nowszej) lub 15 sekund (wartość domyślna w wersji 10.2 lub nowszej). Wartość niezerowa to liczba sekund, które sterownik powinien czekać przed rozłączeniem w przypadku nieudanego połączenia. Jeśli określisz nazwę wirtualnej sieci we właściwości Server połączenia, należy ustawić limit czasu na trzy minuty lub więcej, aby zapewnić wystarczający czas na pomyślne wykonanie połączenia awaryjnego. Aby uzyskać więcej informacji na temat odzyskiwania po awarii, zobacz wsparcie sterowników JDBC dla wysokiej dostępności i odzyskiwania po awarii. |
| Bufor maksymalnych wyników Struna null |
(Wersja 9.2 lub nowsza) maxResultBuffer można użyć do ustawienia maksymalnej liczby bajtów do odczytania podczas przetwarzania zestawu wyników. Jeśli nie zostanie określony, cały zestaw wyników zostanie odczytany. Rozmiar można określić w dwóch stylach: 1. jako rozmiar bajtów (na przykład 100, 150M, 300K, 400G)2. jako procent maksymalnej pamięci stertowej (na przykład 10p, 15pct, 20percent). |
| msiClientId Struna null |
(Przestarzałe) (Wersja 7.2 lub nowsza) Identyfikator klienta Zarządzanej Tożsamości (MSI) używany do uzyskania accessToken w celu nawiązania połączenia z trybem uwierzytelniania ActiveDirectoryManagedIdentity lub ActiveDirectoryMSI. |
| multiSubnetFailover Boolean fałszywy |
Zawsze określ multiSubnetFailover=true, aby nawiązać połączenie z odbiornikiem grupy dostępności programu SQL Server lub wystąpieniem klastra trybu failover programu SQL Server.
multiSubnetFailover=true konfiguruje sterownik w celu zapewnienia szybszego wykrywania i nawiązywania połączenia z (obecnie) aktywnym serwerem. Możliwe wartości to „true” i „false”. Aby uzyskać więcej informacji na temat odzyskiwania po awarii, zobacz obsługa sterowników JDBC w celu zapewnienia wysokiej dostępności, odzyskiwania po awarii. Możesz programowo uzyskać dostęp do właściwości połączenia multiSubnetFailover za pomocą getPropertyInfo, getMultiSubnetFailoveri setMultiSubnetFailover. Uwaga: Począwszy od wersji 6.0 sterownika JDBC firmy Microsoft dla programu SQL Server, nie jest już wymagane ustawienie multiSubnetFailover na "true", aby nawiązać połączenie z nasłuchiwaczem grupy dostępności. Nowa właściwość, transparentNetworkIPResolution, która jest domyślnie włączona, zapewnia wykrywanie i połączenie z (obecnie) aktywnym serwerem. |
| rozmiar pakietu Int [-1 | 0 | 512..32767] 8000 |
Rozmiar pakietu sieciowego używany do komunikowania się z serwerem określonym w bajtach. Wartość -1 wskazuje na użycie domyślnego rozmiaru pakietu serwera. Wartość 0 wskazuje na użycie maksymalnej wartości 32767. Jeśli ta właściwość jest ustawiona na wartość poza dopuszczalnym zakresem, wystąpi wyjątek. Ważne: Użycie właściwości packetSize, gdy szyfrowanie jest włączone (encrypt=true) nie jest zalecane. W przeciwnym razie sterownik może zgłosić błąd połączenia. Aby uzyskać więcej informacji na temat tej właściwości, zobacz metodę setPacketSize klasy SQLServerDataSource. |
| hasło Struna [<=128 znaków] null |
Hasło bazy danych, jeśli łączysz się jako użytkownik SQL przy użyciu hasła. W przypadku połączenia Kerberos z nazwą głównego użytkownika i hasłem, ta właściwość jest ustawiana jako hasło głównego użytkownika Kerberos. (Wersja 10.2 lub nowsza) W przypadku |
| portNumber, port Int [0..65535] 1433 |
Port, na którym nasłuchuje serwer. Jeśli numer portu jest określony w ciągu połączenia, nie zostanie wysłane żadne żądanie do SQLbrowser. Po określeniu portu i parametru instanceName połączenie zostanie nawiązane z określonym portem. Jednak instancja instanceName zostaje zweryfikowana i zostaje zgłoszony błąd, jeśli nie jest zgodna z portem. Ważne: Zalecamy, aby numer portu był zawsze określony, ponieważ jest on bezpieczniejszy niż przy użyciu narzędzia SQLbrowser. |
| przygotujMetodę Struna ["prepexec" | "przygotowanie"] prepexec |
(Wersja 11.2.0 lub nowsza) Określa podstawową metodę przygotowywania, która ma być używana przez sterownik z przygotowanymi instrukcjami. Ustaw , aby przygotować do użycia sp_prepare jako metody przygotowania. Ustawienie prepareMethod na tę wartość powoduje oddzielne, początkowe zapytanie do bazy danych w celu przygotowania instrukcji bez uwzględniania żadnych początkowych wartości do uwzględnienia w planie wykonania. Ustaw prepexec, aby użyć sp_prepexec jako metody prepare. Ta metoda łączy akcję przygotowywania z pierwszym wykonaniem, zmniejszając liczbę rund. Udostępnia również bazę danych z początkowymi wartościami parametrów, które baza danych może rozważyć w planie wykonywania. |
| queryTimeout Int -1 |
Liczba sekund oczekiwania przed przekroczeniem limitu czasu dla zapytania. Wartość domyślna to -1, co oznacza nieskończony limit czasu. Ustawienie tej wartości na wartość 0 oznacza również oczekiwanie na czas nieokreślony. |
| Królestwo Struna null |
(Wersja 9.4 lub nowsza) Obszar uwierzytelniania Kerberos. Ustaw tę wartość, aby zastąpić obszar uwierzytelniania Kerberos automatycznie wykrywa sterowniki z obszaru serwera. |
| replikacja boolean ["prawda" | "fałsz"] fałszywy |
(Wersja 9.4 lub nowsza) To ustawienie informuje serwer, czy połączenie jest używane do replikacji. Po włączeniu wyzwalacze z opcją NOT FOR REPLICATION nie są uruchamiane na połączeniu. |
| buforowanie odpowiedzi Struna ["full" | "adaptacyjny"] adaptacyjny |
Jeśli ta właściwość ma wartość "adaptacyjna", w razie potrzeby minimalne możliwe dane są buforowane. Tryb domyślny to "adaptacyjne". Jeśli ta właściwość ma wartość "full", cały zestaw wyników jest odczytywany z serwera po wykonaniu instrukcji. Uwaga: po sterowniku JDBC w wersji 1.2 domyślne zachowanie buforowania jest "adaptacyjne". Jeśli chcesz zachować domyślne zachowanie wersji 1.2 w aplikacji, ustaw właściwość responseBuffering na wartość "full" we właściwościach połączenia lub użyj setResponseBuffering metody SQLServerStatement obiektu. |
| wybierzMetodę Struna ["bezpośredni" | "kursor"] bezpośredni |
Jeśli ta właściwość jest ustawiona na "kursor", kursor bazy danych jest tworzony dla każdego zapytania utworzonego w połączeniu dla TYPE_FORWARD_ONLY i CONCUR_READ_ONLY kursorów. Ta właściwość jest zwykle wymagana tylko wtedy, gdy aplikacja generuje duże zestawy wyników, które nie mogą być w pełni zawarte w pamięci klienta. Jeśli ta właściwość jest ustawiona na "kursor", tylko ograniczona liczba wierszy zestawu wyników jest przechowywana w pamięci klienta. Domyślne zachowanie polega na tym, że wszystkie wiersze zestawu wyników są przechowywane w pamięci klienta. To zachowanie zapewnia najszybszą wydajność, gdy aplikacja przetwarza wszystkie wiersze. |
| sendStringParameters... AsUnicode boolean ["prawda" | "fałsz"] prawdziwy |
Jeśli właściwość sendStringParametersAsUnicode jest ustawiona na wartość "true", parametry ciągu są wysyłane do serwera w formacie Unicode. Jeśli właściwość sendStringParametersAsUnicode jest ustawiona na wartość "false", parametry ciągu są wysyłane do serwera w formacie innym niż Unicode, takim jak ASCII/MBCS zamiast Unicode. Domyślną wartością właściwości sendStringParametersAsUnicode jest „true”. Uwaga: właściwość sendStringParametersAsUnicode jest sprawdzana tylko w celu wysłania wartości parametru dla typów JDBC: CHAR, VARCHARlub LONGVARCHAR. Nowe metody obsługi znaków narodowych JDBC 4.0 obejmują takie metody jak setNString, setNCharacterStream i setNClob w klasach SQLServerPreparedStatement oraz SQLServerCallableStatement. Te metody zawsze wysyłają swoje wartości parametrów do serwera w formacie Unicode niezależnie od ustawienia tej właściwości. Aby uzyskać optymalną wydajność przy użyciu typów danych JDBC CHAR, VARCHARi LONGVARCHAR, aplikacja powinna ustawić właściwość sendStringParametersAsUnicode na "false" i użyć metod znaków niekompatybilnych z Unicode: setString, setCharacterStream i setClob, klasy SQLServerPreparedStatement oraz SQLServerCallableStatement. Gdy aplikacja ustawia właściwość sendStringParametersAsUnicode na wartość "false" i używa metody znaków innych niż krajowe w celu uzyskania dostępu do typów danych Unicode po stronie serwera (takich jak nchar, nvarchar i ntext), niektóre dane mogą zostać utracone, jeśli sortowanie bazy danych nie obsługuje znaków w parametrach ciągu przekazanych przez metodę znaków innych niż krajowe. Aplikacja powinna używać metod związanych z krajowymi znakami, takich jak setNString, setNCharacterStream i setNClob, w klasach SQLServerPreparedStatement i SQLServerCallableStatement dla typów danych JDBC NCHAR, NVARCHARi LONGNVARCHAR. Zmiana tej wartości może mieć wpływ na sortowanie wyników z bazy danych. Różnice sortowania są spowodowane różnymi regułami sortowania dla znaków Unicode i innych niż Unicode. |
| wysyłajTypyDanychCzasowych... AsStringForBulkCopy boolean ["prawda" | "fałsz"] prawdziwy |
(Wersja 8.4 lub nowsza) Ta właściwość połączenia, gdy jest ustawiona na "false", wysyła DATE, DATETIME, DATETIME2, DATETIMEOFFSET, SMALLDATETIME, i TIME jako ich odpowiednie typy danych, zamiast wysyłać je jako String. Po ustawieniu tej właściwości połączenia na wartość "false" sterownik akceptuje domyślny format literału ciągu dla każdego typu danych czasowych, na przykład: DATA: YYYY-MM-DDDATA/GODZINA: YYYY-MM-DD hh:mm:ss[.nnn]DATETIME2: YYYY-MM-DD hh:mm:ss[.nnnnnnn]DATETIMEOFFSET: YYYY-MM-DD hh:mm:ss[.nnnnnnn] [{+/-}hh:mm]SMALLDATETIME: YYYY-MM-DD hh:mm:ssCZAS: hh:mm:ss[.nnnnnnn] |
| sendTimeAsDatetime boolean ["prawda" | "fałsz"] prawdziwy |
Ta właściwość została dodana w sterowniku JDBC programu SQL Server 3.0. Ustaw na "true", aby wysłać wartości typu java.sql.Time na serwer w formacie wartości data/godzina programu SQL Server. Ustaw na "false", aby wysłać wartości java.sql.Time na serwer jako wartości czasu programu SQL Server . Wartość domyślna dla tej właściwości jest obecnie "true" i może ulec zmianie w przyszłej wersji. Aby uzyskać więcej informacji na temat sposobu konfigurowania wartości java.sql.Time przez sterownik JDBC firmy Microsoft dla programu SQL Server przed wysłaniem ich do serwera, zobacz Konfigurowanie sposobu wysyłania wartości java.sql.Time do serwera. |
| certyfikat serwera serwer Struna null |
(Wersja 11.2.0 lub nowsza) Ścieżka do pliku certyfikatu serwera. Służy do sprawdzania poprawności podczas używania szyfrowania z ustawieniem na ścisłe . Sterownik obsługuje pliki certyfikatów przy użyciu formatu pliku PEM. |
| nazwaSerwera serwer Struna null |
Komputer z programem SQL Server lub bazą danych Azure SQL Database. Można również określić nazwę sieci wirtualnej grupy dostępności. Aby uzyskać więcej informacji na temat odzyskiwania po awarii, zobacz wsparcie sterowników JDBC dla wysokiej dostępności i odzyskiwania po awarii. |
| serverNameAsACE boolean ["prawda" | "fałsz"] fałszywy |
(Wersja 6.0 lub nowsza) Ustaw wartość "true", aby wskazać, że sterownik powinien przetłumaczyć nazwę serwera Unicode na kodowanie zgodne z protokołem ASCII (Punycode) dla połączenia. Jeśli to ustawienie ma wartość false, sterownik używa nazwy serwera jako podanej do nawiązania połączenia. Aby uzyskać więcej informacji na temat funkcji międzynarodowych, zobacz International features of the JDBC driver. |
| serverPreparedStatement... OdrzućThreshold Liczba całkowita 10 |
(Wersja 6.2 lub nowsza) Tej właściwości można użyć do kontrolowania, ile zaległych akcji odrzucania instrukcji (sp_unprepare) może być zaległych na połączenie przed wywołaniem w celu wyczyszczenia zaległych dojść na serwerze. Jeśli ta właściwość jest ustawiona na <= 1, akcje nieprzygotowania są wykonywane natychmiast po zamknięciu przygotowanej instrukcji. Jeśli właściwość jest ustawiona na > 1, te wywołania są grupowane, aby uniknąć przeciążenia związanego z częstym wywoływaniem sp_unprepare. |
| serverSpn Struna null |
(Wersja 4.2 lub nowsza) Tej opcjonalnej właściwości można użyć do określenia głównej nazwy usługi (SPN) dla połączenia Java Kerberos. Jest używany z schematem uwierzytelniania. Aby określić nazwę SPN, może być w postaci: "MSSQLSvc/fqdn:port@REALM", gdzie fqdn jest w pełni kwalifikowaną nazwą domeny, port to numer portu, a REALM to obszar Kerberos programu SQL Server zapisany wielkimi literami. Uwaga: @REALM jest opcjonalny, jeśli domyślny obszar klienta (określony w konfiguracji protokołu Kerberos) jest taki sam jak obszar Protokołu Kerberos dla programu SQL Server. Aby uzyskać więcej informacji na temat używania serverSpn z protokołem Kerberos w języku Java, zobacz Using Kerberos integrated authentication to connect to SQL Server. |
| socketFactoryClass Struna null |
(Wersja 8.4 lub nowsza) Określa nazwę klasy dla niestandardowej fabryki gniazd, która ma być używana zamiast domyślnej fabryki gniazd. |
| socketTimeout Int 0 |
Liczba milisekund oczekiwania przed przekroczeniem limitu czasu w przypadku odczytu lub akceptowania gniazda. Wartość domyślna to 0, co oznacza nieskończony limit czasu. |
| łączone oświadczenia CacheSize Int 0 |
(Wersja 6.4 lub nowsza) Tej właściwości można użyć do włączenia przygotowanej instrukcji obsługi buforowania w sterowniku. Ta właściwość definiuje rozmiar pamięci podręcznej dla pulowania instrukcji. Tej właściwości można używać tylko z właściwością połączenia disableStatementPooling, która powinna być ustawiona na wartość "false". Ustawienie disableStatementPooling na wartość "true" lub instrukcjaPoolingCacheSize na 0 powoduje wyłączenie buforowania przygotowanej instrukcji. |
| sslProtocol Struna TLS |
(Wersja 6.4 lub nowsza) Tej właściwości można użyć do określenia protokołu TLS, który ma być brany pod uwagę podczas bezpiecznego połączenia. Możliwe wartości to: TLS, TLSv1, TLSv1.1i TLSv1.2. Aby uzyskać więcej informacji na temat protokołu Secure Sockets Layer, zobacz SSLProtocol. |
| siećprzezroczysta... IPResolution boolean ["prawda" | "fałsz"] prawdziwy |
(Wersja 6.0 lub nowsza) Ta właściwość zapewnia szybsze wykrywanie i nawiązywanie połączenia z (obecnie) aktywnym serwerem. Możliwe wartości to "true" i "false", gdzie "true" jest wartością domyślną. Przed sterownikiem JDBC firmy Microsoft 6.0 dla programu SQL Server aplikacja musiała ustawić parametry połączenia tak, aby zawierały wartość "multiSubnetFailover=true", aby wskazać, że łączyła się z zawsze włączoną grupą dostępności. Bez ustawiania multiSubnetFailover słowa kluczowego połączenia na wartość "true", aplikacja może napotkać limit czasu podczas nawiązywania połączenia z Grupą Dostępności Always On. W wersji 6.0 i nowszej aplikacja nie musi już ustawiać wartości multiSubnetFailover na wartość true. Uwaga: Gdy transparentNetworkIPResolution=true, pierwsza próba połączenia używa wartości 500 ms jako limitu czasu. Wszelkie późniejsze próby używają tej samej logiki limitu czasu co używana przez właściwość multiSubnetFailover. |
| trustManagerClass Struna null |
(Wersja 6.4 lub nowsza) W pełni kwalifikowana nazwa klasy implementacji niestandardowej javax.net.ssl.TrustManager. |
| trustManager... ConstructorArg Struna null |
(Wersja 6.4 lub nowsza) Opcjonalny argument do przekazania do konstruktora TrustManager. Jeśli określono właściwość trustManagerClass i zażądano zaszyfrowanego połączenia, niestandardowy menedżer zaufania jest używany zamiast domyślnego systemu JVM opartego na magazynie kluczy TrustManager. |
| trustServerCertificate boolean ["prawda" | "fałsz"] fałszywy |
Ustaw wartość "true", aby określić, że sterownik nie weryfikuje certyfikatu TLS/SSL serwera. Jeśli to jest "prawda", certyfikat TLS/SSL serwera jest automatycznie uznawany za zaufany, gdy warstwa komunikacji jest szyfrowana przy użyciu protokołu TLS. Jeśli ustawiona na "false", sterownik weryfikuje certyfikat TLS/SSL serwera. Jeśli weryfikacja certyfikatu serwera zakończy się niepowodzeniem, sterownik zgłasza błąd i zamyka połączenie. Wartość domyślna to "false". Upewnij się, że wartość przekazana do serverName dokładnie pasuje do nazwy pospolitej (CN) lub nazwy DNS w alternatywnej nazwie podmiotu w certyfikacie serwera, aby połączenie TLS/SSL powiodło się. Aby uzyskać więcej informacji na temat obsługi szyfrowania, zobacz Understanding encryption support. Uwaga: Ta właściwość jest używana w połączeniu z właściwościami szyfrowania/ uwierzytelniania. Ta właściwość ma wpływ tylko na weryfikację certyfikatu TLS/SSL serwera, jeśli połączenie korzysta z szyfrowania TLS. |
| trustStore Struna null |
Ścieżka (w tym nazwa pliku) do pliku trustStore dla certyfikatu. Plik trustStore zawiera listę certyfikatów, którym ufa klient. Jeśli ta właściwość jest nieokreślona lub ustawiona na wartość null, sterownik opiera się na regułach wyszukiwania fabryki menedżera zaufania, aby określić, którego magazynu certyfikatów użyć. Domyślna właściwość SunX509 TrustManagerFactory próbuje zlokalizować zaufany materiał w następującej kolejności wyszukiwania: Plik określony przez właściwość systemową JVM "javax.net.ssl.trustStore". plik <java-home>/lib/security/jssecacertsplik <java-home>/lib/security/cacertsAby uzyskać więcej informacji na temat interfejsu SUNX509 TrustManager, zobacz dokumentację interfejsu SUNX509 TrustManager w witrynie sieci Web Sun Microsystems. Uwaga: Ta właściwość wpływa tylko na wyszukiwanie truststore certyfikatu, jeśli połączenie używa szyfrowania TLS i właściwość trustServerCertificate jest ustawiona na "false". |
| trustStorePassword Struna null |
Hasło używane do sprawdzania integralności danych trustStore. Jeśli właściwość trustStore jest ustawiona, ale właściwość trustStorePassword nie jest ustawiona, integralność trustStore nie jest sprawdzana. Jeśli właściwości trustStore i trustStorePassword nie są określone, sterownik używa właściwości systemowych JVM, „javax.net.ssl.trustStore” i „javax.net.ssl.trustStorePassword”. Jeśli właściwość systemowa "javax.net.ssl.trustStorePassword" nie jest określona, integralność magazynu zaufania nie jest sprawdzana. Jeśli użytkownik nie ustawi właściwości trustStore, ale ustawia właściwość trustStorePassword, sterownik JDBC używa pliku , który "javax.net.ssl.trustStore" określa jako magazyn zaufania. Ponadto sterownik sprawdza integralność magazynu zaufania przy użyciu określonego hasła trustStorePassword. To ustawienie jest wymagane, gdy aplikacja kliencka nie chce przechowywać hasła we właściwości systemowej JVM. |
| trustStoreType Struna JKS |
Ustaw tę właściwość, aby określić typ magazynu zaufania, który ma być używany dla trybu FIPS. Możliwe wartości to PKCS12 lub typ zdefiniowany przez dostawcę FIPS. |
| useBulkCopyFor... BatchInsert boolean ["prawda" | "fałsz"] fałszywy |
(Wersja 9.2 lub nowsza) Tę właściwość połączenia można włączyć, aby przezroczysto używać interfejsu API kopiowania zbiorczego podczas wykonywania operacji wstawiania wsadowego przy użyciu java.sql.PreparedStatement. Ta funkcja potencjalnie zapewnia wyższą wydajność po włączeniu. Ta funkcja jest domyślnie wyłączona. Ustaw tę właściwość na wartość "true", aby włączyć tę funkcję. ważna uwaga: Ta funkcja obsługuje tylko w pełni sparametryzowane zapytania INSERT. Jeśli zapytania INSERT są łączone z innymi zapytaniami SQL lub zawierają dane w wartościach, wykonanie powraca do podstawowej operacji wstawiania wsadowego. Aby uzyskać więcej informacji na temat używania tej właściwości, zobacz Using bulk copy API for batch insert operation (Używanie interfejsu API kopiowania zbiorczego dla operacji wstawiania wsadowego) |
| useDefaultGSSCredential boolean ["prawda" | "fałsz"] fałszywy |
(Wersja 12.6 lub nowsza) Flaga wskazująca, czy sterownik powinien utworzyć GSSCredential w imieniu użytkownika do korzystania z natywnego GSS-API w celu uwierzytelniania Kerberos. |
| useDefaultJaasConfig boolean ["prawda" | "fałsz"] fałszywy |
(Wersja 12.6 lub nowsza) Gdy aplikacja istnieje wraz z bibliotekami, które konfigurują usługę JAAS na poziomie systemu, ustawienie tej właściwości na wartość true umożliwia sterownikowi użycie tej samej konfiguracji w celu przeprowadzenia uwierzytelniania Kerberos. |
| useFmtOnly boolean ["prawda" | "fałsz"] fałszywy |
(Wersja 7.4 lub nowsza) Zapewnia alternatywny sposób wykonywania zapytań dotyczących metadanych parametrów z serwera. Ustaw tę właściwość na wartość "true", aby określić, że sterownik powinien używać logiki SET FMTONLY podczas wykonywania zapytań dotyczących metadanych parametrów. Ta funkcja jest domyślnie wyłączona i nie zaleca się używania tej właściwości, ponieważ SET FMTONLY jest oznaczona do wycofania.
useFmtOnly dostępny jest tylko jako rozwiązanie tymczasowe dla znanych problemów i ograniczeń w sp_describe_undeclared_parameters.Ta funkcja obecnie obsługuje tylko pojedyncze zapytania SELECT/INSERT/UPDATE/DELETE. Próba użycia tej funkcji z nieobsługiwanymi/wieloma zapytaniami powoduje, że sterownik próbuje przeanalizować zapytanie, ale najprawdopodobniej spowoduje wyjątek.Aby uzyskać więcej informacji na temat tej właściwości, zobacz Pobieranie parametruMetaData za pomocą funkcji useFmtOnly. |
| userName użytkownik Struna [<=128 znaków] null |
Użytkownik bazy danych, jeśli zostanie nawiązane połączenie z użytkownikiem i hasłem SQL. W przypadku połączenia Kerberos z nazwą głównego podmiotu i hasłem, ta właściwość jest ustawiona na nazwę głównego podmiotu Kerberos. (Wersja 10.2 lub nowsza) Gdy authentication=ActiveDirectoryServicePrincipal, właściwość userName określa prawidłowy identyfikator bezpiecznego klienta usługi Azure Active Directory. |
| identyfikator stacji roboczej Struna [<=128 znaków] <empty string> |
Identyfikator stacji roboczej. Służy do identyfikowania określonej stacji roboczej w różnych narzędziach profilowania i rejestrowania. Jeśli żadna z nich nie zostanie określona, zostanie użyta <empty string>. |
| xopenStates boolean ["prawda" | "fałsz"] fałszywy |
Ustaw wartość "true", aby określić, że sterownik zwraca kody stanu zgodne z XOPEN w wyjątkach. Wartość domyślna to zwracanie kodów stanu SQL 99. |
Notatka
Sterownik JDBC firmy Microsoft dla programu SQL Server przyjmuje wartości domyślne serwera dla właściwości połączenia z wyjątkiem ANSI_DEFAULTS i IMPLICIT_TRANSACTIONS. Sterownik JDBC firmy Microsoft dla programu SQL Server automatycznie ustawia ANSI_DEFAULTS na WŁĄCZONE i IMPLICIT_TRANSACTIONS na WYŁĄCZONE.
Ważny
Jeśli uwierzytelnianie jest ustawione na ActiveDirectoryPassword, to należy dodać następującą bibliotekę do ścieżki klasy: microsoft-authentication-library-for-java. Można go znaleźć w witrynie Maven Repository. Najprostszym sposobem pobrania biblioteki i jej zależności jest użycie narzędzia Maven:
Zobacz też
nawiązywanie połączenia z programem SQL Server za pomocą sterownika JDBC
tryb FIPS