接続プロパティの設定Setting the connection properties

ダウンロードJDBC Driver のダウンロードDownloadDownload JDBC Driver

接続文字列のプロパティは、さまざまな方法で指定できます。The connection string properties can be specified in various ways:

  • DriverManager クラスを使用して接続するときは、接続 URL における "名前=値" 形式のプロパティとして指定できます。As name=value properties in the connection URL when you connect by using the DriverManager class.

  • DriverManager クラスの Connect メソッドの Properties パラメーター の中で "名前=値" 形式のプロパティとして指定できますAs name=value properties in the Properties parameter of the Connect method in the DriverManager class.

  • ドライバーのデータ ソースの適切な setter メソッドの値として指定できます。As values in the appropriate setter method of the data source of the driver. 次に例を示します。For example:

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

解説Remarks

プロパティ名の大文字と小文字は区別されず、重複したプロパティ名は次の順序で解決されます。Property names are case-insensitive, and duplicate property names are resolved in the following order:

  1. API 引数 (user、password など)API arguments (such as user and password)
  2. プロパティ コレクション。Property collection.
  3. 接続文字列の最後のインスタンス。Last instance in the connection string.

プロパティ名には不明な値を使用することもできます。JDBC ドライバーではこのような値の大文字と小文字の区別について検証されません。Also, unknown values are allowed for the property names, and their values are not validated by the JDBC driver for case sensitivity.

シノニムを使用できます。これは、重複したプロパティ名と同じ順序で解決されます。Synonyms are allowed and are resolved in order, just as duplicate property names.

次の表は、JDBC ドライバーで現在使用できるすべての接続文字列プロパティを示しています。The following table lists all the currently available connection string properties for the JDBC driver.

プロパティProperty
TypeType
DefaultDefault
説明Description
accessTokenaccessToken

StringString

nullnull
このプロパティを使用し、アクセス トークンを使って SQL データベースに接続します。Use this property to connect to a SQL database using an access token. accessToken は、接続 URL を使用して設定することはできません。accessToken can't be set using the connection URL.
applicationIntentapplicationIntent

StringString

ReadWriteReadWrite
アプリケーションがサーバーに接続するときのワークロードのタイプを宣言します。Declares the application workload type when connecting to a server.

有効値は、ReadOnlyReadWrite です。Possible values are ReadOnly and ReadWrite.

詳細については、「高可用性、ディザスター リカバリーのための JDBC Driver のサポート」をご覧ください。For more information, see JDBC driver support for High Availability, disaster recovery.
applicationNameapplicationName

StringString
[<=128 文字][<=128 char]

nullnull
アプリケーション名、または "SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server" (名前が指定されていない場合) です。The application name, or "SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server" if no name is provided.

個別のアプリケーションを識別するために、さまざまな SQL ServerSQL Server プロファイリング ツールおよびロギング ツールで使用されます。Used to identify the specific application in various SQL ServerSQL Server profiling and logging tools.
認証authentication

StringString

NotSpecifiedNotSpecified
Microsoft JDBC Driver 6.0 for SQL Server 以降では、この省略可能なプロパティは、接続に使用する SQL 認証方法を示します。Beginning with Microsoft JDBC Driver 6.0 for SQL Server, this optional property indicates which SQL authentication method to use for connection. 指定できる値は、ActiveDirectoryIntegratedActiveDirectoryPasswordActiveDirectoryMSISqlPassword、および NotSpecified (既定) です。Possible values are ActiveDirectoryIntegrated, ActiveDirectoryPassword, ActiveDirectoryMSI, SqlPassword, and the default NotSpecified.

ActiveDirectoryIntegrated を使用して、統合 Windows 認証を使用している SQL Database に接続します。Use ActiveDirectoryIntegrated to connect to a SQL Database using integrated Windows authentication.

ActiveDirectoryPassword を使用して、Azure AD のプリンシパル名とパスワードを使用している SQL Database に接続します。Use ActiveDirectoryPassword to connect to a SQL Database using an Azure AD principal name and password.

ActiveDirectoryMSI を使用して、Azure Virtual Machine、App Service、Function App などにマネージド サービス ID (MSI) 認証を使用して Azure リソース内から SQL Database に接続します。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.

ActiveDirectoryMSI 認証モードを使用するときに、ドライバーでサポートされるマネージド ID は、次の 2 種類です。The two types of Managed Identities supported by the driver when using ActiveDirectoryMSI authentication mode are:
1.システム割り当てマネージド ID:accessToken を取得するために既定で使用されます。1. System-Assigned Managed Identity: Used to acquire accessToken by default.
2.ユーザー割り当てマネージド ID:マネージド サービス ID (MSI) のクライアント ID が msiClientId 接続プロパティで指定されている場合に、accessToken を取得するために使用されます。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.

userName/user プロパティと password プロパティを使って SQL Server に接続するには、SqlPassword を使用します。Use SqlPassword to connect to a SQL Server using userName/user and password properties.

これらの認証方法がいずれも必要ない場合は、NotSpecified を使用します。Use NotSpecified if none of these authentication methods are needed.

重要: 認証が ActiveDirectoryIntegrated に設定されている場合、mssql-jdbc_auth-<バージョン>-<arch>.dll (JDBC ドライバー パッケージで入手可能) と SQL Server 用の Azure Active Directory 認証ライブラリ (ADAL.DLL) の 2 つのライブラリをインストールする必要があります。ADAL をインストールするには、Microsoft ODBC Driver for SQL Server または Microsoft OLE DB Driver for 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. JDBC ドライバーでは、ADAL.DLL のバージョン 1.0.2028.318 以降のみがサポートされます。The JDBC driver only supports version 1.0.2028.318 and higher for ADAL.DLL.

