Définition des propriétés de connexionSetting the connection properties

TéléchargerTélécharger le pilote JDBCDownloadDownload JDBC Driver

Les propriétés de chaîne de connexion peuvent être spécifiées de plusieurs manières :The connection string properties can be specified in various ways:

  • En tant que propriétés nom=valeur dans l’URL de connexion, lors de la connexion à l’aide de la classe DriverManager.As name=value properties in the connection URL when you connect by using the DriverManager class.

  • En tant que propriétés nom=valeur Properties dans le paramètre Properties de la méthode Connect de la classe DriverManager.As name=value properties in the Properties parameter of the Connect method in the DriverManager class.

  • En tant que valeurs dans la méthode setter appropriée de la source de données du pilote.As values in the appropriate setter method of the data source of the driver. Par exemple :For example:

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

NotesRemarks

Les noms de propriétés ne sont pas sensibles à la casse et les noms de propriétés dupliqués sont résolus dans l'ordre suivant :Property names are case-insensitive, and duplicate property names are resolved in the following order:

  1. Arguments API (utilisateur et mot de passe)API arguments (such as user and password)
  2. Collection de propriétés.Property collection.
  3. Dernière instance de la chaîne de connexion.Last instance in the connection string.

Par ailleurs, des valeurs inconnues sont autorisées dans les noms de propriétés et leurs valeurs ne sont pas validées par le pilote JDBC concernant la sensibilité à la casse.Also, unknown values are allowed for the property names, and their values are not validated by the JDBC driver for case sensitivity.

Les synonymes sont autorisés et sont résolus dans l'ordre, tout comme les noms de propriétés dupliqués.Synonyms are allowed and are resolved in order, just as duplicate property names.

Le tableau suivant répertorie toutes les propriétés de chaîne de connexion actuellement disponibles pour le pilote JDBC.The following table lists all the currently available connection string properties for the JDBC driver.

PropriétéProperty
TypeType
DefaultDefault
DescriptionDescription
accessTokenaccessToken

StringString

nullnull
Utilisez cette propriété pour vous connecter à une base de données SQL avec un jeton d’accès.Use this property to connect to a SQL database using an access token. Il n’est pas possible de définir accessToken avec l’URL de connexion.accessToken can't be set using the connection URL.
applicationIntentapplicationIntent

StringString

Lecture/écritureReadWrite
Déclare le type de la charge de travail de l'application lors de la connexion à un serveur.Declares the application workload type when connecting to a server.

Les valeurs possibles sont ReadOnly et ReadWrite.Possible values are ReadOnly and ReadWrite.

Pour plus d'informations, consultez Prise en charge de la haute disponibilité et de la récupération d'urgence par le pilote JDBC.For more information, see JDBC driver support for High Availability, disaster recovery.
applicationNameapplicationName

StringString
[<=128 char][<=128 char]

nullnull
Nom de l’application ou « Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server » si aucun nom n’est fourni.The application name, or "Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server" if no name is provided.

Utilisé pour identifier l’application spécifique dans les divers outils de définition de profils et de journalisation SQL ServerSQL Server.Used to identify the specific application in various SQL ServerSQL Server profiling and logging tools.
Authentificationauthentication

StringString

NotSpecifiedNotSpecified
À compter de la version 6.0 de Microsoft JDBC Driver pour SQL Server, cette propriété facultative indique la méthode d’authentification SQL à utiliser pour la connexion.Beginning with Microsoft JDBC Driver 6.0 for SQL Server, this optional property indicates which SQL authentication method to use for connection. Les valeurs possibles sont ActiveDirectoryIntegrated, ActiveDirectoryPassword, ActiveDirectoryMSI, SqlPassword et NotSpecified (par défaut).Possible values are ActiveDirectoryIntegrated, ActiveDirectoryPassword, ActiveDirectoryMSI, SqlPassword, and the default NotSpecified.

Utilisez ActiveDirectoryIntegrated pour vous connecter à une base de données SQL Database avec l’authentification Windows intégrée.Use ActiveDirectoryIntegrated to connect to a SQL Database using integrated Windows authentication.

Utilisez ActiveDirectoryPassword pour vous connecter à une base de données SQL Database avec un nom de principal Azure AD et un mot de passe.Use ActiveDirectoryPassword to connect to a SQL Database using an Azure AD principal name and password.

Utilisez ActiveDirectoryMSI pour vous connecter à une base de données SQL Database à partir d’une ressource Azure, par exemple une machine virtuelle Azure, App Service ou Function App, avec l’authentification Managed Service Identity (MSI).Use ActiveDirectoryMSI to connect to a SQL Database from inside an Azure Resource, e.g. an Azure Virtual Machine, App Service or Function App using Managed Service Identity (MSI) authentication.

Deux types d’identités managées sont pris en charge par le pilote avec le mode d’authentification ActiveDirectoryMSI :The two types of Managed Identities supported by the driver when using ActiveDirectoryMSI authentication mode are:
1. Identité managée affectée par le système : permet d’acquérir accessToken par défaut.1. System-Assigned Managed Identity: Used to acquire accessToken by default.
2. Identité managée affectée par l’utilisateur : permet d’acquérir accessToken si l’ID client d’une identité MSI est spécifié avec la propriété de connexion msiClientId.2. User-Assigned Managed Identity: Used to acquire accessToken if the Client ID of a Managed Service Identity (MSI) is specified with the msiClientId connection property.

Utilisez SqlPassword pour vous connecter à un serveur SQL Server avec les propriétés nom d’utilisateur/utilisateur et mot de passe.Use SqlPassword to connect to a SQL Server using userName/user and password properties.

Utilisez NotSpecified si aucune de ces méthodes d’authentification n’est nécessaire.Use NotSpecified if none of these authentication methods are needed.

Important : Si l’authentification est définie sur ActiveDirectoryIntegrated, les deux bibliothèques suivantes doivent être installées : mssql-jdbc_auth-<version>-<arch>.dll (disponible dans le package de pilotes JDBC) et la bibliothèque d’authentification Azure Active Directory pour SQL Server (ADAL.DLL). La bibliothèque ADAL peut être installée dans le cadre de l’installation du pilote Microsoft ODBC pour SQL Server ou du pilote Microsoft OLE DB pour SQL Server.Important: If authentication is set to ActiveDirectoryIntegrated, the following two libraries need to be installed: mssql-jdbc_auth-<version>-<arch>.dll (available in the JDBC driver package) and Azure Active Directory Authentication Library for SQL Server (ADAL.DLL) ADAL can be installed by installing the Microsoft ODBC Driver for SQL Server or Microsoft OLE DB Driver for SQL Server. Le pilote JDBC ne prend en charge que les versions 1.0.2028.318 et ultérieures d’ADAL.DLL.The JDBC driver only supports version 1.0.2028.318 and higher for ADAL.DLL.

Remarque : Quand la propriété Authentication est définie avec une valeur autre que NotSpecified, le pilote utilise par défaut le chiffrement TLS (Transport Layer Security), anciennement SSL (Secure Sockets Layer).Note: When the authentication property is set to any value other than NotSpecified, the driver by default uses Transport Layer Security (TLS), previously known as Secure Sockets Layer (SSL), encryption.

Pour savoir comment configurer l’authentification Azure Active Directory, consultez Se connecter à une base de données SQL avec l’authentification Azure Active Directory.For information on how to configure Azure Active Directory authentication visit Connecting to SQL Database By Using Azure Active Directory Authentication.
authenticationSchemeauthenticationScheme

StringString

NativeAuthenticationNativeAuthentication
Indique le genre de sécurité intégrée que votre application doit utiliser.Indicates which kind of integrated security you want your application to use. Les valeurs possibles sont JavaKerberos, NTLM et NativeAuthentication (par défaut).Possible values are JavaKerberos, NTLM, and the default NativeAuthentication.

