Ange anslutningsegenskaperna

Ladda ned JDBC-drivrutin

Du kan ange reťazec pripojenia egenskaper på olika sätt:

• Som <name>=<value> egenskaper i anslutnings-URL:en när du ansluter med hjälp av klassen DriverManager. För syntax för anslutningssträngar, se Skapa anslutnings-URL:en.

• Som <name>=<value> egenskaper i parametern Egenskaper för metoden Connect i klassen DriverManager.

• Som värden i den lämpliga "setter"-metoden för drivrutinensdatakälla . Till exempel:

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

Anmärkningar

• Egenskapsnamn är inte skiftlägeskänsliga. Drivrutinen löser duplicerade egenskapsnamn i följande ordning:

  1. API-argument, till exempel user och password
  2. Egenskapssamling
  3. Sista instansen i anslutningssträngen

• Du kan använda okända värden för egenskapsnamn. JDBC-drivrutinen validerar inte skiftlägeskänslighet.

• Du kan använda synonymer. Drivrutinen löser dem i ordning, precis som med dubbletter av egenskapsnamn.

• Microsoft JDBC-drivrutin för SQL Server tar serverns standardvärden för anslutningsegenskaper förutom ANSI_DEFAULTS och IMPLICIT_TRANSACTIONS. JDBC-drivrutinen för Microsoft för SQL Server anger automatiskt ANSI_DEFAULTS till ON och IMPLICIT_TRANSACTIONS till OFF.

• När du ställer in autentisering till ActiveDirectoryPassword [DEPRECATED], tar du med följande bibliotek i klassökvägen: microsoft-authentication-library-for-java. Hitta den på Maven-lagringsplatsen. Det enklaste sättet att ladda ned biblioteket och dess beroenden är att använda Maven:

  1. Installera Maven i systemet.
  2. Gå till GitHub-sidan för drivrutinen.
  3. pom.xml Ladda ned filen.
  4. Kör följande Maven-kommando för att ladda ned biblioteket och dess beroenden: mvn dependency:copy-dependencies.

Egenskaper

I följande avsnitt beskrivs alla tillgängliga reťazec pripojenia egenskaper för JDBC-drivrutinen.

accessToken

• Typ: String
• Standard: null

(Version 6.0+) Använd den här egenskapen för att ansluta till en databas med hjälp av en åtkomsttoken. Du kan inte ange accessToken med hjälp av anslutnings-URL:en.

accessTokenCallbackClass

• Typ: String
• Standard: null

(Version 12.4+) Namnet på den återanrops-implementeringsklass som ska användas med återanropet av åtkomsttoken.

applicationIntent

• Typ: String
• Standard: ReadWrite

(Version 6.0+) Deklarerar programarbetsbelastningstypen för att ansluta till en server.

Möjliga värden är ReadOnly och ReadWrite.

Mer information om katastrofåterställning finns i JDBC-drivrutinsstöd för hög tillgänglighet och katastrofåterställning.

applicationName

• Typ: String [<=128 char]
• Standard: null

Programnamnet eller "Microsoft JDBC-drivrutin för SQL Server" om du inte anger något namn.

Använd det här namnet för att identifiera det specifika programmet i olika SQL Server profilerings- och loggningsverktyg.

autentisering

• Typ: String
• Standard: NotSpecified

(Version 6.0+) Den här valfria egenskapen anger vilken autentiseringsmetod som ska användas för anslutning.

Möjliga värden är ActiveDirectoryIntegrated, ActiveDirectoryManagedIdentity (version 12.2+), ActiveDirectoryMSI (version 7.2+), ActiveDirectoryInteractive (version 9.2+), ActiveDirectoryServicePrincipal (version 9.2+), ActiveDirectoryPassword [DEPRECATED], SqlPasswordoch standardvärdet NotSpecified.

Använd ActiveDirectoryIntegrated (version 6.0+) för att ansluta till SQL med hjälp av integrerade Windows authentication.

Använd ActiveDirectoryManagedIdentity (version 12.2+) eller ActiveDirectoryMSI (version 7.2+) för att ansluta till SQL inifrån en Azure Resurs. Till exempel en Azure virtuell dator, App Service eller funktionsapp med hanterad identitetsautentisering.

De två typerna av hanterade identiteter som stöds av drivrutinen när du använder ActiveDirectoryManagedIdentity eller ActiveDirectoryMSI autentiseringsläge är:

• System-Assigned Hanterad Identitet: Används för att tillgå accessToken som standard.

• Användarassignerad hanterad identitet: Används för att hämta accessToken om klient-ID:t för en hanterad identitet har angetts med anslutningsegenskapen msiClientId.

Använd ActiveDirectoryInteractive för att ansluta till en databas med hjälp av ett interaktivt autentiseringsflöde.

Använd ActiveDirectoryServicePrincipal (version 9.2+) för att ansluta till en databas med hjälp av klient-ID:t och hemligheten för en tjänsthuvudnamnsidentitet. Ange klient-ID i egenskapen userName och hemlighet i egenskapen password (10.2+).

Använd ActiveDirectoryServicePrincipalCertificate (version 12.4+) för att ansluta till en databas med hjälp av klient-ID:t och certifikatet för en tjänsthuvudnamnsidentitet. Ange klient-ID i egenskapen userName och sökvägen till certifikatet i egenskapen clientCertificate .

Fler alternativ finns i Ansluta med ActiveDirectoryServicePrincipalCertificate-autentiseringsläge.

Använd ActiveDirectoryPassword [DEPRECATED] för att ansluta till SQL med ett Microsoft Entra huvudnamn och lösenord.

ActiveDirectoryPassword är inaktuellt.

För mer information, se Anslut med autentiseringsläget ActiveDirectoryPassword.

Använd SqlPassword för att ansluta till SQL med hjälp avuserName/useroch password egenskaper.

Använd NotSpecified om ingen av dessa autentiseringsmetoder behövs.

När du anger autentiseringsegenskapen till ett annat värde än NotSpecifiedanvänder drivrutinen TLS (Transport Layer Security), tidigare kallat Secure Sockets Layer (SSL), kryptering som standard.

