Nastavení vlastností připojení

Stáhnout ovladač JDBC

Vlastnosti připojovací řetězec můžete zadat různými způsoby:

  • Jako <name>=<value> vlastnosti v adrese URL připojení při připojení pomocí třídy DriverManager. Syntaxi připojovacího řetězce najdete v tématu Sestavení adresy URL připojení.

  • Jako <name>=<value> vlastnosti v parametru Properties metody Connect třídy DriverManager.

  • Hodnoty v metodě setteru příslušného zdroje dat ovladače. Například:

    datasource.setServerName(value)
datasource.setDatabaseName(value)

Poznámky

  • Názvy vlastností nejsou citlivé na velikost písmen. Ovladač řeší duplicitní názvy vlastností v následujícím pořadí:

    1. Argumenty rozhraní API, například user a password
    2. Kolekce vlastností
    3. Poslední instance v připojovacím řetězci

  • Pro názvy vlastností můžete použít neznámé hodnoty. Ovladač JDBC neověřuje citlivost písmen.

  • Můžete použít synonyma. Ovladač je vyřeší v pořadí, stejně jako u duplicitních názvů vlastností.

  • Ovladač Microsoft JDBC pro SQL Server přebírá výchozí hodnoty serveru pro vlastnosti připojení s výjimkou ANSI_DEFAULTS a IMPLICIT_TRANSACTIONS. Ovladač Microsoft JDBC pro SQL Server automaticky nastaví ANSI_DEFAULTS na ON a IMPLICIT_TRANSACTIONS na OFF.

  • Pokud nastavíte ověřování na ActiveDirectoryPassword [DEPRECATED], zahrňte do cesty ke třídě následující knihovnu: microsoft-authentication-library-for-java. Najděte ho v úložišti Maven. Nejjednodušší způsob, jak stáhnout knihovnu a její závislosti, je použití Mavenu:

    1. Nainstalujte Maven do systému.
    2. Přejděte na stránku GitHub ovladače.
    3. pom.xml Stáhněte si soubor.
    4. Spuštěním následujícího příkazu Mavenu stáhněte knihovnu a její závislosti: mvn dependency:copy-dependencies.

Vlastnosti

Následující části popisují všechny aktuálně dostupné připojovací řetězec vlastnosti ovladače JDBC.

accessToken

  • Typ: String
  • Výchozí hodnota: null

(Verze 6.0+) Pomocí této vlastnosti se můžete připojit k databázi pomocí přístupového tokenu. Nemůžete nastavit accessToken pomocí adresy URL připojení.

accessTokenCallbackClass

  • Typ: String
  • Výchozí hodnota: null

(Verze 12.4+) Název třídy implementace zpětného volání, která se má použít s zpětným voláním přístupového tokenu.

applicationIntent

  • Typ: String
  • Výchozí hodnota: ReadWrite

(Verze 6.0+) Deklaruje typ úlohy aplikace pro připojení k serveru.

Možné hodnoty jsou ReadOnly a ReadWrite.

Další informace o zotavení po havárii najdete v tématu podpora ovladačů JDBC pro zajištění vysoké dostupnosti, zotavení po havárii.

applicationName

  • Typ: String [<=128 char]
  • Výchozí hodnota: null

Název aplikace nebo "Microsoft ovladač JDBC pro SQL Server", pokud nezadáte název.

Tento název použijte k identifikaci konkrétní aplikace v různých nástrojích pro profilaci a protokolování SQL Server.

authentication

  • Typ: String
  • Výchozí hodnota: NotSpecified

(Verze 6.0+) Tato volitelná vlastnost označuje, kterou metodu ověřování se má použít pro připojení.

Možné hodnoty jsou ActiveDirectoryIntegrated, ActiveDirectoryManagedIdentity (verze 12.2+), ActiveDirectoryMSI (verze 7.2+), ActiveDirectoryInteractive (verze 9.2+), ActiveDirectoryServicePrincipal (verze 9.2+), ActiveDirectoryPassword [DEPRECATED], SqlPassworda výchozí NotSpecified.

K připojení k SQL pomocí integrovaného Windows authentication použijte ActiveDirectoryIntegrated (verze 6.0+).

K připojení k SQL z prostředku Azure použijte ActiveDirectoryManagedIdentity (verze 12.2+) nebo ActiveDirectoryMSI (verze 7.2+). Například Azure Virtual Machine, App Service nebo Function App využívající ověřování pomocí spravované identity.

Mezi dva typy spravovaných identit podporovaných ovladačem při použití ActiveDirectoryManagedIdentity nebo ActiveDirectoryMSI režimu ověřování patří:

  • Systémem přidělená spravovaná identita: Používá se ke získání accessToken ve výchozím nastavení.

  • User-Assigned Managed Identity: Používá se k získání accessToken , pokud je ID klienta zadaného spravovanou identitou specifikováno pomocí vlastnosti připojení msiClientId.

Použijte ActiveDirectoryInteractive pro připojení k databázi pomocí interaktivního autentizačního procesu.

Použijte ActiveDirectoryServicePrincipal (verze 9.2+) pro připojení k databázi pomocí ID klienta a tajného klíče služebního účtu. Zadejte ID klienta ve userName vlastnosti a tajný klíč vlastnosti password (10.2+).

Použijte ActiveDirectoryServicePrincipalCertificate (verze 12.4+) k připojení k databázi pomocí ID klienta a certifikátu služebního účtu. Zadejte ID klienta ve userName vlastnosti a cestu k certifikátu ve clientCertificate vlastnosti.

Další možnosti najdete v tématu Připojení pomocí režimu ověřování ActiveDirectoryServicePrincipalCertificate.

Pomocí ActiveDirectoryPassword [DEPRECATED] se připojte k SQL pomocí hlavního názvu Microsoft Entra a hesla.

ActiveDirectoryPassword je zastaralý.

Pro více informací si přečtěte téma Připojení pomocí ověřovacího režimu ActiveDirectoryPassword.

Použijte SqlPassword k připojení k SQL pomocí vlastností userName, /, user a password.

Použijte NotSpecified , pokud není potřeba žádná z těchto metod ověřování.

Důležitý

Pokud je ověřování nastaveno na ActiveDirectoryIntegrated, musí být nainstalovány následující dvě knihovny: mssql-jdbc_auth-<version>-<arch>.dll (k dispozici v balíčku ovladače JDBC) a Identity a ověřování Microsoftu pro SQL Server (ADAL.DLL). Identity a ověřování Microsoftu lze nainstalovat ze Stažení ODBC Driveru pro SQL Server nebo Stažení Microsoft OLE DB Driveru pro SQL Server. Ovladač JDBC podporuje pouze verze 1.0.2028.318 a vyšší pro ADAL.DLL.

Když nastavíte vlastnost ověřování na jinou hodnotu než NotSpecified, ovladač používá ve výchozím nastavení šifrování TLS (Transport Layer Security), dříve označované jako SSL (Secure Sockets Layer).