Si vous utilisez authenticationScheme=JavaKerberos, vous devez spécifier le nom de domaine complet (FQDN) dans la propriété serverName ou la propriété serverSpn.When using authenticationScheme=JavaKerberos, you must specify the fully qualified domain name (FQDN) in the serverName or serverSpn property. Sinon, une erreur se produit (serveur introuvable dans la base de données Kerberos).Otherwise, an error occurs (Server not found in Kerberos database).

Pour plus d'informations sur l'utilisation de authenticationScheme=JavaKerberos, consultez Utilisation de l'authentification intégrée Kerberos pour se connecter à SQL Server.For more information on using authenticationScheme=JavaKerberos, see Using Kerberos integrated authentication to connect to SQL Server.

Si vous utilisez authenticationScheme=NTLM, vous devez spécifier le domaine Windows à utiliser pour l’authentification avec NTLM dans la propriété domain ou la propriété domainName, ainsi que les informations d’identification Windows dans les propriétés user ou userName et password.When using authenticationScheme=NTLM, you must specify the Windows domain to authenticate in using NTLM in domain or domainName property, as well as the Windows credentials in user or userName and password properties. Sinon, une erreur se produit (les propriétés de connexion doivent être spécifiées).Otherwise, an error occurs (connection properties must be specified).
cancelQueryTimeoutcancelQueryTimeout

intint

-1-1
À compter de la version 6.4 de Microsoft JDBC Driver pour SQL Server, cette propriété peut être utilisée pour annuler le délai queryTimeout défini sur la connexion.Beginning with Microsoft JDBC Driver 6.4 for SQL Server, this property can be used to cancel queryTimeout set on the connection. L’exécution de la requête se bloque et ne lève pas d’exception si la connexion TCP à SQL Server est annulée en mode silencieux.Query execution hangs and does not throw exception if TCP connection to SQL Server is silently dropped. Cette propriété s’applique uniquement si « queryTimeout » est également défini sur la connexion.This property is only applicable if 'queryTimeout' is also set on the connection.

Le pilote attend la valeur totale en secondes de cancelQueryTimeout + queryTimeout pour annuler la connexion et fermer le canal.The driver waits the total amount of cancelQueryTimeout + queryTimeout seconds, to drop the connection and close the channel.

La valeur par défaut de cette propriété est -1 et le comportement consiste à attendre indéfiniment.The default value for this property is -1 and behavior is to wait indefinitely.
columnEncryptionSettingcolumnEncryptionSetting

StringString
[« Activé » | « Désactivé »]["Enabled" | "Disabled"]

DésactivéDisabled
Affectez la valeur « Enabled » pour utiliser la fonctionnalité Always Encrypted (AE) à compter de Microsoft JDBC Driver 6.0 pour SQL Server.Set to "Enabled" to use the Always Encrypted (AE) feature beginning with Microsoft JDBC Driver 6.0 for SQL Server. Quand la fonctionnalité AE est activée, le pilote JDBC chiffre et déchiffre de manière transparente les données sensibles stockées dans des colonnes de base de données chiffrées sur l’ordinateur SQL Server.When AE is enabled, the JDBC driver transparently encrypts and decrypts sensitive data stored in encrypted database columns in the SQL Server.

Pour plus d’informations sur columnEncryptionSetting, consultez Utiliser Always Encrypted avec le pilote JDBC.For more information about columnEncryptionSetting, see Using Always Encrypted with the JDBC driver for more details.

Remarque : Always Encrypted est disponible avec SQL Server 2016 et les versions ultérieures.Note: Always Encrypted is available with SQL Server 2016 or later versions.
databaseName,databaseName,
databasedatabase

StringString
[<=128 char][<=128 char]

nullnull
Nom de la base de données à laquelle se connecter.The name of the database to connect to.

S'il n'est pas indiqué, une connexion à la base de données par défaut est établie.If not stated, a connection is made to the default database.
domainName,domainName,
domainedomain

StringString
nullnull
Domaine Windows pour l’authentification avec NTLM.The Windows domain to authenticate in using NTLM.
disableStatementPoolingdisableStatementPooling

booleanboolean
["true" | "false"]["true" | "false"]

truetrue
Indicateur spécifiant si le regroupement d’instructions doit être utilisé.Flag indicating if the statement pooling should be used.
enablePrepareOnFirst...enablePrepareOnFirst...
PreparedStatementCallPreparedStatementCall

booleanboolean
["true" | "false"]["true" | "false"]

falsefalse
enablePrepareOnFirstPreparedStatementCallenablePrepareOnFirstPreparedStatementCall

Affectez la valeur « true » pour activer la création du handle d’instruction préparée en appelant sp_prepexec lors de la première exécution de l’instruction préparée.Set to "true" to enable the prepared statement handle creation by calling sp_prepexec in first execution of prepared statement.

Affectez la valeur « false » pour modifier la première exécution d’une instruction préparée de façon à appeler sp_executesql sans préparer d’instruction. À la deuxième exécution, elle appellera sp_prepexec pour configurer un handle d’instruction préparée.Set to "false" to change the first execution of a prepared statement to call sp_executesql and not prepare a statement, once the second execution happens it would call sp_prepexec to set up a prepared statement handle.
enclaveAttestationUrlenclaveAttestationUrl

StringString

nullnull
À compter de Microsoft JDBC Driver 8.2 pour SQL Server, cette propriété facultative indique l’URL de point de terminaison du service d’attestation à utiliser pour Always Encrypted avec enclaves sécurisées.Beginning with Microsoft JDBC Driver 8.2 for SQL Server, this optional property indicates the attestation service endpoint url to use for Always Encrypted with secure enclaves.

Pour plus d’informations, consultez Always Encrypted avec enclaves sécurisées.For more information, see Always Encrypted with secure enclaves.
enclaveAttestationProtocolenclaveAttestationProtocol

StringString

nullnull
À compter de Microsoft JDBC Driver 8.2 pour SQL Server, cette propriété facultative indique le protocole d’attestation à utiliser pour Always Encrypted avec enclaves sécurisées.Beginning with Microsoft JDBC Driver 8.2 for SQL Server, this optional property indicates the attestation protocol to use for Always Encrypted with secure enclaves. Actuellement, HGS est la seule valeur possible pour ce champ.Currently, the only supported value for this field is HGS.

Pour plus d’informations, consultez Always Encrypted avec enclaves sécurisées.For more information, see Always Encrypted with secure enclaves.
encryptencrypt

booleanboolean
["true" | "false"]["true" | "false"]

falsefalse
Affecter la valeur « true » pour spécifier que le SQL ServerSQL Server utilise le chiffrement TLS pour toutes les données envoyées entre le client et le serveur si le serveur a un certificat installé.Set to "true" to specify that the SQL ServerSQL Server uses TLS encryption for all the data sent between the client and the server if the server has a certificate installed. La valeur par défaut est « false ».The default value is "false".

À compter de la version 6.0 de Microsoft JDBC Driver pour SQL Server, il existe un nouveau paramètre de connexion, « authentication », qui utilise le chiffrement TLS par défaut.Beginning with Microsoft JDBC Driver 6.0 for SQL Server, there is a new connection setting 'authentication' that uses TLS encryption by default.

Pour plus d’informations, consultez la propriété « authentification ».For more information, see the 'authentication' property.
failoverPartnerfailoverPartner

StringString

nullnull
Nom du serveur de basculement utilisé dans la configuration de la mise en miroir de bases de données.The name of the failover server used in a database mirroring configuration. Cette propriété est utilisée en cas d'échec de la connexion initiale au serveur principal ; après avoir établi la connexion initiale, cette propriété est ignorée.This property is used for an initial connection failure to the principal server; after you make the initial connection, this property is ignored. Elle doit être utilisée avec la propriété databaseName.Must be used in conjunction with databaseName property.