注: 認証プロパティが NotSpecified 以外の値に設定されている場合、ドライバーでは既定で TLS (トランスポート層セキュリティ) (以前の 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.

Azure Active Directory 認証を構成する方法については、Azure Active Directory 認証を使用した SQL Database への接続に関するページを参照してください。For information on how to configure Azure Active Directory authentication visit Connecting to SQL Database By Using Azure Active Directory Authentication.
authenticationSchemeauthenticationScheme

StringString

NativeAuthenticationNativeAuthentication
アプリケーションで使用する統合セキュリティの種類を示します。Indicates which kind of integrated security you want your application to use. 指定できる値は JavaKerberosNTLM、および NativeAuthentication (既定値) です。Possible values are JavaKerberos, NTLM, and the default NativeAuthentication.

authenticationScheme=JavaKerberos を使用する場合は、serverName プロパティまたは serverSpn プロパティで完全修飾ドメイン名 (FQDN) を指定する必要があります。When using authenticationScheme=JavaKerberos, you must specify the fully qualified domain name (FQDN) in the serverName or serverSpn property. それ以外の場合は、エラーが発生します (Kerberos データベースにサーバーが見つからない)。Otherwise, an error occurs (Server not found in Kerberos database).

authenticationScheme=JavaKerberos の使用について詳しくは、「Kerberos 統合認証による SQL Server への接続」を参照してください。For more information on using authenticationScheme=JavaKerberos, see Using Kerberos integrated authentication to connect to SQL Server.

authenticationScheme=NTLM を使用する場合は、domain プロパティまたは domainName プロパティの NTLM を使用して認証するように Windows ドメインを指定する必要があります。また、user または userName および password の各プロパティの Windows 資格情報も指定する必要があります。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. これを行わないと、エラーが発生します (接続プロパティを指定する必要があります)。Otherwise, an error occurs (connection properties must be specified).
cancelQueryTimeoutcancelQueryTimeout

INTint

-1-1
Microsoft JDBC Driver 6.4 for SQL Server 以降では、このプロパティを使用して、接続に設定されている queryTimeout を取り消すことができます。Beginning with Microsoft JDBC Driver 6.4 for SQL Server, this property can be used to cancel queryTimeout set on the connection. SQL Server への TCP 接続が暗黙的に削除されると、クエリの実行がハングし、例外はスローされません。Query execution hangs and does not throw exception if TCP connection to SQL Server is silently dropped. このプロパティは、接続でも 'queryTimeout' が設定されている場合にのみ適用されます。This property is only applicable if 'queryTimeout' is also set on the connection.

ドライバーは cancelQueryTimeout + queryTimeout を合計した秒数を待機してから、接続を中断し、チャネルを閉じます。The driver waits the total amount of cancelQueryTimeout + queryTimeout seconds, to drop the connection and close the channel.

このプロパティの既定値は -1 で、動作は無期限の待機です。The default value for this property is -1 and behavior is to wait indefinitely.
columnEncryptionSettingcolumnEncryptionSetting

StringString
["Enabled" | "Disabled"]["Enabled" | "Disabled"]

無効Disabled
Microsoft JDBC Driver 6.0 for SQL Server 以降では、"Enabled" に設定すると、Always Encrypted (AE) 機能を使用します。Set to "Enabled" to use the Always Encrypted (AE) feature beginning with Microsoft JDBC Driver 6.0 for SQL Server. AE を有効にすると、JDBC ドライバーは SQL Server の暗号化されたデータベースの列に格納されている機密データについて透過的に暗号化と暗号化の解除を行います。When AE is enabled, the JDBC driver transparently encrypts and decrypts sensitive data stored in encrypted database columns in the SQL Server.

columnEncryptionSetting の詳細については、「JDBC ドライバーでの Always Encrypted の使用」を参照してください。For more information about columnEncryptionSetting, see Using Always Encrypted with the JDBC driver for more details.

注: Always Encrypted は、SQL Server 2016 以降のバージョンで利用できます。Note: Always Encrypted is available with SQL Server 2016 or later versions.
databaseName,databaseName,
databasedatabase

StringString
[<=128 文字][<=128 char]

nullnull
接続するデータベース名です。The name of the database to connect to.

指定しない場合は、既定のデータベースへの接続が確立されます。If not stated, a connection is made to the default database.
domainNamedomainName,
domaindomain

StringString
nullnull
NTLM を使用して認証する Windows ドメイン。The Windows domain to authenticate in using NTLM.
disableStatementPoolingdisableStatementPooling

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

truetrue
ステートメント プーリングを使用する必要があるかどうかを示すフラグ。Flag indicating if the statement pooling should be used.
enablePrepareOnFirst...enablePrepareOnFirst...
PreparedStatementCallPreparedStatementCall

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

falsefalse
enablePrepareOnFirstPreparedStatementCallenablePrepareOnFirstPreparedStatementCall

準備されたステートメントの最初の実行で sp_prepexec を呼び出すことによって、準備されたステートメント ハンドルの作成を有効にするには、"true" に設定します。Set to "true" to enable the prepared statement handle creation by calling sp_prepexec in first execution of prepared statement.

準備されたステートメントの最初の実行で sp_executesql を呼び出し、ステートメントを準備しないように変更するには、"false" に設定します。2 回目の実行が行われると、sp_prepexec が呼び出され、準備されたステートメント ハンドルが設定されます。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
Microsoft JDBC Driver 8.2 for SQL Server 以降では、この省略可能なプロパティは、セキュア エンクレーブを使用する Always Encrypted に使用する構成証明サービスのエンドポイント URL を示します。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.

詳細については、「セキュア エンクレーブを使用する Always Encrypted」を参照してください。For more information, see Always Encrypted with secure enclaves.
enclaveAttestationProtocolenclaveAttestationProtocol

StringString

nullnull
Microsoft JDBC Driver 8.2 for SQL Server 以降では、この省略可能なプロパティは、セキュア エンクレーブを使用する Always Encrypted に使用する構成証明プロトコルを示します。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. 現時点では、このフィールドでサポートされている値は HGS のみです。Currently, the only supported value for this field is HGS.

詳細については、「セキュア エンクレーブを使用する Always Encrypted」を参照してください。For more information, see Always Encrypted with secure enclaves.
encryptencrypt

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

falsefalse
サーバーに証明書がインストールされている場合に、クライアントとサーバー間で送信されるすべてのデータに対して SQL ServerSQL Server で TLS 暗号化が使用されるようにするには、"true" に設定します。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. 既定値は "false" です。The default value is "false".

Microsoft JDBC Driver 6.0 for SQL Server 以降では、既定で TLS 暗号化を使用する新しい接続設定 "authentication" があります。Beginning with Microsoft JDBC Driver 6.0 for SQL Server, there is a new connection setting 'authentication' that uses TLS encryption by default.

詳細については、authentication プロパティを参照してください。For more information, see the 'authentication' property.
failoverPartnerfailoverPartner

StringString

nullnull
データベース ミラーリング構成で使用されるフェールオーバー サーバーの名前です。The name of the failover server used in a database mirroring configuration. このプロパティは、プリンシパル サーバーへの初期接続に失敗した場合に使用されます。初期接続が行われた後は、このプロパティは無視されます。This property is used for an initial connection failure to the principal server; after you make the initial connection, this property is ignored. databaseName プロパティと組み合わせて使用する必要があります。Must be used in conjunction with databaseName property.

注: 接続文字列の中で failoverPartner プロパティを指定するときに、フェールオーバー パートナー インスタンスのサーバー インスタンスのポート番号を指定することはできません。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. ただし、プリンシパル サーバー インスタンスの serverName、instanceName、portNumber の各プロパティ、およびフェールオーバー パートナー インスタンスの failoverPartner プロパティを同じ接続文字列の中で指定することはできます。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.

Server 接続プロパティの仮想ネットワーク名を指定した場合は、データベース ミラーリングを使用できません。If you specify a Virtual Network Name in the Server connection property, you cannot use database mirroring. 詳細については、「高可用性、ディザスター リカバリーのための JDBC Driver のサポート」をご覧くださいFor more information, see JDBC driver support for High Availability, disaster recovery
fipsfips

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

"false""false"
FIPS 対応 JVM の場合、このプロパティを true にする必要があります。For FIPS enabled JVM this property should be true.
fipsProviderfipsProvider

StringString

nullnull
JVM で構成される FIPS プロバイダー。FIPS provider configured in JVM. たとえば、BCFIPS、SunPKCS11-NSS など。For example, BCFIPS or SunPKCS11-NSS. バージョン 6.4.0 で削除されました。詳細はこちらをご覧ください。Removed in version 6.4.0 - see the details Here.
gsscredentialgsscredential

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

nullnull
Microsoft JDBC Driver 6.2 for SQL Server 以降では、Kerberos の制約付き委任に使用されるユーザー資格情報をこのプロパティに渡すことができます。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.

これは integratedSecuritytrue として、JavaKerberosauthenticationScheme として使用します。This should be used with integratedSecurity as true and JavaKerberos as authenticationScheme.
hostNameInCertificatehostNameInCertificate

StringString

nullnull
SQL ServerSQL Server の TLS/SSL 証明書の検証に使用されるホスト名です。The host name to be used in validating the SQL ServerSQL Server TLS/SSL certificate.

hostNameInCertificate プロパティが指定されていないか null に設定されている場合、SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server は、接続 URL の serverName プロパティ値をホスト名として使用して SQL ServerSQL Server の TLS/SSL 証明書を検証します。If the hostNameInCertificate property is unspecified or set to null, the SQL Server 用 Microsoft JDBC ドライバーMicrosoft 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.

注: このプロパティは、encrypt/authentication プロパティおよび trustServerCertificate プロパティと組み合わせて使用されます。Note: This property is used in combination with the encrypt/authentication properties and the trustServerCertificate property. このプロパティが証明書の検証に影響するのは、接続で TLS 暗号化が使用されていて、trustServerCertificate が "false" に設定されている場合のみです。This property affects the certificate validation, if and only if the connection uses TLS encryption and the trustServerCertificate is set to "false". TLS 接続が成功するには、hostNameInCertificate に渡される値が、サーバー証明書に含まれるサブジェクトの別名 (SAN) の共通名 (CN) または DNS 名と一致している必要があります。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. 詳細については、「暗号化のサポートについて」を参照してください。For more information, see Understanding encryption support.
INSTANCENAMEinstanceName

StringString
[<=128 文字][<=128 char]

nullnull
接続する SQL ServerSQL Server のインスタンス名です。The SQL ServerSQL Server instance name to connect to. 指定しない場合は、既定のインスタンスへの接続が確立されます。When it is not specified, a connection is made to the default instance. instanceName と port の両方を指定する場合については、port の注を参照してください。For the case where both the instanceName and port are specified, see the notes for port.

Server 接続プロパティの仮想ネットワーク名を指定した場合は、instanceName 接続プロパティを使用できません。If you specify a Virtual Network Name in the Server connection property, you cannot use instanceName connection property. 詳細については、「高可用性、障害回復のための JDBC Driver のサポート」をご覧ください。See JDBC Driver Support for High Availability, Disaster Recovery for more information.
integratedSecurityintegratedSecurity

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

falsefalse
Windows オペレーティング システムの SQL ServerSQL Server によって Windows 資格情報が使用されていることを示すには、"true" に設定します。Set to "true" to indicate that Windows credentials are used by SQL ServerSQL Server on Windows operating systems. "true" にすると、JDBC ドライバーは、ユーザーがコンピューターまたはネットワークにサインインしたときに提供した資格情報を見つけるために、ローカル コンピューターの資格情報のキャッシュを検索します。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.

Kerberos 資格情報が SQL ServerSQL Server によって使用されていることを示すには、(authenticationscheme=JavaKerberos で) "true" に設定します。Set to "true" (with authenticationscheme=JavaKerberos), to indicate that Kerberos credentials are used by SQL ServerSQL Server. Kerberos 認証の詳細については、「Kerberos 統合認証による SQL Server への接続」をご覧ください。For more information on Kerberos authentication, see Using Kerberos integrated authentication to connect to SQL Server.

NTLM 資格情報が SQL ServerSQL Server によって使用されていることを示すには、(authenticationscheme=NTLM で) "true" に設定します。Set to "true" (with authenticationscheme=NTLM), to indicate that NTLM credentials are used by SQL ServerSQL Server.

"false" の場合は、ユーザー名とパスワードを指定する必要があります。If "false", the username and password must be supplied.
jaasConfigurationNamejaasConfigurationName

StringString

SQLJDBCDriverSQLJDBCDriver
Microsoft JDBC Driver 6.2 for SQL Server 以降では、SQL Server への各接続で、Kerberos 接続を確立するための独自の JAAS ログイン構成ファイルを持つことができます。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. ログイン構成ファイルの名前は、このプロパティを介して渡すことができます。Name of the Login Configuration file can be passed through this property.
既定では、ドライバーによって、IBM JVM に対してはプロパティが useDefaultCcache = true に、他の JVM に対しては useTicketCache = true に設定されます。By default, driver sets property useDefaultCcache = true for IBM JVMs, and useTicketCache = true for other JVMs.
keyStoreAuthenticationkeyStoreAuthentication

StringString

nullnull
Microsoft JDBC Driver 6.0 for SQL Server 以降では、このプロパティによって、Always Encrypted との接続にシームレスに設定するキー ストアが識別され、キー ストアに対する認証に使用される認証メカニズムが決定されます。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. Microsoft JDBC Driver 6.0 for SQL Server では、このプロパティを使用した ("keyStoreAuthentication=JavaKeyStorePassword" を設定する必要があります)、Java キー ストアのシームレスなセットアップをサポートしています。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". このプロパティを使用するには、Java キー ストアに対して keyStoreLocation プロパティと keyStoreSecret プロパティも設定する必要があることに注意してください。Note that to use this property, you also need to set the keyStoreLocation and keyStoreSecret properties for the Java Key Store.

詳細については、「JDBC ドライバーでの Always Encrypted の使用」を参照してください。For more information, visit Using Always Encrypted with the JDBC driver.
keyStoreLocationkeyStoreLocation

StringString

nullnull
keyStoreAuthentication=JavaKeyStorePassword の場合、keyStoreLocation プロパティによって、Always Encrypted データで使用される列マスター キーを格納する Java キーストア ファイルへのパスが識別されます。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. パスにはキーストア ファイル名を含める必要があることに注意してください。Note that the path must include the keystore filename.

詳細については、「JDBC ドライバーでの Always Encrypted の使用」を参照してください。For more information, visit Using Always Encrypted with the JDBC driver.
keyStoreSecretkeyStoreSecret

StringString

nullnull
keyStoreAuthentication=JavaKeyStorePassword の場合、keyStoreSecret プロパティによって、キーストアとキーの両方に使用するパスワードが識別されます。When keyStoreAuthentication=JavaKeyStorePassword, the keyStoreSecret property identifies the password to use for the keystore as well as for the key. Java キー ストアを使用する場合、キーストアとキー パスワードは同じにする必要があることに注意してください。Note that for using the Java Key Store the keystore and the key password must be the same.

詳細については、「JDBC ドライバーでの Always Encrypted の使用」を参照してください。For more information, visit Using Always Encrypted with the JDBC driver.
lastUpdateCountlastUpdateCount

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

truetrue
値が "true" の場合、サーバーに渡された SQL ステートメントから最終的な更新数のみを返します。また、SELECT、INSERT、または DELETE ステートメントのいずれか 1 つで使用して、サーバーのトリガーにより追加された更新数を無視することができます。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. このプロパティを "false" に設定すると、サーバーのトリガーにより返される更新数を含む、すべての更新数が返されます。Setting this property to "false" causes all update counts to be returned, including those returned by server triggers.

注: このプロパティが適用されるのは、executeUpdate メソッドと一緒に使用された場合だけです。Note: This property only applies when it is used with the executeUpdate methods. その他のすべての execute メソッドは、すべての結果および更新数を返します。All other execute methods return all results and update counts. このプロパティは、サーバーのトリガーにより返される更新数にのみ影響します。This property only affects update counts returned by server triggers. トリガーの実行の一部として得られる結果セットまたはエラーには影響しません。It does not affect result sets or errors that result as part of trigger execution.
lockTimeoutlockTimeout

INTint

-1-1
データベースがロック タイムアウトを通知するまでに待機する時間 (ミリ秒) です。既定では、無期限に待機します。The number of milliseconds to wait before the database reports a lock time-out. The default behavior is to wait indefinitely. 指定されている場合、この値は接続上のすべてのステートメントに対する既定値になります。If it is specified, this value is the default for all statements on the connection. 特定のステートメントに対するタイムアウトは、Statement.setQueryTimeout() を使用して設定できることに注意してください。Note that Statement.setQueryTimeout() can be used to set the time-out for specific statements. この値は、待機しないことを示す 0 に設定できます。The value can be 0, which specifies no wait.
loginTimeoutloginTimeout

INTint
[0..65535][0..65535]

1515
ドライバーがタイムアウトを通知して接続を失敗させるまでに待機する時間 (秒) です。The number of seconds the driver should wait before timing out a failed connection. 0 の値は、タイムアウトが既定のシステム タイムアウトであることを示します。既定のシステム タイムアウトは、既定では 15 秒に指定されています。A zero value indicates that the timeout is the default system timeout, which is specified as 15 seconds by default. 0 以外の値は、ドライバーがタイムアウトを通知して接続を失敗させるまでに待機する時間 (秒) を示します。A non-zero value is the number of seconds the driver should wait before timing out a failed connection.

Server 接続プロパティの仮想ネットワーク名を指定する場合は、フェールオーバー接続が成功するまで十分な時間がとれるように、3 分以上のタイムアウト値を指定する必要があります。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. 詳細については、「高可用性、ディザスター リカバリーのための JDBC Driver のサポート」をご覧ください。See JDBC driver support for High Availability, disaster recovery for more information.
msiClientIdmsiClientId

StringString

nullnull
ActiveDirectoryMSI 認証モードで接続を確立するときに、accessToken を取得するために使用されるマネージド サービス ID (MSI) のクライアント ID。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
SQL Server 2012 (11.x)SQL Server 2012 (11.x) 可用性グループまたは SQL Server 2012 (11.x)SQL Server 2012 (11.x) フェールオーバー クラスター インスタンスの可用性グループ リスナーに接続する際には、必ず multiSubnetFailover=true を指定してください。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 によって、(現在) アクティブなサーバーを迅速に検出し、接続するように SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server が構成されます。multiSubnetFailover=true configures SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server to provide faster detection of and connection to the (currently) active server. 可能な値は、true と false です。Possible values are true and false. 詳細については、「高可用性、障害回復のための JDBC Driver のサポート」をご覧ください。See JDBC Driver Support for High Availability, Disaster Recovery for more information.

getPropertyInfogetMultiSubnetFailoversetMultiSubnetFailover がある multiSubnetFailover 接続プロパティには、プログラムからアクセスできます。You can programmatically access the multiSubnetFailover connection property with getPropertyInfo, getMultiSubnetFailover, and setMultiSubnetFailover.

注: Microsoft JDBC Driver 6.0 for SQL Server 以降では、可用性グループ リスナーに接続するときに、multiSubnetFailover を "true" に設定する必要がなくなりました。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. 既定で有効になっている新しいプロパティ transparentNetworkIPResolution により、(現在) アクティブなサーバーの検出と接続が提供されます。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
SQL Server との通信に使用されるネットワーク パケット サイズです (バイトで指定します)。The network packet size used to communicate with SQL Server, specified in bytes. 値が -1 の場合は、サーバーの既定のパケット サイズが使用されます。A value of -1 indicates using the server default packet size. 値が 0 の場合は、最大値 (32767) が使用されます。A value of 0 indicates using the maximum value, which is 32767. このプロパティが許容範囲外の値に設定されている場合は、例外が発生します。If this property is set to a value outside the acceptable range, an exception occurs.

重要: 暗号化を有効 (encrypt=true) にしている場合に packetSize プロパティを使用することはお勧めしません。Important: We do not recommend using the packetSize property when the encryption is enabled (encrypt=true). 使用すると、接続エラーが発生する可能性があります。Otherwise, the driver might raise a connection error. 詳細については、SQLServerDataSource クラスの setPacketSize メソッドを参照してください。For more information, see the setPacketSize method of the SQLServerDataSource class.
passwordpassword

StringString
[<=128 文字][<=128 char]

nullnull
SQL ユーザーとパスワードが接続されている場合のデータベース パスワード。The database password, in case of connection with SQL user and password.
プリンシパル名とパスワードを使用した Kerberos 接続の場合、このプロパティは 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
SQL ServerSQL Server が待機しているポートです。The port where SQL ServerSQL Server is listening. ポート番号が接続文字列に指定されている場合は、SQLbrowser に対する要求は作成されません。If the port number is specified in the connection string, no request to SQLbrowser is made. port と instanceName の両方が指定されている場合は、指定されたポートへの接続が確立されます。When the port and instanceName are both specified, the connection is made to the specified port. ただし、instanceName の検証が行われ、ポートと一致しない場合はエラーがスローされます。However, the instanceName is validated and an error is thrown if it does not match the port.

重要: SQLbrowser を使用する場合よりもセキュリティが向上するため、常にポート番号を指定することをお勧めします。Important: We recommend that the port number is always specified, as this is more secure than using SQLbrowser.
queryTimeoutqueryTimeout

INTint

-1-1
クエリでタイムアウトが発生するまでに待機する秒数。The number of seconds to wait before a timeout has occurred on a query. 既定値は -1 です。これはタイムアウトが無期限であることを意味します。The default value is -1, which means infinite timeout. これを 0 に設定した場合も、無期限の待機を意味します。Setting this to 0 also implies to wait indefinitely.
responseBufferingresponseBuffering

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

adaptiveadaptive
このプロパティを "adaptive" に設定すると、必要に応じて最小限のデータがバッファリングされます。If this property is set to "adaptive", the minimum possible data is buffered when necessary. 既定のモードは "adaptive" です。The default mode is "adaptive."

このプロパティが "full" に設定されている場合、ステートメントの実行時に結果セット全体がサーバーから読み取られます。When this property is set to "full", the entire result set is read from the server when a statement is executed.

注: JDBC ドライバーをバージョン 1.2 からアップグレードすると、既定のバッファリング動作が "adaptive" になります。Note: After upgrading the JDBC driver from version 1.2, the default buffering behavior will be "adaptive." アプリケーションで "responseBuffering" プロパティが設定されていない場合にバージョン 1.2 の既定の動作を維持するには、接続プロパティで、または SQLServerStatement オブジェクトの setResponseBuffering メソッドを使用して、responseBufferring プロパティを "full" に設定する必要があります。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"]

直接direct
このプロパティが "cursor" に設定されている場合、TYPE_FORWARD_ONLY および 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. このプロパティは、通常、クライアントのメモリ内に収まらない大きな結果セットをアプリケーションが生成する場合にのみ必要です。This property is typically required only if the application generates large result sets that cannot be fully contained in client memory. このプロパティが "cursor" に設定されると、結果セットの行が限定された数だけクライアントのメモリに保持されます。When this property is set to "cursor," only a limited number of result set rows are retained in client memory.

既定の動作では、すべての結果セットの行がクライアントのメモリに保持されます。The default behavior is that all result set rows are retained in client memory. この動作により、アプリケーションがすべての行を処理する場合は、パフォーマンスが最も高くなります。This behavior provides the fastest performance when the application is processing all rows.
sendStringParameters...sendStringParameters...
AsUnicodeAsUnicode

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

truetrue
sendStringParametersAsUnicodesendStringParametersAsUnicode

sendStringParametersAsUnicode プロパティが "true" に設定されている場合、文字列パラメーターは Unicode 形式でサーバーに送信されます。If the sendStringParametersAsUnicode property is set to "true", String parameters are sent to the server in Unicode format.

sendStringParametersAsUnicode プロパティが "false" に設定されている場合、文字列パラメーターは、Unicode ではなく ASCII/MBCS などの Unicode 以外の形式でサーバーに送信されます。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.

sendStringParametersAsUnicode プロパティの既定値は "true" です。The default value for the sendStringParametersAsUnicode property is "true".

注: CHARVARCHAR、または LONGVARCHAR の各 JDBC 型のパラメーター値を送信するときにのみ、sendStringParametersAsUnicode プロパティがチェックされます。Note: The sendStringParametersAsUnicode property is only checked when sending a parameter value with CHAR, VARCHAR, or LONGVARCHAR JDBC types. SQLServerPreparedStatement クラスと SQLServerCallableStatement クラスの setNString、setNCharacterStream、setNClob メソッドのような、JDBC 4.0 の新しい National Character メソッドでは、このプロパティの設定に関係なく、常にパラメーター値が Unicode 形式でサーバーに送信されます。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.

CHARVARCHARLONGVARCHAR などの JDBC データ型の使用に伴うパフォーマンスを最適に保つためには、アプリケーションで、sendStringParametersAsUnicode プロパティを "false" に設定し、National Character メソッド以外のメソッドである、SQLServerPreparedStatement クラスおよび SQLServerCallableStatement クラスの setString、setCharacterStream、および setClob を使用する必要があります。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.

アプリケーションで sendStringParametersAsUnicode プロパティが "false" に設定されていて、National Character メソッド以外のメソッドを使用してサーバー側の Unicode データ型 (ncharnvarcharntext など) にアクセスする場合に、National Character メソッド以外のメソッドで渡される文字列パラメーターの文字がデータベース照合順序でサポートされていないときには、一部のデータが失われる可能性があります。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.

アプリケーションでは、NCHARNVARCHARLONGNVARCHAR の各 JDBC データ型に対して、SQLServerPreparedStatement クラスおよび SQLServerCallableStatement クラスの National Character メソッドである setNString、setNCharacterStream、および setNClob を使用する必要がある点に注意してください。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
このプロパティは SQL ServerSQL Server JDBC Driver 3.0 で追加されました。This property was added in SQL ServerSQL Server JDBC Driver 3.0.

"true" に設定すると、java.sql.Time 値は SQL ServerSQL Serverdatetime 値としてサーバーに送信されます。Set to "true" to send java.sql.Time values to the server as SQL ServerSQL Server datetime values.
"false" に設定すると、java.sql.Time 値は SQL ServerSQL Servertime 値としてサーバーに送信されます。Set to "false" to send java.sql.Time values to the server as SQL ServerSQL Server time values.

このプロパティの既定値は、現在は "true" ですが、将来のリリースで変更される可能性があります。The default value for this property is currently "true" and may change in a future release.

java.sql.Time 値をサーバーに送信する前に、SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server でその値を構成する方法の詳細については、「java.sql.Time の値をサーバーに送信する方法の構成」を参照してください。For more information about how the SQL Server 用 Microsoft JDBC ドライバーMicrosoft 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
SQL ServerSQL Server を実行しているコンピューターです。The computer running SQL ServerSQL Server.

AlwaysOn 可用性グループAlwaysOn Availability Groups の可用性グループの仮想ネットワーク名を指定することもできます。You can also specify the Virtual Network Name of a AlwaysOn 可用性グループAlwaysOn Availability Groups availability group. 詳細については、「高可用性、ディザスター リカバリーのための JDBC Driver のサポート」をご覧ください。See JDBC driver support for High Availability, disaster recovery for more information.
serverNameAsACEserverNameAsACE

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

falsefalse
Microsoft JDBC Driver 6.0 for SQL Server 以降では、"true" に設定すると、ドライバーが Unicode のサーバー名を互換性のある ASCII エンコード (Punycode) に変換して接続する必要があることを示します。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. この設定が false の場合、ドライバーは、ユーザーによって提供されたサーバー名を使用して接続します。If this setting is false, the driver connects using the server name as provided by the user.

詳細については、「JDBC ドライバーの国際化機能」を参照してください。See International features of the JDBC driver for more details.
serverPreparedStatement...serverPreparedStatement...
DiscardThresholdDiscardThreshold

IntegerInteger

1010
serverPreparedStatementDiscardThresholdserverPreparedStatementDiscardThreshold

SQL Server の JDBC Driver 6.2 以降では、このプロパティを使用して、サーバー上の未処理のハンドルをsp_unprepareクリーンアップするための呼び出しが実行される前に、1つの接続に対して未処理の準備されたステートメント破棄アクション () の数を制御できます。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.

このプロパティを <= 1 に設定すると、準備解除アクションは、準備されたステートメントの終了時に直ちに実行されます。If this property is set to <= 1, unprepare actions are executed immediately on prepared statement close. >1 に設定すると、これらの呼び出しはバッチ処理され、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
Microsoft JDBC Driver 4.2 for SQL Server 以降では、このオプションのプロパティを使用して Java Kerberos 接続のサービス プリンシパル名 (SPN) を指定できます。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. これは、authenticationScheme メソッドと組み合わせて使用されます。It is used in conjunction with authenticationScheme.

SPN を指定するには、"MSSQLSvc/fqdn:port@REALM" の形式を使用できます。ここで、fqdn は完全修飾ドメイン名、port はポート番号、REALM は大文字で表記された SQL Server の Kerberos 領域です。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.

注: クライアントの既定の領域 (Kerberos 構成で指定した領域) が SQL Server の Kerberos 領域と同じである場合は、@REALM は省略できます。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.

Java Kerberos での serverSpn の使用について詳しくは、「Kerberos 統合認証による 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

JDBC Driver 6.4 for SQL Server 以降では、このプロパティを使用して、ドライバーで準備されたステートメント ハンドルのキャッシュを有効にすることができます。Beginning with JDBC Driver 6.4 for SQL Server, this property can be used to enable Prepared Statement Handle Caching in the driver.

このプロパティにより、ステートメント プールのキャッシュのサイズが定義されます。This property defines the size of the cache for statement pooling.

このプロパティが使用できるのは、disableStatementPooling 接続プロパティ ("false" に設定する必要があります) と組み合わせた場合だけです。This property can only be used in conjunction with disableStatementPooling connection property which should be set to "false". disableStatementPooling を "true" または statementPoolingCacheSize を 0 に設定すると、準備されたステートメント ハンドルのキャッシュが無効になります。Setting disableStatementPooling to "true" or statementPoolingCacheSize to 0 disables prepared statement handle caching.
socketTimeoutsocketTimeout

INTint

00
ソケットの読み取りまたは受け入れで、タイムアウトが発生する前に待機するミリ秒数。The number of milliseconds to wait before a timeout is occurred on a socket read or accept. 既定値は 0 です。これはタイムアウトが無期限であることを意味します。The default value is 0, which means infinite timeout.
sslProtocolsslProtocol

StringString

TLSTLS
JDBC Driver 6.4 for SQL Server 以降では、このプロパティを使用して、セキュリティで保護された接続時に考慮する TLS プロトコルを指定できます。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.
次のいずれかの値になります。TLSTLSv1TLSv1.1TLSv1.2Possible values are: TLS, TLSv1, TLSv1.1, and TLSv1.2.

詳細については、「SSLProtocol」を参照してください。For more information, see SSLProtocol.
transparentNetwork...transparentNetwork...
IPResolutionIPResolution

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

truetrue
transparentNetworkIPResolutiontransparentNetworkIPResolution

Microsoft JDBC Driver 6.0 for SQL Server 以降では、このプロパティを使用すると、(現在) アクティブなサーバーを迅速に検出して接続できます。Beginning with Microsoft JDBC Driver 6.0 for SQL Server, this property provides faster detection of and connection to the (currently) active server. 指定できる値は "true" と "false" です。 "true" は既定値です。Possible values are "true" and "false" where "true" is the default value.

Microsoft JDBC Driver 6.0 for SQL Server より前のバージョンでは、AlwaysOn 可用性グループに接続していることを示すために、アプリケーションで "multiSubnetFailover=true" を含めるように接続文字列を設定する必要がありました。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. multiSubnetFailover 接続キーワードを "true" に設定しないと、アプリケーションで AlwaysOn 可用性グループに接続中にタイムアウトが発生する可能性がありました。Without setting the multiSubnetFailover connection keyword to "true", an application might experience a timeout while connecting to an AlwaysOn Availability Group. Microsoft JDBC Driver 6.0 for SQL Server 以降では、アプリケーションで multiSubnetFailover を true に設定する必要がなくなりました。Beginning with Microsoft JDBC Driver 6.0 for SQL Server, an application does not need to set multiSubnetFailover to true anymore.

注: transparentNetworkIPResolution=true の場合、最初の接続試行では、タイムアウトとして 500 ミリ秒が使用されます。Note: When transparentNetworkIPResolution=true, the first connection attempt uses 500 ms as the timeout. その後の試行では、multiSubnetFailover プロパティで使用されているのと同じタイムアウト ロジックが使用されます。Any subsequent attempts use the same timeout logic as used by the multiSubnetFailover property.
trustManagerClasstrustManagerClass

StringString

nullnull
カスタム javax.net.ssl.TrustManager 実装の完全修飾クラス名。The fully qualified class name of a custom javax.net.ssl.TrustManager implementation.
trustManager...trustManager...
ConstructorArgConstructorArg

StringString

nullnull
trustManagerConstructorArgtrustManagerConstructorArg

TrustManager のコンストラクターに渡す省略可能な引数。An optional argument to pass to the constructor of the TrustManager. trustManagerClass が指定され、暗号化された接続が要求された場合、既定のシステム JVM キーストアベースの TrustManager ではなく、カスタム TrustManager が使用されます。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
SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL ServerSQL ServerSQL Server の TLS/SSL 証明書を検証しないようにするには "true" に設定します。Set to "true" to specify that the SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server does not validate the SQL ServerSQL Server TLS/SSL certificate.

"true" の場合、通信レイヤーが TLS で暗号化されていれば SQL ServerSQL Server の TLS/SSL 証明書は自動的に信頼されます。If "true", the SQL ServerSQL Server TLS/SSL certificate is automatically trusted when the communication layer is encrypted using TLS.

"false" の場合は、SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server がサーバーの TLS/SSL 証明書を検証します。If "false", the SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server validates the server TLS/SSL certificate. サーバー証明書の検証が失敗した場合は、ドライバーでエラーが発生して接続が終了します。If the server certificate validation fails, the driver raises an error and terminates the connection. 既定値は "false" です。The default value is "false". TLS/SSL 接続が成功するには、serverName に渡される値が、サーバー証明書に含まれるサブジェクトの別名の共通名 (CN) または DNS 名と厳密に一致している必要があります。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. 詳細については、「暗号化のサポートについて」を参照してください。For more information, see Understanding encryption support.

注: このプロパティは、encrypt/authentication プロパティと組み合わせて使用されます。Note: This property is used in combination with the encrypt/authentication properties. このプロパティがサーバーの TLS/SSL 証明書の検証に影響するのは、接続で TLS 暗号化が使用される場合のみです。This property only affects server TLS/SSL certificate validation if and only if the connection uses TLS encryption.
trustStoretrustStore

StringString

nullnull
証明書の trustStore ファイルへのパス (ファイル名を含む) です。The path (including filename) to the certificate trustStore file. trustStore ファイルには、クライアントが信頼する証明書の一覧が含まれています。The trustStore file contains the list of certificates that the client trusts.

このプロパティが指定されていないか null に設定されている場合、ドライバーは、信頼マネージャー ファクトリの検索ルールに従って、使用する証明書ストアを決定します。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.

既定の SunX509 TrustManagerFactory では、次の順序で信頼済みマテリアルの検索が行われます。The default SunX509 TrustManagerFactory tries to locate the trusted material in the following search order:

Java 仮想マシン (JVM) システム プロパティの "javax.net.ssl.trustStore" で指定されたファイルA file specified by the "javax.net.ssl.trustStore" Java Virtual Machine (JVM) system property.

"<java-home>/lib/security/jssecacerts" ファイル"<java-home>/lib/security/jssecacerts" file.

"<java-home>/lib/security/cacerts" ファイル"<java-home>/lib/security/cacerts" file.



詳細については、Sun Microsystems の Web サイトで SunX509 TrustManager Interface についてのドキュメントを参照してください。For more information, see the SUNX509 TrustManager Interface documentation on the Sun Microsystems Web site.

注: このプロパティが証明書の trustStore の検索に影響するのは、接続で TLS 暗号化が使用され、trustServerCertificate プロパティが "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
trustStore データの整合性を確認するために使用するパスワードです。The password used to check the integrity of the trustStore data.

trustStore プロパティは設定されているが trustStorePassword プロパティは設定されていない場合、trustStore の整合性は確認されません。If the trustStore property is set but the trustStorePassword property is not set, the integrity of the trustStore is not checked.

trustStore プロパティと trustStorePassword プロパティの両方が指定されていない場合、ドライバーでは、JVM システム プロパティの "javax.net.ssl.trustStore" と "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". "javax.net.ssl.trustStorePassword" システム プロパティが指定されていない場合、trustStore の整合性は確認されません。If the "javax.net.ssl.trustStorePassword" system property is not specified, the integrity of the trustStore is not checked.

trustStore プロパティは設定されていないが trustStorePassword プロパティは設定されている場合、JDBC ドライバーでは、"javax.net.ssl.trustStore" で指定されたファイルが信頼ストアとして使用され、指定された trustStorePassword を使用して信頼ストアの整合性が確認されます。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. これは、クライアント アプリケーションでパスワードを JVM システム プロパティに格納しないようにする場合に必要となることがあります。This might be needed when the client application does not want to store the password in the JVM system property.

注: trustStorePassword プロパティが証明書の trustStore の検索に影響するのは、接続で TLS 接続が使用され、trustServerCertificate プロパティが "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
FIPS モードで使用する信頼ストアの種類を指定するには、このプロパティを設定します。Set this property to specify trust store type to be used for FIPS mode.

指定できる値は、PKCS12 または FIPS プロバイダーによって定義された種類です。Possible values are either PKCS12 or type defined by FIPS provider.
useBulkCopyFor...useBulkCopyFor...
BatchInsertBatchInsert

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

falsefalse
useBulkCopyForBatchInsertuseBulkCopyForBatchInsert

Microsoft JDBC Driver 7.0 for SQL Server 以降では、java.sql.PreparedStatement を使用してバッチ挿入操作を実行するときに、一括コピー API を利用するためにこの接続プロパティを有効にして、パフォーマンスを向上させることができます。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.

この機能は、ターゲット サーバーの種類が Azure Data Warehouse の場合にのみ機能します。This feature is functional only when target server is of type Azure Data Warehouse. この機能は既定では無効になっており、有効にするには、このプロパティを "true" に設定します。It is disabled by default, set this property to "true" to enable this feature.
重要な注意: この機能では、完全にパラメーター化された INSERT クエリのみがサポートされます。Important Note: This feature only supports fully parameterized INSERT queries. INSERT クエリが他の SQL クエリによって結合された場合、または値にデータが含まれている場合、実行は基本的なバッチ挿入操作にフォールバックします。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.

このプロパティの使用方法について詳しくは、「バッチ挿入操作に一括コピー API を使用する」をご覧ください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
Microsoft JDBC Driver for SQL Server の v7.4 以降では、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. パラメーター メタデータのクエリを実行するときに、ドライバーで SET FMTONLY ロジックを使用する必要があることを指定するには、このプロパティを "true" に設定します。Set this property to "true" to specify that the driver should use SET FMTONLY logic when querying Parameter Metadata. この機能は既定ではオフになっています。SET FMTONLY は非推奨としてマークされているため、このプロパティを使用することは推奨されていません。This feature is off by default, and it is not recommended to use this property as SET FMTONLY is marked for deprecation. useFmtOnly は、sp_describe_undeclared_parameters の既知の問題と制限の回避策としてのみ使用できます。useFmtOnly is made available to use only as a workaround for known issues and limitations in sp_describe_undeclared_parameters.

現在、この機能では、単一の SELECT/INSERT/UPDATE/DELETE クエリのみがサポートされています。This feature currently only supports single SELECT/INSERT/UPDATE/DELETE queries. サポートされていないクエリまたは複数のクエリでこの機能を使用しようとすると、ドライバーではクエリの解析が試行されますが、ほとんどの場合、例外が発生します。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.

詳細については、「UseFmtOnly を使用した ParameterMetaData の取得」を参照してください。For more information, see Retrieving ParameterMetaData via useFmtOnly.
userName,userName,
useruser

StringString
[<=128 文字][<=128 char]

nullnull
SQL ユーザーとパスワードが接続されている場合のデータベース ユーザー。The database user, in case of connection with SQL user and password.

プリンシパル名とパスワードを使用した Kerberos 接続の場合、このプロパティは Kerberos プリンシパル名に設定されます。For Kerberos connection with principal name and password, this property is set to Kerberos Principal name.
workstationIDworkstationID

StringString
[<=128 文字][<=128 char]

<空の文字列><empty string>
ワークステーション ID。The workstation ID. 個別のワークステーションを識別するために、さまざまな SQL ServerSQL Server プロファイリング ツールおよびロギング ツールで使用されます。Used to identify the specific workstation in various SQL ServerSQL Server profiling and logging tools.

指定されていない場合は、<空の文字列> が使用されます。If none is specified, the <empty string> is used.
xopenStatesxopenStates

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

falsefalse
"true" に設定すると、ドライバーが XOPEN 互換の状態コードを例外で返します。Set to "true" to specify that the driver returns XOPEN-compliant state codes in exceptions.

既定では、SQL 99 の状態コードを返します。The default is to return SQL 99 state codes.
   

注意

SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server は、ANSI_DEFAULTS および IMPLICIT_TRANSACTIONS 以外の接続プロパティのサーバー既定値を受け取ります。The SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server takes the server default values for connection properties except for ANSI_DEFAULTS and IMPLICIT_TRANSACTIONS. SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server によって、ANSI_DEFAULTS は ON に、IMPLICIT_TRANSACTIONS は OFF に自動的に設定されます。The SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server automatically sets ANSI_DEFAULTS to ON and IMPLICIT_TRANSACTIONS to OFF.

重要

認証に ActiveDirectoryPassword が設定されている場合、次のライブラリがクラスパスに含められている必要があります: azure-active-directory-library-javaIf authentication is set to ActiveDirectoryPassword, the following library needs to be included in classpath: azure-activedirectory-library-for-java. Maven リポジトリ で見つけることができます。It can be found on Maven Repository. ライブラリとその依存関係をダウンロードする最も簡単な方法は、Maven を使用することです。The simplest way to download the library and its dependencies is using Maven:

  1. まず、ご使用のシステムに Maven をインストールします。First, install Maven on your system
  2. ドライバーの GitHub ページ へ移動します。Go to the GitHub page of the driver
  3. pom.xml ファイルをダウンロードします。Download the pom.xml file
  4. 次の Maven コマンドを実行して、ライブラリとその依存関係をダウンロードします。mvn dependency:copy-dependenciesRun the following Maven command to download the library and its dependencies: mvn dependency:copy-dependencies

関連項目See also

JDBC ドライバーによる SQL Server への接続Connecting to SQL Server with the JDBC driver
FIPS モードFIPS mode