De verbindingseigenschappen instellen

JDBC-stuurprogramma downloaden

U kunt de verbindingsreeks eigenschappen op verschillende manieren opgeven:

• Als <name>=<value> eigenschappen in de verbindings-URL wanneer u de verbinding maakt met de klasse DriverManager. Zie voor de syntaxis van de verbindingsreeks De verbindings-URL bouwen.

• Als <name>=<value> eigenschappen in de parameter Properties van de methode Connect in de klasse DriverManager.

• Als waarden in de juiste instelmethode van de gegevensbron van het stuurprogramma. Bijvoorbeeld:

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

Opmerkingen

• Eigenschapsnamen zijn hoofdletterongevoelig. Het stuurprogramma lost dubbele eigenschapsnamen op in de volgende volgorde:

  1. API-argumenten, zoals user en password
  2. Verzameling van Eigenschappen
  3. Laatste exemplaar in de verbindingsreeks

• U kunt onbekende waarden gebruiken voor eigenschapsnamen. Het JDBC-stuurprogramma valideert geen hoofdlettergevoeligheid.

• U kunt synoniemen gebruiken. Het stuurprogramma lost deze op volgorde op, net zoals bij dubbele eigenschapsnamen.

• Het Microsoft JDBC-stuurprogramma voor SQL Server gebruikt de standaardwaarden voor de server voor verbindingseigenschappen, met uitzondering van ANSI_DEFAULTS en IMPLICIT_TRANSACTIONS. Het Microsoft JDBC-stuurprogramma voor SQL Server stelt automatisch ANSI_DEFAULTS in op ON en IMPLICIT_TRANSACTIONS op OFF.

• Als u verificatie instelt op ActiveDirectoryPassword [DEPRECATED], neemt u de volgende bibliotheek op in het klassepad: microsoft-authentication-library-for-java. Zoek deze op de Maven-opslagplaats. De eenvoudigste manier om de bibliotheek en de bijbehorende afhankelijkheden te downloaden, is met behulp van Maven:

  1. Installeer Maven op uw systeem.
  2. Ga naar de pagina GitHub van het stuurprogramma.
  3. Download het pom.xml bestand.
  4. Voer de volgende Maven-opdracht uit om de bibliotheek en de bijbehorende afhankelijkheden te downloaden: mvn dependency:copy-dependencies

Eigenschappen

In de volgende secties worden alle momenteel beschikbare verbindingsreeks eigenschappen voor het JDBC-stuurprogramma beschreven.

accessToken

• Typ: String
• Standaard: null

(Versie 6.0+) Gebruik deze eigenschap om verbinding te maken met een database met behulp van een toegangstoken. U kunt deze niet instellen accessToken met behulp van de verbindings-URL.

accessTokenCallbackClass

• Typ: String
• Standaard: null

(Versie 12.4+) De naam van de callback-implementatieklasse die moet worden gebruikt met de callback van het toegangstoken.

applicationIntent

• Typ: String
• Standaard: ReadWrite

(Versie 6.0+) Declareert het workloadtype van de toepassing om verbinding te maken met een server.

Mogelijke waarden zijn ReadOnly en ReadWrite.

Voor meer informatie over herstel na noodgevallen, zie JDBC-stuurprogrammaundersteuning voor hoge beschikbaarheid en herstel na noodgevallen.

applicationName

• Type: String [<=128 char]
• Standaard: null

De naam van de toepassing of 'Microsoft JDBC-stuurprogramma voor SQL Server' als u geen naam opgeeft.

Gebruik deze naam om de specifieke toepassing te identificeren in verschillende SQL Server hulpprogramma's voor profilering en logboekregistratie.

authenticatie

• Typ: String
• Standaard: NotSpecified

(Versie 6.0+) Deze optionele eigenschap geeft aan welke verificatiemethode moet worden gebruikt voor verbinding.

Mogelijke waarden zijn ActiveDirectoryIntegrated, ActiveDirectoryManagedIdentity (versie 12.2+), ActiveDirectoryMSI (versie 7.2+), (versie 9.2+), ActiveDirectoryInteractiveActiveDirectoryServicePrincipal (versie 9.2+), ActiveDirectoryPassword [DEPRECATED]en SqlPasswordde standaardwaarde NotSpecified.

Gebruik ActiveDirectoryIntegrated (versie 6.0+) om verbinding te maken met SQL met behulp van geïntegreerde Windows authentication.

Gebruik ActiveDirectoryManagedIdentity (versie 12.2+) of ActiveDirectoryMSI (versie 7.2+) om vanuit een Azure-resource verbinding te maken met SQL. Bijvoorbeeld een Azure virtuele machine, App Service of functie-app met behulp van verificatie van beheerde identiteiten.

De twee typen beheerde identiteiten die door het stuurprogramma worden ondersteund bij gebruik van ActiveDirectoryManagedIdentity of ActiveDirectoryMSI verificatiemodus zijn:

• System-Assigned Beheerde Identiteit: Wordt standaard gebruikt om accessToken te verkrijgen.

• Door gebruiker toegewezen beheerde identiteit: wordt gebruikt om accessToken te verkrijgen als de client-id van een beheerde identiteit is opgegeven met de msiClientId verbindingseigenschap.

Gebruik ActiveDirectoryInteractive om verbinding te maken met een database via een interactieve authenticatiestroom.

Gebruik ActiveDirectoryServicePrincipal (versie 9.2+) om verbinding te maken met een database met behulp van de client-id en het geheim van een service-principal-identiteit. Geef de client-id op in de userName eigenschap en het geheim in de password eigenschap (10.2+).

Gebruik ActiveDirectoryServicePrincipalCertificate (versie 12.4+) om verbinding te maken met een database met behulp van de client-id en het certificaat van een service-principal-identiteit. Geef de client-id op in de userName eigenschap en het pad naar het certificaat in de clientCertificate eigenschap.

Zie Verbinding maken met de verificatiemodus ActiveDirectoryServicePrincipalCertificate voor meer opties.

Gebruik ActiveDirectoryPassword [DEPRECATED] om verbinding te maken met SQL met behulp van een Microsoft Entra principal-naam en -wachtwoord.

ActiveDirectoryPassword is verouderd.

Zie Verbinding maken met de activeDirectoryPassword-verificatiemodus voor meer informatie.

Gebruik SqlPassword voor het maken van verbinding met SQL met userName/user en password eigenschappen.

Gebruik NotSpecified als geen van deze verificatiemethoden nodig is.

Wanneer u de verificatie-eigenschap instelt op een andere waarde dan NotSpecified, gebruikt het stuurprogramma Transport Layer Security (TLS), voorheen SSL (Secure Sockets Layer), standaard versleuteling.

Zie Microsoft Entra-verificatie voor Azure SQL voor meer informatie over het configureren van Microsoft Entra verificatie.

authenticationScheme

• Typ: String
• Standaard: NativeAuthentication

