Megosztás a következőn keresztül:


A kapcsolat tulajdonságainak beállítása

JDBC-illesztőprogram letöltése

A kapcsolati sztring tulajdonságai többféleképpen is megadhatók:

  • A kapcsolat URL-jében name=value tulajdonságként, amikor a DriverManager osztályt használva kapcsolódik. A kapcsolati sztring szintaxisát A kapcsolati URL-cím létrehozásacímű témakörben talál.

  • Nevekkel=érték tulajdonságokként a Tulajdonságok paraméterben a Csatlakozás metódusban a DriverManager osztályban.

  • Az illesztőadatforrásának megfelelő beállító metódusának értékeiként. Például:

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

Megjegyzések

A tulajdonságnevek nem nagybetű-érzékenyek, és a duplikált tulajdonságnevek a következő sorrendben oldódnak fel:

  1. API-argumentumok (például felhasználó és jelszó)
  2. Tulajdonsággyűjtemény
  3. Utolsó előfordulás a kapcsolati láncban

A tulajdonságnevek számára ismeretlen értékek engedélyezettek, és a JDBC-illesztő nem ellenőrzi a kis- és nagybetűk érzékenységét.

A szinonimák engedélyezettek, és sorrendben kerülnek feldolgozásra, csakúgy, mint a duplikált tulajdonságnevek.

Tulajdonságok

Az alábbi táblázat a JDBC-illesztő jelenleg elérhető kapcsolati sztring-tulajdonságait sorolja fel.

Ingatlan
Típus
Alapértelmezett
Leírás
accessToken

Zsinór

null
(6.0-s verzió+) Ezzel a tulajdonságtal hozzáférési jogkivonat használatával csatlakozhat egy adatbázishoz. accessToken nem állítható be a kapcsolat URL-címével.
accessTokenCallbackClass (hozzáférési token visszahívó osztály)

Zsinór

null
(12.4-es verzió+) A hozzáférési jogkivonat visszahívásához használandó visszahívási implementálási osztály neve.
alkalmazási szándék

Zsinór

OlvasásÍrás
(6.0-s verzió+) Deklarálja az alkalmazás számítási feladatainak típusát a kiszolgálóhoz való csatlakozáshoz.

A lehetséges értékek ReadOnly és ReadWrite.

További információ a katasztrófa utáni helyreállításról: JDBC-illesztőprogram támogatása a magas rendelkezésre álláshoz és a katasztrófa utáni helyreállításhoz.
Alkalmazásnév

Zsinór
[<=128 karakter]

null
Ha nincs megadva név, az alkalmazás neve vagy "Microsoft JDBC-illesztő az SQL Serverhez".

Az adott alkalmazás azonosítására szolgál a különböző SQL Server-profilkészítési és naplózási eszközökben.
hitelesítés

Zsinór

Nincs meghatározva
(6.0-s verzió+) Ez az opcionális tulajdonság azt jelzi, hogy melyik hitelesítési módszert használja a kapcsolathoz. Lehetséges értékek ActiveDirectoryIntegrated, ActiveDirectoryPassword, ActiveDirectoryManagedIdentity (verzió 12.2+), ActiveDirectoryMSI (verzió 7.2+), ActiveDirectoryInteractive (verzió 9.2+), ActiveDirectoryServicePrincipal (verzió 9.2+), SqlPassword, és az alapértelmezett NotSpecified.

Az ActiveDirectoryIntegrated (6.0+- verzió) használatával integrált Windows-hitelesítéssel csatlakozhat az SQL-hez.

Az ActiveDirectoryPassword (6.0+-os verzió) használatával csatlakozhat az SQL-hez a Microsoft Entra egyszerű nevével és jelszavával.

Az ActiveDirectoryManagedIdentity (12.2+-es verzió) vagy ActiveDirectoryMSI (7.2+- verzió) használatával csatlakozhat az SQL-hez egy Azure-erőforráson belülről. Például egy Azure-beli virtuális gép, app service vagy függvényalkalmazás felügyelt identitáshitelesítéssel.

Az illesztőprogram által ActiveDirectoryManagedIdentity vagy ActiveDirectoryMSI hitelesítési mód használatakor támogatott felügyelt identitások két típusa:
1. System-Assigned Kezelt identitás: Alapértelmezés szerint accessToken megszerzésére szolgál.
2. User-Assigned Felügyelt identitás: accessToken beszerzésére szolgál, ha egy felügyelt identitás ügyfélazonosítója az msiClientId kapcsolati tulajdonsággal van megadva.

Az ActiveDirectoryInteractive használatával interaktív hitelesítési folyamattal csatlakozhat egy adatbázishoz.

A ActiveDirectoryServicePrincipal (9.2 vagy újabb verzió) használatával csatlakozhat egy adatbázishoz a szolgáltatásfőid ügyfélazonosítójával és titkos kulcsával. Adja meg az ügyfél-azonosítót a userName tulajdonságban és a titkos kulcsot a jelszótulajdonságban (10,2+).

Az ActiveDirectoryServicePrincipalCertificate (12.4+-os verzió) használatával csatlakozhat egy adatbázishoz egy szolgáltatásnév-identitás ügyfélazonosítójával és tanúsítványával. Adja meg az ügyfélazonosítót a userName tulajdonságban, és a tanúsítvány elérési útját a clientCertificate tulajdonságban. További lehetőségekért lásd: Csatlakozás ActiveDirectoryServicePrincipalCertificate hitelesítési móddal.

SqlPassword használatával csatlakozhat az SQL-hez felhasználónév/user és jelszó tulajdonságaival.

Ha egyik hitelesítési módszerre sem van szükség, használja a Nem meghatározott.

Fontos: Ha a hitelesítés ActiveDirectoryIntegrated-re van állítva, a következő két könyvtárat kell telepíteni: mssql-jdbc_auth-<verzió>-<architektúra>.dll (elérhető a JDBC illesztőprogram-csomagban) és az SQL Server Microsoft Authentication Library (ADAL.DLL). A Microsoft Authentication Library az SQL Server Microsoft ODBC-illesztőprogramjából vagy AZ SQL ServerMicrosoft OLE DB-illesztőprogramjából telepíthető. A JDBC-illesztő csak az 1.0.2028.318 verziót és ennél magasabbat támogatja az ADAL.DLL esetében.

Megjegyzés: Ha a hitelesítési tulajdonságot bármilyen más értékre állítjuk, mint a Nem meghatározott, akkor a meghajtó alapértelmezés szerint a Transport Layer Security (TLS) titkosítást használja, amelyet korábban Secure Sockets Layer (SSL) néven ismertek.

További információ a Microsoft Entra-hitelesítés konfigurálásáról: Microsoft Entra-hitelesítés használata.
hitelesítési séma

Zsinór

NatívHitelesítés
Azt jelzi, hogy milyen integrált biztonságot szeretne használni az alkalmazás számára. Lehetséges értékek JavaKerberos, NTLM (7.4+verzió), valamint az alapértelmezett NativeAuthentication.

NativeAuthentication miatt a Windowsba betölti az illesztőprogram mssql-jdbc_auth-<version>-<arch>.dll-t (például mssql-jdbc_auth-8.2.2.x64.dll), amely az integrált hitelesítési információk megszerzésére szolgál.

(A betöltött natív hitelesítési kódtár neve sqljdbc_auth.dll a 6.0-7.4-s illesztőprogram-verziók használatakor.)

Az authenticationScheme=JavaKerberoshasználatakor meg kell adnia a teljes tartománynevet (FQDN) a serverName vagy serverSpn tulajdonságban. Ellenkező esetben hiba történik (a kiszolgáló nem található a Kerberos-adatbázisban).

