Bağlantı özelliklerini ayarlama

JDBC sürücüsünü indirin

bağlantı dizesi özelliklerini çeşitli yollarla belirtebilirsiniz:

• DriverManager sınıfını kullanarak bağlandığınızda bağlantı URL'sinde özellikler olarak <name>=<value> . Bağlantı dizesi söz dizimi için bkz. Bağlantı URL'sini oluşturma.

• DriverManager sınıfındaki <name>=<value>nin Properties parametresindeki .

• sürücüsünün veri kaynağının uygun ayarlayıcı yöntemindeki değerler olarak. Örneğin:

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

Açıklamalar

• Özellik adları büyük/küçük harfe duyarlı değildir. Sürücü, yinelenen özellik adlarını aşağıdaki sırayla çözümler:

  1. "API bağımsız değişkenleri, user ve password gibi"
  2. Özellik koleksiyonu
  3. Bağlantı dizesindeki son örnek

• Özellik adları için bilinmeyen değerler kullanabilirsiniz. JDBC sürücüsü büyük/küçük harf duyarlılığını doğrulamaz.

• Eş anlamlıları kullanabilirsiniz. Sürücü, yinelenen özellik adlarında olduğu gibi bunları sırayla çözümler.

• SQL Server için Microsoft JDBC Sürücüsü, ANSI_DEFAULTS ve IMPLICIT_TRANSACTIONS dışında bağlantı özellikleri için sunucu varsayılan değerlerini alır. SQL Server için Microsoft JDBC Sürücüsü otomatik olarak ANSI_DEFAULTS'yi ON ve IMPLICIT_TRANSACTIONSOFF olarak ayarlar.

• Kimlik doğrulamasını ActiveDirectoryPassword [DEPRECATED] olarak ayarlarsanız, classpath'e şu kitaplığı ekleyin: microsoft-authentication-library-for-java. Maven Deposu'nda bulabilirsiniz. Kitaplığı ve bağımlılıklarını indirmenin en basit yolu Maven kullanmaktır:

  1. Maven'i sisteminize yükleyin.
  2. Sürücünün GitHub sayfasına gidin.
  3. pom.xml Dosyayı indirin.
  4. Kitaplığı ve bağımlılıklarını indirmek için aşağıdaki Maven komutunu çalıştırın: mvn dependency:copy-dependencies.

Özellikler

Aşağıdaki bölümlerde, JDBC sürücüsü için şu anda kullanılabilen tüm bağlantı dizesi özellikleri açıklanmaktadır.

accessToken

• Tür: String
• Varsayılan: null

(Sürüm 6.0+) Erişim belirteci kullanarak veritabanına bağlanmak için bu özelliği kullanın. Bağlantı URL'sini kullanarak ayarlayamazsınız accessToken .

accessTokenCallbackClass

• Tür: String
• Varsayılan: null

(Sürüm 12.4+) Erişim belirteci geri çağırması ile kullanılacak geri çağırmayı uygulayan sınıfın adı.

applicationIntent

• Tür: String
• Varsayılan: ReadWrite

(Sürüm 6.0+) Sunucuya bağlanmak için uygulama iş yükü türünü bildirir.

Olası değerler ReadOnly ve ReadWrite şeklindedir.

Olağanüstü durum kurtarma hakkında daha fazla bilgi için bkz. Yüksek Kullanılabilirlik, olağanüstü durum kurtarmaiçin JDBC sürücü desteği.

Applicationname

• Tür: String [<=128 char]
• Varsayılan: null

Uygulamanın adı, veya bir ad belirtmezseniz "SQL Server için Microsoft JDBC Sürücüsü".

Çeşitli SQL Server profil oluşturma ve günlüğe kaydetme araçlarında belirli bir uygulamayı tanımlamak için bu adı kullanın.

kimlik doğrulama

• Tür: String
• Varsayılan: NotSpecified

(Sürüm 6.0+) Bu isteğe bağlı özellik, bağlantı için hangi kimlik doğrulama yönteminin kullanılacağını gösterir.

Olası değerler , ActiveDirectoryIntegrated (sürüm 12.2+), ActiveDirectoryManagedIdentity (sürüm 7.2+), ActiveDirectoryMSI (sürüm 9.2+), ActiveDirectoryInteractive (sürüm 9.2+), ActiveDirectoryServicePrincipalActiveDirectoryPassword [DEPRECATED]ve varsayılan SqlPassworddeğerleridirNotSpecified.

Tümleşik Windows authentication kullanarak SQL'e bağlanmak için ActiveDirectoryIntegrated (sürüm 6.0+) kullanın.

Azure Kaynağı içinden SQL'e bağlanmak için ActiveDirectoryManagedIdentity (sürüm 12.2+) veya ActiveDirectoryMSI (sürüm 7.2+) kullanın. Örneğin, yönetilen kimlik doğrulaması kullanan Azure Sanal Makine, Uygulama Hizmeti veya İşlev Uygulaması.

ActiveDirectoryManagedIdentity veya ActiveDirectoryMSI kimlik doğrulama modu kullanılırken sürücü tarafından desteklenen iki tür yönetilen kimlik şunlardır:

• System-Assigned Yönetilen Kimlik: Varsayılan olarak accessToken edinmek için kullanılır.

• User-Assigned Yönetilen Kimlik: Yönetilen bir kimliğin İstemci Kimliği accessToken bağlantı özelliğiyle belirtilirse, msiClientId elde etmek için kullanılır.

Etkileşimli bir kimlik doğrulama akışı kullanarak veritabanına bağlanmak için kullanın ActiveDirectoryInteractive .

Sürüm 9.2+ ile ActiveDirectoryServicePrincipal kullanarak bir hizmet sorumlusu kimliğinin istemci kimliğini ve gizli dizisini kullanarak veritabanına bağlanın. userName özelliğinde istemci kimliğini ve password özelliğinde gizli anahtarı belirtin (10.2+).

Bir hizmet sorumlusu kimliğinin istemci kimliğini ve sertifikasını kullanarak bir veritabanına bağlanmak için ActiveDirectoryServicePrincipalCertificate (sürüm 12.4+) kullanın. userName özelliğine istemci kimliğini ve clientCertificate özelliğine sertifika yolunu belirtin.

Diğer seçenekler için bkz. ActiveDirectoryServicePrincipalCertificate kimlik doğrulama modunu kullanarak bağlanma.

Microsoft Entra asıl adı ve parola kullanarak SQL'e bağlanmak için ActiveDirectoryPassword [DEPRECATED] kullanın.

ActiveDirectoryPassword kullanım dışı bırakıldı.

Daha fazla bilgi için bkz. ActiveDirectoryPassword kimlik doğrulama modunu kullanarak bağlanma.

SqlPassword kullanarak SQL'e bağlanmak için userName özelliklerini kullanın/userpassword.

Bu kimlik doğrulama yöntemlerinden hiçbiri gerekli değilse kullanın NotSpecified .

Önemli

Kimlik doğrulaması ActiveDirectoryIntegrated olarak ayarlandıysa, şu iki kitaplık yüklenmelidir: mssql-jdbc_auth-<version>-<arch>.dll (JDBC sürücü paketinde kullanılabilir) ve SQL Server için Microsoft Authentication Library (ADAL.DLL). Microsoft Authentication Library, SQL Server için ODBC Sürücüsünü İndir veya SQL Server için Microsoft OLE DB Driver İndir bağlantılarından yüklenebilir. JDBC sürücüsü yalnızca ADAL.DLL için 1.0.2028.318 ve üzeri sürümünü destekler.

Kimlik doğrulama özelliğini NotSpecified dışında bir değere ayarladığınızda, sürücü varsayılan olarak daha önce Güvenli Yuva Katmanı (SSL) olarak bilinen Aktarım Katmanı Güvenliği (TLS) şifrelemesini kullanır.