Geeft aan welk type geïntegreerde beveiliging u wilt gebruiken voor uw toepassing.

Mogelijke waarden zijn JavaKerberos, NTLM (versie 7.4+) en de standaardwaarde NativeAuthentication.

NativeAuthentication zorgt ervoor dat het stuurprogramma mssql-jdbc_auth-<version>-<arch>.dll (bijvoorbeeld mssql-jdbc_auth-8.2.2.x64.dll) laadt op Windows, die wordt gebruikt om geïntegreerde verificatiegegevens te verkrijgen.

(De geladen systeemeigen verificatiebibliotheek krijgt een naam sqljdbc_auth.dll wanneer u stuurprogrammaversie 6.0 tot en met 7.4 gebruikt.)

Wanneer u authenticationScheme=JavaKerberos gebruikt, moet u de volledig gekwalificeerde domeinnaam (FQDN) opgeven in de serverName- of serverSpn-eigenschap. Anders treedt er een fout op (Server niet gevonden in Kerberos-database).

Zie authenticationScheme=JavaKerberos voor meer informatie over het gebruik van .

Wanneer u authenticationScheme=NTLM gebruikt, moet u het Windows domein opgeven met behulp van de eigenschap domain of domainName, de Windows referenties in de eigenschap user of userName en de eigenschap password. Anders treedt er een fout op (verbindingseigenschappen moeten worden opgegeven).

bulkCopyForBatchInsertAllowEncryptedValueModifications

• Type: Boolean [true | false]
• Standaard: false

(Versie 12.10+) Wanneer u deze optie instelt useBulkCopyForBatchInserttrue, stelt u deze optie in om true het bulksgewijs kopiëren van versleutelde gegevens tussen tabellen of databases in te schakelen zonder de gegevens te ontsleutelen.

Zie de optie allowEncryptedValueModifications in SQLServerBulkCopyOptionsvoor meer informatie en waarschuwingen over het gebruik van deze eigenschap.

bulkCopyForBatchInsertBatchSize

• Typ: int
• Standaard: 0

(Versie 12.10+) Wanneer u deze eigenschap instelt useBulkCopyForBatchInserttrue, geeft deze eigenschap de batchgrootte op voor bulkkopiebewerkingen die door het stuurprogramma worden gemaakt op basis van batchinvoegbewerkingen.

Zie de optie BatchSize in SQLServerBulkCopyOptionsvoor meer informatie over de effecten van deze instelling.

bulkCopyForBatchInsertCheckConstraints

• Type: Boolean [true | false]
• Standaard: false

(Versie 12.10+) Wanneer u deze optie gebruikt useBulkCopyForBatchInsert=true, stelt u deze optie in om controlebeperkingen in te true schakelen tijdens het invoegen van gegevens. Stel deze optie in op false om de controlebeperkingen uit te schakelen.

Zie de optie CheckConstraints in SQLServerBulkCopyOptionsvoor meer informatie over de effecten van deze instelling.

bulkCopyForBatchInsertFireTriggers

• Type: Boolean [true | false]
• Standaard: false

(Versie 12.10+) Wanneer u useBulkCopyForBatchInsert=true gebruikt, stelt u deze optie in op true om het activeren van invoegtriggers in te schakelen tijdens het invoeren van rijen in de database. Stel deze optie in op false om invoegtriggers uit te schakelen.

Zie de optie FireTriggers in SQLServerBulkCopyOptionsvoor meer informatie over de effecten van deze instelling.

bulkCopyForBatchInsertKeepIdentity

• Type: Boolean [true | false]
• Standaard: false

(Versie 12.10+) Wanneer u deze optie gebruikt useBulkCopyForBatchInsert=true, stelt u deze optie in om true bronidentiteitswaarden te behouden tijdens het invoegen van gegevens. Stel de optie in op false om identiteitswaarden aan de bestemming toe te wijzen.

Zie de optie KeepIdentity in SQLServerBulkCopyOptionsvoor meer informatie over de effecten van deze instelling.

bulkCopyForBatchInsertKeepNulls

• Type: Boolean [true | false]
• Standaard: false

(Versie 12.10+) Wanneer u deze optie gebruikt useBulkCopyForBatchInsert=true, stelt u deze optie in om true null-waarden in de doeltabel te behouden, ongeacht de standaardwaarde-instellingen. Stel deze optie in op false zodat standaardinstellingen van bestemmingen null-waarden vervangen.

Zie de optie KeepNulls in SQLServerBulkCopyOptionsvoor meer informatie over de effecten van deze instelling.

bulkCopyForBatchInsertTableLock

• Type: Boolean [true | false]
• Standaard: false

(Versie 12.10+) Wanneer u useBulkCopyForBatchInsert naar true instelt, stelt u deze optie in op true om een bulkupdatevergrendeling te verkrijgen tijdens de bulkkopiebewerking. Stel deze optie in op false om rijvergrendelingen te gebruiken.

Zie de optie TableLock in SQLServerBulkCopyOptionsvoor meer informatie over de effecten van deze instelling.

cacheBulkCopyMetadata

• Type: Boolean [true | false]
• Standaard: false

(Versie 12.8+) Wanneer u useBulkCopyForBatchInsert=true gebruikt, geeft deze eigenschap aan de driver aan of de metagegevens van de doelkolom moeten worden gecached op verbindingsniveau. Als dit is ingesteld op true, moet u ervoor zorgen dat de bestemming niet verandert tussen bulkinvoegingen, omdat het stuurprogramma geen manier heeft om deze wijziging te verwerken.

calcBigDecimalPrecision

• Type: Boolean [true | false]
• Standaard: false

(Versie 12.6+) Vlag om aan te geven of het stuurprogramma precisie moet berekenen voor BigDecimale invoer, in tegenstelling tot het gebruik van de maximaal toegestane waarde voor precisie (38).

cancelQueryTimeout

• Typ: int
• Standaard: -1

(Versie 6.4+) Gebruik deze eigenschap om een queryTimeout set voor de verbinding te annuleren. Query-uitvoering reageert niet meer en gooit geen uitzondering als de TCP-verbinding met de server stilzwijgend wegvalt. Deze eigenschap is alleen van toepassing als queryTimeout ook op de verbinding is ingesteld.

Het stuurprogramma wacht de totale hoeveelheid cancelQueryTimeout + queryTimeout seconden om de verbinding te verwijderen en het kanaal te sluiten.

De standaardwaarde voor deze eigenschap is -1 en gedrag is om voor onbepaalde tijd te wachten.

clientCertificate

• Typ: String
• Standaard: null

(Versie 8.4+) Hiermee geeft u de locatie op van het certificaat dat moet worden gebruikt voor verificatie van clientcertificaten. Het JDBC-stuurprogramma ondersteunt PFX-, PEM-, DER- en CER-bestandsextensies.

Zie voor meer informatie Clientcertificaatverificatie voor Loopback-scenario's.

clientKey

• Typ: String
• Standaard: null