Informace o konfiguraci ověřování Microsoft Entra najdete v tématu Ověřování Microsoft Entra pro Azure SQL.

authenticationScheme

  • Typ: String
  • Výchozí hodnota: NativeAuthentication

Určuje, jaký druh integrovaného zabezpečení chcete, aby vaše aplikace používala.

Možné hodnoty jsou JavaKerberos, NTLM (verze 7.4+) a výchozí NativeAuthentication.

NativeAuthentication způsobí načtení ovladače mssql-jdbc_auth-<version>-<arch>.dll (například mssql-jdbc_auth-8.2.2.x64.dll) na Windows, který slouží k získání integrovaných ověřovacích informací.

(Nativní knihovna ověřování, která je načtená, se nazývá sqljdbc_auth.dll, když používáte ovladače verze 6.0 až 7.4.)

Při použití authenticationScheme=JavaKerberosje nutné zadat plně kvalifikovaný název domény (FQDN) v objektu serverName nebo serverSpn vlastnosti. V opačném případě dojde k chybě (server nebyl nalezen v databázi Kerberos).

Další informace o použití authenticationScheme=JavaKerberos najdete v tématu Using Kerberos integrated authentication to connect to SQL Server.

Při použití authenticationScheme=NTLM je nutné zadat Windows doménu pomocí vlastnosti domain nebo domainName, přihlašovací údaje Windows ve vlastnosti user nebo userName a vlastnost password. V opačném případě dojde k chybě (musí být zadány vlastnosti připojení).

bulkCopyForBatchInsertAllowEncryptedValueModifications

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

Pokud nastavíte useBulkCopyForBatchInsert na true, nastavte tuto možnost na true, abyste umožnili hromadné kopírování šifrovaných dat mezi tabulkami nebo databázemi bez dešifrování dat.

Další informace a varování týkající se použití této vlastnosti naleznete v tématu allowEncryptedValueModificationsSQLServerBulkCopyOptions.

bulkCopyForBatchInsertBatchSize

  • Typ: int
  • Výchozí hodnota: 0

(Verze 12.10+) Když nastavíte useBulkCopyForBatchInsert na true, tato konfigurace určuje velikost dávky pro operace hromadného kopírování, které ovladač vytváří z dávkových operací vložení.

Další informace o efektech tohoto nastavení najdete v možnosti BatchSize.

bulkCopyForBatchInsertCheckConstraints

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

(Verze 12.10+) Pokud použijete useBulkCopyForBatchInsert=true, nastavte tuto možnost tak, aby true se při vkládání dat povolila omezení kontroly. Tuto možnost nastavte na false, abyste zakázali omezení kontroly.

Další informace o efektech tohoto nastavení najdete v možnosti CheckConstraints.

bulkCopyForBatchInsertFireTriggers

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

(Verze 12.10+) Pokud použijete useBulkCopyForBatchInsert=true, nastavte tuto možnost na true pro aktivaci triggerů při vkládání řádků do databáze. Nastavte tuto možnost na false, aby se zakázaly inserční triggery.

Další informace o efektech tohoto nastavení najdete v možnosti FireTriggers.

bulkCopyForBatchInsertKeepIdentity

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

(Verze 12.10+) Při použití useBulkCopyForBatchInsert=true nastavte tuto možnost na true, aby se při vkládání dat zachovaly hodnoty zdrojové identity. Nastavte možnost false na přiřazení identitních hodnot podle cíle.

Další informace o efektech tohoto nastavení najdete v možnosti KeepIdentity.

bulkCopyForBatchInsertKeepNulls

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

(Verze 12.10+) Pokud použijete useBulkCopyForBatchInsert=true, nastavte tuto možnost pro true zachování hodnot null v cílové tabulce bez ohledu na výchozí nastavení hodnoty. Nastavte tuto možnost na false, aby cílové výchozí hodnoty nahradily hodnoty null.

Další informace o efektech tohoto nastavení najdete v možnosti KeepNulls.

bulkCopyForBatchInsertTableLock

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

Pokud nastavíte hodnotu useBulkCopyForBatchInsert na true, nastavte tuto možnost na true, aby se během operace hromadného kopírování získal zámek hromadné aktualizace. Nastavte tuto možnost na false, aby se používaly zámky řádků.

Další informace o efektech tohoto nastavení najdete v možnosti TableLock.

cacheBulkCopyMetadata

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

(Verze 12.8+) Při použití useBulkCopyForBatchInsert=truetato vlastnost říká ovladači, zda má ukládat do mezipaměti metadata cílového sloupce na úrovni připojení. Pokud je nastaveno true, ujistěte se, aby se cíl mezi hromadným vkládáním nezměnil, protože ovladač tuto změnu neumí zpracovat.

calcBigDecimalPrecision

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

(Verze 12.6+) Příznak označující, jestli má ovladač vypočítat přesnost pro vstupy BigDecimal, na rozdíl od použití maximální povolené hodnoty přesnosti (38).

cancelQueryTimeout

  • Typ: int
  • Výchozí hodnota: -1

(Verze 6.4+) Tuto vlastnost použijte ke zrušení nastavení na připojení. Provádění dotazu přestane reagovat a nevyvolá výjimku, pokud dojde k tichému vyřazení připojení TCP k serveru. Tato vlastnost je použitelná pouze v případě, že queryTimeout je nastavena také pro připojení.

Ovladač čeká po celkovou dobu cancelQueryTimeout + queryTimeout sekund, aby ukončil připojení a uzavřel kanál.

Výchozí hodnota této vlastnosti je -1 a chování je čekání na neomezenou dobu.

clientCertificate

  • Typ: String
  • Výchozí hodnota: null

(Verze 8.4+) Určuje umístění certifikátu, které se má použít pro ověřování klientských certifikátů. Ovladač JDBC podporuje přípony souborů PFX, PEM, DER a CER.

Podrobnosti naleznete v části Ověřování klientských certifikátů pro scénáře návratové smyčky.

clientKey

  • Typ: String
  • Výchozí hodnota: null

(Verze 8.4+) Určuje umístění privátního klíče pro certifikáty PEM, DER a CER určené atributem clientCertificate .

Podrobnosti naleznete v části Ověřování klientských certifikátů pro scénáře návratové smyčky.

clientKeyPassword

  • Typ: String
  • Výchozí hodnota: null

(Verze 8.4+) Určuje volitelný řetězec hesla pro přístup k privátnímu clientKey klíči souboru.

Podrobnosti naleznete v části Ověřování klientských certifikátů pro scénáře návratové smyčky.

columnEncryptionSetting

  • Typ: String [Enabled | Disabled]
  • Výchozí hodnota: Disabled

(Verze 6.0+) Nastavte na Enabled pro aktivaci funkce Always Encrypted (AE). Pokud je povolená funkce AE, ovladač JDBC transparentně šifruje a dešifruje citlivá data uložená v šifrovaných databázových sloupcích na serveru.

Další informace o funkci Always Encrypted naleznete v tématu Použití funkce Always Encrypted s ovladačem JDBC.