Microsoft Entra kimlik doğrulamasını yapılandırma hakkında bilgi için Azure SQL için Microsoft Entra kimlik doğrulaması bölümüne bakın.

authenticationScheme

• Tür: String
• Varsayılan: NativeAuthentication

Uygulamanızın hangi tür tümleşik güvenlik kullanmasını istediğinizi gösterir.

Olası değerler , JavaKerberos (sürüm 7.4+) ve varsayılan NTLMdeğerleridirNativeAuthentication.

NativeAuthentication, sürücünün tümleşik kimlik doğrulama bilgilerini almak için kullanılan Windows mssql-jdbc_auth-<version>-<arch>.dll (örneğin, mssql-jdbc_auth-8.2.2.x64.dll) yüklemesine neden olur.

(Yüklenen yerel kimlik doğrulama kitaplığı, 6.0 ile 7.4 arası sürücü sürümleri kullanılırken adlandırılır sqljdbc_auth.dll .)

Kullanırken authenticationScheme=JavaKerberos, serverName veya serverSpn özelliğinde tam etki alanı adını (FQDN) belirtmeniz gerekir. Aksi takdirde bir hata oluşur (Sunucu Kerberos veritabanında bulunamadı).

authenticationScheme=JavaKerberos kullanma hakkında daha fazla bilgi için bkz. SQL Server bağlanmak için Kerberos tümleşik kimlik doğrulamasını kullanma.

authenticationScheme=NTLM kullanırken, domain veya domainName özelliğini, user veya userName özelliğindeki Windows kimlik bilgilerini ve password özelliğini kullanarak Windows etki alanını belirtmeniz gerekir. Aksi takdirde bir hata oluşur (bağlantı özellikleri belirtilmelidir).

topluEklemeIçinŞifreliDeğerDeğişikliklerineİzinVerilenTopluKopyalama

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 12.10+) olarak useBulkCopyForBatchInsertayarladığınızdatrue, verilerin şifresini çözmeden şifrelenmiş verilerin tablolar veya veritabanları arasında toplu olarak kopyalanmasını etkinleştirmek için bu seçeneği true olarak ayarlayın.

Bu özelliği kullanma hakkında daha fazla bilgi ve uyarı için allowEncryptedValueModifications seçeneğine bakın.

bulkCopyForBatchInsertBatchSize

• Tür: int
• Varsayılan: 0

(Sürüm 12.10+) olarak useBulkCopyForBatchInsertayarladığınızdatrue, bu özellik sürücünün toplu ekleme işlemlerinden oluşturduğu toplu kopyalama işlemleri için toplu iş boyutunu belirtir.

Bu ayarın etkileri hakkında daha fazla bilgi için BatchSize seçeneğine bakın.

bulkCopyForBatchInsertCheckConstraints

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 12.10+) kullanırken useBulkCopyForBatchInsert=true, veri eklerken denetim kısıtlamalarını etkinleştirmek için bu seçeneği true olarak ayarlayın. Denetim kısıtlamalarını devre dışı bırakmak için bu seçeneği false olarak ayarlayın.

Bu ayarın etkileri hakkında daha fazla bilgi için CheckConstraints seçeneğine bakın.

bulkCopyForBatchInsertFireTriggers

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 12.10+) kullandığınızda useBulkCopyForBatchInsert=true, veritabanına satır eklerken ekleme tetikleyicilerinin tetiklenmesine olanak tanımak için bu seçeneği true olarak ayarlayın. Ekleme tetikleyicilerini false devre dışı bırakmak için bu seçeneği ayarlayın.

Bu ayarın etkileri hakkında daha fazla bilgi için FireTriggers seçeneğine bakın.

bulkCopyForBatchInsertKeepIdentity

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 12.10+) kullandığınızda useBulkCopyForBatchInsert=true, veri eklerken kaynak kimlik değerlerini korumak için true bu seçeneği olarak ayarlayın. Kimlik değerlerini hedefe göre atama seçeneğini false olarak ayarlayın.

Bu ayarın etkileri hakkında daha fazla bilgi için KeepIdentity seçeneğine bakın.

bulkCopyForBatchInsertKeepNulls

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 12.10+) kullandığınızda useBulkCopyForBatchInsert=true, varsayılan değer ayarlarından bağımsız olarak hedef tablodaki null değerleri korumak için bu seçeneği true olarak ayarlayın. Hedef varsayılanlarının null değerleri değiştirmesine izin vermek için bu seçeneği false olarak ayarlayın.

Bu ayarın etkileri hakkında daha fazla bilgi için KeepNulls seçeneğine bakın.

bulkCopyForBatchInsertTableLock

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 12.10+) useBulkCopyForBatchInsert öğesini true olarak ayarladığınızda, toplu kopyalama işlemi sırasında toplu güncelleme kilidi almak için bu seçeneği true olarak ayarlayın. Bu seçeneği satır kilitlerini kullanacak şekilde false ayarlayın.

Bu ayarın etkileri hakkında daha fazla bilgi için TableLock seçeneğine bakın.

cacheBulkCopyMetadata

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 12.8+) kullanırken useBulkCopyForBatchInsert=true, bu özellik sürücüye hedef sütun meta verilerini bağlantı düzeyinde önbelleğe alıp almaması gerektiğini bildirir. trueolarak ayarlanmışsa, sürücünün bu değişikliği sağlayacak bir yolu olmadığından, hedefin toplu eklemeler arasında değişmediğinden emin olun.

calcBigDecimalPrecision

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 12.6+) Hassasiyet için izin verilen en yüksek değeri (38) kullanmak yerine, sürücünün BigDecimal veriler için hassasiyeti hesaplayıp hesaplamayacağını gösteren bir bayrak.

cancelQueryTimeout

• Tür: int
• Varsayılan: -1

(Sürüm 6.4+) Bağlantıdaki bir queryTimeout kümeyi iptal etmek için bu özelliği kullanın. Sunucuya TCP bağlantısı sessizce bırakılırsa sorgu yürütme yanıt vermeyi durdurur ve özel durum oluşturmaz. Bu özellik yalnızca bağlantıda da ayarlanmışsa queryTimeout geçerlidir.

Sürücü, bağlantıyı bırakmak ve kanalı kapatmak için toplam saniye miktarını cancelQueryTimeout + queryTimeout bekler.

Bu özelliğin varsayılan değeri -1 ve davranış süresiz olarak beklemektir.

clientCertificate

• Tür: String
• Varsayılan: null

(Sürüm 8.4+) İstemci sertifikası kimlik doğrulaması için kullanılacak sertifikanın konumunu belirtir. JDBC sürücüsü PFX, PEM, DER ve CER dosya uzantılarını destekler.

Ayrıntılar için bkz. Geri Döngü Senaryoları için İstemci Sertifikası Kimlik Doğrulaması.

clientKey

• Tür: String
• Varsayılan: null

(Sürüm 8.4+) özniteliği tarafından belirtilen PEM, DER ve CER sertifikaları için özel anahtarın clientCertificate konumunu belirtir.

Ayrıntılar için bkz. Geri Döngü Senaryoları için İstemci Sertifikası Kimlik Doğrulaması.

clientKeyPassword

• Tür: String
• Varsayılan: null

(Sürüm 8.4+) Dosyanın özel anahtarına erişmek için isteğe bağlı parola dizesini clientKey belirtir.

Ayrıntılar için bkz. Geri Döngü Senaryoları için İstemci Sertifikası Kimlik Doğrulaması.

sütunŞifrelemeAyarı

• Tür: String [Enabled | Disabled]
• Varsayılan: Disabled

(Sürüm 6.0+) Always Encrypted (AE) özelliğini kullanmak için Enabled olarak ayarlayın. AE etkinleştirildiğinde, JDBC sürücüsü sunucudaki şifrelenmiş veritabanı sütunlarında depolanan hassas verileri saydam bir şekilde şifreler ve şifresini çözer.