(Versie 8.4+) Hiermee geeft u de locatie van de persoonlijke sleutel voor PEM-, DER- en CER-certificaten die zijn opgegeven door het clientCertificate kenmerk.

Zie voor meer informatie Clientcertificaatverificatie voor Loopback-scenario's.

clientKeyPassword

• Typ: String
• Standaard: null

(Versie 8.4+) Hiermee geeft u de optionele wachtwoordtekenreeks voor toegang tot de persoonlijke sleutel van het clientKey bestand.

Zie voor meer informatie Clientcertificaatverificatie voor Loopback-scenario's.

kolomversleutelinginstelling

• Type: String [Enabled | Disabled]
• Standaard: Disabled

Stel in op Enabled om de Always Encrypted (AE) functie te gebruiken. Wanneer AE is ingeschakeld, versleutelt en ontsleutelt het JDBC-stuurprogramma gevoelige gegevens die zijn opgeslagen in versleutelde databasekolommen op de server.

Zie Always Encrypted gebruiken met het JDBC-stuurprogramma voor meer informatie over Always Encrypted.

concatNullYieldsNull

• Type: String [ON | OFF]
• Standaard: ON

(Versie 13.2+) Wanneer u deze optie OFFinstelt, stelt het stuurprogramma de databasesessievariabele CONCAT_NULL_YIELDS_NULLOFF in op het moment dat de verbinding tot stand wordt gebracht. Het resultaat is dat het samenvoegen van een null-waarde met een tekenreeks de tekenreeks zelf oplevert (de null-waarde wordt behandeld als een lege tekenreeks).

Zie SET CONCAT_NULL_YIELDS_NULLvoor meer informatie.

connectRetryCount

• Type: int [0..255]
• Standaard: 1

(Versie 9.4+) Het aantal pogingen om opnieuw verbinding te maken als er een verbindingsfout optreedt.

connectRetryInterval

• Type: int [1..60]
• Standaard: 10

(Versie 9.4+) Het aantal seconden tussen elke poging tot opnieuw proberen van de verbinding.

databaseName, database

• Type: String [<=128 char]
• Standaard: null

De naam van de database waarmee verbinding moet worden gemaakt.

Als u geen databasenaam opgeeft, gebruikt de verbinding de standaarddatabase.

datetimeParameterType

• Type: String [datetime | datetime2 | datetimeoffset]
• Standaard: datetime2

(Versie 12.2+) Het SQL-gegevenstype dat moet worden gebruikt voor Java datum- en tijdstempelparameters.

Wanneer u verbinding maakt met SQL Server 2016 of nieuwere versies en communiceert met verouderde datetime waarden, stelt u deze eigenschap in op datetime. Deze instelling vermindert conversieproblemen aan de serverzijde tussen datetime en datetime2 waarden.

Zie voor meer informatie De aanpak van gedragsveranderingen bij de conversie van datetime naar datetime2 vanaf SQL Server 2016.

delayLoadingLobs

• Type: Boolean [true | false]
• Standaard: true

Vlag om aan te geven of alle LOB-objecten moeten worden gestreamd die zijn opgehaald uit de ResultSet. Als u deze eigenschap instelt om het hele LOB-object naar het geheugen te false laden zonder te streamen.

disableStatementPooling

• Type: Boolean [true | false]
• Standaard: true

Vlag die aangeeft of statement pooling moet worden gebruikt.

domeinnaam, domein

• Typ: String
• Standaard: null

(Versie 7.4+) Het Windows-domein voor verificatie bij het gebruik van NTLM-verificatie.

enablePrepareOnFirstPreparedStatementCall

• Type: Boolean [true | false]
• Standaard: false

Ingesteld op true om de creatie van een voorbereide instructiehandgreep mogelijk te maken door sp_prepexec aan te roepen bij de eerste uitvoering van een voorbereide instructie.

Stel in op false om de eerste uitvoering van een prepared statement uit te voeren naar sp_executesql en geen statement voor te bereiden. Als er een tweede verwerking plaatsvindt, wordt sp_prepexec aangeroepen om een voorbereide statementhandle in te stellen.

enclaveAttestationProtocol

• Typ: String
• Standaard: null

(Versie 8.2+) Deze optionele eigenschap geeft het attestation-protocol aan dat moet worden gebruikt voor Always Encrypted met beveiligde enclaves. Op dit moment zijn HGSde enige ondersteunde waarden voor dit veld, AASen NONE (NONE wordt alleen ondersteund in versie 11.2+).

Zie Always Encrypted gebruiken met beveiligde enclaves voor meer informatie over Always Encrypted met beveiligde enclaves met het JDBC-stuurprogramma.

enclaveAttestationUrl

• Typ: String
• Standaard: null

(Versie 8.2+) Deze optionele eigenschap geeft de URL van het attestation-service-eindpunt aan die moet worden gebruikt voor Always Encrypted met beveiligde enclaves.

Zie Always Encrypted gebruiken met beveiligde enclaves voor meer informatie over Always Encrypted met beveiligde enclaves met het JDBC-stuurprogramma.

versleutelen

• Typ: String
• Standaard: null

Ingesteld op true om op te geven dat de SQL-Database Engine TLS-versleuteling gebruikt voor alle gegevens die worden verzonden tussen de client en de server als er een certificaat is geïnstalleerd op de server. De standaardwaarde is true in versie 10.2 en hoger en false in 9.4 en eerder.

In versie 6.0 en hoger is er een nieuwe verbindingsinstelling authentication die standaard TLS-versleuteling gebruikt.

Zie de authentication eigenschap voor meer informatie over deze eigenschap.

In versie 11.2.0 en hoger is encrypt gewijzigd van Boolean , stringwaardoor TDS 8.0-ondersteuning wordt geboden wanneer de eigenschap is ingesteld op strict.

De standaardwijziging in versie 10.2 is een belangrijke wijziging. Als u een upgrade uitvoert van 9.4 of eerder en uw server geen geldig TLS-certificaat heeft, moet u een geldig certificaat instellen of opgeven trustServerCertificatetrue .

failoverPartner

• Typ: String
• Standaard: null

De naam van de failoverserver die wordt gebruikt in een databasespiegelingsconfiguratie. Deze eigenschap wordt gebruikt voor een eerste verbindingsfout met de principal-server. Nadat u de initiële verbinding hebt uitgevoerd, wordt deze eigenschap genegeerd. Moet worden gebruikt met de databaseName eigenschap.

Als u een Virtual Network Name opgeeft in de Server-verbindingsinstelling, kunt u database-spiegeling niet gebruiken.

Voor meer informatie over herstel na noodgevallen, zie JDBC-stuurprogrammaundersteuning voor hoge beschikbaarheid en herstel na noodgevallen.

Fips

• Type: Boolean [true | false]
• Standaard: false

Stel deze eigenschap in op true voor Java JVM (Virtual Machine) met FIPS-functionaliteit.

fipsProvider