Poznámka

Funkce Always Encrypted je dostupná s SQL Server 2016 nebo novějším a Azure SQL Database.

concatNullYieldsNull

  • Typ: String [ON | OFF]
  • Výchozí hodnota: ON

(Verze 13.2+) Když tuto možnost nastavíte na OFF, ovladač nastaví proměnnou databázové relace CONCAT_NULL_YIELDS_NULL na OFF jakmile dojde k navázání připojení. Výsledkem je, že zřetězení hodnoty null s řetězcem dává samotný řetězec (hodnota null je považována za prázdný řetězec).

Další informace najdete na webu SET CONCAT_NULL_YIELDS_NULL.

connectRetryCount

  • Typ: int [0..255]
  • Výchozí hodnota: 1

(Verze 9.4+) Počet pokusů o opětovné připojení, pokud dojde k selhání připojení.

connectRetryInterval

  • Typ: int [1..60]
  • Výchozí hodnota: 10

(Verze 9.4+) Počet sekund mezi jednotlivými pokusy o opakování připojení.

databaseName, database

  • Typ: String [<=128 char]
  • Výchozí hodnota: null

Název databáze, ke které se chcete připojit.

Pokud nezadáte název databáze, použije připojení výchozí databázi.

datetimeParameterType

  • Typ: String [datetime | datetime2 | datetimeoffset]
  • Výchozí hodnota: datetime2

(Verze 12.2+) Datový typ SQL, který se má použít pro parametry data a časového razítka Java.

Když se připojíte k SQL Server 2016 nebo novějším verzím a pracujete se staršími hodnotami datetime, nastavte tuto vlastnost na datetime. Toto nastavení snižuje problémy s převodem na straně serveru mezi datetime hodnotami a datetime2 hodnotami.

Další informace najdete v tématu Řešení změny chování při převodu z datetime na datetime2 od SQL Serveru 2016.

delayLoadingLobs

  • Typ: Boolean [true | false]
  • Výchozí hodnota: true

Příznak označující, zda se mají streamovat všechny objekty LOB načtené z ResultSet. Nastavením této vlastnosti na false načtete celý objekt LOB do paměti bez streamování.

disableStatementPooling

  • Typ: Boolean [true | false]
  • Výchozí hodnota: true

Příznak označující, jestli se má použít sdružování příkazů

domainName, domain

  • Typ: String
  • Výchozí hodnota: null

(Verze 7.4+) Doména Windows, ke které se přihlásit při použití ověřování pomocí NTLM.

enablePrepareOnFirstPreparedStatementCall

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

Nastavte na true, aby bylo možné povolit vytvoření připraveného příkazu voláním sp_prepexec při prvním spuštění tohoto příkazu.

Nastavte na false, aby se při prvním spuštění připraveného příkazu zavolalo sp_executesql a příkaz se nepřipravoval. Pokud dojde k druhému spuštění, volá sp_prepexec, aby nastavil připravený příkazový popisovač.

enclaveAttestationProtocol

  • Typ: String
  • Výchozí hodnota: null

(Verze 8.2+) Tato volitelná vlastnost označuje protokol ověření identity, který se má použít pro Always Encrypted se zabezpečenými enklávy. V současné době jsou jedinými podporovanými hodnotami pro toto pole HGS, AASa NONE (NONE je podporován pouze ve verzi 11.2+).

Další informace o funkci Always Encrypted se zabezpečenými enklávy naleznete v tématu Použití funkce Always Encrypted se zabezpečenými enklávy s ovladačem JDBC.

enclaveAttestationUrl

  • Typ: String
  • Výchozí hodnota: null

(Verze 8.2+) Tato volitelná vlastnost označuje adresu URL koncového bodu služby ověření identity, která se má použít pro Always Encrypted se zabezpečenými enklávy.

Další informace o funkci Always Encrypted se zabezpečenými enklávy naleznete v tématu Použití funkce Always Encrypted se zabezpečenými enklávy s ovladačem JDBC.

encrypt

  • Typ: String
  • Výchozí hodnota: null

Nastavte na true určit, že sql Database Engine používá šifrování TLS pro všechna data odesílaná mezi klientem a serverem, pokud má server nainstalovaný certifikát. Výchozí hodnota je true ve verzi 10.2 a novější a false ve verzi 9.4 a starší.

Ve verzi 6.0 a novější je k dispozici nové nastavení authentication připojení, které ve výchozím nastavení používá šifrování TLS.

Další informace o této vlastnosti viz authentication.

Ve verzi 11.2.0 a novější byla encrypt změněna z Boolean na string, což umožnilo podporu TDS 8.0, když je vlastnost nastavena na strict.

Výchozí změna ve verzi 10.2 je zásadní změna. Pokud upgradujete z verze 9.4 nebo starší a server nemá platný certifikát TLS, nastavte trustServerCertificatetrue nebo zadejte platný certifikát.

failoverPartner

  • Typ: String
  • Výchozí hodnota: null

Název serveru převzetí služeb při selhání používaného v konfiguraci zrcadlení databáze. Tato vlastnost se používá pro počáteční selhání připojení k hlavnímu serveru. Po provedení počátečního připojení bude tato vlastnost ignorována. Musí se použít s vlastností databaseName.

Poznámka

Ovladač nepodporuje číslo portu instance serveru pro instanci partnera převzetí služeb při selhání jako součást vlastnosti failoverPartner v připojovacím řetězci. Ovladač však podporuje zadávání vlastností serverName, instanceName a portNumber instance hlavního serveru a vlastnosti failoverPartner instance partnera pro převzetí služeb při selhání ve stejném připojovacím řetězci.

Pokud do vlastnosti připojení Server zadáte název Virtual Network, nemůžete použít zrcadlení databáze.

Další informace o zotavení po havárii najdete v tématu podpora ovladačů JDBC pro zajištění vysoké dostupnosti, zotavení po havárii.

fips

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

Nastavte tuto vlastnost na true pro virtuální počítač s podporou FIPS Java (JVM).

fipsProvider

  • Typ: String
  • Výchozí hodnota: null

Poskytovatel FIPS nakonfigurovaný v prostředí JVM, například BCFIPS nebo SunPKCS11-NSS. Odebráno ve verzi 6.4.0.

Další informace najdete viz problém na GitHubu 460.

gsscredential

  • Typ: org.ietf.jgss.GSSCredential
  • Výchozí hodnota: null

Od verze 6.2+ je možné v této vlastnosti předávat přihlašovací údaje uživatele pro omezené delegování pomocí protokolu Kerberos.

Toto nastavení použijte s integratedSecurity jako true a JavaKerberos jako authenticationScheme.

hostNameInCertificate

  • Typ: String
  • Výchozí hodnota: null

Název hostitele, který se má použít k ověření SQL Server certifikátu TLS/SSL.

Tuto hostNameInCertificate možnost můžete použít k určení názvu hostitele v situacích, kdy název nebo názvy použité v certifikátu neodpovídá názvu předanému serverName vlastnosti. Pokud ale existuje shoda, tato možnost hostNameInCertificate by se neměla použít.