Always Encrypted hakkında daha fazla bilgi için bkz. JDBC sürücüsüyle Always Encrypted kullanma.

Not

Always Encrypted, SQL Server 2016 veya üzeri ve Azure SQL Veritabanı ile kullanılabilir.

concatNullYieldsNull

• Tür: String [ON | OFF]
• Varsayılan: ON

(Sürüm 13.2+) Bu seçeneği olarak OFFayarladığınızda, sürücü veritabanı oturum değişkenini CONCAT_NULL_YIELDS_NULLOFF bağlantı kurduğunda olarak ayarlar. Sonuç, bir null değeri bir dizeyle birleştirmek dizenin kendisini verir (null değer boş dize olarak kabul edilir).

Daha fazla bilgi için bkz. SET CONCAT_NULL_YIELDS_NULL.

connectRetryCount

• Tür: int [0..255]
• Varsayılan: 1

(Sürüm 9.4+) Bağlantı hatası olduğunda yeniden bağlanma denemelerinin sayısı.

connectRetryInterval

• Tür: int [1..60]
• Varsayılan: 10

(Sürüm 9.4+) Her bağlantı yeniden deneme girişimi arasındaki saniye sayısı.

databaseName, veritabanı

• Tür: String [<=128 char]
• Varsayılan: null

Bağlanacak veritabanının adı.

Veritabanı adı belirtmezseniz, bağlantı varsayılan veritabanını kullanır.

datetimeParameterType

• Tür: String [datetime | datetime2 | datetimeoffset]
• Varsayılan: datetime2

(Sürüm 12.2+) Java tarih ve zaman damgası parametreleri için kullanılacak SQL veri türü.

SQL Server 2016 veya sonraki sürümlerine bağlanıp eski datetime değerleriyle etkileşim kurduğunuzda, bu özelliği datetime olarak ayarlayın. Bu ayar, datetime ve datetime2 değerleri arasındaki sunucu tarafı dönüştürme sorunlarını azaltır.

Daha fazla bilgi için, SQL Server 2016'dan itibaren gerçekleşen datetime'dan datetime2'ye dönüştürme davranışı değişikliklerine bakın Addressing datetime to datetime2 conversion behavior change starting from SQL Server 2016.

delayLoadingLobs

• Tür: Boolean [true | false]
• Varsayılan: true

ResultSet'ten alınan tüm LOB nesnelerinin akışla aktarılıp aktarılmayacağını belirten bayrak. Bu özelliğin false ayarlanması, akış olmadan LOB nesnesinin tamamını belleğe yükler.

disableStatementPooling

• Tür: Boolean [true | false]
• Varsayılan: true

İfade havuzunun kullanılıp kullanılmayacağını belirten bayrak.

domainName, alan adı

• Tür: String
• Varsayılan: null

(Sürüm 7.4+) NTLM kimlik doğrulaması kullanılırken kimlik doğrulaması için Windows etki alanı.

enablePrepareOnFirstPreparedStatementCall (İlk hazırlanan ifade çağrısında hazırlamayı etkinleştir)

• Tür: Boolean [true | false]
• Varsayılan: false

true değerini, hazırlanmış deyimin ilk yürütmesinde sp_prepexec çağrılarak hazırlanmış deyim tanıtıcısı oluşturmayı etkinleştirmek için ayarlayın.

false değerine ayarlayın, böylece bir hazır deyimin ilk yürütmesinde sp_executesql çağrılır ve deyim hazırlanmamış olur. İkinci bir yürütme gerçekleşirse, hazırlanmış ifade tutucusunu ayarlamak için sp_prepexec'ı çağırır.

enclaveAttestationProtocol

• Tür: String
• Varsayılan: null

(Sürüm 8.2+) Bu isteğe bağlı özellik, güvenli kuşatmalarla Always Encrypted için kullanılacak kanıtlama protokolünü gösterir. Şu anda bu alan için desteklenen tek değerler HGS, AAS ve NONE'dir (NONE yalnızca 11.2+ sürümünde desteklenir).

Güvenli kuşatmalarla Always Encrypted hakkında daha fazla bilgi için bkz. JDBC sürücüsüyle güvenli kuşatmalarla Always Encrypted kullanma.

enclaveAttestationUrl

• Tür: String
• Varsayılan: null

(Sürüm 8.2+) Bu isteğe bağlı özellik, güvenli kuşatmalarla Always Encrypted için kullanılacak kanıtlama hizmeti uç noktası URL'sini gösterir.

Güvenli kuşatmalarla Always Encrypted hakkında daha fazla bilgi için bkz. JDBC sürücüsüyle güvenli kuşatmalarla Always Encrypted kullanma.

şifreleme

• Tür: String
• Varsayılan: null

SQL Database Engine, sunucuda yüklü bir sertifika varsa istemci ile sunucu arasında gönderilen tüm veriler için TLS şifrelemesi kullandığını belirtmek için true olarak ayarlayın. Varsayılan değer, sürüm 10.2 ve üzeri ile true 9.4 ve önceki sürümlerdedirfalse.

Sürüm 6.0 ve sonrasında, varsayılan olarak TLS şifrelemesi kullanan yeni bir bağlantı ayarı authentication vardır.

Bu özellik hakkında daha fazla bilgi için özelliğine authentication bakın.

Sürüm 11.2.0 ve sonraki sürümlerde, encrypt, Boolean'den string'ye değiştirildi ve özellik strict olarak ayarlandığında TDS 8.0 desteği sağlandı.

Sürüm 10.2'deki varsayılan değişiklik, hataya neden olan bir değişikliktir. 9.4 veya önceki bir sürümden yükseltme yapıyorsanız ve sunucunuz geçerli bir TLS sertifikasına sahip değilse, trustServerCertificate değerini true olarak ayarlayın veya geçerli bir sertifika sağlayın.

failoverPartner

• Tür: String
• Varsayılan: null

Veritabanı yansıtma yapılandırmasında kullanılan yük devretme sunucusunun adı. Bu özellik, asıl sunucuya ilk bağlantı hatası için kullanılır. İlk bağlantıyı yaptıktan sonra bu özellik yoksayılır. özelliğiyle databaseName kullanılmalıdır.

Not

Sürücü, bağlantı dizgisindeki failoverPartner özelliğinin bir parçası olarak yük devretme iş ortağı örneği için sunucu örneği port numarasını desteklemez. Ancak sürücü, ana sunucu örneğinin serverName, instanceName ve portNumber özelliklerini ve aynı bağlantı dizesi yük devretme iş ortağı örneğinin failoverPartner özelliğini belirtmeyi destekler.

Server bağlantı özelliğinde bir Sanal Ağ Adı belirtirseniz, veritabanı yansıtmayı kullanamazsınız.

Olağanüstü durum kurtarma hakkında daha fazla bilgi için bkz. Yüksek Kullanılabilirlik, olağanüstü durum kurtarmaiçin JDBC sürücü desteği.

FIPS

• Tür: Boolean [true | false]
• Varsayılan: false

FiPS özellikli Java Sanal Makine (JVM) için bu özelliği true olarak ayarlayın.

fipsProvider

• Tür: String
• Varsayılan: null

BCFIPS veya SunPKCS11-NSS gibi JVM'de yapılandırılmış FIPS sağlayıcısı. Sürüm 6.4.0'da kaldırıldı.

Daha fazla bilgi için bkz. GitHub sorunu 460.

gsscredential

• Tür: org.ietf.jgss.GSSCredential
• Varsayılan: null

(Sürüm 6.2+) Bu özellikte Kerberos Kısıtlanmış Yetkilendirme için kullanıcı kimlik bilgilerini geçirin.

Bu ayarı, integratedSecurity'yu true ve JavaKerberos'yi authenticationScheme olarak kullanarak ayarlayın.