• Typ: String
• Standaard: null

FIPS-provider die is geconfigureerd in de JVM, zoals BCFIPS of SunPKCS11-NSS. Verwijderd in versie 6.4.0.

Zie GitHub-probleem 460voor meer informatie.

gsscredential

• Typ: org.ietf.jgss.GSSCredential
• Standaard: null

(Versie 6.2+) Geef gebruikersgegevens door voor Kerberos-beperkte delegatie in deze eigenschap.

Gebruik deze instelling met integratedSecurity als true en JavaKerberos als authenticationScheme.

hostNameInCertificate

• Typ: String
• Standaard: null

De hostnaam die moet worden gebruikt om het SQL Server TLS/SSL-certificaat te valideren.

De hostNameInCertificate optie kan worden gebruikt om de hostnaam op te geven in situaties waarin de naam, of namen, die in het certificaat worden gebruikt, niet overeenkomt met de naam die is doorgegeven aan de serverName eigenschap. Als er echter een overeenkomst is, moet de hostNameInCertificate optie niet worden gebruikt.

In situaties waarin de eigenschap hostNameInCertificate niet is opgegeven of is ingesteld op null, gebruikt het Microsoft JDBC-stuurprogramma voor SQL Server de eigenschapswaarde serverName op de verbindings-URL als hostnaam om het SQL Server TLS/SSL-certificaat te valideren.

Gebruik deze eigenschap in combinatie met de encrypt en authentication eigenschappen en de trustServerCertificate eigenschap. Deze eigenschap is van invloed op de certificaatvalidatie als de verbinding TLS-versleuteling gebruikt en de trustServerCertificate eigenschap is ingesteld op false. Zorg ervoor dat de waarde die u doorgeeft hostNameInCertificate , overeenkomt met de algemene naam (CN) of DNS-naam in de alternatieve onderwerpnaam (SAN) in het servercertificaat om een TLS-verbinding te laten slagen.

Zie Informatie over ondersteuning voor versleutelingvoor meer informatie over versleutelingsondersteuning.

Instancename

• Type: String [<=128 char]
• Standaard: null

De naam van het database-exemplaar waarmee verbinding moet worden gemaakt. Wanneer u deze eigenschap niet opgeeft, maakt u verbinding met het standaardexemplaar. Zie de notities voor de poort voor het geval u zowel de als de instanceName poort opgeeft.

Als u een Virtual Network-naam opgeeft in de eigenschap Server-verbinding, kunt u de eigenschap instanceName-verbinding niet gebruiken.

Voor meer informatie over herstel na noodgevallen, zie JDBC-stuurprogrammaundersteuning voor hoge beschikbaarheid en herstel na noodgevallen.

integratedSecurity

• Type: Boolean [true | false]
• Standaard: false

Ingesteld op true om aan te geven dat Windows referenties worden gebruikt door SQL Server op Windows besturingssystemen. Als true, het JDBC-stuurprogramma zoekt de lokale computer referentiecache op referenties die zijn opgegeven toen een gebruiker zich heeft aangemeld bij de computer of het netwerk.

Ingesteld op true (met authenticationscheme=JavaKerberos), om aan te geven dat Kerberos-referenties worden gebruikt door SQL Server.

Zie Geïntegreerde Kerberos-verificatie gebruiken om verbinding te maken met SQL Servervoor meer informatie over Kerberos-verificatie.

Ingesteld op true (met authenticationscheme=NTLM), om aan te geven dat NTLM-referenties worden gebruikt door SQL Server.

Als false, moeten de gebruikersnaam en het wachtwoord worden opgegeven.

ipaddresspreference

• Type: String [<=128 char]
• Standaard: IPv4First

De IP-voorkeur die wordt gebruikt door de clienttoepassing.

Met IPV4First verwerkt de driver eerst IPv4-adressen. Als er geen IPv4-adressen met succes kunnen worden verbonden, gaat het stuurprogramma door en probeert het IPv6-adressen, indien aanwezig.

Met IPV6First, het stuurprogramma doorkruist eerst IPv6-adressen. Als er geen IPv6-adressen kunnen worden verbonden, gaat het stuurprogramma door en probeert het IPv4-adressen, indien aanwezig.

Met UsePlatformDefault doorloopt de driver alle IP-adressen in de volgorde zoals bepaald via DNS-resolutie.

jaasConfigurationName

• Typ: String
• Standaard: SQLJDBCDriver

(Versie 6.2+) Elke verbinding met SQL Server kan een eigen JAAS-aanmeldingsconfiguratienaam gebruiken om een Kerberos-verbinding tot stand te brengen. U kunt de naam van de configuratievermelding doorgeven via deze eigenschap. Gebruik deze eigenschap bij het maken van een Kerberos-configuratiebestand. Standaard zoekt het stuurprogramma naar de naam SQLJDBCDriver.

Als het stuurprogramma geen externe configuratie vindt, wordt deze ingesteld useDefaultCcache=true voor IBM JVM's en useTicketCache=true voor andere JVM's.

keyStoreAuthentication

• Typ: String
• Standaard: null

(Versie 6.0+) Deze eigenschap identificeert welk sleutelarchief moet worden gebruikt met Always Encrypted en bepaalt een verificatiemechanisme dat wordt gebruikt voor verificatie bij het sleutelarchief. Het stuurprogramma ondersteunt het instellen van de Java Key Store naadloos wanneer u keyStoreAuthentication=JavaKeyStorePassword instelt. Als u deze eigenschap wilt gebruiken, moet u ook de eigenschappen keyStoreLocation en keyStoreSecret instellen voor het Java Sleutelarchief.

Vanaf Microsoft JDBC-stuurprogramma 8.4 kunt u keyStoreAuthentication=KeyVaultManagedIdentity of keyStoreAuthentication=KeyVaultClientSecret instellen om te verifiëren bij Azure Key Vault met beheerde identiteiten.

Zie Always Encrypted gebruiken met het JDBC-stuurprogramma voor meer informatie over Always Encrypted.

keyStoreLocation

• Typ: String
• Standaard: null

(Versie 6.0+) Wanneer keyStoreAuthentication=JavaKeyStorePassword, identificeert de eigenschap keyStoreLocation het pad naar het Java sleutelarchiefbestand waarin de kolomhoofdsleutel wordt opgeslagen voor gebruik met Always Encrypted-gegevens. Het pad moet de bestandsnaam van het sleutelarchief bevatten.

Zie Always Encrypted gebruiken met het JDBC-stuurprogramma voor meer informatie over Always Encrypted.

keyStorePrincipalId

• Typ: String
• Standaard: null

(Versie 8.4+) Wanneer keyStoreAuthentication=KeyVaultManagedIdentity, geeft de eigenschap keyStorePrincipalId een geldige Microsoft Entra toepassingsclient-id op.

Zie Always Encrypted gebruiken met het JDBC-stuurprogramma voor meer informatie over Always Encrypted.