Information om hur du konfigurerar Microsoft Entra autentisering finns i Microsoft Entra-autentisering för Azure SQL.

authenticationScheme

• Typ: String
• Standard: NativeAuthentication

Anger vilken typ av integrerad säkerhet du vill att programmet ska använda.

Möjliga värden är JavaKerberos, NTLM (version 7.4+) och standardvärdet NativeAuthentication.

NativeAuthentication gör att drivrutinen läser in mssql-jdbc_auth-<version>-<arch>.dll (till exempel mssql-jdbc_auth-8.2.2.x64.dll) på Windows, som används för att hämta integrerad autentiseringsinformation.

(Det inbyggda autentiseringsbiblioteket som läses in namnges sqljdbc_auth.dll när drivrutinsversionerna 6.0 till och med 7.4 används.

När du använder authenticationScheme=JavaKerberosmåste du ange det fullständigt kvalificerade domännamnet (FQDN) i serverName egenskapen eller serverSpn . Annars uppstår ett fel (servern hittades inte i Kerberos-databasen).

Mer information om hur du använder authenticationScheme=JavaKerberos finns i Använda Kerberos-integrerad autentisering för att ansluta till SQL Server.

När du använder authenticationScheme=NTLM måste du ange egenskapen Windows med egenskapen domain eller domainName, Windows-autentiseringsuppgifterna i egenskapen user eller userName och egenskapen password. Annars uppstår ett fel (anslutningsegenskaper måste anges).

bulkCopyForBatchInsertAllowEncryptedValueModifications

• Typ: Boolean [true | false]
• Standard: false

(Version 12.10+) När du anger useBulkCopyForBatchInsert till trueanger du det här alternativet för true att aktivera masskopiering av krypterade data mellan tabeller eller databaser, utan att dekryptera data.

Mer information och varningar om hur du använder den här egenskapen finns i alternativet allowEncryptedValueModifications i SQLServerBulkCopyOptions.

bulkCopyForBatchInsertBatchSize

• Typ: int
• Standard: 0

(Version 12.10+) När du anger useBulkCopyForBatchInsert till true, specificerar den här egenskapen batchstorleken för masskopiering som drivrutinen skapar från batchinfogning.

Mer information om effekterna av den här inställningen finns i alternativet BatchSize i SQLServerBulkCopyOptions.

bulkCopyForBatchInsertCheckConstraints

• Typ: Boolean [true | false]
• Standard: false

(Version 12.10+) När du använder useBulkCopyForBatchInsert=true, ställ in alternativet på true för att aktivera kontrollbegränsningar vid infogning av data. Ställ in det här alternativet på false för att inaktivera kontrollbegränsningar.

Mer information om effekterna av den här inställningen finns i alternativet CheckConstraints i SQLServerBulkCopyOptions.

bulkCopyForBatchInsertFireTriggers

• Typ: Boolean [true | false]
• Standard: false

När du använder useBulkCopyForBatchInsert=true ska du använda detta alternativ för true för att aktivera infogningsutlösare när rader infogas i databasen. Ange det här alternativet till false för att inaktivera infogningsutlösare.

Mer information om effekterna av den här inställningen finns i alternativet FireTriggers i SQLServerBulkCopyOptions.

bulkCopyForBatchInsertKeepIdentity

• Typ: Boolean [true | false]
• Standard: false

(Version 12.10+) När du använder useBulkCopyForBatchInsert=true, ange det här alternativet till true för att behålla källidentitetsvärden när data infogas. Ange alternativet false för att tilldela identitetsvärden enligt målet.

Mer information om effekterna av den här inställningen finns i alternativet KeepIdentity i SQLServerBulkCopyOptions.

bulkCopyForBatchInsertKeepNulls

• Typ: Boolean [true | false]
• Standard: false

(Version 12.10+) När du använder useBulkCopyForBatchInsert=trueanger du det här alternativet till true för att bevara null-värden i måltabellen oavsett standardvärdeinställningar. Ange det här alternativet till false för att tillåta att standardvärden för destinationen ersätter null-värden.

Mer information om effekterna av den här inställningen finns i alternativet KeepNulls i SQLServerBulkCopyOptions.

bulkCopyForBatchInsertTableLock

• Typ: Boolean [true | false]
• Standard: false

(Version 12.10+) När du anger useBulkCopyForBatchInsert till true, anger du det här alternativet till true för att få ett bulkuppdateringslås under bulk kopieringsåtgärden. Ange det här alternativet till false att använda radlås.

Mer information om effekterna av den här inställningen finns i alternativet TableLock i SQLServerBulkCopyOptions.

cacheBulkCopyMetadata

• Typ: Boolean [true | false]
• Standard: false

(Version 12.8+) När du använder useBulkCopyForBatchInsert=true anger den här egenskapen för drivrutinen om den ska cachelagra metadata för målkolumnen på anslutningsnivå. Om värdet är inställt på truebör du se till att målet inte ändras mellan massinfogningar eftersom drivrutinen inte har något sätt att hantera den här ändringen.

calcBigDecimalPrecision

• Typ: Boolean [true | false]
• Standard: false

(Version 12.6+) Flagga för att ange om drivrutinen ska beräkna precision för BigDecimala indata, i stället för att använda det högsta tillåtna värdet för precision (38).

cancelQueryTimeout

• Typ: int
• Standard: -1

(Version 6.4+) Använd den här egenskapen om du vill avbryta en queryTimeout inställning för anslutningen. Frågekörningen slutar svara och utlöser inget undantag om TCP-anslutningen till servern tas bort tyst. Den här egenskapen gäller endast om queryTimeout också har ställts in på anslutningen.

Drivrutinen väntar totalt cancelQueryTimeout + queryTimeout sekunder på att bryta anslutningen och stänga kanalen.

Standardvärdet för den här egenskapen är -1 och beteendet är att vänta på obestämd tid.

clientCertificate

• Typ: String
• Standard: null

(Version 8.4+) Anger platsen för certifikatet som ska användas för klientcertifikatautentisering. JDBC-drivrutinen stödjer filändelserna PFX, PEM, DER och CER.

Mer information finns i Klientcertifikatautentisering för Loopback-scenarier.

clientKey

• Typ: String
• Standard: null

(Version 8.4+) Anger platsen för den privata nyckeln för PEM-, DER- och CER-certifikat som anges av clientCertificate attributet.

Mer information finns i Klientcertifikatautentisering för Loopback-scenarier.

clientKeyPassword

• Typ: String
• Standard: null

(Version 8.4+) Anger den valfria lösenordssträngen clientKey för åtkomst till filens privata nyckel.

Mer information finns i Klientcertifikatautentisering för Loopback-scenarier.

columnEncryptionSetting

• Typ: String [Enabled | Disabled]
• Standard: Disabled

(Version 6.0+) Ange till Enabled att använda funktionen Always Encrypted (AE). När AE är aktiverat krypterar och dekrypterar JDBC-drivrutinen transparent känsliga data som lagras i krypterade databaskolumner på servern.

Mer information om Always Encrypted finns i Använda Always Encrypted med JDBC-drivrutinen.

concatNullYieldsNull

• Typ: String [ON | OFF]
• Standard: ON

(Version 13.2+) När du anger det här alternativet till OFFanger drivrutinen databassessionsvariabeln CONCAT_NULL_YIELDS_NULL till OFF när anslutningen upprättas. Resultatet är att sammanfogning av ett null-värde med en sträng ger själva strängen (null-värdet behandlas som en tom sträng).

Mer information finns i SET CONCAT_NULL_YIELDS_NULL.

connectRetryCount

• Typ: int [0..255]
• Standard: 1

(Version 9.4+) Antalet återanslutningsförsök om det uppstår ett anslutningsfel.

connectRetryInterval

• Typ: int [1..60]
• Standard: 10

(Version 9.4+) Antalet sekunder mellan varje försök till nytt anslutningsförsök.

databaseName, databas

• Typ: String [<=128 char]
• Standard: null

Namnet på databasen som ska anslutas till.

Om du inte anger något databasnamn använder anslutningen standarddatabasen.

datetimeParameterType

• Typ: String [datetime | datetime2 | datetimeoffset]
• Standard: datetime2

(Version 12.2+) DEN SQL-datatyp som ska användas för Java datum- och tidsstämpelparametrar.

När du ansluter till SQL Server 2016 eller senare versioner och interagerar med äldre datetime-värden anger du den här egenskapen till datetime. Den här inställningen minimerar konverteringsproblem på serversidan mellan datetime och datetime2 värden.

Mer information finns i Hantera ändringen av beteendet vid konvertering från datetime till datetime2 från och med SQL Server 2016.

delayLoadingLobs

• Typ: Boolean [true | false]
• Standard: true

Flagga för att ange om du vill strömma alla LOB-objekt som hämtats från ResultSet. Om du ställer in den här egenskapen så läses false hela LOB-objektet in i minnet utan direktuppspelning.

disableStatementPooling

• Typ: Boolean [true | false]
• Standard: true

Flagga som anger om instruktionspooler ska användas.

domainName, domän

• Typ: String
• Standard: null

(Version 7.4+) Den Windows domän som du vill autentisera till när du använder NTLM-autentisering.

enablePrepareOnFirstPreparedStatementCall

• Typ: Boolean [true | false]
• Standard: false

Ange till true för att aktivera skapande av förberedd instruktion genom att anropa sp_prepexec vid den första körningen av en förberedd instruktion.

Ställ in på false för att ändra den första körningen av ett förberett uttryck till att anropa sp_executesql och inte förbereda ett uttryck. Om en andra körning sker anropas sp_prepexec för att konfigurera en förberedd instruktionsreferens.

enclaveAttestationProtocol

• Typ: String
• Standard: null

(Version 8.2+) Den här valfria egenskapen anger attesteringsprotokollet som ska användas för Always Encrypted med säkra enklaver. För närvarande är HGSde enda värden som stöds för det här fältet , AASoch NONE (NONE stöds endast i version 11.2+).

Mer information om Always Encrypted med säkra enklaver finns i Använda Always Encrypted med säkra enklaver med JDBC-drivrutinen.

enclaveAttestationUrl

• Typ: String
• Standard: null

(Version 8.2+) Den här valfria egenskapen anger den attesteringstjänstslutpunkts-URL som ska användas för Always Encrypted med säkra enklaver.

Mer information om Always Encrypted med säkra enklaver finns i Använda Always Encrypted med säkra enklaver med JDBC-drivrutinen.

kryptera

• Typ: String
• Standard: null

Ange till true för att ange att SQL-Database Engine använder TLS-kryptering för alla data som skickas mellan klienten och servern om servern har ett certifikat installerat. Standardvärdet är true i version 10.2 och senare och false i 9.4 och tidigare.

I version 6.0 och senare finns det en ny anslutningsinställning authentication som använder TLS-kryptering som standard.

Mer information om den här egenskapen finns i egenskapen authentication .

I version 11.2.0 och senare encrypt ändrades från Boolean till string, vilket möjliggör TDS 8.0-stöd när egenskapen är inställd på strict.

Standardändringen i version 10.2 är en icke-bakåtkompatibel ändring. Om du uppgraderar från 9.4 eller tidigare och servern inte har något giltigt TLS-certifikat anger du trustServerCertificate till true eller anger ett giltigt certifikat.

failoverPartner

• Typ: String
• Standard: null

Namnet på den redundansserver som används i en databasspeglingskonfiguration. Den här egenskapen används för ett inledande anslutningsfel till huvudservern. När du har skapat den första anslutningen ignoreras den här egenskapen. Måste användas med egenskapen databaseName .

Om du anger ett Virtual Network namn i anslutningsegenskapen Server kan du inte använda databasspegling.

Mer information om katastrofåterställning finns i JDBC-drivrutinsstöd för hög tillgänglighet och katastrofåterställning.

FIPS

• Typ: Boolean [true | false]
• Standard: false

Ange den här egenskapen till true för FIPS-aktiverad Java virtuell dator (JVM).

fipsProvider

• Typ: String
• Standard: null

FIPS-provider som konfigurerats i JVM, till exempel BCFIPS eller SunPKCS11-NSS. Har tagits bort i version 6.4.0.

Mer information finns i GitHub-problem 460.

gsscredential

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

(Version 6.2+) Skicka användarautentiseringsuppgifter för Kerberos-begränsad delegering i den här egenskapen.

Använd den här inställningen med integratedSecurity som true och JavaKerberos som authenticationScheme.

hostNameInCertificate

• Typ: String
• Standard: null

Värdnamnet som ska användas för att verifiera SQL Server TLS/SSL-certifikatet.

Alternativet hostNameInCertificate kan användas för att ange värdnamnet i situationer där namnet eller namnen som används i certifikatet inte matchar namnet som skickas till serverName egenskapen. Om det finns en matchning bör alternativet dock hostNameInCertificate inte användas.

I situationer där egenskapen hostNameInCertificate är ospecificerad eller inställd på null använder Microsoft JDBC-drivrutinen för SQL Server egenskapsvärdet serverName på anslutnings-URL:en som värdnamn för att verifiera SQL Server TLS/SSL-certifikatet.

Använd den här egenskapen i kombination med encrypt egenskaperna och authentication och egenskapen trustServerCertificate . Den här egenskapen påverkar certifikatverifieringen om anslutningen använder TLS-kryptering och trustServerCertificate är inställd på false. Kontrollera att det värde som du skickar till hostNameInCertificate matchar det gemensamma namnet (CN) eller DNS-namnet i SAN (Subject Alternate Name) i servercertifikatet för att en TLS-anslutning ska lyckas.

Mer information om krypteringsstöd finns i Förstå krypteringsstöd.

Instansnamn

• Typ: String [<=128 char]
• Standard: null

Namnet på databasinstansen som ska anslutas till. När du inte anger den här egenskapen ansluter du till standardinstansen. För fallet där du anger både instanceName och port, se anteckningarna för port.

Om du anger ett Virtual Network namn i anslutningsegenskapen Server kan du inte använda anslutningsegenskapen instanceName.

Mer information om katastrofåterställning finns i JDBC-drivrutinsstöd för hög tillgänglighet och katastrofåterställning.

integratedSecurity

• Typ: Boolean [true | false]
• Standard: false

Ange till true för att ange att Windows autentiseringsuppgifter används av SQL Server på Windows operativsystem. Om truesöker JDBC-drivrutinen i cacheminnet för lokala datorer efter autentiseringsuppgifter som angavs när en användare loggade in på datorn eller nätverket.

Ange till true (med authenticationscheme=JavaKerberos) för att ange att Kerberos-autentiseringsuppgifter används av SQL Server.

Mer information om Kerberos-autentisering finns i Använda Kerberos-integrerad autentisering för att ansluta till SQL Server.

Ange till true (med authenticationscheme=NTLM) för att ange att NTLM-autentiseringsuppgifter används av SQL Server.

Om falsemåste användarnamnet och lösenordet anges.

ipaddresspreference

• Typ: String [<=128 char]
• Standard: IPv4First

IP-inställningen som används av klientprogrammet.

Med IPV4Firstgår drivrutinen först igenom IPv4-adresser. Om inga IPv4-adresser kan anslutas till fortsätter drivrutinen och försöker IPv6-adresser, om det finns några.

Med IPV6Firstgår drivrutinen först igenom IPv6-adresser. Om inga IPv6-adresser kan anslutas till fortsätter drivrutinen och försöker med IPv4-adresser, om det finns några.

Med UsePlatformDefault går drivrutinen igenom alla IP-adresser i sin ursprungliga ordning från DNS-upplösning.

jaasConfigurationName

• Typ: String
• Standard: SQLJDBCDriver

(Version 6.2+) Varje anslutning till SQL Server kan använda sitt eget JAAS-inloggningskonfigurationsnamn för att upprätta en Kerberos-anslutning. Du kan skicka namnet på konfigurationsposten via den här egenskapen. Använd den här egenskapen när du skapar en Kerberos-konfigurationsfil. Som standard letar drivrutinen efter namnet SQLJDBCDriver.

Om drivrutinen inte hittar någon extern konfiguration ställs den in useDefaultCcache=true för IBM JVM:er och useTicketCache=true för andra JVM:er.

keyStoreAuthentication

• Typ: String
• Standard: null

(Version 6.0+) Den här egenskapen identifierar vilket nyckellager som ska användas med Always Encrypted och avgör en autentiseringsmekanism som används för att autentisera till nyckelarkivet. Drivrutinen stöder sömlös konfiguration av Java Key Store när du ställer in keyStoreAuthentication=JavaKeyStorePassword. Om du vill använda den här egenskapen måste du också ange egenskaperna keyStoreLocation och keyStoreSecret för Java Key Store.

Från och med Microsoft JDBC Driver 8.4 kan du ange keyStoreAuthentication=KeyVaultManagedIdentity eller keyStoreAuthentication=KeyVaultClientSecret för att autentisera till Azure Key Vault med hanterade identiteter.

Mer information om Always Encrypted finns i Använda Always Encrypted med JDBC-drivrutinen.

keyStoreLocation

• Typ: String
• Standard: null

(Version 6.0+) När keyStoreAuthentication=JavaKeyStorePassword identifierar egenskapen keyStoreLocation sökvägen till den Java nyckellagringsfil som lagrar kolumnhuvudnyckeln som ska användas med Always Encrypted-data. Sökvägen måste innehålla nyckelarkivets filnamn.

Mer information om Always Encrypted finns i Använda Always Encrypted med JDBC-drivrutinen.

keyStorePrincipalId

• Typ: String
• Standard: null

(Version 8.4+) När keyStoreAuthentication=KeyVaultManagedIdentity anger egenskapen keyStorePrincipalId ett giltigt Microsoft Entra programklient-ID.

Mer information om Always Encrypted finns i Använda Always Encrypted med JDBC-drivrutinen.

keyStoreSecret

• Typ: String
• Standard: null

(Version 6.0+) När keyStoreAuthentication=JavaKeyStorePasswordidentifierar egenskapen keyStoreSecret lösenordet som ska användas för nyckelarkivet och nyckeln. När du använder Java Key Store måste nyckelarkivet och nyckellösenordet vara desamma.

Mer information om Always Encrypted finns i Använda Always Encrypted med JDBC-drivrutinen.

lastUpdateCount

• Typ: Boolean [true | false]
• Standard: true

Ett true värde returnerar endast det senaste uppdateringsantalet från en SQL-instruktion som du skickar till servern. Använd det här värdet med bara enkla SELECT, INSERT eller DELETE-instruktioner för att ignorera andra uppdateringsantal som servertriggers kan orsaka. Ange den här egenskapen till false för att returnera alla uppdateringsantal, inklusive de som returneras av triggers från servern.

lockTimeout

• Typ: int
• Standard: -1

Antalet millisekunder som ska vänta innan databasen rapporterar en tidsgräns för lås. Standardbeteendet är att vänta på obestämd tid. Om du inte anger något värde för den här egenskapen är det här värdet standardvärdet för alla instruktioner i anslutningen.

Du kan också använda Statement.setQueryTimeout() för att ange timeout för frågan för specifika kommandon. Värdet kan vara 0, vilket anger ingen väntan.

loginTimeout

• Typ: int [0..65535]
• Standard: 30 (version 11.2 och senare) eller 15 (version 10.2 och tidigare)

Antalet sekunder som föraren ska vänta innan en misslyckad anslutning avbryts. Ett nollvärde anger att tidsgränsen är standardtidsgränsen för systemet. Det här värdet är antingen 30 sekunder (standardvärdet i version 11.2 och senare) eller 15 sekunder (standardvärdet i version 10.2 och tidigare). Ett icke-nollvärde är antalet sekunder som drivrutinen ska vänta innan en misslyckad anslutning går ut på tid.

Om du anger ett Virtual Network namn i anslutningsegenskapen Server anger du ett timeout-värde på tre minuter eller mer för att ge tillräckligt med tid för att en redundansanslutning ska lyckas.

Mer information om katastrofåterställning finns i JDBC-drivrutinsstöd för hög tillgänglighet och katastrofåterställning.

maxResultBuffer

• Typ: String
• Standard: null

(Version 9.2+) Använd maxResultBuffer för att ange det maximala antalet byte som ska läsas när du läser en resultatuppsättning. Om du inte anger det här värdet läser drivrutinen hela resultatuppsättningen. Du kan ange storleken i två format:

• Som en storlek i byte (till exempel 100, 150M, 300K, 400G).
• Som en procentandel av maximalt heapminne (till exempel 10p, 15pct, 20percent).

msiClientId

• Typ: String
• Standard: null

(Inaktuell) (Version 7.2+) Klient-ID för en hanterad identitet (MSI) som används för att hämta en accessToken för att upprätta en anslutning genom autentiseringsläget ActiveDirectoryManagedIdentity eller ActiveDirectoryMSI.

multiSubnetFailover

• Typ: Boolean [true | false]
• Standard: false

Ange alltid multiSubnetFailover=true för att ansluta till tillgänglighetsgruppens lyssnare för en SQL Server tillgänglighetsgrupp eller en SQL Server redundansklusterinstans. multiSubnetFailover=true konfigurerar drivrutinen för snabbare identifiering av och anslutning till den aktiva servern.

Möjliga värden är true och false.

Mer information om katastrofåterställning finns i JDBC-drivrutinsstöd för hög tillgänglighet och katastrofåterställning.

Du kan programmatiskt komma åt anslutningsegenskapen multiSubnetFailover med hjälp av getPropertyInfo, getMultiSubnetFailover och setMultiSubnetFailover.

packetSize

• Typ: int [-1 | 0 | 512..32767]
• Standard: 8000

Storleken på nätverkspaketen som används för att kommunicera med servern, som anges i byte. Värdet -1 anger att serverns standardpaketstorlek ska användas. Värdet 0 anger att det maximala värdet 32767 ska användas. Om du anger den här egenskapen till ett värde utanför det acceptabla intervallet uppstår ett undantag.

Mer information om den här egenskapen finns i metoden setPacketSize för klassen SQLServerDataSource.

lösenord

• Typ: String [<=128 char]
• Standard: null

Databaslösenordet om du ansluter med en SQL-användare och ett lösenord.

För Kerberos-anslutning med huvudnamn och lösenord anger du den här egenskapen till Kerberos-huvudnamnslösenordet.

(Version 10.2+) När authentication=ActiveDirectoryServicePrincipal identifierar egenskapen password lösenordet som ska användas för služba Active Directory huvudnamn.

portnummer, port

• Typ: int [0..65535]
• Standard: 1433

Porten där servern lyssnar. Om du anger portnumret i reťazec pripojenia görs ingen begäran till SQLbrowser. När du anger både porten och instanceNameupprättas anslutningen till den angivna porten. instanceName verifieras dock och ett fel kastas om det inte stämmer överens med porten.

prepareMethod

• Typ: String [prepexec | prepare | scopeTempTablesToConnection | none]
• Standard: prepexec

(Version 11.2.0+) Anger den underliggande förberedelsemetoden som drivrutinen använder med förberedda instruktioner.

Ställ in prepare för att använda sp_prepare som förberedelsemetod. Om du anger prepareMethod till det här värdet resulterar det i ett separat, inledande anrop till databasen för att förbereda instruktionen utan att några initiala värden beaktas i databasens körningsplan. Ställ in prepexec för att använda sp_prepexec som förberedelsemetod. Den här metoden kombinerar förberedelseåtgärden med den första körningen, vilket minskar antalet rundresor. Det ger också databasen initiala parametervärden som databasen kan överväga i körningsplanen.

(Version 13.4.0+) Ange scopeTempTablesToConnection för att tillämpa omfattningen av temporära tabeller som skapas i förberedda instruktioner till anslutningen genom att använda bokstavlig parameterersättning istället för förberett hantering på serversidan. Ställ in som none för att tvinga fram bokstavlig parameterersättning vid SQL-batchkörning och förbikoppla handtag för förberedda instruktioner på serversidan (sp_prepexec / sp_prepare).

Begränsningar och ansvarsfriskrivningar för scopeTempTablesToConnection och none:

De här prepareMethod alternativen är avsedda för kompatibilitets- och migreringsscenarier, inte för allmän prestandaanvändning.

• Inga förberedda instruktioner på serversidan. SQL körs alltid som en batch.
• Kräver FORCED_PARAMETERIZATION för effektiv återanvändning av plan.
• Parametrar anges som literaler snarare än bundna typer.
• Numerisk precision och skala kan skilja sig från parameterbindning på serversidan.
• Datum- och tidsvärden formateras som strängar av drivrutinen.
• Stora strängparametrar ökar SQL-textstorleken och minnesanvändningen.
• BLOB- och CLOB-parametrar kan orsaka hög minnesanvändning eller minnesbrist.
• SQL Server härleder parameterdatatyper vid SQL-parsningstid.
• Frågeplaner kan variera på grund av skillnader i literalvärden.
• Fel identifieras vid körning i stället för vid bindningstid.
• Körd SQL innehåller literalvärden och visas i serverspårningar och loggar.

queryTimeout

• Typ: int
• Standard: -1

Antalet sekunder att vänta innan en timeout inträffar på en fråga. Standardvärdet är -1, vilket innebär oändlig timeout. Ange det här värdet till 0 innebär också att vänta på obestämd tid.

quotedIdentifier

• Typ: String [ON | OFF]
• Standard: ON

(Version 13.2+) När du anger det här alternativet till OFFanger drivrutinen databassessionsvariabeln QUOTED_IDENTIFIER till OFF när anslutningen upprättas. Databasen behandlar dubbla citattecken som strängavgränsare för teckenliteraler och du kan inte omsluta identifierare med dubbla citattecken.

Mer information finns i SET QUOTED_IDENTIFIER.

Domän

• Typ: String
• Standard: null

(Version 9.4+) Sfären för Kerberos-autentisering. Ange det här värdet för att åsidosätta Kerberos-autentiseringssfären som drivrutinen automatiskt identifierar från serverns sfär.

Replikering

• Typ: Boolean [true | false]
• Standard: false

(Version 9.4+) Den här inställningen anger för servern om anslutningen används för replikering. När aktiverad utlöses inte utlösare med alternativet NOT FOR REPLICATION på anslutningen.

responseBuffering

• Typ: String [full | adaptive]
• Standard: adaptive

Om du anger den här egenskapen till adaptivebuffrar drivrutinen den minsta mängden data vid behov. Standardläget är adaptive.

Om du anger den här egenskapen till fullläser drivrutinen hela resultatuppsättningen från servern när den kör en instruktion.

selectMethod

• Typ: String [direct | cursor]
• Standard: direct

Om du anger den här egenskapen till cursorskapar drivrutinen en databasmarkör för varje fråga som skapas på anslutningen för TYPE_FORWARD_ONLY och CONCUR_READ_ONLY markörer. Vanligtvis behöver du bara den här egenskapen om ditt program genererar stora resultatuppsättningar som inte får plats helt i klientminnet. Om du anger den här egenskapen till cursorbehåller drivrutinen endast ett begränsat antal resultatuppsättningsrader i klientminnet.

Som standard behåller drivrutinen alla resultatuppsättningsrader i klientminnet. Det här standardbeteendet ger den snabbaste prestandan när programmet bearbetar alla rader.

sendStringParametersAsUnicode

• Typ: Boolean [true | false]
• Standard: true

Om du anger sendStringParametersAsUnicode egenskapen till trueskickar drivrutinen strängparametrar till servern i Unicode-format.

Om du anger sendStringParametersAsUnicode egenskapen till falseskickar drivrutinen strängparametrar till servern i icke-Unicode-format som ASCII eller MBCS i stället för Unicode.

Standardvärdet för sendStringParametersAsUnicode egenskapen är true.

För optimala prestanda med datatyperna CHAR, VARCHARoch LONGVARCHAR JDBC bör ett program ange sendStringParametersAsUnicode egenskapen till false och använda setStringmetoderna , setCharacterStreamoch setClob icke-nationella tecken i klassklasserna SQLServerPreparedStatement och SQLServerCallableStatement Class.

När programmet anger sendStringParametersAsUnicode egenskapen till false och använder en icke-nationell teckenmetod för att komma åt Unicode-datatyper på serversidan (till exempel , ncharoch nvarchar), kan vissa data gå förlorade om databassortering inte stöder tecknen i parametrarna ntext som Stringskickas av den icke-nationella teckenmetoden.

Ett program bör använda de nationella teckenmetoderna setNString, setNCharacterStream och setNClob i SQLServerPreparedStatement-klassen och SQLServerCallableStatement-klassen för JDBC-datatyperna NCHAR, NVARCHAR och LONGNVARCHAR.

Om du ändrar det här värdet kan det påverka sortering av resultat från databasen. Sorteringsskillnaderna beror på olika sorteringsregler för Unicode jämfört med icke-Unicode-tecken.

sendTemporalDataTypesAsStringForBulkCopy (skicka tidsbaserade datatyper som sträng för bulköverföring)

• Typ: Boolean [true | false]
• Standard: true

(Version 8.4+) När du anger den här anslutningsegenskapen till false, skickar drivrutinen DATE, DATETIME, DATETIME2, DATETIMEOFFSET, SMALLDATETIME och TIME-datatyper som sina respektive typer i stället för att skicka dem som String.

När du anger den här anslutningsegenskapen till falseaccepterar drivrutinen standardformatet strängliteral för varje temporal datatyp, till exempel:

• 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]
• Standard: true