hostNameInCertificate

• Tür: String
• Varsayılan: null

SQL Server TLS/SSL sertifikasını doğrulamak için kullanılacak ana bilgisayar adı.

hostNameInCertificate seçeneği, sertifikada kullanılan adın veya adların serverName özelliğine geçirilen adla eşleşmediği durumlarda konak adını belirtmek için kullanılabilir. Ancak bir eşleşme varsa seçeneği hostNameInCertificate kullanılmamalıdır.

hostNameInCertificate özelliğinin belirtilmemiş veya null olarak ayarlandığı durumlarda, SQL Server için Microsoft JDBC Sürücüsü, SQL Server TLS/SSL sertifikasını doğrulamak için bağlantı URL'sindeki serverName özellik değerini ana bilgisayar adı olarak kullanır.

Not

Önceki paragrafta açıklandığı gibi, sertifikadaki adın veya adların hostNameInCertificate seçenekte serverName geçirdiğiniz adlarla eşleşmediğinden emin olmadıkça seçeneği ayarlamayın.

Bu özelliği, encrypt, authentication ve trustServerCertificate özellikleri ile birlikte kullanın. Bu özellik, bağlantı TLS şifrelemesi kullanıyorsa ve trustServerCertificate olarak ayarlandıysa, sertifika doğrulamasını false etkiler. TlS bağlantısının başarılı olması için hostNameInCertificate geçirdiğiniz değerin sunucu sertifikasındaki Konu Diğer Adı'ndaki (SAN) Ortak Ad (CN) veya DNS adıyla eşleştiğinden emin olun.

Şifreleme desteği hakkında daha fazla bilgi için bkz. şifreleme desteğini anlama.

Örnek Adı

• Tür: String [<=128 char]
• Varsayılan: null

Bağlanacak veritabanı örneği adı. Bu özelliği belirtmediğinizde varsayılan örneğe bağlanırsınız. Hem instanceName hem de port belirttiğiniz durumunda port notları bölümüne bakın.

Server bağlantı özelliğinde bir Sanal Ağ Adı belirtirseniz, instanceName bağlantı özelliğini kullanamazsınız.

Olağanüstü durum kurtarma hakkında daha fazla bilgi için bkz. Yüksek Kullanılabilirlik, olağanüstü durum kurtarmaiçin JDBC sürücü desteği.

IntegratedSecurity

• Tür: Boolean [true | false]
• Varsayılan: false

Windows kimlik bilgilerinin Windows işletim sistemlerinde SQL Server tarafından kullanıldığını belirtmek için true olarak ayarlayın. ise true, JDBC sürücüsü yerel bilgisayar kimlik bilgisi önbelleğinde bir kullanıcı bilgisayarda veya ağda oturum açtığında sağlanan kimlik bilgilerini arar.

Kerberos kimlik bilgilerinin SQL Server tarafından kullanıldığını belirtmek için true (authenticationscheme=JavaKerberos ile) olarak ayarlayın.

Kerberos kimlik doğrulaması hakkında daha fazla bilgi için bkz. SQL Serverbağlanmak için Kerberos tümleşik kimlik doğrulamasını kullanma .

NTLM kimlik bilgilerinin SQL Server tarafından kullanıldığını belirtmek için true (authenticationscheme=NTLM ile) olarak ayarlayın.

ise false, kullanıcı adı ve parola sağlanmalıdır.

ipaddresspreference

• Tür: String [<=128 char]
• Varsayılan: IPv4First

İstemci uygulaması tarafından kullanılan IP tercihi.

IPV4First ile sürücü öncelikle IPv4 adreslerini tarar. Hiçbir IPv4 adresi başarıyla bağlanamıyorsa, sürücü devam eder ve varsa IPv6 adreslerini dener.

IPV6First ile sürücü önce IPv6 adreslerini geçer. Hiçbir IPv6 adresi başarıyla bağlanamıyorsa, sürücü devam eder ve varsa IPv4 adreslerini dener.

UsePlatformDefault ile, sürücü DNS çözümlemesiyle elde edilen IP adreslerini ilk sırayla geçmektedir.

jaasConfigurationName

• Tür: String
• Varsayılan: SQLJDBCDriver

(Sürüm 6.2+) SQL Server'a yapılan her bağlantı, kerberos bağlantısı kurmak için kendi JAAS Oturum Açma Yapılandırması adını kullanabilir. Bu özellik aracılığıyla yapılandırma girdisinin adını geçirebilirsiniz. Kerberos yapılandırma dosyası oluştururken bu özelliği kullanın. Varsayılan olarak, sürücü SQLJDBCDriveradını arar.

Eğer sürücü dış bir yapılandırma bulamazsa, IBM JVM'leri için useDefaultCcache=true ve diğer JVM'ler için useTicketCache=true ayarlar.

keyStoreAuthentication

• Tür: String
• Varsayılan: null

(Sürüm 6.0+) Bu özellik, Always Encrypted ile kullanılacak anahtar depoyu tanımlar ve anahtar deposunda kimlik doğrulaması yapmak için kullanılan bir kimlik doğrulama mekanizmasını belirler. Sürücü, keyStoreAuthentication=JavaKeyStorePassword ayarladığınızda Java Anahtar Deposu'nu sorunsuz bir şekilde ayarlamayı destekler. Bu özelliği kullanmak için Java Anahtar Deposu için keyStoreLocation ve keyStoreSecret özelliklerini de ayarlamanız gerekir.

Microsoft JDBC Sürücüsü 8.4'le başlayarak, yönetilen kimlikleri kullanarak Azure Key Vault kimlik doğrulaması yapmak için keyStoreAuthentication=KeyVaultManagedIdentity veya keyStoreAuthentication=KeyVaultClientSecret ayarlayabilirsiniz.

Always Encrypted hakkında daha fazla bilgi için bkz. JDBC sürücüsüyle Always Encrypted kullanma.

keyStoreLocation

• Tür: String
• Varsayılan: null

(Sürüm 6.0+) keyStoreAuthentication=JavaKeyStorePassword olduğunda, keyStoreLocation özelliği, Always Encrypted verileriyle kullanılacak Sütun Ana Anahtarını depolayan Java anahtar deposu dosyasının yolunu tanımlar. Yol, keystore dosya adını içermelidir.

Always Encrypted hakkında daha fazla bilgi için bkz. JDBC sürücüsüyle Always Encrypted kullanma.

keyStorePrincipalId

• Tür: String
• Varsayılan: null

(Sürüm 8.4+) keyStoreAuthentication=KeyVaultManagedIdentity olduğunda, keyStorePrincipalId özelliği geçerli bir Microsoft Entra uygulama istemci kimliği belirtir.

Always Encrypted hakkında daha fazla bilgi için bkz. JDBC sürücüsüyle Always Encrypted kullanma.

keyStoreSecret

• Tür: String
• Varsayılan: null

(Sürüm 6.0+) olduğunda keyStoreAuthentication=JavaKeyStorePasswordözelliği, keyStoreSecret anahtar deposu ve anahtar için kullanılacak parolayı tanımlar. Java Anahtar Deposu'nı kullandığınızda, anahtar deposu ve anahtar parolası aynı olmalıdır.

Always Encrypted hakkında daha fazla bilgi için bkz. JDBC sürücüsüyle Always Encrypted kullanma.

lastUpdateCount

• Tür: Boolean [true | false]
• Varsayılan: true

Değer true , sunucuya geçirdiğiniz sql deyiminden yalnızca son güncelleştirme sayısını döndürür. Sunucu tetikleyicilerinin oluşturabileceği diğer güncelleme sayılarını yoksaymak için bu değeri yalnızca tek bir SELECT, INSERT veya DELETE deyimiyle kullanın. Bu özelliği, sunucu tetikleyicilerinin döndüreceği güncelleştirme sayıları da dahil olmak üzere tüm güncelleştirme sayılarını döndürecek şekilde false olarak ayarlayın.