keyStoreSecret

• Typ: String
• Standaard: null

(Versie 6.0+) Wanneer keyStoreAuthentication=JavaKeyStorePassword, identificeert de keyStoreSecret eigenschap het wachtwoord dat moet worden gebruikt voor het sleutelarchief en de sleutel. Wanneer u het Java Sleutelarchief gebruikt, moeten de sleutelopslag en het sleutelwachtwoord hetzelfde zijn.

Zie Always Encrypted gebruiken met het JDBC-stuurprogramma voor meer informatie over Always Encrypted.

lastUpdateCount

• Type: Boolean [true | false]
• Standaard: true

Een true waarde retourneert alleen het laatste aantal updates van een SQL-instructie die u doorgeeft aan de server. Gebruik deze waarde met slechts één SELECT, INSERT, of DELETE instructie om andere aantallen updates te negeren die server-triggers kunnen veroorzaken. Stel deze eigenschap in op false om alle updateaantallen terug te geven, inclusief die welke door servertriggers worden geretourneerd.

lockTimeout

• Typ: int
• Standaard: -1

Het aantal milliseconden dat moet worden gewacht voordat de database een time-out voor vergrendeling rapporteert. Het standaardgedrag is om voor onbepaalde tijd te wachten. Als u geen waarde voor deze eigenschap opgeeft, is deze waarde de standaardwaarde voor alle instructies in de verbinding.

U kunt Statement.setQueryTimeout() ook de time-out van de query instellen voor specifieke verklaringen. De waarde kan 0 zijn, wat geen wachttijd aangeeft.

loginTimeout

• Type: int [0..65535]
• Standaard: 30 (versie 11.2 en hoger) of 15 (versie 10.2 en eerder)

Het aantal seconden dat de driver moet wachten voordat er een time-out optreedt voor een mislukte verbinding. Een nulwaarde geeft aan dat de time-out de standaardtime-out van het systeem is. Deze waarde is 30 seconden (de standaardwaarde in versie 11.2 en hoger) of 15 seconden (de standaardwaarde in versie 10.2 en eerder). Een niet-nul waarde is het aantal seconden dat de driver moet wachten voordat een mislukte verbinding een time-out genereert.

Als u een Virtual Network Naam opgeeft in de Server-verbindingseigenschap, stel een time-outwaarde van drie minuten of meer in om voldoende tijd te bieden voor een failoververbinding.

Voor meer informatie over herstel na noodgevallen, zie JDBC-stuurprogrammaundersteuning voor hoge beschikbaarheid en herstel na noodgevallen.

maxResultBuffer

• Typ: String
• Standaard: null

(Versie 9.2+) Hiermee maxResultBuffer stelt u het maximum aantal bytes in dat moet worden gelezen bij het lezen van een resultatenset. Als u deze waarde niet opgeeft, leest het stuurprogramma de volledige resultatenset. U kunt de grootte in twee stijlen opgeven:

• Als een grootte in bytes (bijvoorbeeld 100, 150M, 300K, ). 400G
• Als percentage van het maximale heapgeheugen (bijvoorbeeld 10p, 15pct, 20percent).

msiClientId

• Typ: String
• Standaard: null

(Afgeschaft) (Versie 7.2+) De client-id van de beheerde identiteit (MSI) die wordt gebruikt om een accessToken verbinding tot stand te brengen met behulp van de ActiveDirectoryManagedIdentity of ActiveDirectoryMSI verificatiemodus.

multiSubnetFailover

• Type: Boolean [true | false]
• Standaard: false

Geef altijd multiSubnetFailover=true op om verbinding te maken met de listener van een SQL Server beschikbaarheidsgroep of een SQL Server Failover Cluster Instance. multiSubnetFailover=true configureert het stuurprogramma om snellere detectie en verbinding met de actieve server te bieden.

Mogelijke waarden zijn true en false.

Voor meer informatie over herstel na noodgevallen, zie JDBC-stuurprogrammaundersteuning voor hoge beschikbaarheid en herstel na noodgevallen.

U kunt programmatisch toegang krijgen tot de multiSubnetFailover verbindingseigenschap met behulp van getPropertyInfo, getMultiSubnetFailover en setMultiSubnetFailover.

packetSize

• Type: int [-1 | 0 | 512..32767]
• Standaard: 8000

De netwerkpakketgrootte die wordt gebruikt om te communiceren met de server, opgegeven in bytes. Een waarde van -1 geeft aan dat de standaardpakketgrootte van de server moet worden gebruikt. Een waarde van 0 geeft aan dat de maximumwaarde 32767 moet worden gebruikt. Als u deze eigenschap instelt op een waarde buiten het acceptabele bereik, treedt er een uitzondering op.

Zie de setPacketSize-methode van de klasse SQLServerDataSource voor meer informatie over deze eigenschap.

password

• Type: String [<=128 char]
• Standaard: null

Het databasewachtwoord, als u verbinding maakt met een SQL-gebruiker en -wachtwoord.

Voor Kerberos-verbinding met principal-naam en -wachtwoord stelt u deze eigenschap in op het kerberos-principalwachtwoord.

(Versie 10.2+) Wanneer authentication=ActiveDirectoryServicePrincipal, identificeert de eigenschap password het wachtwoord dat moet worden gebruikt voor de Active Directory-principal.

poortnummer, poort

• Type: int [0..65535]
• Standaard: 1433

De poort waar de server luistert. Als u het poortnummer in de verbindingsreeks opgeeft, wordt er geen aanvraag voor SQLbrowser gedaan. Wanneer u zowel de poort als de verbinding instanceNameopgeeft, wordt de verbinding gemaakt met de opgegeven poort. De instanceName waarde wordt echter gevalideerd en er wordt een fout gegenereerd als deze niet overeenkomt met de poort.

prepareMethod

• Type: String [prepexec | prepare | scopeTempTablesToConnection | none]
• Standaard: prepexec

(Versie 11.2.0+) Hiermee geeft u de onderliggende voorbereidingsmethode op die het stuurprogramma gebruikt met voorbereide instructies.

Stel in op prepare om sp_prepare als voorbereidingsmethode te gebruiken. Als u prepareMethod op deze waarde instelt, resulteert dit in een afzonderlijke, eerste reis naar de database om de instructie voor te bereiden zonder initiële waarden voor de database die in het uitvoeringsplan moet worden overwogen. Stel in op prepexec om sp_prepexec als voorbereidingsmethode te gebruiken. Deze methode combineert de voorbereidingsactie met de eerste uitvoering, waardoor retouren worden verminderd. Het biedt ook de database met initiële parameterwaarden die de database in het uitvoeringsplan kan overwegen.

(Versie 13.4.0+) Zet op scopeTempTablesToConnection om tijdelijke tabellen die zijn gemaakt in voorbereide instructies aan de verbinding te koppelen met behulp van letterlijke parametervervanging in plaats van voorbereide handles aan de serverzijde. Ingesteld op none om letterlijke parametervervanging met SQL-batchuitvoering af te dwingen, waarbij voorbereide instructiehandgrepen aan de serverzijde worden overgeslagen (sp_prepexec / sp_prepare).