További információ a authenticationScheme=JavaKerberoshasználatáról: A Kerberos integrált hitelesítés használata az SQL Servervaló csatlakozáshoz.

Az authenticationScheme=NTLMhasználatakor meg kell adnia a Windows-tartományt a tartomány vagy domainName tulajdonságban, a Windows-hitelesítő adatokat a felhasználó vagy userName tulajdonságban, valamint a jelszót a jelszó tulajdonságban. Ellenkező esetben hiba történik (a kapcsolat tulajdonságait meg kell adni).
cacheBulkCopyMetadata

Boolean
["igaz" | "hamis"]

téves
(12.8+-os verzió) A használatakor a BulkCopyForBatchInsert=truetulajdonság jelzi az illesztőprogramnak, hogy gyorsítótárazza-e a céloszlop metaadatait a kapcsolati szinten. Ha trueértékre van állítva, győződjön meg arról, hogy a célhely nem változik a tömeges beszúrások között, mivel az illesztőprogram nem tudja kezelni ezt a módosítást.
calcBigDecimalPrecision

Boolean
["igaz" | "hamis"]

téves
(12.6-os verzió+) Jelző, amely jelzi, hogy az illesztőnek ki kell-e számítania a bigdecimális bemenetek pontosságát, szemben a pontosság megengedett maximális értékével (38).
lekérdezés időtúllépésének törlése

Int

-1
(6.4-es verzió+) Ez a tulajdonság a kapcsolaton beállított queryTimeout megszakítására használható. A lekérdezés végrehajtása leáll, és nem ad kivételt, ha a kiszolgálóhoz való TCP-kapcsolat csendesen megszakad. Ez a tulajdonság csak akkor alkalmazható, ha a "queryTimeout" is be van állítva a kapcsolaton.

Az illesztőprogram az összes cancelQueryTimeout + queryTimeout másodpercnyi időtartamát kivárja, hogy eldobja a kapcsolatot és bezárja a csatornát.

A tulajdonság alapértelmezett értéke -1, a viselkedés pedig a határozatlan ideig történő várakozás.
ügyfél tanúsítvány

Zsinór

null
(8.4-es verzió+) Megadja az ügyféltanúsítvány-hitelesítéshez használandó tanúsítvány helyét. A JDBC-illesztő támogatja a PFX, a PEM, a DER és a CER fájlkiterjesztéseket.

További információ: ügyféltanúsítvány-hitelesítés visszacsatolási forgatókönyvekhez.
ügyfélkulcs

Zsinór

null
(8.4-es verzió+) Megadja a clientCertificate attribútum által megadott PEM-, DER- és CER-tanúsítványok titkos kulcsának helyét.

További információ: ügyféltanúsítvány-hitelesítés visszacsatolási forgatókönyvekhez.
ügyfélkulcs-jelszó

Zsinór

null
(8.4-es verzió+) Megadja a clientKey-fájl titkos kulcsához való hozzáféréshez szükséges opcionális jelszósztringet.

További információ: ügyféltanúsítvány-hitelesítés visszacsatolási forgatókönyvekhez.
oszlop titkosítási beállítás

Zsinór
["Engedélyezve" | "Letiltva"]

Fogyatékos
(6.0-s verzió+) Állítsa "Engedélyezve" értékre az Always Encrypted (AE) funkció használatához. Ha az AE engedélyezve van, a JDBC-illesztő transzparensen titkosítja és visszafejti a kiszolgálón titkosított adatbázisoszlopokban tárolt bizalmas adatokat.

További információ az Always Encryptedről: Az Always Encrypted használata a JDBC-illesztővel.

Megjegyzés: Az Always Encrypted az SQL Server 2016-os vagy újabb verziójában és az Azure SQL Database-ben érhető el.
csatlakozásiÚjrapróbálkozásSzám

Int
[0..255]

1
(9.4-es verzió+) Kapcsolati hiba esetén az újracsatlakozási kísérletek száma.
kapcsolatÚjrapróbálkozásIdőköz

Int
[1..60]

10
(9.4-es verzió+) Az egyes újrapróbálkozási kísérletek között eltelt másodpercek száma.
adatbázisNév
adatbázis

Zsinór
[<=128 karakter]

null
A csatlakozni kívánt adatbázis neve.

Ha nincs megadva, a rendszer kapcsolatot létesít az alapértelmezett adatbázissal.
idő- és dátumparaméter típusa

Zsinór
["datetime" | "datetime2" | "datetimeoffset"]

datetime2
(12.2+-es verzió) A Java dátum/időbélyeg paramétereihez használandó SQL-adattípus.

Ha valaki az SQL Server 2016-os vagy újabb verziójához csatlakozik, és az örökölt "datetime" értékekkel kommunikál, az ügyfelek kihasználhatják, hogy a tulajdonságot "datetime" értékre állítja. Ez a beállítás enyhíti a kiszolgálóoldali konverziós problémákat a "datetime" és a "datetime2" értékek között. További információért lásd: A datetime-tól datetime2-re történő konverzió viselkedésváltozásának kezelése az SQL Server 2016-tól kezdődően
késlelteti a LOB-ok betöltését

Boolean
["igaz" | "hamis"]

igaz
Egy jelző, amely megadja, hogy az összes LOB-objektumot a ResultSetből streameljük vagy sem. Ha ezt a tulajdonságot "false" értékre állítja, a teljes LOB-objektumot betölti a memóriába streamelés nélkül.
tartománynév
tartomány

Zsinór
null
(7.4-es verzió+) Az NTLM-hitelesítés használatakor hitelesíteni kívánt Windows-tartomány.
Nyilatkozatköteg összefűzésének letiltása

Boolean
["igaz" | "hamis"]

igaz
A jelző azt jelzi, hogy szükség van-e utasításkészletezésre.
Első előkészítés engedélyezése...
ElőkészítettNyilatkozatHívás

Boolean
["igaz" | "hamis"]

téves
Állítsa "true"-ra, hogy engedélyezze az előkészített utasításkezelő létrehozását, amikor a sp_prepexec-t egy előkészített utasítás első végrehajtásakor hívja meg.

Állítsa a "false" (hamis) értékre, hogy az előkészített utasítás első végrehajtását módosítsa úgy, hogy az meghívja a sp_executesql-t, és ne előkészítsen utasítást. Ha második végrehajtás történik, meghívja sp_prepexec, hogy állítson be egy előkészített utasításkezelőt.
enclaveAttestationUrl

Zsinór

null
(8.2-es verzió+) Ez az opcionális tulajdonság azt az igazolási szolgáltatás végpontJÁNAK URL-címét jelzi, amelyet az Always Encrypted biztonságos enklávékkal használ.

A biztonságos enklávékkal rendelkező Always Encryptedről további információt Az Always Encrypted biztonságos enklávékkalcímű témakörben talál.
enclaveBizonyítványProtokoll

Zsinór

null
(8.2-es verzió+) Ez az opcionális tulajdonság azt az igazolási protokollt jelzi, amelyet az Always Encrypted biztonságos enklávékkal használ. Jelenleg a mező egyetlen támogatott értéke HGS, AAS, és NONE (a NONE csak a 11.2+-es verzióban támogatott).

A biztonságos enklávékkal rendelkező Always Encryptedről további információt Az Always Encrypted biztonságos enklávékkalcímű témakörben talál.
titkosít

Zsinór

null
Állítsa "igaz" értékre, hogy az SQL Server TLS-titkosítást használjon az ügyfél és a kiszolgáló között küldött összes adathoz, ha a kiszolgáló rendelkezik telepített tanúsítvánnyal. Az alapértelmezett érték a 10.2-es és újabb verzióban "igaz", a 9.4-es és korábbi verziókban pedig "hamis".