Not

Bu özellik yalnızca executeUpdate yöntemleriyle kullandığınızda geçerlidir. Diğer tüm yürütme yöntemleri tüm sonuçları ve güncelleştirme sayılarını döndürür. Bu özellik yalnızca sunucu tetikleyicilerinin döndüreceği güncelleştirme sayılarını etkiler. Tetikleyici yürütmesinin bir parçası olarak sonuç veren sonuç kümelerini veya hataları etkilemez.

Locktimeout

• Tür: int
• Varsayılan: -1

Veritabanının bir kilit zaman aşımı bildirmesinden önce belirtilen milisaniye sayısı. Varsayılan davranış süresiz beklemektir. Bu özellik için bir değer belirtmezseniz, bu değer bağlantıdaki tüm deyimler için varsayılan değerdir.

Alternatif olarak, belirli deyimler için sorgu zaman aşımını ayarlamak için kullanın Statement.setQueryTimeout() . Değer, bekleme olmadığını belirten 0 olabilir.

Logintimeout

• Tür: int [0..65535]
• Varsayılan: 30 (sürüm 11.2 ve üzeri) veya 15 (sürüm 10.2 ve öncesi)

Başarısız bir bağlantının zaman aşımına uğramasından önce sürücünün beklemesi gereken saniye sayısı. Sıfır değeri, zaman aşımının varsayılan sistem zaman aşımı olduğunu gösterir. Bu değer 30 saniye (sürüm 11.2 ve üzeri için varsayılan) veya 15 saniyedir (sürüm 10.2 ve önceki sürümlerde varsayılan). Sıfır olmayan bir değer, başarısız bir bağlantının zaman aşımına uğraması için sürücünün beklemesi gereken saniye sayısıdır.

Server bağlantı özelliğinde bir Sanal Ağ Adı belirtirseniz, yük devretme bağlantısının başarılı olması için üç dakika veya daha fazla bir zaman aşımı değeri belirtin; böylece yeterli süre sağlanmış olur.

Olağanüstü durum kurtarma hakkında daha fazla bilgi için bkz. Yüksek Kullanılabilirlik, olağanüstü durum kurtarmaiçin JDBC sürücü desteği.

maxResultBuffer

• Tür: String
• Varsayılan: null

(Sürüm 9.2+) Sonuç kümesi okunurken okunacak bayt sayısı üst sınırını ayarlamak için kullanın maxResultBuffer . Bu değeri belirtmezseniz, sürücü sonuç kümesinin tamamını okur. Boyutu iki stilde belirtebilirsiniz:

• Bayt cinsinden boyut olarak (örneğin, 100, 150M, 300K, 400G).
• En yüksek yığın belleği yüzdesi olarak (örneğin, 10p, 15pct, 20percent).

msiClientId

• Tür: String
• Varsayılan: null

(Kullanım dışı) (Sürüm 7.2+) accessToken veya ActiveDirectoryManagedIdentity kimlik doğrulama modunu kullanarak bağlantı kurmak için bir ActiveDirectoryMSI edinmek üzere kullanılan Yönetilen Kimliğin (MSI) İstemci Kimliği.

multiSubnetFailover

• Tür: Boolean [true | false]
• Varsayılan: false

Bir SQL Server kullanılabilirlik grubunun veya SQL Server Yük Devretme Kümesi Örneğinin kullanılabilirlik grubu dinleyicisine bağlanmak için her zaman multiSubnetFailover=true belirtin. multiSubnetFailover=true etkin sunucuya daha hızlı algılama ve bağlantı sağlamak için sürücüyü yapılandırır.

Olası değerler true ve false şeklindedir.

Olağanüstü durum kurtarma hakkında daha fazla bilgi için bkz. Yüksek Kullanılabilirlik, olağanüstü durum kurtarmaiçin JDBC sürücü desteği.

multiSubnetFailover, getMultiSubnetFailover ve setMultiSubnetFailover kullanarak bağlantı özelliğine program aracılığıyla erişebilirsiniz.

Not

SQL Server için Microsoft JDBC Sürücüsü 6.0'da başlayarak, kullanılabilirlik grubu dinleyicisine bağlanmak için multiSubnetFailover'yi true olarak ayarlamanız gerekmez. Varsayılan olarak etkin olan yeni bir özellik transparentNetworkIPResolution, etkin sunucuya yönelik algılama ve bağlantı sağlar.

packetSize

• Tür: int [-1 | 0 | 512..32767]
• Varsayılan: 8000

Sunucuyla iletişim kurmak için kullanılan ve bayt cinsinden belirtilen ağ paketi boyutu. -1 değeri, sunucunun varsayılan paket boyutunun kullanılacağını gösterir. 0 değeri, en fazla 32767 değerinin kullanılacağını gösterir. Bu özelliği kabul edilebilir aralığın dışındaki bir değere ayarlarsanız bir özel durum oluşur.

Önemli

Şifreleme etkinleştirildiğinde (packetSize) özelliğini kullanmayınencrypt=true. Aksi takdirde, sürücü bir bağlantı hatası verebilir.

Bu özellik hakkında daha fazla bilgi için SQLServerDataSource sınıfının setPacketSize yöntemine bakın.

parola

• Tür: String [<=128 char]
• Varsayılan: null

SQL kullanıcısı ve parolası ile bağlanırsanız veritabanı parolası.

Asıl ad ve parola ile Kerberos bağlantısı için bu özelliği Kerberos Asıl parolası olarak ayarlayın.

(Sürüm 10.2+) authentication=ActiveDirectoryServicePrincipal olduğunda, password özelliği Active Directory sorumlusu için kullanılacak parolayı tanımlar.

bağlantıNoktasıNumarası, bağlantı noktası

• Tür: int [0..65535]
• Varsayılan: 1433

Sunucunun dinlediği bağlantı noktası. Bağlantı dizesindeki port numarasını belirtirseniz, SQLbrowser'a istek yapılmaz. Bağlantı noktasıyla instanceName değerini belirttiğinizde, bağlantı belirtilen bağlantı noktasına yapılır. Ancak, instanceName doğrulanır ve bağlantı noktasıyla eşleşmiyorsa bir hata oluşur.

Önemli

SQLbrowser kullanmaktan daha güvenli olduğundan her zaman bağlantı noktası numarasını belirtin.

prepareMethod

• Tür: String [prepexec | prepare | scopeTempTablesToConnection | none]
• Varsayılan: prepexec

(Sürüm 11.2.0+) Sürücünün hazırlanmış deyimlerle kullandığı temel hazırlama yöntemini belirtir.

prepare hazırlama yöntemi olarak kullanılacak sp_prepare şekilde ayarlayın. prepareMethod bu değere ayarlandığında, veritabanının yürütme planında herhangi bir başlangıç değeri olmaksızın deyimini hazırlamak üzere ayrı bir ilk sorgu yapılır. prepexec hazırlama yöntemi olarak kullanılacak sp_prepexec şekilde ayarlayın. Bu yöntem, hazırlama eylemini ilk yürütme ile birleştirir ve gidiş dönüşleri azaltır. Ayrıca veritabanına, veritabanının yürütme planında göz önünde bulundurabileceği ilk parametre değerlerini de sağlar.

(Sürüm 13.4.0+) scopeTempTablesToConnection Sunucu tarafı tarafından hazırlanan tanıtıcılar yerine değişmez parametre değişimini kullanarak, hazırlanan deyimlerde oluşturulan geçici tabloların bağlantı kapsamına ayarlayın. none değerini SQL toplu yürütmesi ile değişmez parametre ikamesini zorlamak için ayarlayın, sunucu tarafında hazırlanan deyim tanıtıcılarını atlayın.sp_prepexec / sp_prepare