Beperkingen en disclaimers voor scopeTempTablesToConnection en none:

Deze prepareMethod opties zijn bedoeld voor compatibiliteits- en migratiescenario's, niet voor algemeen gebruik van prestaties.

• Geen voorbereide instructies aan de serverzijde; SQL wordt altijd uitgevoerd als een batch.
• Vereist FORCED_PARAMETERIZATION voor effectief hergebruik van plannen.
• Parameters worden inline weergegeven als letterlijke waarden in plaats van afhankelijke typen.
• Numerieke precisie en schaal kunnen verschillen van de parameterbinding aan de serverzijde.
• Datum- en tijdwaarden worden opgemaakt als tekenreeksen door het stuurprogramma.
• Grote tekenreeksparameters vergroten de tekengrootte en het geheugengebruik van SQL.
• Blob- en CLOB-parameters kunnen leiden tot een hoog geheugengebruik of onvoldoende geheugen.
• SQL Server leidt parametergegevenstypen af tijdens de SQL-parsefase.
• Queryplannen kunnen variëren vanwege verschillen in letterlijke waarden.
• Er worden fouten gedetecteerd tijdens de uitvoering in plaats van bij bindingstijd.
• Uitgevoerde SQL bevat letterlijke waarden en is zichtbaar in servertraceringen en logboeken.

queryTimeout

• Typ: int
• Standaard: -1

Het aantal seconden dat moet worden gewacht voordat een time-out op een query plaatsvindt. De standaardwaarde is -1, wat een oneindige time-out betekent. Als u deze waarde instelt op 0, betekent dit ook dat u voor onbepaalde tijd moet wachten.

quotedIdentifier

• Type: String [ON | OFF]
• Standaard: ON

(Versie 13.2+) Wanneer u deze optie OFFinstelt, stelt het stuurprogramma de databasesessievariabele QUOTED_IDENTIFIEROFF in op het moment dat de verbinding tot stand wordt gebracht. De database behandelt dubbele aanhalingstekens als tekenreeksscheidingstekens voor letterlijke tekens en u kunt geen id's tussen dubbele aanhalingstekens plaatsen.

Zie SET QUOTED_IDENTIFIERvoor meer informatie.

Realm

• Typ: String
• Standaard: null

(Versie 9.4+) De realm voor Kerberos-verificatie. Stel deze waarde in om het Kerberos-authenticatiedomein te overschrijven dat het stuurprogramma automatisch detecteert vanuit het domein van de server.

Replicatie

• Type: Boolean [true | false]
• Standaard: false

(Versie 9.4+) Deze instelling vertelt de server of de verbinding wordt gebruikt voor replicatie. Wanneer deze optie is ingeschakeld, worden triggers met de optie NOT FOR REPLICATION niet geactiveerd op de verbinding.

responseBuffering

• Type: String [full | adaptive]
• Standaard: adaptive

Als u deze eigenschap adaptiveinstelt op, buffert het stuurprogramma de minimale hoeveelheid gegevens wanneer dat nodig is. De standaardmodus is adaptive.

Als u deze eigenschap fullinstelt op, leest het stuurprogramma de volledige resultatenset van de server wanneer er een instructie wordt uitgevoerd.

selectMethod

• Type: String [direct | cursor]
• Standaard: direct

Als u deze eigenschap cursorinstelt op, maakt het stuurprogramma een databasecursor voor elke query die wordt gemaakt op de verbinding voor TYPE_FORWARD_ONLY en CONCUR_READ_ONLY cursors. Normaal gesproken hebt u deze eigenschap alleen nodig als uw toepassing grote resultatensets genereert die niet volledig in het clientgeheugen passen. Als u deze eigenschap cursorinstelt op, behoudt het stuurprogramma slechts een beperkt aantal rijen met resultatensets in het clientgeheugen.

Standaard bewaart het stuurprogramma alle rijen met resultatensets in het clientgeheugen. Dit standaardgedrag biedt de snelste prestaties wanneer de toepassing alle rijen verwerkt.

sendStringParametersAsUnicode

• Type: Boolean [true | false]
• Standaard: true

Als u de sendStringParametersAsUnicode eigenschap trueinstelt op, verzendt het stuurprogramma tekenreeksparameters naar de server in Unicode-indeling.

Als u de sendStringParametersAsUnicode eigenschap falseinstelt op, verzendt het stuurprogramma tekenreeksparameters naar de server in niet-Unicode-indelingen, zoals ASCII of MBCS in plaats van Unicode.

De standaardwaarde voor de sendStringParametersAsUnicode eigenschap is true.

Voor optimale prestaties met de CHAR, VARCHAR en LONGVARCHAR JDBC-gegevensformaten moet een toepassing de eigenschap sendStringParametersAsUnicode instellen op false en de niet-nationale tekenmethoden van de klassen setString, setCharacterStream en setClob gebruiken, namelijk de SQLServerPreparedStatement klasse en de SQLServerCallableStatement klasse.

Wanneer de toepassing de sendStringParametersAsUnicode eigenschap false instelt en een niet-nationale tekenmethode gebruikt om toegang te krijgen tot Unicode-gegevenstypen aan de serverzijde (zoals ncharnvarchar, enntext), gaan sommige gegevens mogelijk verloren als de databasesortering geen ondersteuning biedt voor de tekens in de String parameters die worden doorgegeven door de niet-nationale tekenmethode.

Een toepassing moet gebruikmaken van de nationale tekenmethoden setNString, setNCharacterStream en setNClob van de klassen SQLServerPreparedStatement Class en SQLServerCallableStatement Class voor de JDBC-gegevenstypen NCHAR, NVARCHAR en LONGNVARCHAR.

Het wijzigen van deze waarde kan van invloed zijn op het sorteren van resultaten uit de database. De sorteerverschillen worden veroorzaakt door verschillende sorteerregels voor Unicode-tekens versus niet-Unicode-tekens.

sendTemporalDataTypesAsStringForBulkCopy

• Type: Boolean [true | false]
• Standaard: true

(Versie 8.4+) Wanneer u deze verbindingseigenschap instelt op false, verzendt het stuurprogramma DATE, DATETIME, DATETIME2, DATETIMEOFFSET, SMALLDATETIME en TIME gegevenstypen als hun respectieve typen in plaats van ze te verzenden als String.

Wanneer u deze verbindingseigenschap falseinstelt op, accepteert het stuurprogramma de letterlijke standaardtekenreeksindeling van elk tijdelijk gegevenstype, bijvoorbeeld:

• 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

• Type: Boolean [true | false]
• Standaard: true

Deze eigenschap is toegevoegd in SQL Server JDBC-stuurprogramma 3.0.

• Ingesteld op true om java.sql.Time-waarden naar de server te verzenden als SQL Server datetime waarden.