A 6.0-s és újabb verzióban van egy új kapcsolati beállítás, a "hitelesítés", amely alapértelmezés szerint TLS-titkosítást használ.

A tulajdonságról további információt a "authentication" tulajdonságban talál.

11.2.0-s és újabb verziókban titkosít átváltott logikai-ről sztring-ra, lehetővé téve a TDS 8.0 támogatását, ha a tulajdonság szigorú-ra van állítva.
átállási partner

Zsinór

null
Az adatbázis-tükrözési konfigurációban használt tartalékkiszolgáló neve. Ez a tulajdonság a fő kiszolgálóhoz történő kezdeti kapcsolódási hibák kezelésére szolgál. A kezdeti kapcsolat létrehozása után a rendszer figyelmen kívül hagyja ezt a tulajdonságot. A databaseName tulajdonsággal együtt kell használni.

Megjegyzés: Az illesztőprogram nem támogatja a feladatátvételi partner példányának kiszolgálópéldány-portszámát a kapcsolati sztring feladatátvételi partner tulajdonságaként. Az illesztőprogram azonban támogatja a fő kiszolgálópéldány serverName, instanceName és portNumber tulajdonságainak, valamint a feladatátvétel partner feladatátvételipartner tulajdonságának megadását ugyanabban a kapcsolati karakterláncban.

Ha a kiszolgáló kapcsolattulajdonságában megad egy virtuális hálózatnevet, nem használhat adatbázis-tükrözést. További információ a vészhelyreállításról: a JDBC-illesztőprogram támogatása magas szintű rendelkezésre álláshoz és katasztrófa utáni helyreállításhoz
fips

Boolean
["igaz" | "hamis"]

"hamis"
A FIPS-kompatibilis Java virtuális gép (JVM) esetében ennek a tulajdonságnak igaznak kell lennie.
fipsProvider

Zsinór

null
A JVM-ben konfigurált FIPS-szolgáltató. Például: BCFIPS vagy SunPKCS11-NSS. A 6.4.0-s verzióban el lett távolítva. További információ: GitHub probléma 460.
gsscredential

org.ietf.jgss.GSSCredential

null
(6.2-es verzió+) A Kerberos korlátozott delegáláshoz használandó felhasználói hitelesítő adatok átadhatók ebben a tulajdonságban.

Ezt a beállítást integratedSecurity értékének igaz és a JavaKerberosauthenticationSchemehasználata esetén kell alkalmazni.
tanúsítványban szereplő hosztnév

Zsinór

null
Az SQL Server TLS/SSL-tanúsítvány érvényesítéséhez használandó állomásnév.

A hostNameInCertificate beállítással megadhatja a gazdagép nevét olyan helyzetekben, amikor a tanúsítványban használt név vagy nevek nem egyeznek a serverName tulajdonságnak átadott névvel. Ha azonban egyezés van, a hostNameInCertificate beállítást nem szabad használni.

Ha a hostNameInCertificate tulajdonság nincs meghatározva vagy null értékűre van állítva, az SQL Server Microsoft JDBC-illesztőprogramja a kapcsolati URL-cím serverName tulajdonságértékét használja állomásnévként az SQL Server TLS/SSL-tanúsítvány ellenőrzéséhez.

Megjegyzés: Az előző bekezdésben leírtak szerint nem ajánlott beállítani a hostNameInCertificate beállítást, kivéve, ha meg tudja erősíteni a nevet vagy a neveket, a tanúsítványban nem egyezik a serverName beállításban átadott névvel.

Megjegyzés: Ezt a tulajdonságot a titkosítási és / tulajdonságokkal, valamint a trustServerCertificate tulajdonsággal használják együtt. Ez a tulajdonság befolyásolja a tanúsítvány érvényesítését, ha a kapcsolat TLS-titkosítást használ, és a trustServerCertificate értéke "false". Győződjön meg arról, hogy az hostNameInCertificate érték, amelyet átadnak, megegyezik a szerver tanúsítványában a Tárgy Alternatív Név (SAN) mezőben szereplő köznapi névvel (CN) vagy a DNS-névvel a TLS-kapcsolat sikeressége érdekében. További információ a titkosítás támogatásáról: A titkosítás támogatásának ismertetése.
példánynév

Zsinór
[<=128 karakter]

null
Az adatbázispéldány neve, amelyhez csatlakozni szeretne. Ha nincs megadva, a rendszer kapcsolatot létesít az alapértelmezett példánysal. Abban az esetben, ha a instanceName és a port is meg van adva, tekintse meg a portra vonatkozó megjegyzéseket.

Ha a Kiszolgáló kapcsolati tulajdonságban megad egy virtuális hálózatnevet, nem használhatja a instanceName kapcsolattulajdonságot. További információ a vészhelyreállításról: JDBC-illesztőprogramok támogatása a magas rendelkezésre állás és vészhelyreállítás érdekében.
integráltBiztonság

Boolean
["igaz" | "hamis"]

téves
Állítsa "igaz" értékre, hogy jelezze, hogy az SQL Server windowsos operációs rendszereken használja a Windows-hitelesítő adatokat. Ha "igaz", a JDBC-meghajtó megkeresi a helyi számítógép hitelesítőadat-gyorsítótárában azokat a hitelesítő adatokat, amelyeket a felhasználó a számítógépre vagy a hálózatra való bejelentkezésekor megadott.

Állítsa a "true" (az authenticationscheme=JavaKerberos) értékre annak jelzésére, hogy a Kerberos-hitelesítő adatokat az SQL Server használja. További információ a Kerberos-hitelesítésről: A Kerberos integrált hitelesítés használata az SQL Serverhez való csatlakozáshoz.

Állítsa a "true" (az authenticationscheme=NTLM) értékre, hogy jelezze, hogy az SQL Server NTLM-hitelesítő adatokat használ.

Ha "hamis", meg kell adnia a felhasználónevet és a jelszót.
IP-cím preferencia

Zsinór
[<=128 karakter]

IPv4First
Az ügyfélalkalmazás által használt IP-beállítás.

A IPV4Firstesetén az illesztőprogram először az IPv4-címeket futtatja. Ha nem lehet sikeresen csatlakozni az IPv4-címekhez, az illesztő folytatja és megpróbálja az IPv6-címeket, ha vannak ilyenek.

Az IPv6-címeket először az IPV6Firstillesztőprogram bejárja. Ha nem lehet sikeresen csatlakoztatni IPv6-címeket, az illesztő folytatja és megpróbálja az IPv4-címeket, ha vannak ilyenek.

A UsePlatformDefaultesetén az illesztő a DNS-feloldás során kapott IP-címeket a kezdeti sorrendben bejárja.
jaasKonfigurációNév

Zsinór

SQLJDBCDriver
(6.2-es verzió+) Az SQL Serverrel létesített minden kapcsolat saját JAAS bejelentkezési konfigurációs névvel hozhat létre Kerberos-kapcsolatot. A konfigurációs bejegyzés neve átadható ezen a tulajdonságon keresztül. Ez a tulajdonság kerberos konfigurációs fájl létrehozásakor használható. Alapértelmezés szerint az illesztőprogram a SQLJDBCDrivernevet keresi.

Ha nem található külső konfiguráció, az illesztőprogram beállítja useDefaultCcache = true IBM JVM-ekhez, és useTicketCache = true más JVM-ekhez.
kulcstárhitelesítés

Zsinór