scopeTempTablesToConnection ve none için sınırlamalar ve sorumluluk reddi:

Bu prepareMethod seçenekler genel performans kullanımına değil, uyumluluk ve geçiş senaryolarına yöneliktir.

• Sunucu tarafında hazırlanmış ifade yok; SQL her zaman toplu iş olarak yürütülür.
• Etkili planların yeniden kullanılabilmesi için FORCED_PARAMETERIZATION gereklidir.
• Parametreler, bağlı türler yerine değişmez değer olarak çizilir.
• Sayısal duyarlık ve ölçek, sunucu tarafı parametre bağlamasından farklı olabilir.
• Tarih ve saat değerleri sürücü tarafından dize olarak biçimlendirilir.
• Büyük dize parametreleri SQL metin boyutunu ve bellek kullanımını artırır.
• BLOB ve CLOB parametreleri yüksek bellek kullanımına veya yetersiz bellek koşullarına neden olabilir.
• SQL Server SQL ayrıştırma zamanında parametre veri türlerini çıkarsar.
• Sorgu planları sabit değerlerdeki farklılıklara bağlı olarak farklılık gösterebilir.
• Hatalar bağlama zamanında değil yürütme zamanında algılandı.
• Yürütülen SQL sabit değerler içerir ve sunucu günlüklerinde ve izlerinde görülür.

Querytimeout

• Tür: int
• Varsayılan: -1

Bir sorguda zaman aşımı gerçekleşmeden önce bekleme süresi olarak belirlenen saniye sayısı. Varsayılan değer -1'dir ve bu da sonsuz zaman aşımı anlamına gelir. Bu değeri 0 olarak ayarlamak, süresiz olarak beklemeyi de gösterir.

quotedIdentifier

• Tür: String [ON | OFF]
• Varsayılan: ON

(Sürüm 13.2+) Bu seçeneği olarak OFFayarladığınızda, sürücü veritabanı oturum değişkenini QUOTED_IDENTIFIEROFF bağlantı kurduğunda olarak ayarlar. Veritabanı, çift tırnak işaretlerini karakter değişmez değerleri için dize sınırlayıcıları olarak ele alır ve tanımlayıcıları çift tırnak içine alamazsınız.

Daha fazla bilgi için bkz. SET QUOTED_IDENTIFIER.

Bölge

• Tür: String
• Varsayılan: null

(Sürüm 9.4+) Kerberos kimlik doğrulaması için bölge. Sunucunun alanından sürücü otomatik olarak algılar Kerberos kimlik doğrulama alanını geçersiz kılmak için bu değeri ayarlayın.

Çoğaltma

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 9.4+) Bu ayar, sunucuya bağlantının çoğaltma için kullanılıp kullanılmadiğini bildirir. Etkinleştirildiğinde, NOT FOR REPLICATION seçeneğine sahip tetikleyiciler bağlantı üzerinde çalışmaz.

responseBuffering

• Tür: String [full | adaptive]
• Varsayılan: adaptive

Bu özelliği adaptive olarak ayarlarsanız, sürücü gerektiğinde minimum veri miktarını arabelleğe alır. Varsayılan mod şeklindedir adaptive.

Bu özelliği olarak fullayarlarsanız, sürücü bir deyimi yürütürken sunucudan sonuç kümesinin tamamını okur.

Not

JDBC sürücüsü sürüm 1.2'den başlayarak varsayılan arabelleğe alma davranışı şeklindedir adaptive. Uygulamanızda sürüm 1.2 varsayılan davranışını kullanmak için, responseBuffering özelliğini bağlantı özelliklerinde veya full nesnesinin setResponseBuffering yöntemini kullanarak ayarlayın.

Selectmethod

• Tür: String [direct | cursor]
• Varsayılan: direct

Bu özelliği cursor olarak ayarlarsanız, sürücü TYPE_FORWARD_ONLY ve CONCUR_READ_ONLY imleçleri için bağlantıda oluşturduğu her sorgu için bir veritabanı imleci oluşturur. Genellikle, yalnızca uygulamanız istemci belleğine tamamen sığmayan büyük sonuç kümeleri oluşturuyorsa bu özelliğe ihtiyacınız vardır. Bu özelliği olarak cursorayarlarsanız, sürücü istemci belleğinde yalnızca sınırlı sayıda sonuç kümesi satırı tutar.

Varsayılan olarak, sürücü tüm sonuç kümesi satırlarını istemci belleğinde tutar. Bu varsayılan davranış, uygulama tüm satırları işlerken en hızlı performansı sağlar.

sendStringParametersAsUnicode

• Tür: Boolean [true | false]
• Varsayılan: true

özelliğini sendStringParametersAsUnicodeolarak ayarlarsanıztrue, sürücü dize parametrelerini Unicode biçiminde sunucuya gönderir.

özelliğini sendStringParametersAsUnicodeolarak ayarlarsanızfalse, sürücü sunucuya Unicode yerine ASCII veya MBCS gibi Unicode olmayan biçimlerde dize parametreleri gönderir.

özelliği için sendStringParametersAsUnicode varsayılan değerdir true.

Not

Sürücü, yalnızca sendStringParametersAsUnicode, CHAR, VARCHAR veya LONGVARCHAR JDBC türleriyle bir parametre değeri gönderirken özelliği denetler. Yeni JDBC 4.0 ulusal karakter yöntemleri, setNString ve setNCharacterStream sınıflarının setNClob, ve yöntemlerini içerir. Bu yöntemler, bu özelliğin ayarından bağımsız olarak parametre değerlerini her zaman Unicode olarak sunucuya gönderir.

, ve JDBC veri türleriyle en iyi performansı elde etmek için, bir uygulamanın özelliğini olarak ayarlaması ve SQLServerPreparedStatement Sınıfı ile SQLServerCallableStatement Sınıfı sınıflarının ulusal olmayan karakter yöntemlerini kullanması gerekir.

Uygulama, özelliği sendStringParametersAsUnicode ve false olarak ayarladığında ve sunucu tarafındaki Unicode veri türlerine erişmek için ulusal olmayan bir karakter yöntemi (örneğin, nchar, nvarchar ve ntext) kullandığında, veritabanı sıralaması, ulusal olmayan karakter yöntemiyle aktarılan String karakterlerini desteklemiyorsa bazı veriler kaybolabilir.

Bir uygulama, , setNStringve setNCharacterStream JDBC veri türleri için setNClobSQLServerPreparedStatement Sınıfı ve SQLServerCallableStatement Sınıfı sınıflarının , NCHARve NVARCHAR ulusal karakter yöntemlerini kullanmalıdırLONGNVARCHAR.

Bu değerin değiştirilmesi, veritabanındaki sonuçların sıralanmasında etkilenebilir. Sıralama farklılıkları, Unicode olmayan karakterler yerine Unicode için farklı sıralama kurallarından kaynaklanır.

sendTemporalVeriTipleriniTopluKopyaOlarakDiziGibiGönder

• Tür: Boolean [true | false]
• Varsayılan: true

(Sürüm 8.4+) Bu bağlantı özelliğini olarak falseayarladığınızda, sürücü DATE, DATETIME, , DATETIME2DATETIMEOFFSET, SMALLDATETIMEve TIME veri türlerini olarak göndermek yerine ilgili türler olarak Stringgönderir.

Bu bağlantı özelliğini olarak falseayarladığınızda, sürücü her zamansal veri türünün varsayılan dize değişmez biçimini kabul eder, örneğin:

• 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

• Tür: Boolean [true | false]
• Varsayılan: true

Bu özellik SQL Server JDBC Sürücüsü 3.0'a eklendi.

• java.sql.Time değerlerini sunucuya SQL Server true değerleri olarak göndermek için datetime olarak ayarlayın.

• java.sql.Time değerlerini sunucuya SQL Server false değerleri olarak göndermek için time olarak ayarlayın.