• Ingesteld op false om java.sql.Time-waarden naar de server te verzenden als SQL Server time waarden.

De standaardwaarde voor deze eigenschap is momenteel true en kan in een toekomstige release worden gewijzigd.

Zie Configuring how java.sql.Time values are sent voor meer informatie over hoe het Microsoft JDBC-stuurprogramma voor SQL Server configureert java.sql.Time-waarden voordat deze naar de server worden verzonden.

servercertificaat, server

• Typ: String
• Standaard: null

(Versie 11.2.0+) Het pad naar het servercertificaatbestand. Het stuurprogramma gebruikt dit certificaat voor validatie wanneer u encrypt instelt op strict. Het stuurprogramma ondersteunt certificaatbestanden die gebruikmaken van de PEM-bestandsindeling.

servernaam, server

• Typ: String
• Standaard: null

De computer met SQL Server of een Azure SQL-database.

U kunt ook de naam van een virtueel netwerk van een beschikbaarheidsgroep opgeven.

Voor meer informatie over herstel na noodgevallen, zie JDBC-stuurprogrammaundersteuning voor hoge beschikbaarheid en herstel na noodgevallen.

serverNameAsACE

• Type: Boolean [true | false]
• Standaard: false

(Versie 6.0+) Ingesteld om true aan te geven dat het stuurprogramma de Unicode-servernaam moet vertalen naar ASCII-compatibele codering (Punycode) voor de verbinding. Als deze instelling is false, gebruikt het stuurprogramma de servernaam zoals opgegeven om verbinding te maken.

Zie Internationale functies van het JDBC-stuurprogrammavoor meer informatie over internationale functies.

serverPreparedStatementDiscardThreshold

• Typ: int
• Standaard: 10

(Versie 6.2+) Gebruik deze eigenschap om te bepalen hoeveel openstaande acties voor het negeren van een voorbereide instructie (sp_unprepare) openstaand kunnen zijn per verbinding voordat het stuurprogramma de openstaande ingangen op de server opschoont.

Als u deze eigenschap instelt op <= 1, voert het stuurprogramma onmiddellijk acties uit voor het afbreken van voorbereidingen bij het sluiten van de voorbereide statement. Als u de eigenschap instelt op > 1, groepeert het stuurprogramma deze aanroepen samen om de overhead van het te vaak aanroepen van sp_unprepare te voorkomen.

serverSpn

• Typ: String
• Standaard: null

(Versie 4.2+) Gebruik deze optionele eigenschap om de SPN (Service Principal Name) op te geven voor een Java Kerberos-verbinding. Gebruik het met authenticationScheme.

Als u de SPN wilt opgeven, gebruikt u het formulier: MSSQLSvc/fqdn:port@REALM waarbij fqdn de volledig gekwalificeerde domeinnaam is, poort het poortnummer is en REALM de Kerberos-realm van de SQL Server in hoofdletters.

Zie voor meer informatie over het gebruik van serverSpn met Java Kerberos Het gebruik van geïntegreerde Kerberos-verificatie om verbinding te maken met SQL Server.

socketFactoryClass

• Typ: String
• Standaard: null

(Versie 8.4+) Hiermee geeft u de klassenaam op voor een aangepaste socketfactory die moet worden gebruikt in plaats van de standaardsocketfactory.

socketTimeout

• Typ: int
• Standaard: 0

Het aantal milliseconden dat moet worden gewacht voordat een time-out optreedt bij het lezen of accepteren van een verbinding op een socket. De standaardwaarde is 0, wat een oneindige time-out betekent.

statementPoolingCacheSize

• Typ: int
• Standaard: 0

(Versie 6.4+) Gebruik deze eigenschap om caching van prepared statement-handles in het stuurprogramma in te schakelen.

Deze eigenschap definieert de grootte van de cache voor statement pooling.

Gebruik deze eigenschap alleen met de disableStatementPooling verbindingseigenschap, die u moet instellen op false. Instellen van disableStatementPooling op true of statementPoolingCacheSize op 0 schakelt het cachegeheugen voor geprepareerde instructieverwerking uit.

sslProtocol

• Typ: String
• Standaard: TLS

(Versie 6.4+) Gebruik deze eigenschap om het TLS-protocol op te geven dat moet worden overwogen tijdens een beveiligde verbinding.

Mogelijke waarden zijn: TLS, TLSv1, TLSv1.1en TLSv1.2.

Zie SSLProtocolvoor meer informatie over het Secure Sockets Layer-protocol.

transparanteNetwerkIPResolutie

• Type: Boolean [true | false]
• Standaard: true

(Versie 6.0+) Deze eigenschap biedt een snellere detectie van en verbinding met de actieve server. Stel deze in op true of false. De standaardwaarde is true.

Voordat het Microsoft JDBC-stuurprogramma 6.0 voor SQL Server beschikbaar was, moest een toepassing de verbindingsreeks instellen om multiSubnetFailover=true op te nemen om aan te geven dat er verbinding werd gemaakt met een Always On-beschikbaarheidsgroep. Zonder het trefwoord voor de multiSubnetFailover verbinding in te truestellen, kan een toepassing een time-out ervaren tijdens het maken van verbinding met een AlwaysOn-beschikbaarheidsgroep. Vanaf versie 6.0 is het niet meer vereist dat een toepassing multiSubnetFailover naar true instelt.

Wanneer transparentNetworkIPResolution=true, gebruikt de eerste verbindingspoging 500 ms als time-out. Bij latere pogingen wordt dezelfde time-outlogica gebruikt als voor de multiSubnetFailover eigenschap.

trustManagerClass

• Typ: String
• Standaard: null

(Versie 6.4+) De volledig gekwalificeerde klassenaam van een aangepaste javax.net.ssl.TrustManager-implementatie.

trustManagerConstructorArg

• Typ: String
• Standaard: null

(Versie 6.4+) Een optioneel argument dat moet worden doorgegeven aan de constructor van de TrustManager. Als u de trustManagerClass eigenschap opgeeft en een versleutelde verbinding aanvraagt, gebruikt het stuurprogramma de aangepaste TrustManager in plaats van de standaard op JVM gebaseerde TrustManager van het systeem.

trustServerCertificate

• Type: Boolean [true | false]
• Standaard: false

Stel in op true om te specificeren dat het stuurprogramma het TLS/SSL-certificaat van de server niet valideert.

• Als true het TLS/SSL-certificaat van de server automatisch wordt vertrouwd wanneer de communicatielaag wordt versleuteld met TLS.

• Als falsehet stuurprogramma het TLS/SSL-certificaat van de server valideert. Als de validatie van het servercertificaat mislukt, genereert het stuurprogramma een fout en wordt de verbinding gesloten. De standaardwaarde is false. Zorg ervoor dat de waarde die aan serverName wordt doorgegeven exact overeenkomt met de algemene naam (CN) of DNS-naam in de alternatieve onderwerpnaam in het servercertificaat, zodat een TLS/SSL-verbinding kan slagen.