null
(6.0-s verzió+) Ez a tulajdonság azonosítja, hogy melyik kulcstárolót használja az Always Encrypted, és meghatározza a kulcstárolóban való hitelesítéshez használt hitelesítési mechanizmust. Az illesztőprogram támogatja a Java-kulcstároló zökkenőmentes beállítását a "keyStoreAuthentication=JavaKeyStorePassword" beállításnál. A tulajdonság használatához a Java-kulcstároló keyStoreLocation és keyStoreSecret tulajdonságait is be kell állítania.

További információ az Always Encryptedről: Az Always Encrypted használata a JDBC-illesztővel.

A Microsoft JDBC Driver 8.4-es verziójától kezdve beállíthatja a "keyStoreAuthentication=KeyVaultManagedIdentity" vagy a "keyStoreAuthentication=KeyVaultClientSecret" értéket az Azure Key Vaultban való hitelesítéshez felügyelt identitások használatával.

További információ az Always Encryptedről: Az Always Encrypted használata a JDBC-illesztővel.
kulcstároló helye

Zsinór

null
(6.0-s verzió+) Amikor keyStoreAuthentication=JavaKeyStorePassword, a keyStoreLocation tulajdonság azonosítja az oszlop főkulcsát tároló Java-kulcstárfájl elérési útját az Always Encrypted-adatokkal való használathoz. Az elérési útnak tartalmaznia kell a kulcstár fájlnevét.

További információ az Always Encryptedről: Az Always Encrypted használata a JDBC-illesztővel.
kulcstárolóFőAzonosító

Zsinór

null
(8.4-es verzió+) Amikor keyStoreAuthentication=KeyVaultManagedIdentity, a keyStorePrincipalId tulajdonság érvényes Microsoft Entra-alkalmazás ügyfél-azonosítót ad meg.

További információ az Always Encryptedről: Az Always Encrypted használata a JDBC-illesztővel.
kulcstár titok

Zsinór

null
(6.0-s verzió+) Amikor keyStoreAuthentication=JavaKeyStorePassword, a keyStoreSecret tulajdonság azonosítja a kulcstárhoz és a kulcshoz használandó jelszót. Ha valaki a Java-kulcstárolót használja, a kulcstárnak és a kulcs jelszavának meg kell egyeznie.

További információ az Always Encryptedről: Az Always Encrypted használata a JDBC-illesztővel.
utolsóFrissítésSzám

Boolean
["igaz" | "hamis"]

igaz
A "true" érték csak a kiszolgálónak átadott SQL-utasítás utolsó frissítési számát adja vissza. Emellett csak egyetlen SELECT, INSERT vagy DELETE utasításra használható, hogy figyelmen kívül hagyja a kiszolgálói eseményindítók által okozott egyéb frissítési számokat. Ha ezt a tulajdonságot "hamis" értékre állítja, az összes frissítési számot visszaadja, beleértve a kiszolgáló eseményindítói által visszaadott frissítési számokat is.

Megjegyzés: Ez a tulajdonság csak akkor érvényes, ha az executeUpdate metódusokkal van használatban. Az összes többi végrehajtási metódus visszaadja az összes eredményt és frissítési számot. Ez a tulajdonság csak a kiszolgáló eseményindítói által visszaadott frissítési számokat érinti. Nincs hatással az eseményindító végrehajtásának eredményeként keletkező eredményhalmazokra vagy hibákra.
lockTimeout

Int

-1
Azon ezredmásodpercek száma, amíg az adatbázis zárolási időtúllépést jelez. Az alapértelmezett viselkedés a határozatlan ideig történő várakozás. Ha a felhasználó nem adott meg értéket ehhez a tulajdonsághoz, ez az érték a kapcsolat összes utasításának alapértelmezett értéke.

Másik lehetőségként az Statement.setQueryTimeout() is használható adott utasítások lekérdezési időtúllépésének beállításához. Az érték lehet 0, ami azt jelzi, hogy nincs várakozás.
bejelentkezési időkorlát

Int
[0..65535]

30 (11.2-es és újabb verzió)
15 (10.2-es és újabb verzió)
Azon másodpercek száma, amíg az illesztőprogramnak várnia kell a sikertelen kapcsolat időzítése előtt. A nulla érték azt jelzi, hogy az időtúllépés a rendszer alapértelmezett időkorlátja. Ez az érték 30 másodperc (a 11.2-es és újabb verzió alapértelmezett értéke) vagy 15 másodperc (a 10.2-es vagy újabb verzió alapértelmezett értéke). Egy nullától eltérő érték az a másodpercek száma, amíg az illesztőprogramnak várnia kell, mielőtt időtúllépés következik be egy sikertelen kapcsolat esetén.

Ha a Kiszolgáló kapcsolat tulajdonságában megad egy virtuális hálózatnevet, három perc vagy hosszabb időkorlát-értéket kell megadnia, hogy elegendő idő álljon rendelkezésre a feladatátvételi kapcsolat sikerességéhez. További információ a katasztrófa utáni helyreállításról: JDBC-illesztőprogram támogatása a magas rendelkezésre álláshoz és a katasztrófa utáni helyreállításhoz.
maxResultBuffer

Zsinór

null
(9.2-es verzió+) maxResultBuffer az eredményhalmaz olvasásakor beolvasott bájtok maximális értékének beállítására használható. Ha nincs megadva, a teljes eredményhalmaz beolvasva lesz. A méret két stílusban adható meg:
1. bájtok méreteként (például 100, 150M, 300K, 400G)
2. a maximális halommemória százalékában (például 10p, 15pct, 20percent).
msiClientId

Zsinór

null
(Elavult) (7.2-es verzió+) A felügyelt identitás (MSI) ügyfélazonosítója, amely egy accessToken beszerzésére szolgál, hogy kapcsolatot létesítsen az ActiveDirectoryManagedIdentity vagy ActiveDirectoryMSI hitelesítési móddal.
Több alhálózat kiesés esetén történő átállás

logikai

téves
Mindig adja meg a multiSubnetFailover=true beállítást, hogy csatlakozzon egy SQL Server rendelkezésre állási csoport figyelőjéhez vagy egy SQL Server feladatátvevő fürt példányához. multiSubnetFailover=true úgy konfigurálja az illesztőprogramot, hogy gyorsabb észlelést és kapcsolatot biztosítson a (jelenleg) aktív kiszolgálóval. A lehetséges értékek igazak és hamisak. További információ a vészhelyreállításról: JDBC-illesztőprogramok támogatása a magas rendelkezésre állás és vészhelyreállítás érdekében.

Programozással elérheti a multiSubnetFailover kapcsolati tulajdonságot a getPropertyInfo, a getMultiSubnetFailoverés a setMultiSubnetFailoversegítségével.

Megjegyzés: Az SQL ServerHez készült Microsoft JDBC Driver 6.0-val kezdődően már nem szükséges multiSubnetFailover "true" értékre állítani a rendelkezésre állási csoport figyelőjéhez való csatlakozáshoz. Egy új tulajdonság, transparentNetworkIPResolution, amely alapértelmezés szerint engedélyezve van, az aktív kiszolgáló észlelését és kapcsolatát biztosítja.
csomagméret

Int
[-1 | 0 | 512..32767]

8 000
A kiszolgálóval való kommunikációhoz használt hálózati csomagméret bájtban megadva. A -1 érték azt jelzi, hogy a kiszolgáló alapértelmezett csomagméretét használja. A 0 érték azt jelzi, hogy a maximális értéket, azaz a 32767-et kell használni. Ha ez a tulajdonság az elfogadható tartományon kívüli értékre van állítva, kivétel történik.