Bu özelliğin varsayılan değeri şu anda true ve gelecekteki bir sürümde değişebilir.

SQL Server için Microsoft JDBC Sürücüsünün java.sql.Time değerlerini sunucuya göndermeden önce nasıl yapılandırıldığı hakkında daha fazla bilgi için bkz. java.sql.Time değerlerinin nasıl gönderildiğini yapılandırma.

serverCertificate, sunucu

• Tür: String
• Varsayılan: null

(Sürüm 11.2.0+) Sunucu sertifika dosyasının yolu. Sürücü, doğrulama için encrypt'i strict olarak ayarladığınızda bu sertifikayı kullanır. Sürücü, PEM dosya biçimini kullanan sertifika dosyalarını destekler.

serverName, sunucu

• Tür: String
• Varsayılan: null

SQL Server veya Azure SQL veritabanı çalıştıran bilgisayar.

Kullanılabilirlik grubunun Sanal Ağ Adını da belirtebilirsiniz.

Olağanüstü durum kurtarma hakkında daha fazla bilgi için bkz. Yüksek Kullanılabilirlik, olağanüstü durum kurtarmaiçin JDBC sürücü desteği.

serverNameAsACE

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 6.0+) true Sürücünün bağlantı için Unicode sunucu adını ASCII uyumlu kodlamaya (Punycode) çevirmesi gerektiğini belirtmek üzere olarak ayarlayın. Bu ayar ise false, sürücü bağlanmak için sağlanan sunucu adını kullanır.

Uluslararası özellikler hakkında daha fazla bilgi için bkz. JDBC sürücüsünün uluslararası özellikleri.

serverPreparedStatementDiscardThreshold

• Tür: int
• Varsayılan: 10

(Sürüm 6.2+) Sürücü sunucudaki bekleyen tanıtıcıları temizlemeden önce bağlantı başına kaç bekleyen hazır deyim atma eyleminin (sp_unprepare) geri alınabileceğini denetlemek için bu özelliği kullanın.

Bu özelliği olarak <= 1ayarlarsanız, sürücü hazır olmayan eylemleri hemen hazır deyim kapatmada yürütür. Özelliği > 1 olarak ayarlarsanız, sürücü bu çağrıları sp_unprepare ile bir araya getirir, böylece sık sık çağrı yapmanın getirdiği yükten kaçınılır.

serverSpn

• Tür: String
• Varsayılan: null

(Sürüm 4.2+) Java Kerberos bağlantısı için Hizmet Asıl Adını (SPN) belirtmek için bu isteğe bağlı özelliği kullanın. Bunu authenticationScheme ile kullanın.

SPN'yi belirtmek için şu formu kullanın: MSSQLSvc/fqdn:port@REALM burada fqdn tam etki alanı adı, bağlantı noktası numarası ve REALM büyük harflerle SQL Server Kerberos alanıdır.

Not

İstemcinin varsayılan bölgesi (Kerberos yapılandırmasında belirtildiği gibi) SQL Server için Kerberos bölgesi ile aynıysa @REALM isteğe bağlıdır.

Java Kerberos ile serverSpn kullanma hakkında daha fazla bilgi için bkz. SQL Server'e bağlanmak için Kerberos tümleşik kimlik doğrulamasını kullanma.

socketFactoryClass

• Tür: String
• Varsayılan: null

(Sürüm 8.4+) Varsayılan yuva fabrikası yerine kullanılacak özel yuva fabrikasının sınıf adını belirtir.

socketTimeout

• Tür: int
• Varsayılan: 0

Zaman aşımı oluşmadan önce bir soket üzerinde okuma veya kabul sırasında beklenecek milisaniye sayısı. Varsayılan değer 0'dır ve bu da sonsuz zaman aşımı anlamına gelir.

statementPoolingCacheSize

• Tür: int
• Varsayılan: 0

(Sürüm 6.4+) Bu özelliği, sürücü tarafından hazırlanmış ifade işlemcisi önbelleğini etkinleştirmek için kullanın.

Bu özellik, ifade havuzunun önbellek boyutunu tanımlar.

Bu özelliği yalnızca, disableStatementPooling olarak ayarlamanız gereken false bağlantı özelliğiyle kullanın. disableStatementPooling ayarını true'e veya statementPoolingCacheSize'yi 0'a ayarlayarak hazırlanan deyim işleme önbelleğini devre dışı bırakır.

sslProtocol

• Tür: String
• Varsayılan: TLS

(Sürüm 6.4+) Güvenli bağlantı sırasında dikkate alınacak TLS protokolünü belirtmek için bu özelliği kullanın.

Olası değerler şunlardır: TLS, TLSv1, TLSv1.1ve TLSv1.2.

Güvenli Yuva Katmanı protokolü hakkında daha fazla bilgi için bkz. SSLProtocol.

transparentNetworkIPResolution

• Tür: Boolean [true | false]
• Varsayılan: true

(Sürüm 6.0+) Bu özellik, etkin sunucuya daha hızlı algılama ve bağlantı sağlar. Bunu true veya false olarak ayarlayın. Varsayılan değer şudur: true.

Microsoft JDBC Sürücüsü 6.0'dan önce SQL Server için, bir uygulamanın, Always On Kullanılabilirlik Grubuna bağlandığını belirtmek için bağlantı dizesi 'e multiSubnetFailover=true dahil etmesi gerekirdi. Uygulama, Bağlantı anahtar sözcüğü multiSubnetFailovertrue olarak ayarlanmadan, Always On Kullanılabilirlik Grubu'na bağlanırken bir zaman aşımıyla karşılaşabilir. Sürüm 6.0'dan itibaren, bir uygulamanın multiSubnetFailover öğesini true olarak ayarlaması artık gerekmez.

Not

Federasyon kimlik doğrulamasını kullandığınızda veya multisubnetfailover belirttiğinizde, sürücü varsayılan olarak transparentNetworkIPResolution devre dışı bırakır. Bu özelliği etkinleştirmek için transparentNetworkIPResolution değerini açıkça true olarak ayarlayın.

olduğunda transparentNetworkIPResolution=true, ilk bağlantı girişimi zaman aşımı olarak 500 ms kullanır. Sonraki girişimlerinde, multiSubnetFailover özelliği tarafından kullanılan zaman aşımı mantığı aynı şekilde kullanılır.

trustManagerClass

• Tür: String
• Varsayılan: null

(Sürüm 6.4+) Özel javax.net.ssl.TrustManager uygulamasının tam sınıf adı.

trustManagerConstructorArg

• Tür: String
• Varsayılan: null

(Sürüm 6.4+) TrustManager oluşturucusuna geçirmek için isteğe bağlı bir bağımsız değişken. trustManagerClass özelliğini belirtirseniz ve şifreli bir bağlantı talep ederseniz, sürücü, varsayılan sistem JVM anahtar deposu tabanlı TrustManager yerine özel TrustManager kullanır.

Trustservercertificate

• Tür: Boolean [true | false]
• Varsayılan: false

true Sürücünün sunucu TLS/SSL sertifikasını doğrulamadığını belirtmek için olarak ayarlayın.

• Eğer true, iletişim katmanı TLS kullanılarak şifrelendiğinde sunucu TLS/SSL sertifikasına otomatik olarak güvenilir kabul edilir.

• ise false, sürücü sunucu TLS/SSL sertifikasını doğrular. Sunucu sertifikası doğrulaması başarısız olursa, sürücü bir hata oluşturur ve bağlantıyı kapatır. Varsayılan değer şudur: false. TLS/SSL bağlantısının başarılı olması için geçirilen serverName değerin sunucu sertifikasındaki Konu Diğer Adı'ndaki Ortak Ad (CN) veya DNS adıyla tam olarak eşleştiğinden emin olun.

Şifreleme desteği hakkında daha fazla bilgi için bkz. şifreleme desteğini anlama.

Not