Den här egenskapen lades till i SQL Server JDBC Driver 3.0.

• Ställ in true för att skicka java.sql.Time-värden till servern som SQL Server datetime-värden.

• Ställ in false för att skicka java.sql.Time-värden till servern som SQL Server time-värden.

Standardvärdet för den här egenskapen är för närvarande true och kan ändras i en framtida version.

Mer information om hur JDBC-drivrutinen för Microsoft för SQL Server konfigurerar java.sql.Time-värden innan den skickar dem till servern finns i Konfigurera hur java.sql.Time-värden skickas.

servercertifikat, server

• Typ: String
• Standard: null

(Version 11.2.0+) Sökvägen till servercertifikatfilen. Drivrutinen använder det här certifikatet för validering när du anger encrypt till strict. Drivrutinen stöder certifikatfiler som använder PEM-filformatet.

serverName, server

• Typ: String
• Standard: null

Datorn som kör SQL Server eller en Azure SQL-databas.

Du kan också ange namnet på det virtuella nätverket för en tillgänglighetsgrupp.

Mer information om katastrofåterställning finns i JDBC-drivrutinsstöd för hög tillgänglighet och katastrofåterställning.

serverNameAsACE

• Typ: Boolean [true | false]
• Standard: false

(Version 6.0+) Ange till true för att ange att drivrutinen ska översätta Unicode-servernamnet till ASCII-kompatibel kodning (Punycode) för anslutningen. Om den här inställningen är falseanvänder drivrutinen servernamnet som angetts för att ansluta.