Remarque : Le pilote ne prend pas en charge la spécification du numéro de port de l’instance du serveur pour l’instance du partenaire de basculement dans le cadre de la propriété failoverPartner dans la chaîne de connexion.Note: The driver does not support specifying the server instance port number for the failover partner instance as part of the failoverPartner property in the connection string. Toutefois, la spécification des propriétés serverName, instanceName et portNumber de l’instance du serveur principal et la propriété failoverPartner de l’instance du partenaire de basculement dans la même chaîne de connexion est prise en charge.However, specifying the serverName, instanceName, and portNumber properties of the principal server instance and failoverPartner property of the failover partner instance in the same connection string is supported.

Si vous spécifiez un nom de réseau virtuel dans la propriété de connexion Server, vous ne pourrez pas utiliser la mise en miroir de bases de données.If you specify a Virtual Network Name in the Server connection property, you cannot use database mirroring. Pour plus d'informations, consultez Prise en charge de la haute disponibilité et de la récupération d'urgence par le pilote JDBC.For more information, see JDBC driver support for High Availability, disaster recovery
fipsfips

booleanboolean
["true" | "false"]["true" | "false"]

"false""false"
Pour la machine virtuelle Java compatible FIPS, cette propriété doit être true.For FIPS enabled JVM this property should be true.
fipsProviderfipsProvider

StringString

nullnull
Fournisseur FIPS configuré dans la machine virtuelle Java,FIPS provider configured in JVM. par exemple BCFIPS ou SunPKCS11-NSS.For example, BCFIPS or SunPKCS11-NSS. Supprimé dans la version 6.4.0 : consultez les détails ici.Removed in version 6.4.0 - see the details Here.
gsscredentialgsscredential

org.ietf.jgss.GSSCredentialorg.ietf.jgss.GSSCredential

nullnull
À compter de la version 6.2 de Microsoft JDBC Driver pour SQL Server, les informations d’identification de l’utilisateur à utiliser pour la délégation Kerberos contrainte peuvent être transmises dans cette propriété.Beginning with Microsoft JDBC Driver 6.2 for SQL Server, user credentials to be used for Kerberos Constrained Delegation can be passed in this property.

Elle doit être utilisée avec integratedSecurity défini sur true et JavaKerberos défini sur authenticationScheme.This should be used with integratedSecurity as true and JavaKerberos as authenticationScheme.
hostNameInCertificatehostNameInCertificate

StringString

nullnull
Nom d’hôte à utiliser pour valider le certificat TLS/SSL SQL ServerSQL Server.The host name to be used in validating the SQL ServerSQL Server TLS/SSL certificate.

Si la propriété hostNameInCertificate n’est pas spécifiée ou si elle a la valeur Null, le Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server utilise la valeur de propriété serverName sur l’URL de connexion comme nom d’hôte pour valider le certificat TLS/SSL SQL ServerSQL Server.If the hostNameInCertificate property is unspecified or set to null, the Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server uses the serverName property value on the connection URL as the host name to validate the SQL ServerSQL Server TLS/SSL certificate.

Remarque : Cette propriété est utilisée en association avec les propriétés encrypt/authentication et la propriété trustServerCertificate.Note: This property is used in combination with the encrypt/authentication properties and the trustServerCertificate property. Elle affecte la validation du certificat si et seulement si la connexion utilise le chiffrement TLS et que trustServerCertificate a la valeur « false ».This property affects the certificate validation, if and only if the connection uses TLS encryption and the trustServerCertificate is set to "false". Pour garantir une connexion TLS, vérifiez que la valeur passée à hostNameInCertificate correspond au nom CN (Nom commun) ou DNS dans le nom SAN (Autre nom du sujet) du certificat de serveur.Make sure the value passed to hostNameInCertificate matches the Common Name (CN) or DNS name in the Subject Alternate Name (SAN) in the server certificate for a TLS connection to succeed. Pour plus d’informations, consultez Comprendre la prise en charge du chiffrement.For more information, see Understanding encryption support.
INSTANCENAMEinstanceName

StringString
[<=128 char][<=128 char]

nullnull
Nom de l’instance de SQL ServerSQL Server à laquelle se connecter.The SQL ServerSQL Server instance name to connect to. S'il n'est pas spécifié, une connexion à l'instance par défaut est établie.When it is not specified, a connection is made to the default instance. Si l'instanceName et le port sont tous deux spécifiés, consultez les notes relatives au port.For the case where both the instanceName and port are specified, see the notes for port.

Si vous spécifiez un nom de réseau virtuel dans la propriété de connexion Server, vous ne pourrez pas utiliser la propriété de connexion instanceName.If you specify a Virtual Network Name in the Server connection property, you cannot use instanceName connection property. Consultez Prise en charge par le pilote JDBC de la haute disponibilité et de la récupération d'urgence pour plus d’informations.See JDBC Driver Support for High Availability, Disaster Recovery for more information.
integratedSecurityintegratedSecurity

booleanboolean
[« true »|« false »]["true"|"false"]

falsefalse
Affectez la valeur « true » pour indiquer que les informations d’identification Windows sont utilisées par SQL ServerSQL Server sur les systèmes d’exploitation Windows.Set to "true" to indicate that Windows credentials are used by SQL ServerSQL Server on Windows operating systems. Si la valeur est « true », le pilote JDBC recherche des informations d’identification fournies lors de la connexion de l’utilisateur à l’ordinateur ou au réseau dans la mémoire cache des informations d’identification de l’ordinateur local.If "true," the JDBC driver searches the local computer credential cache for credentials that were provided when a user signed in to the computer or network.

Affectez la valeur « true » (avec authenticationscheme=JavaKerberos) pour indiquer que SQL ServerSQL Server utilise les informations d’identification Kerberos.Set to "true" (with authenticationscheme=JavaKerberos), to indicate that Kerberos credentials are used by SQL ServerSQL Server. Pour plus d'informations sur l'authentification Kerberos, consultez Utilisation de l'authentification intégrée Kerberos pour se connecter à SQL Server.For more information on Kerberos authentication, see Using Kerberos integrated authentication to connect to SQL Server.

Affectez la valeur « true » (avec authenticationscheme=NTLM) pour indiquer que SQL ServerSQL Server utilise les informations d’identification NTLM.Set to "true" (with authenticationscheme=NTLM), to indicate that NTLM credentials are used by SQL ServerSQL Server.

Si la valeur est « false », le nom d'utilisateur et le mot de passe doivent être fournis.If "false", the username and password must be supplied.
jaasConfigurationNamejaasConfigurationName

StringString

SQLJDBCDriverSQLJDBCDriver
À compter de la version 6.2 de Microsoft JDBC Driver pour SQL Server, chaque connexion à SQL Server peut avoir son propre fichier de configuration de connexion JAAS pour établir la connexion Kerberos.Beginning with Microsoft JDBC Driver 6.2 for SQL Server, each connection to SQL Server can have its own JAAS Login Configuration file to establish Kerberos connection. Le nom de ce fichier peut être transmis par le biais de cette propriété.Name of the Login Configuration file can be passed through this property.
Par défaut, le pilote définit la propriété useDefaultCcache = true pour les machines virtuelles Java IBM et useTicketCache = true pour les autres machines virtuelles Java.By default, driver sets property useDefaultCcache = true for IBM JVMs, and useTicketCache = true for other JVMs.
keyStoreAuthenticationkeyStoreAuthentication

StringString

nullnull
À compter de la version 6.0 de Microsoft JDBC Driver pour SQL Server, cette propriété identifie le magasin de clés à configurer de manière transparente pour la connexion avec Always Encrypted et détermine le mécanisme d’authentification utilisé auprès du magasin de clés.Beginning with Microsoft JDBC Driver 6.0 for SQL Server, this property identifies which key store to seamlessly set up for the connection with Always Encrypted and determines an authentication mechanism used to authenticate to the key store. La version 6.0 de Microsoft JDBC Driver pour SQL Server prend en charge la configuration transparente du magasin de clés Java avec cette propriété, pour laquelle vous devez définir « keyStoreAuthentication=JavaKeyStorePassword ».Microsoft JDBC Driver 6.0 for SQL Server supports setting up of the Java Key Store seamlessly using this property for which you need to set "keyStoreAuthentication=JavaKeyStorePassword". Il est à noter que, pour pouvoir utiliser cette propriété, vous devez également définir les propriétés keyStoreLocation et keyStoreSecret du magasin de clés Java.Note that to use this property, you also need to set the keyStoreLocation and keyStoreSecret properties for the Java Key Store.