Fontos: A packetSize tulajdonság használata a titkosítás engedélyezésekor (encryption=true) nem ajánlott. Ellenkező esetben az illesztőprogram csatlakozási hibát jelezhet. A tulajdonságról további információt az SQLServerDataSource osztály setPacketSize metódusában talál.
jelszó

Zsinór
[<=128 karakter]

null
Az adatbázis jelszava, ha SQL felhasználói és jelszavas kapcsolat van megadva.
Az egyszerű névvel és jelszóval rendelkező Kerberos-kapcsolat esetén ez a tulajdonság a Kerberos-egyszerű jelszóra van állítva.

(10.2+-os verzió) Ha authentication=ActiveDirectoryServicePrincipal, a jelszó tulajdonság azonosítja az Active Directory-taghoz használandó jelszót.
portszám
átvisz

Int
[0..65535]

1433
A port, ahol a kiszolgáló figyel. Ha a kapcsolati sztringben meg van adva a portszám, nem történik kérés az SQLbrowser felé. Ha a port és a instanceName is meg van adva, a kapcsolat a megadott porthoz jön létre. Azonban a instanceName érvényesítve van, és hibát dob, ha nem egyezik a porttal.

Fontos: Javasoljuk, hogy a portszám mindig meg legyen adva, mivel biztonságosabb, mint az SQLbrowser használata.
előkészítésiMódszer

Zsinór
["prepexec" | "előkészítés"]

prepexec
(11.2.0-s verzió+) Meghatározza az illesztőprogram által előkészített utasításokkal használandó mögöttes előkészítési módszert.

Állítsa be a paramétert úgy, hogy a a sp_prepare előkészítési módszerként legyen használva. Ha prepareMethod-t erre az értékre állítja, az eredményez egy különálló, kezdeti adatbázislekérést az utasítás előkészítésére, anélkül, hogy az adatbázis azokat a kezdeti értékeket figyelembe venné a végrehajtási tervben. A előkészítési módszerként való használatához állítsa be a(z) sp_prepexec. Ez a módszer egyesíti az előkészítési műveletet az első végrehajtással, csökkentve a körök számát. Emellett olyan kezdeti paraméterértékeket is biztosít az adatbázisnak, amelyeket az adatbázis figyelembe vehet a végrehajtási tervben.
lekérdezés időkorlát

Int

-1
A másodpercek száma, amíg a lekérdezés ideje lejár. Az alapértelmezett érték -1, ami korlátlan időtúllépést jelent. Ha ezt az értéket 0 értékre állítja, az azt is jelenti, hogy határozatlan ideig várni kell.
birodalom

Zsinór

null
(9.4-es verzió+) A Kerberos-hitelesítés tartománya. Állítsa be ezt az értéket, hogy felülírja a Kerberos-hitelesítési tartományt, amelyet az illesztőprogram a kiszolgáló tartományából automatikusan észlel.
replikáció

Boolean
["igaz" | "hamis"]

téves
(9.4-es verzió+) Ez a beállítás jelzi a kiszolgálónak, hogy a kapcsolatot replikációra használják-e. Ha engedélyezve van, a NOT FOR REPLICATION beállítással rendelkező eseményindítók nem aktiválják a kapcsolatot.
válaszbüfferezés

Zsinór
["teljes" | "adaptív"]

alkalmazkodó
Ha ez a tulajdonság "adaptív" értékre van állítva, a rendszer szükség esetén a minimálisan lehetséges adatokat puffereli. Az alapértelmezett mód az "adaptív".

Ha ez a tulajdonság "teljes" értékre van állítva, az utasítás végrehajtásakor a rendszer beolvassa a teljes eredménykészletet a kiszolgálóról.

Megjegyzés: A JDBC-illesztőprogram 1.2-es verziója után az alapértelmezett pufferelési viselkedés "adaptív". Ha meg szeretné tartani az 1.2-es verzió alapértelmezett viselkedését az alkalmazásban, állítsa a responseBuffering tulajdonságot "teljes" értékre a kapcsolat tulajdonságai között, vagy használja az SQLServerStatement objektum setResponseBuffering metódusát.
módszer kiválasztása

Zsinór
["direkt" | "kurzor"]

közvetlen
Ha ez a tulajdonság a "kurzor" értékre van állítva, a rendszer létrehoz egy adatbázis-kurzort a TYPE_FORWARD_ONLY és CONCUR_READ_ONLY kurzorok kapcsolatán létrehozott lekérdezésekhez. Ez a tulajdonság általában csak akkor szükséges, ha az alkalmazás olyan nagy eredményhalmazokat hoz létre, amelyek nem tárolhatók teljes mértékben az ügyfél memóriájában. Ha ez a tulajdonság "kurzor" értékre van állítva, csak korlátozott számú eredményhalmaz-sor marad az ügyfél memóriájában.

Az alapértelmezett viselkedés az, hogy az eredményhalmaz összes sora az ügyfél memóriájában marad. Ez a viselkedés biztosítja a leggyorsabb teljesítményt, amikor az alkalmazás az összes sort feldolgozta.
karakterláncParaméterekKüldése
AsUnicode

Boolean
["igaz" | "hamis"]

igaz
Ha a sendStringParametersAsUnicode tulajdonság értéke "true", a sztringparaméterek Unicode formátumban lesznek elküldve a kiszolgálónak.

Ha a sendStringParametersAsUnicode tulajdonság értéke "false" (hamis), a sztringparaméterek Unicode helyett nem Unicode formátumban, például ASCII/MBCS formátumban lesznek elküldve a kiszolgálónak.

A sendStringParametersAsUnicode tulajdonság alapértelmezett értéke "true".

Megjegyzés: A sendStringParametersAsUnicode tulajdonság csak akkor van bejelölve, ha CHAR, VARCHARvagy LONGVARCHAR JDBC-típussal szeretne paraméterértéket küldeni. Az új JDBC 4.0-s nemzeti karaktermetelyek olyan metódusokat tartalmaznak, mint a setNString, a setNCharacterStream és a setNClob az SQLServerPreparedStatement és SQLServerCallableStatement osztályokat. Ezek a metódusok a tulajdonság beállításától függetlenül mindig a Unicode-ban küldik el a paraméterértékeiket a kiszolgálónak.

A CHAR, VARCHARés LONGVARCHAR JDBC adattípusokkal való optimális teljesítmény érdekében az alkalmazásnak a sendStringParametersAsUnicode tulajdonságot "false" értékre kell állítania, és az SQLServerPreparedStatement és SQLServerCallableStatement osztályainak setString, setCharacterStream és setClob nem nemzeti karaktermetelyeit kell használnia.

Amikor az alkalmazás a sendStringParametersAsUnicode tulajdonságot "false" értékre állítja, és nem nemzeti karaktermetódussal éri el a Unicode-adattípusokat a kiszolgálóoldalon (például ncharnvarchar és ntext) egyes adatok elveszhetnek, ha az adatbázis-rendezés nem támogatja a nem nemzeti karaktermetódus által átadott sztringparaméterek karaktereit.

Az alkalmazásoknak az SQLServerPreparedStatement és SQLServerCallableStatement osztályainak setNString, setNCharacterStream és setNClob nemzeti karaktermetszetét kell használniuk az NCHAR, NVARCHARés LONGNVARCHAR JDBC-adattípusokhoz.

Az érték módosítása hatással lehet az adatbázisból származó eredmények rendezésére. A rendezési különbségek oka a Unicode és a nem Unicode karakterek eltérő rendezési szabályai.
sendTemporalDataTypes...
SzövegkéntTömegesMásoláshoz

Boolean
["igaz" | "hamis"]