V situacích, kdy vlastnost hostNameInCertificate není zadaná nebo nastavená na hodnotu null, Microsoft ovladač JDBC pro SQL Server používá hodnotu vlastnosti serverName na adrese URL připojení jako název hostitele k ověření SQL Server certifikátu TLS/SSL.

Poznámka

Dokud nepotvrdíte, že název nebo jména v certifikátu skutečně neodpovídají názvům, které zadáte v hostNameInCertificate, nenastavujte možnost serverName.

Tuto vlastnost použijte v kombinaci s vlastnostmi encrypt a authentication vlastnostmi trustServerCertificate . Tato vlastnost ovlivňuje ověření certifikátu, pokud připojení používá šifrování TLS a je nastaveno trustServerCertificate na false. Ujistěte se, že hodnota, kterou hostNameInCertificate předáte, odpovídá názvu běžného názvu (CN) nebo názvu DNS v alternativním názvu subjektu (SAN) v certifikátu serveru, aby bylo připojení TLS úspěšné.

Další informace o podpoře šifrování najdete v tématu Principy podpory šifrování.

instanceName

  • Typ: String [<=128 char]
  • Výchozí hodnota: null

Název instance databáze, ke které se chcete připojit. Pokud tuto vlastnost nezadáte, připojíte se k výchozí instanci. V případě, že zadáte jak instanceName, tak port, podívejte se do poznámek k portu.

Pokud do vlastnosti připojení Server zadáte název Virtual Network, nemůžete použít vlastnost připojení instanceName.

Další informace o zotavení po havárii najdete v tématu podpora ovladačů JDBC pro zajištění vysoké dostupnosti, zotavení po havárii.

integratedSecurity

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

Nastavte true, aby bylo uvedeno, že SQL Server používá přihlašovací údaje Windows na operačních systémech Windows. Pokud trueovladač JDBC vyhledá v mezipaměti přihlašovacích údajů místního počítače přihlašovací údaje, které byly zadány při přihlášení uživatele k počítači nebo síti.

Nastavte na true (s authenticationscheme=JavaKerberos), aby bylo uvedeno, že SQL Server používá přihlašovací údaje protokolu Kerberos.

Další informace o ověřování protokolem Kerberos naleznete v tématu Použití integrovaného ověřování Kerberos pro připojení k SQL Serveru.

Nastavte na true (s authenticationscheme=NTLM), aby bylo uvedeno, že SQL Server používají přihlašovací údaje NTLM.

Pokud falseje nutné zadat uživatelské jméno a heslo.

ipaddresspreference

  • Typ: String [<=128 char]
  • Výchozí hodnota: IPv4First

Předvolba PROTOKOLU IP používaná klientskou aplikací.

S IPV4First ovladačem nejprve prochází adresy IPv4. Pokud se k úspěšnému připojení žádné adresy IPv4 nedají připojit, ovladač pokračuje a pokusí se o adresy IPv6, pokud nějaké existují.

Ovladač nejprve prochází adresami IPV6FirstIPv6. Pokud se k úspěšnému připojení žádné adresy IPv6 nedají připojit, ovladač pokračuje a zkouší adresy IPv4, pokud nějaké existují.

S pomocí UsePlatformDefault ovladač prochází všechny IP adresy ve výchozím pořadí určeném záznamem DNS.

jaasConfigurationName

  • Typ: String
  • Výchozí hodnota: SQLJDBCDriver

(Verze 6.2+) Každé připojení k SQL Serveru může k navázání připojení Kerberos použít vlastní přihlašovací název JAAS. Prostřednictvím této vlastnosti můžete předat název položky konfigurace. Tuto vlastnost použijte při vytváření konfiguračního souboru Kerberos. Ve výchozím nastavení ovladač hledá název SQLJDBCDriver.

Pokud ovladač nenajde externí konfiguraci, nastaví useDefaultCcache=true se pro IBM JVM a useTicketCache=true pro jiné JVM.

keyStoreAuthentication

  • Typ: String
  • Výchozí hodnota: null

(Verze 6.0+) Tato vlastnost identifikuje úložiště klíčů, které se má použít s funkcí Always Encrypted, a určuje ověřovací mechanismus použitý k ověření v úložišti klíčů. Ovladač podporuje bezproblémové nastavení úložiště klíčů Java při nastavování keyStoreAuthentication=JavaKeyStorePassword. Chcete-li použít tuto vlastnost, musíte také nastavit vlastnosti keyStoreLocation a keyStoreSecret úložiště klíčů Java.

Počínaje ovladačem Microsoft JDBC 8.4 můžete nastavit keyStoreAuthentication=KeyVaultManagedIdentity nebo keyStoreAuthentication=KeyVaultClientSecret k ověření v Azure Key Vault pomocí spravovaných identit.

Další informace o funkci Always Encrypted naleznete v tématu Použití funkce Always Encrypted s ovladačem JDBC.

keyStoreLocation

  • Typ: String
  • Výchozí hodnota: null

(Verze 6.0+) Když keyStoreAuthentication=JavaKeyStorePassword, vlastnost keyStoreLocation identifikuje cestu k souboru úložiště klíčů Java, který ukládá hlavní klíč sloupce pro použití s daty Always Encrypted. Cesta musí obsahovat název souboru úložiště klíčů.

Další informace o funkci Always Encrypted naleznete v tématu Použití funkce Always Encrypted s ovladačem JDBC.

keyStorePrincipalId

  • Typ: String
  • Výchozí hodnota: null

(Verze 8.4+) Při keyStoreAuthentication=KeyVaultManagedIdentity určuje vlastnost keyStorePrincipalId platné ID klienta aplikace Microsoft Entra.

Další informace o funkci Always Encrypted naleznete v tématu Použití funkce Always Encrypted s ovladačem JDBC.

keyStoreSecret

  • Typ: String
  • Výchozí hodnota: null

Když je keyStoreAuthentication=JavaKeyStorePassword aktivní, vlastnost keyStoreSecret identifikuje heslo, které se má použít pro úložiště klíčů a klíč. Pokud používáte úložiště klíčů Java, úložiště klíčů a heslo klíče musí být stejné.

Další informace o funkci Always Encrypted naleznete v tématu Použití funkce Always Encrypted s ovladačem JDBC.

lastUpdateCount

  • Typ: Boolean [true | false]
  • Výchozí hodnota: true

Hodnota true vrátí pouze poslední počet aktualizací z příkazu SQL, který předáte serveru. Tuto hodnotu použijte pouze s jedním SELECT parametrem, INSERT nebo DELETE příkazem k ignorování jiných aktualizačních počtů, které mohou způsobit triggery serveru. Nastavte tuto vlastnost na false, aby vrátila všechny počty aktualizací, včetně těch, které vracejí serverové triggery.

Poznámka