Pour plus d'informations, consultez Utilisation d'Always Encrypted avec le pilote JDBC.For more information, visit Using Always Encrypted with the JDBC driver.
keyStoreLocationkeyStoreLocation

StringString

nullnull
Lorsque keyStoreAuthentication=JavaKeyStorePassword, la propriété keyStoreLocation identifie le chemin du fichier de magasin de clés Java qui stocke la clé principale de colonne à utiliser avec les données Always Encrypted.When keyStoreAuthentication=JavaKeyStorePassword, the keyStoreLocation property identifies the path to the Java keystore file that stores the column master key to be used with Always Encrypted data. Il est à noter que le chemin doit inclure le nom de fichier du magasin de clés.Note that the path must include the keystore filename.

Pour plus d'informations, consultez Utilisation d'Always Encrypted avec le pilote JDBC.For more information, visit Using Always Encrypted with the JDBC driver.
keyStoreSecretkeyStoreSecret

StringString

nullnull
Lorsque keyStoreAuthentication=JavaKeyStorePassword, la propriété keyStoreSecret identifie le mot de passe à utiliser pour le magasin de clés ainsi que pour la clé.When keyStoreAuthentication=JavaKeyStorePassword, the keyStoreSecret property identifies the password to use for the keystore as well as for the key. Il est à noter que, pour pouvoir utiliser le magasin de clés Java, il est nécessaire que le magasin de clés et le mot de passe de clé soient identiques.Note that for using the Java Key Store the keystore and the key password must be the same.

Pour plus d'informations, consultez Utilisation d'Always Encrypted avec le pilote JDBC.For more information, visit Using Always Encrypted with the JDBC driver.
lastUpdateCountlastUpdateCount

booleanboolean
["true" | "false"]["true" | "false"]

truetrue
Une valeur « true » retourne uniquement le dernier nombre de mises à jour à partir d'une instruction SQL transmise au serveur et peut être utilisée dans des instructions uniques SELECT, INSERT ou DELETE pour ignorer les nombres de mises à jours supplémentaires causés par les déclencheurs du serveur.A "true" value only returns the last update count from an SQL statement passed to the server, and it can be used on single SELECT, INSERT, or DELETE statements to ignore additional update counts caused by server triggers. La définition de cette propriété sur « false » provoque le retour de tous les nombres de mises à jour, y compris ceux retournés par les déclencheurs du serveur.Setting this property to "false" causes all update counts to be returned, including those returned by server triggers.

Remarque : Cette propriété est applicable uniquement lorsqu'elle est utilisée avec les méthodes executeUpdate.Note: This property only applies when it is used with the executeUpdate methods. Toutes les autres méthodes execute retournent l’ensemble des résultats et des nombres de mises à jour.All other execute methods return all results and update counts. Cette propriété affecte uniquement les nombres de mises à jour retournés par les déclencheurs du serveur.This property only affects update counts returned by server triggers. Elle n'affecte pas les jeux de résultats ou les erreurs provenant de l'exécution du déclencheur.It does not affect result sets or errors that result as part of trigger execution.
lockTimeoutlockTimeout

intint

-1-1
Nombre de millisecondes à attendre avant que la base de données ne rapporte l'expiration d'un délai de verrouillage. Par défaut, la durée de l'attente est indéterminée.The number of milliseconds to wait before the database reports a lock time-out. The default behavior is to wait indefinitely. Si elle est spécifiée, cette valeur devient la valeur par défaut pour toutes les instructions de la connexion.If it is specified, this value is the default for all statements on the connection. Il est à noter que Statement.setQueryTimeout() peut être utilisé pour définir le délai d’expiration de certaines instructions.Note that Statement.setQueryTimeout() can be used to set the time-out for specific statements. La valeur peut être 0, ce qui signifie aucune attente.The value can be 0, which specifies no wait.
loginTimeoutloginTimeout

intint
[0..65535][0..65535]

1515
Nombre de secondes que le pilote doit attendre avant l'expiration d'une connexion qui a échoué.The number of seconds the driver should wait before timing out a failed connection. La valeur zéro indique que le délai d'attente correspond au délai d'attente système par défaut, lequel est de 15 secondes.A zero value indicates that the timeout is the default system timeout, which is specified as 15 seconds by default. Une valeur différente de zéro correspond au nombre de secondes que le pilote doit attendre avant l'expiration d'une connexion échouée.A non-zero value is the number of seconds the driver should wait before timing out a failed connection.

Si vous spécifiez un nom de réseau virtuel dans la propriété de connexion Server, vous devez spécifier une valeur de délai de connexion de trois minutes minimum, afin que les connexions de basculement de serveur aient suffisamment de temps pour s’établir.If you specify a Virtual Network Name in the Server connection property, you should specify a timeout value of three minutes or more to allow sufficient time for a failover connection to succeed. Pour plus d'informations, consultez Prise en charge de la haute disponibilité et de la récupération d'urgence par le pilote JDBC.See JDBC driver support for High Availability, disaster recovery for more information.
msiClientIdmsiClientId

StringString

nullnull
ID client de l’identité Managed Service Identity (MSI) à utiliser pour acquérir accessToken lors de l’établissement d’une connexion avec le mode d’authentification ActiveDirectoryMSI.The Client ID of the Managed Service Identity (MSI) to be used for acquiring accessToken when establishing a connection with ActiveDirectoryMSI authentication mode.
multiSubnetFailovermultiSubnetFailover

BooleanBoolean

falsefalse
Spécifiez toujours multiSubnetFailover=true lors de la connexion à l’écouteur de groupe de disponibilité d’un groupe de disponibilité SQL Server 2012 (11.x)SQL Server 2012 (11.x) ou d’une instance de cluster de basculement SQL Server 2012 (11.x)SQL Server 2012 (11.x).Always specify multiSubnetFailover=true when connecting to the availability group listener of a SQL Server 2012 (11.x)SQL Server 2012 (11.x) availability group or a SQL Server 2012 (11.x)SQL Server 2012 (11.x) Failover Cluster Instance. multiSubnetFailover=true configure le Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server pour accélérer la détection et la connexion au serveur (actuellement) actif.multiSubnetFailover=true configures Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server to provide faster detection of and connection to the (currently) active server. Les valeurs possibles sont true et false.Possible values are true and false. Consultez Prise en charge par le pilote JDBC de la haute disponibilité et de la récupération d'urgence pour plus d’informations.See JDBC Driver Support for High Availability, Disaster Recovery for more information.

Vous pouvez accéder par programmation à la propriété de connexion multiSubnetFailover avec getPropertyInfo, getMultiSubnetFailover et setMultiSubnetFailover.You can programmatically access the multiSubnetFailover connection property with getPropertyInfo, getMultiSubnetFailover, and setMultiSubnetFailover.

Remarque : À compter de la version 6.0 de Microsoft JDBC Driver pour SQL Server, il n’est plus nécessaire de définir multiSubnetFailover sur « true » lors de la connexion à un écouteur de groupe de disponibilité.Note: Beginning with Microsoft JDBC Driver 6.0 for SQL Server, it is no longer required to set multiSubnetFailover to "true" when connecting to an Availability Group Listener. Une nouvelle propriété, transparentNetworkIPResolution, activée par défaut, assure la détection du serveur (actuellement) actif et la connexion à ce serveur.A new property, transparentNetworkIPResolution, which is enabled by default, provides the detection of and connection to the (currently) active server.
packetSizepacketSize

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