igaz
(8.4-es verzió+) Ez a kapcsolati tulajdonság "false" értékre van állítva, DATE, DATETIME, DATIMETIME2, DATETIMEOFFSET, SMALLDATETIME, és TIME adattípusokat küld a megfelelő típusként ahelyett, hogy sztringként küldené őket.

Ha ez a kapcsolati tulajdonság "false" (hamis) értékre van állítva, a meghajtó elfogadja az egyes időbeli adattípusok alapértelmezett sztring formátumát, például:

DÁTUM: YYYY-MM-DD
DÁTUMIDŐ: YYYY-MM-DD hh:mm:ss[.nnn]
DATETIME2: YYYY-MM-DD hh:mm:ss[.nnnnnnn]
DATETIMEOFFSET (időeltolás): YYYY-MM-DD hh:mm:ss[.nnnnnnn] [{+/-}hh:mm]
SMALLDATETIME: YYYY-MM-DD hh:mm:ss
IDŐ: hh:mm:ss[.nnnnnnn]
sendTimeAsDatetime

Boolean
["igaz" | "hamis"]

igaz
Ezt a tulajdonságot hozzáadták az SQL Server JDBC Driver 3.0-hoz.

Állítsa a "true" értékre, hogy java.sql.Time értékeket küldjön a kiszolgálónak SQL Server datetime értékekként.
Állítsa "false" értékre, hogy a java.sql.Time értékeket SQL Server idő értékekként küldje el a kiszolgálónak.

A tulajdonság alapértelmezett értéke jelenleg "igaz", és egy későbbi kiadásban változhat.

További információ arról, hogy az SQL Server Microsoft JDBC-illesztőprogramja hogyan konfigurálja a java.sql.Time értékeket, mielőtt elküldi őket a kiszolgálónak, olvassa el A java.sql.Time-értékek kiszolgálóivaló küldésének konfigurálása című témakört.
szerver tanúsítvány
kiszolgáló

Zsinór

null
(11.2.0-s verzió+) A kiszolgálótanúsítvány-fájl elérési útja. A titkosításszigorú beállítással végzett ellenőrzéshez használható. Az illesztőprogram a PEM fájlformátummal támogatja a tanúsítványfájlokat.
szerverNév
kiszolgáló

Zsinór

null
Az SQL Servert vagy egy Azure SQL-adatbázist futtató számítógép.

Megadhatja egy rendelkezésre állási csoport virtuális hálózatának nevét is. További információ a katasztrófa utáni helyreállításról: JDBC-illesztőprogram támogatása a magas rendelkezésre álláshoz és a katasztrófa utáni helyreállításhoz.
serverNameAsACE (szerver neve ACE formátumban)

Boolean
["igaz" | "hamis"]

téves
(6.0-s verzió+) Állítsa "igaz" értékre, hogy az illesztőprogram lefordítsa a Unicode-kiszolgáló nevét ASCII-kompatibilis kódolásra (Punycode) a kapcsolathoz. Ha ez a beállítás hamis, az illesztő a megadott kiszolgálónevet használja a csatlakozáshoz.

További információ a nemzetközi funkciókról: JDBC-illesztő nemzetközi funkciói.
szerverElőkészítettUtasítás...
Küszöbszint Elvetése

Egész szám

10
(6.2-es verzió+) Ezzel a tulajdonságtal szabályozható, hogy kapcsolatonként hány előkészített utasításelvetési művelet (sp_unprepare) lehet függőben, mielőtt a kiszolgáló ki nem állított leíróinak törlésére irányuló hívás befejeződik.

Ha ez a tulajdonság <= 1értékre van állítva, a nem előkészített műveletek azonnal, az előkészített utasítás bezárásakor lesznek végrehajtva. Ha a tulajdonság > 1értékre van állítva, a rendszer ezeket a hívásokat kötegelve végzi, hogy elkerülje a túl gyakori sp_unprepare hívás többletterhelését.
serverSpn

Zsinór

null
(4.2+-es verzió) Ez az opcionális tulajdonság a Java Kerberos-kapcsolatok egyszerű szolgáltatásnévének (SPN) megadására használható. Ez a(z) authenticationSchemeesetén használatos.

Az SPN (Szolgáltatás Fő Név) megadásához a következő formátumot használhatja: "MSSQLSvc/fqdn:port@REALM", ahol az fqdn a teljesen minősített tartománynév, a port a portszám, a REALM pedig az SQL Server Kerberos-tartománya nagybetűkkel.

Megjegyzés: a @REALM nem kötelező, ha az ügyfél alapértelmezett tartománya (a Kerberos-konfigurációban megadottak szerint) megegyezik az SQL Server Kerberos-tartományával.

További információ a ServerSpn Java Kerberossal való használatáról: Az SQL Servervaló csatlakozáshoz használt Kerberos integrált hitelesítés használata.
socketFactoryClass

Zsinór

null
(8.4-es verzió+) Megadja az alapértelmezett szoftvercsatorna-előállító helyett használandó egyéni szoftvercsatorna-előállító osztálynevét.
csatlakozási időkorlát

Int

0
A socket olvasásának vagy elfogadásának időtúllépése előtt várakozandó ezredmásodpercek száma. Az alapértelmezett érték 0, ami végtelen időtúllépési időt jelent.
állítások összevonása...
GyorsítótárMéret

Int

0
(6.4-es verzió+) Ezzel a tulajdonságtal engedélyezheti az előkészített utasításkezelő gyorsítótárazását az illesztőprogramban.

Ez a tulajdonság határozza meg a gyorsítótár méretét az utasításkészletezéshez.

Ez a tulajdonság csak a disableStatementPooling kapcsolati tulajdonsággal használható, amelynek "false" (hamis) értékűnek kell lennie. Ha a(z) disableStatementPooling értéke „true” lesz, vagy a(z) statementPoolingCacheSize értéke 0-ra áll, az előkészített utasításkezelő gyorsítótárazása letiltásra kerül.
SSL-protokoll

Zsinór

TLS
(6.4-es verzió+) Ez a tulajdonság a biztonságos kapcsolat során figyelembe venni kívánt TLS-protokoll megadására használható.
Lehetséges értékek: TLS, TLSv1, TLSv1.1és TLSv1.2.

További információ a Secure Sockets Layer protokollról: SSLProtocol.
átlátszóhálózat
IPResolution

Boolean
["igaz" | "hamis"]

igaz
(6.0-s verzió+) Ez a tulajdonság gyorsabb észlelést és kapcsolatot biztosít az (jelenleg) aktív kiszolgálóval. A lehetséges értékek "igaz" és "hamis", ahol az "igaz" az alapértelmezett érték.

Az SQL Serverhez készült Microsoft JDBC Driver 6.0 előtt egy alkalmazásnak be kellett állítania a kapcsolati karakterláncot a "multiSubnetFailover=true" paraméterrel, hogy jelezze, hogy egy Always On elérhetőségi csoporthoz kapcsolódik. Ha nem állítja be a multiSubnetFailover kapcsolat kulcsszót "true" értékre, előfordulhat, hogy egy alkalmazás időtúllépést tapasztal egy Always On rendelkezésre állási csoporthoz való csatlakozáskor. A 6.0-s és újabb verziójú alkalmazásokban már nem szükséges a multiSubnetFailover értékét igazra állítani.

Jegyzet: Ha összevont hitelesítést használ, vagy ha többsubnetfailover van megadva, a transparentNetworkIPResolution alapértelmezés szerint le van tiltva, ezért a funkció engedélyezéséhez explicit módon "true" értékre kell állítani az transparentNetworkIPResolution értéket.