Tato vlastnost platí pouze v případě, že ji použijete s metodami executeUpdate . Všechny ostatní metody spuštění vrátí všechny výsledky a počty aktualizací. Tato vlastnost má vliv pouze na počty aktualizací, které vrací triggery serveru. Nemá vliv na sady výsledků ani chyby, které jsou výsledkem při spuštění triggeru.

lockTimeout

  • Typ: int
  • Výchozí hodnota: -1

Počet milisekund, které je třeba čekat, než databáze hlásí vypršení časového limitu uzamčení. Výchozí chování je čekání na neomezenou dobu. Pokud pro tuto vlastnost nezadáte hodnotu, je tato hodnota výchozí pro všechny příkazy v připojení.

Případně můžete Statement.setQueryTimeout() nastavit časový limit dotazu pro konkrétní příkazy. Hodnota může být 0, což určuje žádné čekání.

loginTimeout

  • Typ: int [0..65535]
  • Výchozí nastavení: 30 (verze 11.2 a novější) nebo 15 (verze 10.2 a starší)

Počet sekund, po které by měl ovladač čekat před vypršením časového limitu neúspěšného připojení. Nulová hodnota označuje, že časový limit je standardním systémovým časovým limitem. Tato hodnota je buď 30 sekund (výchozí hodnota ve verzi 11.2 a novější) nebo 15 sekund (výchozí hodnota ve verzi 10.2 a starší). Nenulová hodnota je počet sekund, který by měl ovladač čekat před vypršením časového limitu pro neúspěšné připojení.

Pokud do vlastnosti připojení Server zadáte název virtuální sítě, zadejte hodnotu časového limitu alespoň tří minut nebo více, aby bylo možné úspěšně provést přepojování.

Další informace o zotavení po havárii najdete v tématu podpora ovladačů JDBC pro zajištění vysoké dostupnosti, zotavení po havárii.

maxResultBuffer

  • Typ: String
  • Výchozí hodnota: null

(Verze 9.2+) Slouží maxResultBuffer k nastavení maximálního počtu bajtů ke čtení při čtení sady výsledků. Pokud tuto hodnotu nezadáte, ovladač přečte celou sadu výsledků. Velikost můžete zadat ve dvou stylech:

  • Jako velikost v bajtech (například 100, 150M, 300K, ). 400G
  • Jako procento maximální velikosti paměti haldy (například 10p, 15pct, 20percent).

msiClientId

  • Typ: String
  • Výchozí hodnota: null

(Zastaralé) (Verze 7.2+) ID klienta spravované identity (MSI) sloužící k získání accessToken pro navázání připojení pomocí ověřovacího režimu ActiveDirectoryManagedIdentity nebo ActiveDirectoryMSI.

multiSubnetFailover

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

Vždy zadejte multiSubnetFailover=true, abyste se připojili k naslouchacímu modulu skupiny dostupnosti SQL Serveru nebo k instanci clusteru SQL Serveru s podporou převzetí služeb při selhání. multiSubnetFailover=true nakonfiguruje ovladač tak, aby poskytoval rychlejší detekci a připojení k aktivnímu serveru.

Možné hodnoty jsou true a false.

Další informace o zotavení po havárii najdete v tématu podpora ovladačů JDBC pro zajištění vysoké dostupnosti, zotavení po havárii.

K vlastnosti připojení můžete přistupovat programově multiSubnetFailover pomocí getPropertyInfo, getMultiSubnetFailover a setMultiSubnetFailover.

Poznámka

Počínaje ovladačem Microsoft JDBC 6.0 pro SQL Server už nemusíte nastavovat multiSubnetFailover na true pro připojení k posluchači skupiny dostupnosti. Nová vlastnost, transparentNetworkIPResolutionkterá je ve výchozím nastavení povolena, poskytuje detekci a připojení k aktivnímu serveru.

packetSize

  • Typ: int [-1 | 0 | 512..32767]
  • Výchozí hodnota: 8000

Velikost síťového paketu používaná ke komunikaci se serverem zadaným v bajtech. Hodnota -1 označuje, že se má použít výchozí velikost paketu serveru. Hodnota 0 označuje použití maximální hodnoty 32767. Pokud tuto vlastnost nastavíte na hodnotu mimo přijatelný rozsah, dojde k výjimce.

Důležitý

Nepoužívejte packetSize vlastnost, pokud je povolené šifrování (encrypt=true). Jinak může ovladač vyvolat chybu připojení.

Další informace o této vlastnosti naleznete v metodě setPacketSize třídy SQLServerDataSource.

password

  • Typ: String [<=128 char]
  • Výchozí hodnota: null

Heslo databáze, pokud se připojujete s uživatelem a heslem SQL.

Pro připojení Kerberos s hlavním názvem a heslem nastavte tuto vlastnost na hlavní heslo kerberos.

(Verze 10.2+) Při authentication=ActiveDirectoryServicePrincipal určuje vlastnost password heslo, které se má použít pro objekt zabezpečení služba Active Directory.

portNumber, port

  • Typ: int [0..65535]
  • Výchozí hodnota: 1433

Port, na kterém server naslouchá. Pokud zadáte číslo portu v připojovací řetězec, nebude proveden žádný požadavek na SQLbrowser. Když zadáte jak port, tak instanceName, připojení se naváže na zadaný port. Ověří se instanceName, a pokud se neshoduje s portem, vyvolá se chyba.

Důležitý

Vždy zadejte číslo portu, protože je bezpečnější než použití nástroje SQLbrowser.

prepareMethod

  • Typ: String [prepexec | prepare | scopeTempTablesToConnection | none]
  • Výchozí hodnota: prepexec

(Verze 11.2.0+) Určuje základní metodu přípravy, kterou ovladač používá s připravenými příkazy.

Nastavte na prepare, aby se sp_prepare použila jako metoda přípravy. Nastavení prepareMethod na tuto hodnotu má za následek samostatnou počáteční cestu do databáze, aby se příkaz připravil bez počátečních hodnot pro databázi, které by bylo potřeba vzít v úvahu v plánu provádění. Nastavte na prepexec, aby se sp_prepexec použila jako metoda přípravy. Tato metoda kombinuje přípravu a první spuštění, čímž snižuje počet potřebných výměn dat. Poskytuje také databázi s počátečními hodnotami parametrů, které může databáze zvážit v plánu provádění.

(Verze 13.4.0+) Nastavte na scopeTempTablesToConnection vymezení oboru dočasných tabulek vytvořených v rámci připravených dotazů v rámci připojení pomocí substituce literálového parametru místo použití popisovačů připravených na straně serveru. Nastavte na none, aby došlo k doslovnému nahrazení parametrů při dávkovém spuštění SQL, čímž se obejde použití popisovačů příkazů připravených na straně serveru (sp_prepexec / sp_prepare).

Omezení a vyloučení odpovědnosti pro scopeTempTablesToConnection a none:

Tyto prepareMethod možnosti jsou určeny pro scénáře kompatibility a migrace, ne pro obecné použití výkonu.

  • Žádné příkazy připravené na straně serveru; SQL se vždy spouští jako dávka.
  • Vyžaduje FORCED_PARAMETERIZATION pro efektivní využívání plánu.
  • Parametry jsou vloženy jako literály, nikoli jako vázané typy.
  • Číselná přesnost a škálování se můžou lišit od vazby parametrů na straně serveru.
  • Hodnoty data a času jsou ovladačem formátované jako řetězce.
  • Velké parametry řetězce zvyšují velikost textu SQL a využití paměti.
  • Parametry BLOB a CLOB můžou způsobit vysoké využití paměti nebo nedostatek paměti.
  • SQL Server odvodí datové typy parametrů v době analýzy SQL.
  • Plány dotazů se můžou lišit kvůli rozdílům v hodnotách literálů.
  • Chyby se detekují v době provádění, nikoli v době vazby.
  • Provedený SQL obsahuje literální hodnoty a je viditelný v trasování a protokolech serveru.

queryTimeout

  • Typ: int
  • Výchozí hodnota: -1

Počet sekund čekání před vypršením časového limitu dotazu. Výchozí hodnota je -1, což znamená nekonečný časový limit. Nastavení této hodnoty na 0 znamená také čekat neomezeně dlouho.

quotedIdentifier

  • Typ: String [ON | OFF]
  • Výchozí hodnota: ON

(Verze 13.2+) Když tuto možnost nastavíte na OFF, ovladač nastaví proměnnou databázové relace QUOTED_IDENTIFIER na OFF jakmile dojde k navázání připojení. Databáze považuje dvojité uvozovky za oddělovače řetězců pro literály znaků a identifikátory nelze uzavřít do dvojitých uvozovek.

Další informace najdete na webu SET QUOTED_IDENTIFIER.

realm

  • Typ: String
  • Výchozí hodnota: null

(Verze 9.4+) Sféra pro ověřování protokolem Kerberos. Nastavte tuto hodnotu tak, aby přepsala sféru ověřování Kerberos, kterou ovladač automaticky detekuje ze sféry serveru.

replication

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

(Verze 9.4+) Toto nastavení serveru říká, jestli se pro replikaci používá připojení. Pokud je tato možnost povolená, triggery s možností NOT FOR REPLICATION se u připojení neaktivují.

responseBuffering

  • Typ: String [full | adaptive]
  • Výchozí hodnota: adaptive

Pokud tuto vlastnost nastavíte na adaptive, ovladač umožňuje vyrovnání minimálního množství dat v případě potřeby. Výchozí režim je adaptive.

Pokud tuto vlastnost nastavíte na full, ovladač při spuštění příkazu přečte celou sadu výsledků ze serveru.

Poznámka

Počínaje ovladačem JDBC verze 1.2 je výchozí chování ukládání do vyrovnávací paměti adaptive. Chcete-li použít výchozí chování verze 1.2 ve své aplikaci, nastavte responseBuffering vlastnost full buď ve vlastnostech připojení, nebo metodou setResponseBuffering objektu SQLServerStatement Třídy.

selectMethod

  • Typ: String [direct | cursor]
  • Výchozí hodnota: direct

Pokud tuto vlastnost nastavíte na cursor, ovladač vytvoří kurzor databáze pro každý dotaz vytvořený na připojení, který je určen pro kurzory TYPE_FORWARD_ONLY a CONCUR_READ_ONLY. Tuto vlastnost obvykle potřebujete jenom v případě, že vaše aplikace generuje velké sady výsledků, které se zcela nevejdou do klientské paměti. Pokud tuto vlastnost nastavíte na cursor, ovladač zachová pouze omezený počet řádků sady výsledků v paměti klienta.

Ve výchozím nastavení ovladač uchovává všechny řádky sady výsledků v paměti klienta. Toto výchozí chování poskytuje nejrychlejší výkon, když aplikace zpracuje všechny řádky.

sendStringParametersAsUnicode

  • Typ: Boolean [true | false]
  • Výchozí hodnota: true

Pokud nastavíte sendStringParametersAsUnicode vlastnost na true, ovladač odešle parametry řetězce na server ve formátu Unicode.

Pokud nastavíte vlastnost sendStringParametersAsUnicode, ovladač false odešle parametry řetězce na server ve formátech, jako je ASCII nebo MBCS, namísto Unicode.

Výchozí hodnota vlastnosti sendStringParametersAsUnicode je true.

Poznámka

Ovladač zkontroluje sendStringParametersAsUnicode vlastnost pouze při odesílání hodnoty parametru s typy JDBC CHAR, VARCHAR nebo LONGVARCHAR. Nové metody pro práci s národními znaky v JDBC 4.0 zahrnují metody, jako setNString, setNCharacterStream a setNClob třídy SQLServerPreparedStatement a SQLServerCallableStatement. Tyto metody vždy odesílají své hodnoty parametrů na server v Unicode bez ohledu na nastavení této vlastnosti.

Pro optimální výkon s datovými typy CHAR, VARCHAR a LONGVARCHAR JDBC by aplikace měla nastavit vlastnost sendStringParametersAsUnicode na false a používat metody znaků bez národního určení setString, setCharacterStream a setClob tříd SQLServerPreparedStatement a SQLServerCallableStatement.

Když aplikace nastaví sendStringParametersAsUnicode vlastnost false na a používá jinou než národní znakovou metodu pro přístup k datovým typům Unicode na straně serveru (například nchar, nvarchara ntext), mohou být některá data ztracena, pokud kolace databáze nepodporuje znaky v String parametrech předávaných jinou než národní metodou znaků.

Aplikace by měla použít setNString, setNCharacterStream, a setNClob národní znakové metody tříd SQLServerPreparedStatement a SQLServerCallableStatement pro NCHAR, NVARCHAR, a LONGNVARCHAR JDBC datové typy.

Změna této hodnoty může ovlivnit řazení výsledků z databáze. Rozdíly řazení jsou způsobeny různými pravidly řazení pro Unicode a jinými znaky než Unicode.

sendTemporalDataTypesAsStringForBulkCopy

  • Typ: Boolean [true | false]
  • Výchozí hodnota: true

(Verze 8.4+) Když nastavíte tuto vlastnost připojení na false, ovladač odešle DATE, DATETIME, DATETIME2, DATETIMEOFFSET, , SMALLDATETIMEa TIME datové typy jako jejich odpovídající typy místo jejich odeslání jako String.

Když tuto vlastnost připojení nastavíte na false, ovladač přijme výchozí řetězcový literálový formát každého dočasného datového typu, například:

  • DATE: YYYY-MM-DD
  • DATETIME: 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:ss
  • TIME: hh:mm:ss[.nnnnnnn]

sendTimeAsDatetime

  • Typ: Boolean [true | false]
  • Výchozí hodnota: true

Tato vlastnost byla přidána v ovladači SQL Server JDBC 3.0.

  • Nastavte na hodnotu true, aby se na server odesílaly hodnoty java.sql.Time jako hodnoty SQL Server datetime.

  • Nastavte na hodnotu false, aby se na server odesílaly hodnoty java.sql.Time jako hodnoty SQL Server time.