Mer information om internationella funktioner finns i Internationella funktioner i JDBC-drivrutinen.

serverPreparedStatementDiscardThreshold

• Typ: int
• Standard: 10

(Version 6.2+) Använd den här egenskapen om du vill styra hur många oavslutade åtgärder för att slutföra förberedda uttalanden (sp_unprepare) som kan finnas per anslutning innan drivrutinen rensar de utestående handtagen på servern.

Om du anger den här egenskapen till <= 1kör drivrutinen omedelbart avförberedande åtgärder när en förberedd instruktion stängs. Om du anger egenskapen till > 1, batchar drivrutinen dessa anrop för att undvika att kalla på sp_unprepare för ofta.

serverSpn

• Typ: String
• Standard: null

(Version 4.2+) Använd den här valfria egenskapen för att ange tjänstens huvudnamn (SPN) för en Java Kerberos-anslutning. Använd den med authenticationScheme.

Om du vill ange SPN använder du formuläret: MSSQLSvc/fqdn:port@REALM där fqdn är det fullständigt kvalificerade domännamnet, port är portnumret och REALM är Kerberos-sfären för SQL Server med versaler.

Mer information om hur du använder serverSpn med Java Kerberos finns i Använd Kerberos-integrerad autentisering för att ansluta till SQL Server.