80008000
Taille de paquet du réseau utilisée pour communiquer avec SQL Server, spécifiée en octets.The network packet size used to communicate with SQL Server, specified in bytes. Une valeur de -1 indique l'utilisation de la taille de paquet par défaut du serveur.A value of -1 indicates using the server default packet size. Une valeur de 0 indique la valeur maximale, à savoir 32767.A value of 0 indicates using the maximum value, which is 32767. Si cette propriété est définie sur une valeur située en dehors des limites acceptables, une exception se produit.If this property is set to a value outside the acceptable range, an exception occurs.

Important : Nous déconseillons d’utiliser la propriété packetSize lorsque le chiffrement est activé (encrypt=true).Important: We do not recommend using the packetSize property when the encryption is enabled (encrypt=true). Sinon, le pilote risque de générer une erreur de connexion.Otherwise, the driver might raise a connection error. Pour plus d’informations, consultez la méthode setPacketSize de la classe SQLServerDataSource.For more information, see the setPacketSize method of the SQLServerDataSource class.
mot de passepassword

StringString
[<=128 char][<=128 char]

nullnull
Mot de passe de la base de données, en cas de connexion avec l’utilisateur et le mot de passe SQL.The database password, in case of connection with SQL user and password.
Pour la connexion Kerberos avec le nom de principal et le mot de passe, cette propriété est définie sur le mot de passe du principal Kerberos.For Kerberos connection with principal name and password, this property is set to Kerberos Principal password.
portNumber,portNumber,
portport

intint
[0..65535][0..65535]

14331433
Port sur lequel SQL ServerSQL Server est à l’écoute.The port where SQL ServerSQL Server is listening. Si le numéro du port est spécifié dans la chaîne de connexion, aucune demande n’est formulée à SQLbrowser.If the port number is specified in the connection string, no request to SQLbrowser is made. Lorsque le port et instanceName sont spécifiés, la connexion se fait vers le port spécifié.When the port and instanceName are both specified, the connection is made to the specified port. Cependant, instanceName est validé et une erreur est générée s’il ne correspond pas au port.However, the instanceName is validated and an error is thrown if it does not match the port.

Important : Il est recommandé de toujours spécifier le numéro du port, car cette pratique est plus sûre que l’utilisation de SQLbrowser.Important: We recommend that the port number is always specified, as this is more secure than using SQLbrowser.
queryTimeoutqueryTimeout

intint

-1-1
Nombre de secondes à attendre avant expiration du délai d’attente sur une requête.The number of seconds to wait before a timeout has occurred on a query. La valeur -1 par défaut signifie un délai infini.The default value is -1, which means infinite timeout. La valeur 0 implique également d’attendre indéfiniment.Setting this to 0 also implies to wait indefinitely.
responseBufferingresponseBuffering

StringString
["full" | "adaptive"]["full" | "adaptive"]

adaptiveadaptive
Si cette propriété a la valeur « adaptive », les données possibles minimales sont mises en mémoire tampon en cas de nécessité.If this property is set to "adaptive", the minimum possible data is buffered when necessary. Le mode par défaut est « adaptive ».The default mode is "adaptive."

Lorsque cette propriété a la valeur « full », le jeu de résultats entier est lu à partir du serveur lorsqu'une instruction est exécutée.When this property is set to "full", the entire result set is read from the server when a statement is executed.

Remarque : Après la mise à niveau du pilote JDBC à compter de la version 1.2, le comportement de mise en mémoire tampon par défaut est « adaptive ».Note: After upgrading the JDBC driver from version 1.2, the default buffering behavior will be "adaptive." Si votre application n’a jamais défini la propriété « responseBuffering » et si vous souhaitez conserver le comportement par défaut de la version 1.2 dans votre application, vous devez affecter la valeur « full » à la propriété responseBufferring dans les propriétés de connexion ou par le biais de la méthode setResponseBuffering de l’objet SQLServerStatement.If your application has never set the "responseBuffering" property and you want to keep the version 1.2 default behavior in your application, you must set the responseBufferring property to "full" either in the connection properties or by using the setResponseBuffering method of the SQLServerStatement object.
selectMethodselectMethod

StringString
["direct" | "cursor"]["direct" | "cursor"]

directesdirect
Si cette propriété a la valeur « cursor », un curseur de base de données est créé pour chaque requête créée sur la connexion pour les curseurs TYPE_FORWARD_ONLY et CONCUR_READ_ONLY.If this property is set to "cursor," a database cursor is created for each query created on the connection for TYPE_FORWARD_ONLY and CONCUR_READ_ONLY cursors. Cette propriété n’est généralement requise que si l’application génère de grands jeux de résultats qui ne peuvent pas être entièrement contenus dans la mémoire du client.This property is typically required only if the application generates large result sets that cannot be fully contained in client memory. Si cette propriété est définie sur « curseur », seul un nombre restreint de lignes de jeux de résultats est conservé dans la mémoire du client.When this property is set to "cursor," only a limited number of result set rows are retained in client memory.

Par défaut, toutes les lignes de jeux de résultats sont conservées dans la mémoire du client.The default behavior is that all result set rows are retained in client memory. Ce comportement est le plus rapide si l'application doit traiter toutes les lignes.This behavior provides the fastest performance when the application is processing all rows.
sendStringParameters...sendStringParameters...
AsUnicodeAsUnicode

booleanboolean
["true" | "false"]["true" | "false"]

truetrue
sendStringParametersAsUnicodesendStringParametersAsUnicode

Si la propriété sendStringParametersAsUnicode a la valeur « true », les paramètres de chaîne sont envoyés au serveur au format Unicode.If the sendStringParametersAsUnicode property is set to "true", String parameters are sent to the server in Unicode format.

Si la propriété sendStringParametersAsUnicode a la valeur « false », les paramètres de chaîne sont envoyés au serveur dans un format non Unicode, par exemple ASCII/MBCS.If the sendStringParametersAsUnicode property is set to "false", String parameters are sent to the server in non-Unicode format such as ASCII/MBCS instead of Unicode.

La valeur par défaut de la propriété sendStringParametersAsUnicode est « true ».The default value for the sendStringParametersAsUnicode property is "true".

Remarque : La propriété sendStringParametersAsUnicode est uniquement vérifiée lors de l'envoi d'une valeur de paramètre avec les types JDBC CHAR, VARCHAR ou LONGVARCHAR.Note: The sendStringParametersAsUnicode property is only checked when sending a parameter value with CHAR, VARCHAR, or LONGVARCHAR JDBC types. Les nouvelles méthodes JDBC 4.0 prenant en charge les caractères nationaux, notamment les méthodes setNString, setNCharacterStream et setNClob des classes SQLServerPreparedStatement et SQLServerCallableStatement, envoient toujours leurs valeurs de paramètres au serveur au format Unicode indépendamment de la valeur de cette propriété.The new JDBC 4.0 national character methods, such as the setNString, setNCharacterStream, and setNClob methods of SQLServerPreparedStatement and SQLServerCallableStatement classes, always send their parameter values to the server in Unicode regardless of the setting of this property.

Pour garantir des performances optimales avec les types de données JDBC CHAR, VARCHAR et LONGVARCHAR, une application doit affecter la valeur « false » à la propriété sendStringParametersAsUnicode et utiliser les méthodes setString, setCharacterStream et setClob et basées sur les caractères non nationaux des classes SQLServerPreparedStatement et SQLServerCallableStatement.For optimal performance with the CHAR, VARCHAR, and LONGVARCHAR JDBC data types, an application should set the sendStringParametersAsUnicode property to "false" and use the setString, setCharacterStream, and setClob non-national character methods of the SQLServerPreparedStatement and SQLServerCallableStatement classes.