Výchozí hodnota této vlastnosti je aktuálně true a může se změnit v budoucí verzi.

Další informace o tom, jak ovladač Microsoft JDBC pro SQL Server konfiguruje hodnoty java.sql.Time před jejich odesláním na server, najdete v tématu Konfigurování způsobu odesílání hodnot java.sql.Time.

serverCertificate, server

  • Typ: String
  • Výchozí hodnota: null

(Verze 11.2.0+) Cesta k souboru certifikátu serveru. Ovladač používá tento certifikát k ověření při nastavení encrypt na strict. Ovladač podporuje soubory certifikátů, které používají formát souboru PEM.

serverName, server

  • Typ: String
  • Výchozí hodnota: null

Počítač s SQL Serverem nebo databází Azure SQL.

Můžete také zadat název virtuální sítě skupiny dostupnosti.

Další informace o zotavení po havárii najdete v tématu podpora ovladačů JDBC pro zajištění vysoké dostupnosti, zotavení po havárii.

serverNameAsACE

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

(Verze 6.0+) Nastavte na true indikaci, že ovladač by měl pro připojení přeložit název serveru Unicode na kódování kompatibilní s kódováním ASCII (Punycode). Pokud je falsetoto nastavení, ovladač použije název serveru, jak je uvedeno pro připojení.

Další informace o mezinárodních funkcích naleznete v tématu Mezinárodní funkce ovladače JDBC.

serverPreparedStatementDiscardThreshold

  • Typ: int
  • Výchozí hodnota: 10

(Verze 6.2+) Pomocí této vlastnosti můžete určit, kolik nevyřízených akcí pro zrušení připravených příkazů může být na každé připojení, než ovladač na serveru vyčistí nevyřízené popisovače.

Pokud tuto vlastnost nastavíte na <= 1, ovladač okamžitě provede akce pro zrušení přípravy při uzavření připraveného příkazu. Pokud nastavíte vlastnost na > 1, ovladač tyto volání dávkuje dohromady, aby se snížila režie volání sp_unprepare příliš často.

serverSpn

  • Typ: String
  • Výchozí hodnota: null

(Verze 4.2+) Tuto volitelnou vlastnost použijte k určení hlavního názvu služby (SPN) pro připojení Java Kerberos. Použijte ho s authenticationScheme.

Chcete-li zadat hlavní název služby (SPN), použijte formulář: MSSQLSvc/fqdn:port@REALM, kde fqdn je plně kvalifikovaný název domény, port je číslo portu a sféra je doména Kerberos pro SQL Server psaná velkými písmeny.

Poznámka

@REALM je nepovinný, pokud je výchozí sféra klienta (jak je uvedeno v konfiguraci protokolu Kerberos) stejná jako sféra protokolu Kerberos pro SQL Server.

Další informace o použití protokolu serverSpn s protokolem kerberos Java najdete v tématu Usování integrovaného ověřování Kerberos pro připojení k SQL Server.

socketFactoryClass

  • Typ: String
  • Výchozí hodnota: null

(Verze 8.4+) Určuje název třídy pro továrnu na vlastní sokety, která se má použít místo výchozí továrny na sokety.

socketTimeout

  • Typ: int
  • Výchozí hodnota: 0

Počet milisekund, které se mají počkat před vypršením časového limitu na čtení nebo přijetí soketu. Výchozí hodnota je 0, což znamená nekonečný časový limit.

statementPoolingCacheSize

  • Typ: int
  • Výchozí hodnota: 0

(Verze 6.4+) Tato vlastnost slouží k povolení ukládání připravených příkazů do mezipaměti v ovladači.

Tato vlastnost definuje velikost mezipaměti pro sdružování příkazů.

Tuto vlastnost použijte pouze s vlastností připojení disableStatementPooling, kterou nastavte na hodnotu false. Nastavení disableStatementPooling na true nebo nastavení statementPoolingCacheSize na 0 zakáže ukládání připravených příkazů do mezipaměti.

sslProtocol

  • Typ: String
  • Výchozí hodnota: TLS

(Verze 6.4+) Tato vlastnost slouží k určení protokolu TLS, který se má zvážit při zabezpečeném připojení.

Možné hodnoty jsou: TLS, TLSv1, TLSv1.1a TLSv1.2.

Další informace o protokolu Secure Sockets Layer naleznete v tématu SSLProtocol.

transparentNetworkIPResolution

  • Typ: Boolean [true | false]
  • Výchozí hodnota: true

(Verze 6.0+) Tato vlastnost poskytuje rychlejší detekci a připojení k aktivnímu serveru. Nastavte ho na true nebo false. Výchozí hodnota je true.

Před Microsoft ovladačem JDBC 6.0 pro SQL Server musela aplikace nastavit připojovací řetězec tak, aby zahrnovala multiSubnetFailover=true, aby značila, že se připojila ke skupině dostupnosti AlwaysOn. Bez nastavení klíčového slova multiSubnetFailover pro připojení na true může aplikace dojít k vypršení časového limitu při připojování ke skupině dostupnosti Always On. Počínaje verzí 6.0 už aplikace nemusí nastavit multiSubnetFailover na true.

Poznámka

Pokud používáte federované ověřování nebo zadáte multisubnetfailover, ovladač ve výchozím nastavení zakáže transparentNetworkIPResolution . Chcete-li tuto funkci povolit, nastavte transparentNetworkIPResolution explicitně na true.

Když transparentNetworkIPResolution=true, první pokus o připojení použije časový limit 500 ms. Jakékoli pozdější pokusy používají stejnou logiku časového limitu jako vlastnost multiSubnetFailover .

trustManagerClass

  • Typ: String
  • Výchozí hodnota: null

(Verze 6.4+) Plně kvalifikovaný název třídy vlastní implementace javax.net.ssl.TrustManager.

trustManagerConstructorArg

  • Typ: String
  • Výchozí hodnota: null

(Verze 6.4+) Volitelný argument, který se má předat konstruktoru TrustManager. Pokud zadáte trustManagerClass vlastnost a požádáte o šifrované připojení, ovladač použije vlastní TrustManager místo výchozího systémového úložiště klíčů TrustManager založený na JVM.

trustServerCertificate

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

Nastavte true a určete, že ovladač neověřuje certifikát TLS/SSL serveru.

  • Pokud true, serverový certifikát TLS/SSL je při šifrování komunikační vrstvy pomocí protokolu TLS automaticky důvěryhodný.

  • Pokud false, ovladač ověří certifikát TLS/SSL serveru. Pokud ověření certifikátu serveru selže, ovladač vyvolá chybu a ukončí připojení. Výchozí hodnota je false. Ujistěte se, že se hodnota předaná serverName přesně shoduje s běžným názvem (CN) nebo názvem DNS v alternativním názvu subjektu v certifikátu serveru pro úspěšné připojení TLS/SSL.