socketFactoryClass

• Typ: String
• Standard: null

(Version 8.4+) Anger klassnamnet för en anpassad socketfabrik som ska användas i stället för standard-socketfabriken.

socketTimeout

• Typ: int
• Standard: 0

Antalet millisekunder som ska vänta innan en timeout inträffar på en socket som läses eller godkänns. Standardvärdet är 0, vilket innebär oändlig timeout.

statementPoolingCacheSize

• Typ: int
• Standard: 0

(Version 6.4+) Använd den här egenskapen för att aktivera cachelagring av förberedda instruktioners hantering i drivrutinen.

Den här egenskapen definierar storleken på cachen för statement pooling.

Använd endast den här egenskapen med anslutningsegenskapen disableStatementPooling , som du bör ange till false. Inställningen disableStatementPooling till true eller statementPoolingCacheSize till 0 inaktiverar förberedda instruktioner för cachelagring.

sslProtocol

• Typ: String
• Standard: TLS

(Version 6.4+) Använd den här egenskapen för att ange det TLS-protokoll som ska beaktas vid säker anslutning.

Möjliga värden är: TLS, TLSv1, TLSv1.1och TLSv1.2.

Mer information om protokollet Secure Sockets Layer finns i SSLProtocol.

transparent nätverkets IP-upplösning