Megjegyzés: Az transparentNetworkIPResolution=true érték esetén az első kapcsolati kísérlet 500 ms időtúllépést használ. Minden későbbi kísérlet ugyanazt az időtúllépési logikát használja, mint a multiSubnetFailover tulajdonság.
bizalomkezelő osztály

Zsinór

null
(6.4-es verzió+) Az egyéni javax.net.ssl.TrustManager implementáció teljesen kvalifikált osztályneve.
bizalomkezelő
KonstruktorArg

Zsinór

null
(6.4-es verzió+) Az TrustManager konstruktorának átadandó opcionális argumentum. Ha a trustManagerClass tulajdonság meg van adva, és titkosított kapcsolatot kér, a rendszer az egyéni TrustManagert használja az alapértelmezett JVM-kulcstároló-alapú TrustManager helyett.
Bizalom a szerver tanúsítványában

Boolean
["igaz" | "hamis"]

téves
Állítsa "true" értékre, hogy az illesztőprogram ne érvényesítse a kiszolgáló TLS/SSL-tanúsítványát.

Ha "igaz", a kiszolgáló TLS-/SSL-tanúsítványa automatikusan megbízható, ha a kommunikációs réteg TLS használatával van titkosítva.

Ha "hamis", az illesztőprogram ellenőrzi a kiszolgáló TLS/SSL-tanúsítványát. Ha a kiszolgálótanúsítvány érvényesítése sikertelen, az illesztőprogram hibát jelez, és bezárja a kapcsolatot. Az alapértelmezett érték "hamis". Győződjön meg arról, hogy a serverName számára átadott érték pontosan megegyezik a szerver tanúsítványban szereplő közös névvel (CN), vagy egy DNS-névvel a tárgy alternatív nevei között a TLS/SSL-kapcsolat sikerességéhez. További információ a titkosítás támogatásáról: A titkosítás támogatásának ismertetése.

Megjegyzés: Ez a tulajdonság a titkosítási/hitelesítési tulajdonságaival együtt használatos. Ez a tulajdonság csak akkor befolyásolja a kiszolgáló TLS-/SSL-tanúsítványérvényesítését, ha a kapcsolat TLS-titkosítást használ.
trustStore

Zsinór

null
A tanúsítvány trustStore-fájljának elérési útja (beleértve a fájlnevet is). Az trustStore fájl tartalmazza az ügyfél által megbízhatóként megadott tanúsítványok listáját.

Ha ez a tulajdonság nincs meghatározva vagy null értékűre van állítva, az illesztőprogram a trust manager factory keresési szabályaira támaszkodva határozza meg, hogy melyik tanúsítványtárolót használja.

Az alapértelmezett SunX509 TrustManagerFactory a következő keresési sorrendben próbálja megtalálni a megbízható anyagot:

A "javax.net.ssl.trustStore" JVM rendszertulajdonság által megadott fájl.

<java-home>/lib/security/jssecacerts fájl.

<java-home>/lib/security/cacerts fájl.



Az SUNX509 TrustManager interface-ről további információt a Sun Microsystems webhelyén található SUNX509 TrustManager Interface dokumentációjában talál.

Megjegyzés: Ez a tulajdonság csak a tanúsítvány trustStore-keresésére van hatással, ha a kapcsolat TLS-titkosítást használ, és a trustServerCertificate tulajdonság értéke "false".
megbízhatósági tároló jelszó

Zsinór

null
A trustStore-adatok integritásának ellenőrzéséhez használt jelszó.

Ha a trustStore tulajdonság be van állítva, de a trustStorePassword tulajdonság nincs beállítva, a trustStore integritása nincs bejelölve.

Ha az trustStore és a trustStorePassword tulajdonságok sem vannak meghatározva, az illesztőprogram a JVM rendszertulajdonságait, a "javax.net.ssl.trustStore" és a "javax.net.ssl.trustStorePassword" tulajdonságot használja. Ha nincs megadva a "javax.net.ssl.trustStorePassword" rendszertulajdonság, a rendszer nem ellenőrzi az trustStore integritását.

Ha a felhasználó nem állítja be az trustStore tulajdonságot, de az trustStorePassword tulajdonságot állítja be, a JDBC-illesztő a "javax.net.ssl.trustStore" által megadott fájlt használja megbízhatósági tárolóként. Ezenkívül az illesztőprogram a megadott trustStorePassword használatával ellenőrzi a megbízhatósági tároló integritását. Erre a beállításra akkor van szükség, ha az ügyfélalkalmazás nem szeretné tárolni a jelszót a JVM rendszertulajdonságban.

Megjegyzés: A trustStorePassword tulajdonság csak a tanúsítvány trustStore-keresésére van hatással, ha a kapcsolat TLS-kapcsolatot használ, és a trustServerCertificate tulajdonság értéke "false".
bizalomTárolóTípus

Zsinór

JKS
Állítsa be ezt a tulajdonságot a FIPS módhoz használandó megbízhatósági tár típusának megadásához.

A lehetséges értékek PKCS12 vagy a FIPS-szolgáltató által definiált típus.
használja a tömeges másolást a(z) ... esetén
BatchInsert

Boolean
["igaz" | "hamis"]

téves
(9.2-es verzió+) Ez a kapcsolattulajdonság lehetővé teszi a Tömeges másolás API transzparens használatát a java.sql.PreparedStatement-val végzett kötegelt beszúrási műveletek során. Ez a funkció nagyobb teljesítményt nyújt, ha engedélyezve van.

Ez a funkció alapértelmezés szerint le van tiltva. Állítsa ezt a tulajdonságot "true" értékre a funkció engedélyezéséhez.

Fontos megjegyzés: Ez a funkció csak a teljes paraméteres INSERT-lekérdezéseket támogatja. Ha az INSERT lekérdezések más SQL-lekérdezésekkel vannak kombinálva, vagy értékekben lévő adatokat tartalmaznak, a végrehajtás visszaesik az alapszintű kötegbeszúrási műveletre.

További információ a tulajdonság használatáról: Tömeges másolási API használata gyűjtő beszúrási művelethez
useDefaultGSSCredential

Boolean
["igaz" | "hamis"]

téves
(12.6-os verzió+) Jelző, amely jelzi, hogy az illesztőprogramnak létre kell-e hoznia a GSSCredential-t a felhasználó nevében a natív GSS-API Kerberos-hitelesítéshez való használatához.
Csomagolási Művelet Tétel Beszúrásához Használható Tételméret

Int

0
(12.10-es verzió+) A useBulkCopyForBatchInsert=true használata esetén ez a tulajdonság határozza meg a kötegelt beszúrási műveletekből létrehozott tömeges másolási műveletek kötegméretét. A beállítás hatásairól további információt az BatchSize opciójában talál.
tömegesMásolásKötegeltBeszúrásEllenőrzésiFeltételekhez

Boolean
["igaz" | "hamis"]

téves
(12.10-es verzió+) Ha a useBulkCopyForBatchInsert=true értéket használja, a beállítás igaz értékre állítása lehetővé teszi a check constraints működését az adatok beszúrása során. Ha ezt a beállítást hamisra állítja, letiltja az ellenőrzési korlátozásokat. A beállítás hatásairól további információt az CheckConstraints opciójában talál.
kötegeltBeszúráshozKapcsolódóTömegmásolásÉrtesítőTriggerek

Boolean
["igaz" | "hamis"]

téves
(12.10-es verzió+) Ha a UseBulkCopyForBatchInsert=true értéket használja, a beállítás igaz értékre állítása lehetővé teszi a beszúrási eseményindítók indítását, miközben sorokat szúr be az adatbázisba. Amikor ezt a beállítást false-re állítja, letiltja a beszúrási triggerek működését. A beállítás hatásairól további információt az FireTriggers opciójában talál.
nagy mennyiség másolása kötegelt beszúráshoz identitás megtartásával