Zie Informatie over ondersteuning voor versleutelingvoor meer informatie over versleutelingsondersteuning.

trustStore

• Typ: String
• Standaard: null

Het pad (inclusief bestandsnaam) naar het certificaatbestand trustStore . Het trustStore bestand bevat de lijst met certificaten die de client vertrouwt.

Wanneer u deze eigenschap niet opgeeft of instelt op null, gebruikt het stuurprogramma de zoekregels van de trustmanagerfactory om te bepalen welk certificaatarchief moet worden gebruikt.

De standaard SunX509 TrustManagerFactory probeert het vertrouwde materiaal te vinden in de volgende zoekvolgorde:

1. Een bestand dat is opgegeven door de javax.net.ssl.trustStore JVM-systeemeigenschap.
2. <java-home>/lib/security/jssecacerts bestand.
3. <java-home>/lib/security/cacerts bestand.

Zie de SUNX509 TrustManager Interface-documentatie op de website sun microsystems voor meer informatie over de SUNX509 TrustManager Interface.

trustStorePassword

• Typ: String
• Standaard: null

Het wachtwoord dat wordt gebruikt om de integriteit van de trustStore gegevens te controleren.

Als u de trustStore eigenschap instelt maar de trustStorePassword eigenschap niet instelt, controleert het stuurprogramma de integriteit van de trustStoreeigenschap niet.

Wanneer u de trustStore eigenschappen niet opgeeft, gebruikt het stuurprogramma de JVM-systeemeigenschappen en trustStorePasswordjavax.net.ssl.trustStore.javax.net.ssl.trustStorePassword Als de javax.net.ssl.trustStorePassword systeemeigenschap niet wordt opgegeven, controleert het stuurprogramma de integriteit van de trustStore niet.

Als u de trustStore eigenschap niet instelt, maar de trustStorePassword eigenschap instelt, gebruikt het JDBC-stuurprogramma het bestand dat de javax.net.ssl.trustStore-parameter opgeeft als een truststore. Het stuurprogramma controleert de integriteit van de vertrouwensopslag door gebruik te maken van de opgegeven trustStorePassword. Deze instelling is nodig wanneer de clienttoepassing het wachtwoord niet wil opslaan in de JVM-systeemeigenschap.

trustStoreType

• Typ: String
• Standaard: JKS

Stel deze eigenschap in om het type vertrouwensarchief op te geven dat moet worden gebruikt voor de FIPS-modus.

Mogelijke waarden zijn PKCS12 of typen die zijn gedefinieerd door de FIPS-provider.

useBulkCopyForBatchInsert

• Type: Boolean [true | false]
• Standaard: false

(Versie 9.2+) Wanneer u deze verbindingseigenschap inschakelt, gebruikt het stuurprogramma transparant de Bulk Copy-API voor batchinvoegbewerkingen die gebruikmaken van java.sql.PreparedStatement. Deze functie kan betere prestaties bieden.

Deze functie is standaard uitgeschakeld. Stel deze eigenschap in op true om deze in te schakelen.

Zie Bulk copy API gebruiken voor batchinvoegbewerkingen voor meer informatie over het gebruik van deze eigenschap.

useDefaultGSSCredential

• Type: Boolean [true | false]
• Standaard: false

(Versie 12.6+) Vlag om aan te geven of het stuurprogramma de GSSCredential namens de gebruiker moet maken voor het gebruik van Native GSS-API voor Kerberos-authenticatie.

useDefaultJaasConfig

• Type: Boolean [true | false]
• Standaard: false

(Versie 12.6+) Wanneer de toepassing naast bibliotheken bestaat die JAAS op systeemniveau configureren, stelt u deze eigenschap in zodat true het stuurprogramma dezelfde configuratie kan gebruiken om Kerberos-verificatie uit te voeren.

useFmtOnly

• Type: Boolean [true | false]
• Standaard: false

(Versie 7.4+) Biedt een alternatieve manier om metagegevens van parameters op te vragen vanaf de server. Stel deze eigenschap in om aan te true geven dat het stuurprogramma SET FMTONLY logica moet gebruiken tijdens het uitvoeren van query's op parametermetagegevens. Deze functie is standaard uitgeschakeld en het wordt afgeraden deze eigenschap te gebruiken omdat SET FMTONLY is gemarkeerd voor afschaffing. useFmtOnly wordt alleen beschikbaar gesteld voor gebruik als tijdelijke oplossing voor bekende problemen en beperkingen in sp_describe_undeclared_parameters.

Deze functie ondersteunt momenteel slechts enkele SELECT/INSERT/UPDATE/DELETE query's. Als u deze functie probeert te gebruiken met niet-ondersteunde of meerdere query's, probeert het stuurprogramma de query te parseren, wat waarschijnlijk tot een foutmelding leidt.

Voor meer informatie over deze eigenschap, zie ParameterMetaData ophalen via useFmtOnly.

userName, gebruiker

• Type: String [<=128 char]
• Standaard: null

De databasegebruiker, als u verbinding maakt met behulp van een SQL-gebruiker en wachtwoord.

Voor Kerberos-verbinding met behulp van principal-naam en wachtwoord stelt u deze eigenschap in op de Kerberos Principal-naam.

(Versie 10.2+) Wanneer authentication=ActiveDirectoryServicePrincipal, geeft de eigenschap userName een geldige Microsoft Entra beveiligde client-id op.

vectorTypeSupport

• Type: String [v2 | v1 | off]
• Standaard: v1

(Versie 13.2+) Ingesteld off om op te geven dat de server vectortypen verzendt als tekenreeksgegevens in JSON-indeling en v1 om op te geven dat de server vectortypen van FLOAT32 als vectorgegevens verzendt. De standaardwaarde is v1.

(Versie 13.4+) Stel in op v2 om de systeemeigen ondersteuning voor vectortypen in te schakelen voor zowel FLOAT32- als FLOAT16-vectoren. FLOAT16 vectoren gebruiken IEEE-754 halve precisie serialisatie op de draad en worden weergegeven als Float[] matrices in Java.

Zie Vectorgegevenstype gebruiken met het JDBC-stuurprogramma voor meer informatie.

workstationID

• Type: String [<=128 char]
• Standaard: <empty string>

De werkstation-id. Gebruik deze id om het specifieke werkstation te identificeren in verschillende hulpprogramma's voor profilering en logboekregistratie.

Als u geen waarde opgeeft, is de standaardwaarde <empty string>.

xopenStates

• Type: Boolean [true | false]
• Standaard: false

Stel in op true om aan te geven dat het stuurprogramma XOPEN-compatibele statuscodes retourneert in uitzonderingen.

De standaardinstelling is om SQL 99-statuscodes te retourneren.

Verwante inhoud

• verbinding maken met SQL Server met het JDBC-stuurprogramma
• FIPS-modus