• Typ: Boolean [true | false]
• Standard: true

(Version 6.0+) Den här egenskapen ger snabbare identifiering av och anslutning till den aktiva servern. Ange den till true eller false. Standardvärdet är true.

Innan Microsoft JDBC Driver 6.0 för SQL Server var ett program tvunget att ange reťazec pripojenia att inkludera multiSubnetFailover=true för att indikera att det anslöt till en AlwaysOn-tillgänglighetsgrupp. Utan att ställa in anslutningsnyckelordet multiSubnetFailover på truekan ett program få en timeout vid anslutning till en AlwaysOn-tillgänglighetsgrupp. Från och med version 6.0 behöver multiSubnetFailover inte längre ställas in till true för ett program.

När transparentNetworkIPResolution=trueanvänder det första anslutningsförsöket 500 ms som timeout. Alla senare försök använder samma timeout-logik som används av egenskapen multiSubnetFailover .

trustManagerClass

• Typ: String
• Standard: null

(Version 6.4+) Det fullständigt kvalificerade klassnamnet för en anpassad javax.net.ssl.TrustManager implementering.

trustManagerConstructorArg

• Typ: String
• Standard: null

(Version 6.4+) Ett valfritt argument som ska skickas till konstruktorn i TrustManager. Om du anger trustManagerClass egenskapen och begär en krypterad anslutning använder drivrutinen den anpassade TrustManager i stället för standardsystemet JVM-nyckelarkivbaserad TrustManager.