Další informace o podpoře šifrování najdete v tématu Principy podpory šifrování.

Poznámka

Tuto vlastnost použijte s vlastnostmi encrypt a authentication. Tato vlastnost má vliv pouze na ověření certifikátu TLS/SSL serveru, pokud připojení používá šifrování TLS.

trustStore

  • Typ: String
  • Výchozí hodnota: null

Cesta (včetně názvu souboru) k souboru certifikátu trustStore . Soubor trustStore obsahuje seznam certifikátů, kterým klient důvěřuje.

Pokud tuto vlastnost nezadáte nebo ji nastavíte na hodnotu null, ovladač použije vyhledávací pravidla objektu pro správu důvěryhodnosti k rozhodnutí, které úložiště certifikátů použít.

Výchozí SunX509 TrustManagerFactory se pokusí najít důvěryhodný materiál v následujícím pořadí hledání:

  1. Soubor určený javax.net.ssl.trustStore vlastností systému JVM.
  2. <java-home>/lib/security/jssecacerts soubor.
  3. <java-home>/lib/security/cacerts soubor.

Další informace o rozhraní SUNX509 TrustManager naleznete v dokumentaci SUNX509 TrustManager Interface na webu Sun Microsystems.

Poznámka

Tato vlastnost má vliv pouze na vyhledávání certifikátu trustStore , pokud připojení používá šifrování TLS a trustServerCertificate vlastnost je nastavena na false.

trustStorePassword

  • Typ: String
  • Výchozí hodnota: null

Heslo použité ke kontrole integrity trustStore dat.

Pokud nastavíte vlastnost trustStore, ale nenastavíte vlastnost trustStorePassword, ovladač nekontroluje integritu trustStore.

Pokud nezadáte trustStore vlastnosti a trustStorePassword vlastnosti, ovladač použije vlastnosti javax.net.ssl.trustStore systému JVM a javax.net.ssl.trustStorePassword. Pokud nezadáte systémovou javax.net.ssl.trustStorePassword vlastnost, ovladač nekontroluje integritu objektu trustStore.

Pokud vlastnost trustStore nenastavíte, ale nastavíte trustStorePassword, ovladač JDBC použije soubor, který javax.net.ssl.trustStore určuje jako úložiště důvěryhodnosti. Ovladač zkontroluje integritu úložiště důvěryhodnosti pomocí zadaného trustStorePassword. Toto nastavení je potřeba v případě, že klientská aplikace nechce ukládat heslo do vlastnosti systému JVM.

Poznámka

Vlastnost trustStorePassword má vliv pouze na vyhledávání certifikátu trustStore , pokud připojení používá připojení TLS a trustServerCertificate vlastnost je nastavena na false.

trustStoreType

  • Typ: String
  • Výchozí hodnota: JKS

Nastavte tuto vlastnost pro určení typu úložiště důvěryhodnosti, který se má použít pro režim FIPS.

Možné hodnoty jsou buď PKCS12 nebo typ definovaný poskytovatelem FIPS.

useBulkCopyForBatchInsert

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

(Verze 9.2+) Když tuto vlastnost připojení povolíte, ovladač transparentně použije rozhraní API hromadného kopírování pro dávkové operace vkládání, které používají java.sql.PreparedStatement. Tato funkce může poskytovat lepší výkon.

Tato funkce je ve výchozím nastavení zakázaná. Nastavte tuto vlastnost na true, aby se aktivovala.

Důležitý

Tato funkce podporuje pouze plně parametrizované INSERT dotazy. Pokud zkombinujete INSERT dotazy s jinými dotazy SQL nebo pokud dotazy obsahují data v hodnotách, provádění se vrátí do základní dávkové operace vložení.

Další informace o použití této vlastnosti naleznete v tématu Použití rozhraní API hromadného kopírování pro operaci dávkové vložení.

useDefaultGSSCredential

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

(Verze 12.6+) Příznak označující, jestli má ovladač vytvořit GSSCredential jménem uživatele pro použití nativního GSS-API pro ověřování protokolem Kerberos.

useDefaultJaasConfig

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

(Verze 12.6+) Pokud aplikace existuje společně s knihovnami, které konfigurují JAAS na úrovni systému, nastavte tuto vlastnost tak, aby true ovladač mohl používat stejnou konfiguraci k ověřování Kerberos.

useFmtOnly

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

(Verze 7.4+) Poskytuje alternativní způsob dotazování metadat parametrů ze serveru. Nastavte tuto vlastnost na true, aby ovladač používal SET FMTONLY logiku při dotazování metadat parametrů. Tato funkce je ve výchozím nastavení vypnutá a nedoporučuje se tuto vlastnost používat, protože SET FMTONLY je označena k vyřazení. useFmtOnly je k dispozici pouze jako alternativní řešení pro známé problémy a omezení v sp_describe_undeclared_parameters.

Tato funkce momentálně podporuje pouze jeden SELECT/INSERT/UPDATE/DELETE dotaz. Pokus o použití této funkce s nepodporovanými nebo více dotazy způsobí, že se ovladač pokusí dotaz analyzovat, ale s největší pravděpodobností dojde k výjimce.

Další informace o této vlastnosti naleznete v tématu Načítání ParametrMetaData prostřednictvím useFmtOnly.

userName, user

  • Typ: String [<=128 char]
  • Výchozí hodnota: null

Uživatel databáze, pokud se připojujete pomocí uživatele a hesla SQL.

Pro připojení Kerberos pomocí hlavního názvu a hesla nastavte tuto vlastnost na Kerberos Principal name.

(Verze 10.2+) Při authentication=ActiveDirectoryServicePrincipal určuje vlastnost userName platné ID zabezpečeného klienta Microsoft Entra.

vectorTypeSupport

  • Typ: String [v2 | v1 | off]
  • Výchozí hodnota: v1

(Verze 13.2+) Nastavte na off, aby server odesílal vektorové typy jako řetězcová data ve formátu JSON, a na v1, aby server odesílal vektorové typy FLOAT32 jako vektorová data. Výchozí hodnota je v1.

(Verze 13.4+) Nastavte na v2 povolení podpory nativního typu vektoru pro oba FLOAT32 i FLOAT16 vektory. FLOAT16 vektory používají serializaci IEEE-754 s poloviční přesností na drátu a jsou vystaveny jako pole Float[] v Java.

Další informace naleznete v tématu Použití vektorového datového typu s ovladačem JDBC.

workstationID

  • Typ: String [<=128 char]
  • Výchozí hodnota: <empty string>

ID pracovní stanice. Pomocí tohoto ID identifikujte konkrétní pracovní stanici v různých nástrojích profilace a protokolování.

Pokud nezadáte hodnotu, výchozí hodnota je <empty string>.

xopenStates

  • Typ: Boolean [true | false]
  • Výchozí hodnota: false

Nastavte true tak, aby ovladač vracel kódy stavu ve formátu XOPEN ve výjimkách.

Výchozí hodnota je vrátit stavové kódy SQL 99.

Související obsah

  • Last updated on