Quand l’application affecte la valeur « false » à la propriété sendStringParametersAsUnicode et qu’elle emploie une méthode basée sur des caractères non nationaux pour accéder aux types de données Unicode côté serveur (par exemple nchar, nvarchar et ntext), certaines données risquent d’être perdues si le classement de la base de données ne prend pas en charge les caractères des paramètres de chaîne passés à la méthode utilisant des caractères non nationaux.When the application sets the sendStringParametersAsUnicode property to "false" and uses a non-national character method to access Unicode data types on the server side (such as nchar, nvarchar and ntext), some data might be lost if the database collation does not support the characters in the String parameters passed by the non-national character method.

Il est à noter qu’une application doit utiliser les méthodes basées sur les caractères nationaux setNString, setNCharacterStream et setNClob des classes SQLServerPreparedStatement et SQLServerCallableStatement pour les types de données JDBC NCHAR, NVARCHAR et LONGNVARCHAR.Note that an application should use the setNString, setNCharacterStream, and setNClob national character methods of the SQLServerPreparedStatement and SQLServerCallableStatement classes for the NCHAR, NVARCHAR, and LONGNVARCHAR JDBC data types.
sendTimeAsDatetimesendTimeAsDatetime

booleanboolean
["true" | "false"]["true" | "false"]

truetrue
Cette propriété a été ajoutée dans SQL ServerSQL Server JDBC Driver 3.0.This property was added in SQL ServerSQL Server JDBC Driver 3.0.

Affectez la valeur « true » pour envoyer les valeurs java.sql.Time au serveur en tant que valeurs SQL ServerSQL Server datetime.Set to "true" to send java.sql.Time values to the server as SQL ServerSQL Server datetime values.
Affectez la valeur « false » pour envoyer les valeurs java.sql.Time au serveur en tant que valeurs SQL ServerSQL Server time.Set to "false" to send java.sql.Time values to the server as SQL ServerSQL Server time values.

La valeur par défaut de cette propriété, actuellement « true », pourra être modifiée dans une prochaine version.The default value for this property is currently "true" and may change in a future release.

Pour savoir plus en détail comment Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server configure les valeurs java.sql.Time avant de les envoyer au serveur, consultez Configurer la manière dont les valeurs java.sql.Time sont envoyées au serveur.For more information about how the Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server configures java.sql.Time values before sending them to the server, see Configuring How java.sql.Time Values are Sent to the Server.
serverName,serverName,
serverserver

StringString

nullnull
Ordinateur exécutant SQL ServerSQL Server.The computer running SQL ServerSQL Server.

Vous pouvez également spécifier le nom du réseau virtuel d’un groupe de disponibilité Groupes de disponibilité AlwaysOnAlwaysOn Availability Groups.You can also specify the Virtual Network Name of a Groupes de disponibilité AlwaysOnAlwaysOn Availability Groups availability group. Pour plus d'informations, consultez Prise en charge de la haute disponibilité et de la récupération d'urgence par le pilote JDBC.See JDBC driver support for High Availability, disaster recovery for more information.
serverNameAsACEserverNameAsACE

booleanboolean
["true" | "false"]["true" | "false"]

falsefalse
À compter de Microsoft JDBC Driver 6.0 pour SQL Server, affectez la valeur « true » pour indiquer que le pilote doit traduire le nom du serveur Unicode en codage compatible ASCII (Punycode) pour la connexion.Beginning with Microsoft JDBC Driver 6.0 for SQL Server, set to "true" to indicate that the driver should translate the Unicode server name to ASCII compatible encoding (Punycode) for the connection. Si ce paramètre a la valeur « false », le pilote se connecte à l’aide du nom de serveur tel qu’il est fourni par l’utilisateur.If this setting is false, the driver connects using the server name as provided by the user.

Pour plus d’informations, consultez Fonctionnalités internationales du pilote JDBC.See International features of the JDBC driver for more details.
serverPreparedStatement...serverPreparedStatement...
DiscardThresholdDiscardThreshold

IntegerInteger

1010
serverPreparedStatementDiscardThresholdserverPreparedStatementDiscardThreshold

À compter de la version 6.2 de JDBC Driver pour SQL Server, cette propriété permet de contrôler le nombre maximal d’actions d’abandon d’instruction préparée en attente (sp_unprepare) par connexion avant l’exécution d’un appel pour nettoyer les handles en attente sur le serveur.Beginning with JDBC Driver 6.2 for SQL Server, this property can be used to control how many outstanding prepared statement discard actions (sp_unprepare) can be outstanding per connection before a call to clean up the outstanding handles on the server is executed.

Si elle a la valeur <=1, les actions d’annulation de la préparation sont exécutées immédiatement à la fermeture de l’instruction préparée.If this property is set to <= 1, unprepare actions are executed immediately on prepared statement close. Si elle a la valeur >1, ces appels sont regroupés pour éviter une surcharge d’appels trop fréquents de sp_unprepare.If it is set to >1 these calls are batched together to avoid overhead of calling sp_unprepare too often.
serverSpnserverSpn

StringString

nullnull
À compter de Microsoft JDBC Driver 4.2 pour SQL Server, cette propriété facultative peut être utilisée pour spécifier le nom de principal du service (SPN) pour une connexion Java Kerberos.Beginning in Microsoft JDBC Driver 4.2 for SQL Server, this optional property can be used to specify the Service Principal Name (SPN) for a Java Kerberos connection. Elle est utilisée conjointement avec authenticationScheme.It is used in conjunction with authenticationScheme.

Pour spécifier le nom de principal du service, vous pouvez utiliser le format « MSSQLSvc/fqdn:port@REALM », où fqdn désigne le nom de domaine complet, port désigne le numéro de port et REALM désigne le domaine Kerberos du serveur SQL Server en majuscules.To specify the SPN, it can be in the form of: "MSSQLSvc/fqdn:port@REALM" where fqdn is the fully qualified domain name, port is the port number, and REALM is the Kerberos realm of the SQL Server in upper-case letters.

Remarque : la partie @REALM est facultative si le domaine par défaut du client (comme spécifié dans la configuration Kerberos) est le même que le domaine Kerberos pour le serveur SQL Server.Note: the @REALM is optional if the default realm of the client (as specified in the Kerberos configuration) is the same as the Kerberos realm for the SQL Server.

Pour plus d'informations sur l'utilisation de serverSpn avec Java Kerberos, consultez Utilisation de l'authentification intégrée Kerberos pour se connecter à SQL Server.For more information on using serverSpn with Java Kerberos, see Using Kerberos integrated authentication to connect to SQL Server.
statementPooling…statementPooling...
CacheSizeCacheSize

intint

00
statementPoolingCacheSizestatementPoolingCacheSize

À compter de la version 6.4 de JDBC Driver pour SQL Server, cette propriété permet d’activer la mise en cache des handles d’instructions préparées dans le pilote.Beginning with JDBC Driver 6.4 for SQL Server, this property can be used to enable Prepared Statement Handle Caching in the driver.

Cette propriété définit la taille du cache du regroupement d’instructions.This property defines the size of the cache for statement pooling.

Cette propriété ne peut être utilisée que conjointement avec la propriété de connexion disableStatementPooling qui doit avoir la valeur « false ».This property can only be used in conjunction with disableStatementPooling connection property which should be set to "false". Si disableStatementPooling a la valeur « true » ou statementPoolingCacheSize la valeur 0, la mise en cache des handles d’instructions préparées est désactivée.Setting disableStatementPooling to "true" or statementPoolingCacheSize to 0 disables prepared statement handle caching.
socketTimeoutsocketTimeout

intint

00
Nombre de millisecondes à attendre avant expiration du délai d’attente de lecture ou d’acceptation d’un socket.The number of milliseconds to wait before a timeout is occurred on a socket read or accept. La valeur 0 par défaut signifie un délai infini.The default value is 0, which means infinite timeout.
sslProtocolsslProtocol

StringString

TLSTLS
À compter de la version 6.4 du pilote JDBC pour SQL Server, cette propriété permet de spécifier le protocole TLS à utiliser pendant la connexion sécurisée.Beginning with JDBC Driver 6.4 for SQL Server, this property can be used to specify the TLS protocol to be considered during secure connection.
Les valeurs possibles sont les suivantes : TLS, TLSv1, TLSv1.1 et TLSv1.2.Possible values are: TLS, TLSv1, TLSv1.1, and TLSv1.2.