trustServerCertificate

• Typ: Boolean [true | false]
• Standard: false

Ange till true för att ange att drivrutinen inte verifierar serverns TLS/SSL-certifikat.

• Om trueär serverns TLS/SSL-certifikat automatiskt betrott när kommunikationsskiktet krypteras med TLS.

• Om falsevaliderar drivrutinen serverns TLS/SSL-certifikat. Om verifieringen av servercertifikatet misslyckas genererar drivrutinen ett fel och stänger anslutningen. Standardvärdet är false. Kontrollera att värdet som skickas till serverName exakt matchar det gemensamma namnet (CN) eller DNS-namnet i det alternativa ämnesnamnet i servercertifikatet för att en TLS/SSL-anslutning ska lyckas.

Mer information om krypteringsstöd finns i Förstå krypteringsstöd.

trustStore

• Typ: String
• Standard: null

Sökvägen (inklusive filnamn) till certifikatfilen trustStore . Filen trustStore innehåller listan över certifikat som klienten litar på.

När du inte anger den här egenskapen eller anger den till null använder drivrutinen trust manager-fabrikens uppslagsregler för att bestämma vilket certifikatarkiv som ska användas.

Standard SunX509 TrustManagerFactory försöker att lokalisera de betrodda resurserna i följande sökordning:

1. En fil som anges av JVM-systemegenskapen javax.net.ssl.trustStore .
2. <java-home>/lib/security/jssecacerts fil.
3. <java-home>/lib/security/cacerts fil.

Mer information om SUNX509 TrustManager-gränssnittet finns i dokumentationen om SUNX509 TrustManager Interface på Sun Microsystems webbplats.

trustStorePassword

• Typ: String
• Standard: null

Lösenordet som används för att kontrollera dataintegriteten trustStore .

Om du anger trustStore egenskapen men inte anger trustStorePassword egenskapen kontrollerar drivrutinen inte integriteten för trustStore.

När du inte anger trustStore egenskaperna och trustStorePassword använder drivrutinen JVM-systemegenskaperna javax.net.ssl.trustStore och javax.net.ssl.trustStorePassword. Om du inte anger javax.net.ssl.trustStorePassword systemegenskapen kontrollerar drivrutinen inte integriteten för trustStore.

Om du inte ställer in trustStore egenskapen men ställer in trustStorePassword egenskapen, använder JDBC-drivrutinen filen som javax.net.ssl.trustStore anger som en truststore. Drivrutinen kontrollerar integriteten för förtroendearkivet med hjälp av den angivna trustStorePassword. Den här inställningen behövs när klientprogrammet inte vill lagra lösenordet i JVM-systemegenskapen.

trustStoreType

• Typ: String
• Standard: JKS

Ange den här egenskapen för att ange vilken typ av förtroendearkiv som ska användas för FIPS-läge.

Möjliga värden är antingen PKCS12 eller typ som definieras av FIPS-providern.

useBulkCopyForBatchInsert

• Typ: Boolean [true | false]
• Standard: false

(Version 9.2+) När du aktiverar den här anslutningsegenskapen använder drivrutinen transparent API för masskopiering för batchinfogningsåtgärder som använder java.sql.PreparedStatement. Den här funktionen kan ge bättre prestanda.

Den här funktionen är inaktiverad som standard. Ange den här egenskapen till true för att aktivera den.

Mer information om hur du använder det här attributet finns i avsnittet Använda masskopierings-API för batchinfogning.

useDefaultGSSCredential

• Typ: Boolean [true | false]
• Standard: false

(Version 12.6+) Flagga för att ange om drivrutinen ska skapa GSSCredential å användarens vägnar för att använda Native GSS-API för Kerberos-autentisering.

useDefaultJaasConfig

• Typ: Boolean [true | false]
• Standard: false

(Version 12.6+) När programmet finns tillsammans med bibliotek som konfigurerar JAAS på systemnivå anger du den här egenskapen så true att drivrutinen kan använda samma konfiguration för att utföra Kerberos-autentisering.

useFmtOnly

• Typ: Boolean [true | false]
• Standard: false

(Version 7.4+) Ger ett alternativt sätt att fråga efter parametermetadata från servern. Ange den här egenskapen till true för att ange att drivrutinen ska använda SET FMTONLY logik vid frågor mot parametermetadata. Den här funktionen är inaktiverad som standard och vi rekommenderar inte att du använder den här egenskapen eftersom SET FMTONLY har markerats för utfasning. useFmtOnly är tillgänglig för användning endast som en lösning för kända problem och begränsningar i sp_describe_undeclared_parameters.

Den här funktionen har för närvarande endast stöd för enskilda SELECT/INSERT/UPDATE/DELETE frågor. Försök att använda den här funktionen med frågor som inte stöds/flera frågor gör att drivrutinen försöker parsa frågan, men resulterar troligen i ett undantag.

Mer information om den här egenskapen finns i Hämta ParameterMetaData via useFmtOnly.

userName, user

• Typ: String [<=128 char]
• Standard: null

Databasanvändaren, om du ansluter med hjälp av en SQL-användare och ett lösenord.

För Kerberos-anslutning med hjälp av huvudnamn och lösenord anger du den här egenskapen till Kerberos-huvudnamn.

(Version 10.2+) När authentication=ActiveDirectoryServicePrincipal anger egenskapen userName ett giltigt Microsoft Entra säkert klient-ID.

vectorTypeSupport

• Typ: String [v2 | v1 | off]
• Standard: v1

(Version 13.2+) Ange till off för att ange att servern skickar vektortyper som strängdata i JSON-format och v1 för att ange att servern skickar vektortyper som FLOAT32 vektordata. Standardvärdet är v1.

(Version 13.4+) Ange till v2 för att aktivera stöd för inbyggda vektortyper för både FLOAT32 och FLOAT16 vektorer. FLOAT16-vektorer använder IEEE-754 halvprecisions serialisering på tråden och exponeras som Float[] matriser i Java.

Mer information finns i Använda vektordatatyp med JDBC-drivrutinen.

workstationID

• Typ: String [<=128 char]
• Standard: <empty string>

Arbetsstations-ID:t. Använd det här ID:t för att identifiera den specifika arbetsstationen i olika profilerings- och loggningsverktyg.

Om du inte anger något värde är <empty string>standardvärdet .

xopenStates

• Typ: Boolean [true | false]
• Standard: false

För att ange att drivrutinen ska returnera XOPEN-kompatibla tillståndskoder i undantag, ställ in till true.

Standardvärdet är att returnera SQL 99-tillståndskoder.

Relaterat innehåll

• Ansluta till SQL Server med JDBC-drivrutinen
• FIPS-läge