Boolean
["igaz" | "hamis"]

téves
(12.10-es verzió+) Ha a UseBulkCopyForBatchInsert=true értéket használja, a beállítás igaz értékre állítása megőrzi a forrásidentitás értékeit az adatok beszúrása közben. Ha hamis értékre állítja a beállítást, az azt jelenti, hogy a cél identitásértékeket rendelhet hozzá. A beállítás hatásairól további információt az KeepIdentity opciójában talál.
tömegesMásolásTételesBeszúrásnálNullÉrtékeketMegőrizve

Boolean
["igaz" | "hamis"]

téves
(12.10-es verzió+) Ha a useBulkCopyForBatchInsert=true értéket használja, a beállítás igaz értékre állítása a céltáblában az alapértelmezett értékbeállításoktól függetlenül megőrzi a null értékeket. Ha ezt a beállítást hamis értékre állítja, a cél alapértelmezett értékei a null értékeket cserélik le. A beállítás hatásairól további információt az KeepNulls opciójában talál.
bulkCopyForBatchInsertTableLock

Boolean
["igaz" | "hamis"]

téves
(12.10-es verzió+) Ha a useBulkCopyForBatchInsert=true értéket használja, a beállítás igaz értékre állítása esetén a tömeges másolási művelet során tömeges frissítési zárolást kap. Ha ezt a beállítást hamisra állítja, sorzárolásokat használ. A beállítás hatásairól további információt az TableLock opciójában talál.
kötegelt beszúráshoz használt tömeges másolás, amely engedélyezi a titkosított értékek módosítását

Boolean
["igaz" | "hamis"]

téves
(12.10-es verzió+) Ha a useBulkCopyForBatchInsert=true értéket használja, a beállítás igaz értékre állítása lehetővé teszi a titkosított adatok táblák vagy adatbázisok közötti tömeges másolását az adatok visszafejtése nélkül. Az adott tulajdonság használatával kapcsolatos további információkért és figyelmeztetésekért tekintse meg a allowEncryptedValueModifications opciót.
useDefaultJaasConfig

Boolean
["igaz" | "hamis"]

téves
(12.6-os verzió+) Ha az alkalmazás olyan kódtárak mellett létezik, amelyek a rendszer szintjén konfigurálják a JAAS-t, a tulajdonság igaz értékre állítása lehetővé teszi, hogy az illesztő ugyanazt a konfigurációt használja a Kerberos-hitelesítés végrehajtásához.
useFmtOnly

Boolean
["igaz" | "hamis"]

téves
(7.4-es verzió+) Alternatív módot kínál a paraméter metaadatainak lekérdezésére a kiszolgálóról. Állítsa ezt a tulajdonságot "true" értékre, hogy az illesztőprogram SET FMTONLY logikát használjon a paraméter metaadatainak lekérdezéséhez. Ez a funkció alapértelmezés szerint ki van kapcsolva, és nem ajánlott ezt a tulajdonságot használni, mivel SET FMTONLY elavuláshoz van megjelölve. useFmtOnly csak átmeneti megoldásként használható az sp_describe_undeclared_parametersmár ismert problémái és korlátai miatt.

Ez a funkció jelenleg csak egyetlen SELECT/INSERT/UPDATE/DELETE lekérdezést támogat. Ha nem támogatott/több lekérdezéssel próbálja használni ezt a funkciót, az illesztőprogram megpróbálja elemezni a lekérdezést, de valószínűleg kivételt eredményez.

További információért erről a tulajdonságról, lásd: ParameterMetaData lekérése a useFmtOnly módszerrel.
felhasználónév
felhasználó

Zsinór
[<=128 karakter]

null
Az adatbázis-felhasználó, ha az SQL-felhasználóval és a jelszóval van kapcsolat.

Az egyszerű névvel és jelszóval rendelkező Kerberos-kapcsolat esetén ez a tulajdonság a Kerberos Egyszerű név értékre van állítva.

(10.2+-os verzió) Ha authentication=ActiveDirectoryServicePrincipal, a userName tulajdonság egy érvényes Microsoft Entra biztonságos ügyfél-azonosítót ad meg.
munkaállomásID

Zsinór
[<=128 karakter]

<empty string>
A munkaállomás azonosítója. Az adott munkaállomás azonosítására szolgál a különböző profilkészítési és naplózási eszközökben.

Ha nincs megadva, a rendszer a <empty string> használja.
xopenStates

Boolean
["igaz" | "hamis"]

téves
Állítsa "true" értékre, hogy az illesztőprogram xOPEN-kompatibilis állapotkódokat adjon vissza a kivételekben.

Az alapértelmezett érték az SQL 99-állapotkódok visszaadása.
vectorTypeSupport

Zsinór
["v1" | "ki"]

v1
(13.2-es verzió+) A "ki" értékre állítva megadhatja, hogy a kiszolgáló sztring típusú vektortípusokat küldjön sztringadatokként JSON formátumban, a "v1" pedig annak megadásához, hogy a kiszolgáló vektoradatokként FLOAT32 vektortípusokat küldjön. Az alapértelmezett érték a v1.
QUOTED_IDENTIFIER

karakterlánc
["ON" | "KI"]

ON
(13.2-es verzió+) Ha "KI" értékre van állítva, az illesztő a kapcsolat létrehozásakor a QUOTED_IDENTIFIER adatbázis-munkamenet változóját KI értékre állítja. Az eredmény az, hogy az adatbázis sztringelválasztóként kezeli a kettős idézőjeleket a karakterkonstansokhoz, az azonosítókat pedig nem lehet idézőjelek közé foglalni. További információ: SET QUOTED_IDENTIFIER (Transact-SQL).

Az alapértelmezett érték az "ON".
CONCAT_NULL_YIELDS_NULL

karakterlánc
["ON" | "KI"]

ON
(13.2-es verzió+) Ha "KI" értékre van állítva, az illesztőprogram a kapcsolat létrehozásakor beállítja a CONCAT_NULL_YIELDS_NULL adatbázis-munkamenet változóját KI értékre. Az eredmény az, hogy egy null érték sztringgel való összefűzésével a sztring maga a sztring lesz (a null érték üres sztringként lesz kezelve). További információ: SET CONCAT_NULL_YIELDS_NULL (Transact-SQL).

Az alapértelmezett érték az "ON".

Jegyzet

Az SQL Server Microsoft JDBC-illesztőprogramja a kiszolgáló alapértelmezett kapcsolati értékeit veszi át, kivéve ANSI_DEFAULTS és IMPLICIT_TRANSACTIONS. Az SQL Serverhez készült Microsoft JDBC-illesztő automatikusan az ANSI_DEFAULTS-et BE állítja, és az IMPLICIT_TRANSACTIONS-t KI.

Fontos

Ha a hitelesítés ActiveDirectoryPassword értékre van állítva, a következő kódtárat kell tartalmaznia az osztályútvonalnak: microsoft-authentication-library-for-java. Megtalálható a Maven-adattárban. A könyvtár és függőségei letöltésének legegyszerűbb módja a Maven használata:

  1. A Maven telepítése a rendszerre
  2. Nyissa meg az illesztőprogram GitHub- lapját
  3. A pom.xml fájl letöltése
  4. Futtassa a következő Maven-parancsot a könyvtár és függőségei letöltéséhez: mvn dependency:copy-dependencies

Lásd még:

Csatlakozás az SQL Serverhez a JDBC-illesztővel
FIPS mód