Pour plus d’informations, consultez SSLProtocol.For more information, see SSLProtocol.
transparentNetwork…transparentNetwork...
IPResolutionIPResolution

booleanboolean
["true" | "false"]["true" | "false"]

truetrue
transparentNetworkIPResolutiontransparentNetworkIPResolution

À compter de la version 6.0 de Microsoft JDBC Driver pour SQL Server, cette propriété assure une détection plus rapide du serveur (actuellement) actif et la connexion à ce serveur.Beginning with Microsoft JDBC Driver 6.0 for SQL Server, this property provides faster detection of and connection to the (currently) active server. Les valeurs possibles sont « true » (par défaut) et « false ».Possible values are "true" and "false" where "true" is the default value.

Avant la version 6.0 de Microsoft JDBC Driver pour SQL Server, l’application devait définir la chaîne de connexion de façon à inclure « multiSubnetFailover=true » pour indiquer qu’elle se connectait à un groupe de disponibilité AlwaysOn.Prior to Microsoft JDBC Driver 6.0 for SQL Server, an application had to set the connection string to include "multiSubnetFailover=true" to indicate that it was connecting to an AlwaysOn Availability Group. Si elle ne définissait le mot clé de connexion multiSubnetFailover sur « true », elle risquait de se heurter à un délai d’expiration lors de la connexion au groupe de disponibilité AlwaysOn.Without setting the multiSubnetFailover connection keyword to "true", an application might experience a timeout while connecting to an AlwaysOn Availability Group. À compter de la version 6.0 de Microsoft JDBC Driver pour SQL Server, l’application n’a plus besoin de définir multiSubnetFailover sur true.Beginning with Microsoft JDBC Driver 6.0 for SQL Server, an application does not need to set multiSubnetFailover to true anymore.

Remarque : Lorsque transparentNetworkIPResolution=true, la première tentative de connexion utilise 500 ms comme délai d’expiration.Note: When transparentNetworkIPResolution=true, the first connection attempt uses 500 ms as the timeout. Toutes les tentatives suivantes suivent la même logique de délai d’attente que la propriété multiSubnetFailover.Any subsequent attempts use the same timeout logic as used by the multiSubnetFailover property.
trustManagerClasstrustManagerClass

StringString

nullnull
Nom complet de la classe d’une implémentation javax.net.ssl.TrustManager personnalisée.The fully qualified class name of a custom javax.net.ssl.TrustManager implementation.
trustManager…trustManager...
ConstructorArgConstructorArg

StringString

nullnull
trustManagerConstructorArgtrustManagerConstructorArg

Argument facultatif à transmettre au constructeur de TrustManager.An optional argument to pass to the constructor of the TrustManager. Si trustManagerClass est spécifié et qu’une connexion chiffrée est demandée, c’est le TrustManager personnalisé qui est utilisé à la place du TrustManager par défaut basé sur le magasin de clés de la machine virtuelle Java du système.If trustManagerClass is specified and an encrypted connection is requested, the custom TrustManager is used rather than the default system JVM keystore-based TrustManager.
trustServerCertificatetrustServerCertificate

booleanboolean
["true" | "false"]["true" | "false"]

falsefalse
Affectez la valeur « True » pour spécifier que le Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server ne doit pas valider le certificat TLS/SSL SQL ServerSQL Server.Set to "true" to specify that the Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server does not validate the SQL ServerSQL Server TLS/SSL certificate.

Si la valeur est « true », le certificat TLS/SSL SQL ServerSQL Server est approuvé automatiquement quand la couche de communication est chiffrée à l’aide du protocole TLS.If "true", the SQL ServerSQL Server TLS/SSL certificate is automatically trusted when the communication layer is encrypted using TLS.

Si la valeur est « false », Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server valide le certificat TLS/SSL du serveur.If "false", the Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server validates the server TLS/SSL certificate. Si la validation du certificat de serveur échoue, le pilote génère une erreur et met fin à la connexion.If the server certificate validation fails, the driver raises an error and terminates the connection. La valeur par défaut est « false ».The default value is "false". Pour garantir une connexion TLS/SSL, vérifiez que la valeur passée à serverName correspond exactement au nom CN (Nom commun) ou DNS dans le nom SAN (Autre nom du sujet) du certificat de serveur.Make sure the value passed to serverName exactly matches the Common Name (CN) or DNS name in the Subject Alternate Name in the server certificate for a TLS/SSL connection to succeed. Pour plus d’informations, consultez Comprendre la prise en charge du chiffrement.For more information, see Understanding encryption support.

Remarque : Cette propriété est utilisée en association avec les propriétés encrypt/authentication.Note: This property is used in combination with the encrypt/authentication properties. Elle affecte la validation du certificat TLS/SSL de serveur si et seulement si la connexion utilise le chiffrement TLS.This property only affects server TLS/SSL certificate validation if and only if the connection uses TLS encryption.
trustStoretrustStore

StringString

nullnull
Chemin d'accès (y compris le nom de fichier) au fichier trustStore de certificat.The path (including filename) to the certificate trustStore file. Le fichier trustStore contient la liste des certificats approuvés par le client.The trustStore file contains the list of certificates that the client trusts.

Quand cette propriété n’est pas spécifiée ou a la valeur null, le pilote se fie aux règles de recherche de la fabrication du gestionnaire d’approbation pour déterminer le magasin de certificats à utiliser.When this property is unspecified or set to null, the driver relies on the trust manager factory's lookup rules to determine which certificate store to use.

Le TrustManagerFactory SunX509 par défaut essaie de localiser les informations approuvées dans l’ordre de recherche suivant :The default SunX509 TrustManagerFactory tries to locate the trusted material in the following search order:

Un fichier spécifié par la propriété système de machine virtuelle Java (JVM) « javax.net.ssl.trustStore ».A file specified by the "javax.net.ssl.trustStore" Java Virtual Machine (JVM) system property.

Fichier « <java-home>/lib/security/jssecacerts »."<java-home>/lib/security/jssecacerts" file.

Fichier « <java-home>/lib/security/cacerts »."<java-home>/lib/security/cacerts" file.



Pour plus d’informations, consultez la documentation d’interface SUNX509 TrustManager sur le site web de Sun Microsystems.For more information, see the SUNX509 TrustManager Interface documentation on the Sun Microsystems Web site.

Remarque : Elle affecte la recherche du trustStore du certificat si et seulement si la connexion utilise le chiffrement TLS et que la propriété trustServerCertificate a la valeur « false ».Note: This property only affects the certificate trustStore lookup, if and only if the connection uses TLS encryption and the trustServerCertificate property is set to "false".
trustStorePasswordtrustStorePassword

StringString

nullnull
Mot de passe utilisé pour vérifier l'intégrité des données trustStore.The password used to check the integrity of the trustStore data.

Si la propriété trustStore est définie mais que la propriété trustStorePassword n'est pas définie, l'intégrité du trustStore n'est pas vérifiée.If the trustStore property is set but the trustStorePassword property is not set, the integrity of the trustStore is not checked.

Quand les propriétés trustStore et trustStorePassword ne sont pas spécifiées, le pilote utilise les propriétés système JVM « javax.net.ssl.trustStore » et « javax.net.ssl.trustStorePassword ».When both trustStore and trustStorePassword properties are unspecified, the driver uses the JVM system properties, "javax.net.ssl.trustStore" and "javax.net.ssl.trustStorePassword". Si la propriété système « javax.net.ssl.trustStorePassword » n'est pas spécifiée, l'intégrité du trustStore n'est pas vérifiée.If the "javax.net.ssl.trustStorePassword" system property is not specified, the integrity of the trustStore is not checked.