encrypt ve authentication özellikleriyle bu özelliği kullanın. Bu özellik yalnızca bağlantı TLS şifrelemesi kullanıyorsa sunucu TLS/SSL sertifika doğrulamasını etkiler.

trustStore

• Tür: String
• Varsayılan: null

Sertifika trustStore dosyasının yolu (dosya adı dahil). Dosya, trustStore istemcinin güvendiği sertifikaların listesini içerir.

Bu özelliği belirtmediğinizde veya null olarak ayarlamadığınızda, sürücü hangi sertifika deposunun kullanılacağına karar vermek için güven yöneticisi fabrikasının arama kurallarını kullanır.

Varsayılan SunX509 TrustManagerFactory, güvenilen malzemeyi aşağıdaki arama sırasına göre bulmaya çalışır:

1. JVM sistem özelliği tarafından javax.net.ssl.trustStore belirtilen bir dosya.
2. <java-home>/lib/security/jssecacerts dosyası.
3. <java-home>/lib/security/cacerts dosyası.

SUNX509 TrustManager Arabirimi hakkında daha fazla bilgi için Sun Microsystems Web sitesindeki SUNX509 TrustManager Arabirimi belgelerine bakın.

Not

Bu özellik, yalnızca bağlantı TLS şifrelemesi kullanıyorsa ve trustStore özelliği trustServerCertificate olarak ayarlandıysa sertifika false aramasını etkiler.

trustStorePassword

• Tür: String
• Varsayılan: null

Verilerin bütünlüğünü trustStore denetlemek için kullanılan parola.

Eğer trustStore özelliğini ayarlarsanız ama trustStorePassword özelliğini ayarlamazsanız, sürücü, trustStore bütünlüğünü denetlemez.

Belirtmediğinizde trustStore ve trustStorePassword özelliklerini, sürücü JVM sistem özelliklerini, javax.net.ssl.trustStore ve javax.net.ssl.trustStorePassword kullanır. Eğer javax.net.ssl.trustStorePassword sistem özelliğini belirtmezseniz, sürücü trustStore bütünlüğünü kontrol etmez.

Eğer trustStore özelliğini ayarlamaz ancak trustStorePassword özelliğini ayarlarsanız, JDBC sürücüsü, javax.net.ssl.trustStore tarafından belirtilen dosyayı bir güvenlik deposu olarak kullanır. Sürücü, belirtilen trustStorePasswordöğesini kullanarak güven deposunun bütünlüğünü denetler. İstemci uygulaması parolayı JVM sistem özelliğinde depolamak istemediği durumlarda bu ayar gereklidir.

Not

trustStorePassword özelliği, yalnızca bağlantı TLS bağlantısı kullanıyorsa ve trustStore özelliği trustServerCertificate olarak ayarlandıysa sertifika false aramasını etkiler.

trustStoreType

• Tür: String
• Varsayılan: JKS

FIPS modu için kullanılacak güven deposu türünü belirtmek için bu özelliği ayarlayın.

Olası değerler ya PKCS12 ya da FIPS sağlayıcısı tarafından tanımlanan türdür.

useBulkCopyForBatchInsert

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 9.2+) Bu bağlantı özelliğini etkinleştirdiğinizde, sürücü java.sql.PreparedStatement kullanan toplu ekleme işlemleri için Toplu Kopyalama API'sini otomatik olarak kullanır. Bu özellik daha iyi performans sağlayabilir.

Bu özellik varsayılan olarak devre dışıdır. Etkinleştirmek için bu özelliği olarak true ayarlayın.

Önemli

Bu özellik yalnızca tam parametreli INSERT sorguları destekler. Sorguları diğer SQL sorguları ile birleştirirseniz INSERT veya sorgular değerlerde veri içeriyorsa yürütme temel toplu ekleme işlemine geri döner.

Bu özelliği kullanma hakkında daha fazla bilgi için bkz. Toplu ekleme işlemi için toplu kopyalama API'sini kullanma.

useDefaultGSSCredential

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 12.6+) Kerberos kimlik doğrulaması için Yerel GSS-API kullanmak amacıyla sürücünün kullanıcı adına GSSCredential oluşturup oluşturmayacağını belirleyen bir işaret.

useDefaultJaasConfig

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 12.6+) Uygulama, JAAS'yi sistem düzeyinde yapılandıran kitaplıklarla birlikte mevcut olduğunda, sürücünün Kerberos kimlik doğrulamasını gerçekleştirmek için aynı yapılandırmayı kullanmasına izin vermek için bu özelliği true olarak ayarlayın.

useFmtOnly

• Tür: Boolean [true | false]
• Varsayılan: false

(Sürüm 7.4+) Parametre Meta Verilerini sunucudan sorgulamak için alternatif bir yol sağlar. Bu özelliği true olarak ayarlayın, böylece sürücünün Parametre Meta Verilerini sorgularken SET FMTONLY mantığını kullanması sağlanır. Bu özellik varsayılan olarak kapalıdır ve SET FMTONLY kullanımdan kaldırılmak üzere işaretlendiğinden bu özelliğin kullanılması önerilmez. useFmtOnly yalnızca sp_describe_undeclared_parameters'daki bilinen sorunlar ve sınırlamalar için geçici bir çözüm olarak kullanılabilir.

Bu özellik şu anda yalnızca tek SELECT/INSERT/UPDATE/DELETE sorgularını destekler. Bu özelliği desteklenmeyen/birden çok sorguyla kullanmaya çalışmak, sürücünün sorguyu ayrıştırmaya çalışmasına neden olur, ancak büyük olasılıkla bir özel durumla sonuçlanır.

Bu özellik hakkında daha fazla bilgi için bkz. useFmtOnlyParameterMetaData'yı Alma aracılığıyla.

kullanıcıAdı, kullanıcı

• Tür: String [<=128 char]
• Varsayılan: null

SQL kullanıcı ve parola kullanarak bağlanıyorsanız veritabanı kullanıcısı.

Asıl ad ve parola kullanarak Kerberos bağlantısı için bu özelliği Kerberos Asıl adı olarak ayarlayın.

(Sürüm 10.2+) authentication=ActiveDirectoryServicePrincipal olduğunda, userName özelliği geçerli bir Microsoft Entra güvenli istemci kimliği belirtir.

vectorTypeSupport

• Tür: String [v2 | v1 | off]
• Varsayılan: v1

(Sürüm 13.2+) off Sunucunun vektör türlerini JSON biçiminde dize verileri olarak gönderdiğini ve v1 sunucunun vektör türlerini vektör verileri olarak gönderdiğini FLOAT32 belirtmek için olarak ayarlayın. Varsayılan değer şudur: v1.

(Sürüm 13.4+) v2'yi, FLOAT32 ve FLOAT16 vektörleri için yerel vektör türü desteğini etkinleştirmek amacıyla ayarlayın. FLOAT16 vektörleri, ağ üzerinden IEEE-754 yarı duyarlıklı serileştirilmesi kullanır ve Java'da Float[] dizileri olarak gösterilir.

Daha fazla bilgi için bkz. JDBC sürücüsüyle vektör veri türünü kullanma.

workstationID

• Tür: String [<=128 char]
• Varsayılan: <empty string>

İş istasyonu kimliği. Çeşitli profil oluşturma ve günlüğe kaydetme araçlarında belirli iş istasyonunu tanımlamak için bu kimliği kullanın.

Bir değer belirtmezseniz, varsayılan değer olur <empty string>.

xopenStates

• Tür: Boolean [true | false]
• Varsayılan: false

true Özel durumlarda sürücünün XOPEN uyumlu durum kodları döndüreceğini belirtmek için olarak ayarlayın.

Varsayılan değer SQL 99 durum kodlarını döndürmektir.

İlgili içerik

• JDBC sürücüsüyle SQL Server'a bağlanma
• FIPS modu