Si la propriété trustStore n’est pas définie mais que la propriété trustStorePassword est définie, le pilote JDBC utilise le fichier spécifié par la propriété « javax.net.ssl.trustStore » comme magasin d’approbations et l’intégrité du magasin d’approbations est vérifiée à l’aide de la propriété trustStorePassword spécifiée.If the trustStore property is not set but the trustStorePassword property is set, the JDBC driver uses the file specified by the "javax.net.ssl.trustStore" as a trust store and the integrity of the trust store is checked by using the specified trustStorePassword. Cela peut être nécessaire lorsque l'application cliente ne souhaite pas stocker le mot de passe dans la propriété système JVM.This might be needed when the client application does not want to store the password in the JVM system property.

Remarque : La propriété trustStorePassword affecte la recherche du trustStore du certificat si et seulement si la connexion utilise la connexion TLS et que la propriété trustServerCertificate a la valeur « false ».Note: The trustStorePassword property only affects the certificate trustStore lookup, if and only if the connection uses TLS connection and the trustServerCertificate property is set to "false".
trustStoreTypetrustStoreType

StringString

JKSJKS
Définissez cette propriété pour spécifier le type de magasin de confiance à utiliser pour le mode FIPS.Set this property to specify trust store type to be used for FIPS mode.

Les valeurs possibles sont PKCS12 ou le type défini par le fournisseur FIPS.Possible values are either PKCS12 or type defined by FIPS provider.
useBulkCopyFor…useBulkCopyFor...
BatchInsertBatchInsert

booleanboolean
["true" | "false"]["true" | "false"]

falsefalse
useBulkCopyForBatchInsertuseBulkCopyForBatchInsert

À compter de la version 7.0 de Microsoft JDBC Driver pour SQL Server, cette propriété de connexion peut être activée pour utiliser l’API de copie en bloc lors de l’exécution d’opérations d’insertion par lots avec java.sql.PreparedStatement afin d’améliorer les performances.Beginning with Microsoft JDBC Driver 7.0 for SQL Server, this connection property can be enabled to make use of Bulk Copy API when performing batch insert operations using java.sql.PreparedStatement for performance improvement.

Cette fonctionnalité n’est fonctionnelle que si le serveur cible est de type Azure Data Warehouse.This feature is functional only when target server is of type Azure Data Warehouse. Elle est désactivée par défaut. Affectez la valeur « true » à cette propriété pour activer cette fonctionnalité.It is disabled by default, set this property to "true" to enable this feature.
Remarque importante : Cette fonctionnalité ne prend en charge que les requêtes INSERT entièrement paramétrables.Important Note: This feature only supports fully parameterized INSERT queries. Si les requêtes INSERT sont combinées par d’autres requêtes SQL ou contiennent des données dans des valeurs, l’exécution revient à l’opération d’insertion par lots de base.If the INSERT Queries are combined by other SQL queries, or contain data in values, execution will fall back to the basic Batch Insert operation.

Pour plus d’informations sur cette propriété, consultez Utiliser l’API de copie en bloc pour les opérations d’insertion par lots.For more information on how to use this property, see Using bulk copy API for batch insert operation
useFmtOnlyuseFmtOnly

booleanboolean
["true" | "false"]["true" | "false"]

falsefalse
À compter de la version 7.4 de Microsoft JDBC Driver pour SQL Server, il existe une autre façon d’interroger les métadonnées de paramètres à partir du serveur en spécifiant la propriété de connexion useFmtOnly.Microsoft JDBC Driver for SQL Server starting v7.4 provides an alternative way to query Parameter Metadata from the server by specifying the useFmtOnly connection property. Définissez cette propriété sur « true » pour spécifier que le pilote doit utiliser la logique SET FMTONLY lors de l’interrogation des métadonnées de paramètre.Set this property to "true" to specify that the driver should use SET FMTONLY logic when querying Parameter Metadata. Cette fonctionnalité est désactivée par défaut ; il n’est pas recommandé d’utiliser cette propriété, car SET FMTONLY est déprécié.This feature is off by default, and it is not recommended to use this property as SET FMTONLY is marked for deprecation. useFmtOnly n’est utilisable que comme solution de contournement des problèmes et limitations connus dans sp_describe_undeclared_parameters.useFmtOnly is made available to use only as a workaround for known issues and limitations in sp_describe_undeclared_parameters.

Cette fonctionnalité ne prend actuellement en charge que les requêtes SELECT/INSERT/UPDATE/DELETE uniques.This feature currently only supports single SELECT/INSERT/UPDATE/DELETE queries. Si vous tentez de l’utiliser avec des requêtes non prises en charge/multiples, le pilote essayera d’analyser la ou des requêtes, mais il en résultera probablement une exception.Attempting to use this feature with unsupported/multiple queries will cause the driver to make an attempt to parse the query(s), but will most likely result in an exception.

Pour plus d’informations, consultez Récupérer ParameterMetaData avec useFmtOnly.For more information, see Retrieving ParameterMetaData via useFmtOnly.
userName,userName,
utilisateuruser

StringString
[<=128 char][<=128 char]

nullnull
Utilisateur de la base de données, en cas de connexion avec un utilisateur et un mot de passe SQL.The database user, in case of connection with SQL user and password.

Pour la connexion Kerberos avec un nom de principal et un mot de passe, cette propriété est définie sur le nom du principal Kerberos.For Kerberos connection with principal name and password, this property is set to Kerberos Principal name.
workstationIDworkstationID

StringString
[<=128 char][<=128 char]

<chaîne vide><empty string>
ID de station de travail.The workstation ID. Utilisé pour identifier la station de travail spécifique dans divers outils de définition de profils et de journalisation SQL ServerSQL Server.Used to identify the specific workstation in various SQL ServerSQL Server profiling and logging tools.

Si vous n’en spécifiez aucun, une <chaîne vide> est utilisée.If none is specified, the <empty string> is used.
xopenStatesxopenStates

booleanboolean
["true" | "false"]["true" | "false"]

falsefalse
Définir sur « true » pour spécifier que le pilote retourne les codes d'état compatibles XOPEN dans des exceptions.Set to "true" to specify that the driver returns XOPEN-compliant state codes in exceptions.

Par défaut, des codes d'état SQL 99 sont retournés.The default is to return SQL 99 state codes.
   

Notes

Le Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server prend les valeurs par défaut du serveur pour les propriétés de connexion à l’exception de ANSI_DEFAULTS et IMPLICIT_TRANSACTIONS.The Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server takes the server default values for connection properties except for ANSI_DEFAULTS and IMPLICIT_TRANSACTIONS. Le Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server affecte automatiquement la valeur ON à ANSI_DEFAULTS et la valeur OFF à IMPLICIT_TRANSACTIONS.The Pilote Microsoft JDBC pour SQL ServerMicrosoft JDBC Driver for SQL Server automatically sets ANSI_DEFAULTS to ON and IMPLICIT_TRANSACTIONS to OFF.

Important

Si l’authentification est définie sur ActiveDirectoryPassword, la bibliothèque suivante doit être incluse dans classpath : azure-activedirectory-library-for-java.If authentication is set to ActiveDirectoryPassword, the following library needs to be included in classpath: azure-activedirectory-library-for-java. Elle se trouve dans le référentiel Maven.It can be found on Maven Repository. Le plus simple pour télécharger la bibliothèque et ses dépendances consiste à utiliser Maven :The simplest way to download the library and its dependencies is using Maven:

  1. Tout d’abord, installez Maven sur votre système.First, install Maven on your system
  2. Accédez à la page GitHub du pilote.Go to the GitHub page of the driver
  3. Téléchargez le fichier pom.xml.Download the pom.xml file
  4. Exécutez la commande Maven suivante pour télécharger la bibliothèque et ses dépendances : mvn dependency:copy-dependencies.Run the following Maven command to download the library and its dependencies: mvn dependency:copy-dependencies

Voir aussiSee also

Connexion à SQL Server avec le pilote JDBCConnecting to SQL Server with the JDBC driver
Mode FIPSFIPS mode