接続プロパティの設定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)  
    

RemarksRemarks

プロパティ名の大文字と小文字は区別されず、重複したプロパティ名は次の順序で解決されます。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
Type
既定Default
[説明]Description
accessTokenaccessToken

StringString

nullnull
このプロパティを使用して、アクセス トークンを使用して SQL database に接続します。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 ドライバー サポートします。For more information, see JDBC Driver Support for High Availability, Disaster Recovery.
applicationNameapplicationName

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

nullnull
アプリケーション名、または " Microsoft SQL Server 用 JDBC DriverMicrosoft JDBC Driver for SQL Server" (名前が指定されていない場合) です。The application name, or " Microsoft SQL Server 用 JDBC DriverMicrosoft 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)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. 指定できる値はActiveDirectoryIntegratedActiveDirectoryPasswordSqlPasswordと既定NotSpecified.Possible values are ActiveDirectoryIntegrated, ActiveDirectoryPassword, 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.

使用SqlPasswordを使用して、SQL Server に接続するuserName/ユーザーパスワードプロパティ。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 に設定されている場合、次の 2 つのライブラリをインストールする必要: SQLJDBC_AUTH します。DLL (JDBC ドライバー パッケージで使用可能) と Azure Active Directory の認証ライブラリの SQL Server (ADALSQL します。DLL) (x86 と amd64 の両方) に対して、ダウンロード センターからのさまざまな言語で使用可能になるMicrosoft Active Directory の認証ライブラリの Microsoft SQL Serverします。Important: If authentication is set to ActiveDirectoryIntegrated, the following two libraries need to be installed: SQLJDBC_AUTH.DLL (available in the JDBC driver package) and Azure Active Directory Authentication Library for SQL Server (ADALSQL.DLL) It's available in different languages (for both x86 and amd64) from the download center at Microsoft Active Directory Authentication Library for Microsoft SQL Server. JDBC driver バージョンのみをサポート1.0.2028.318 以上ADALSQL の。DLL です。The JDBC driver only supports version 1.0.2028.318 and higher for the ADALSQL.DLL.

注: 認証プロパティが設定されている場合に任意の値以外のNotSpecified、既定では、ドライバーは Secure Sockets Layer (SSL) 暗号化を使用します。Note: When authentication property is set to any value other than NotSpecified, the driver by default uses Secure Sockets Layer (SSL) encryption.

Azure Active Directory 認証を構成する方法については、次を参照してください。 SQL データベースを 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
アプリケーションで使用する統合セキュリティの種類を示します。Indicates which kind of integrated security you want your application to use. 指定できる値はjava Kerberosと既定NativeAuthenticationします。Possible values are JavaKerberos and the default NativeAuthentication.

使用する場合authenticationScheme = java Kerberosで完全修飾ドメイン名 (FQDN) を指定する必要があります、 serverNameまたはserverSpnプロパティ。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を参照してくださいを使用した Kerberos 統合認証を SQL Server への接続します。For more information on using authenticationScheme, see Using Kerberos Integrated Authentication to Connect to SQL Server.
cancelQueryTimeoutcancelQueryTimeout

ssNoversionint

-1-1
SQL Server 用 Microsoft JDBC Driver 6.4 以降、このプロパティをキャンセルに使用する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"]

DisabledDisabled
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,
[データベース]database

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

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

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

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

truetrue
ステートメントのプールを使用する場合を示すフラグします。Flag indicating if the statement pooling should be used.
enablePrepareOnFirst.enablePrepareOnFirst...
PreparedStatementCallPreparedStatementCall

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

オプションfalse
enablePrepareOnFirstPreparedStatementCallenablePrepareOnFirstPreparedStatementCall

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

呼び出して、準備されたステートメントの最初の実行を変更する、"false"に設定sp_executesqlしたら、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 setup a prepared statement handle.
encryptencrypt

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

オプションfalse
SQL ServerSQL Server で、サーバーに証明書がインストールされている場合に、クライアントとサーバーの間で送信されるすべてのデータに対して SSL (Secure Sockets Layer) 暗号化が使用されるようにするには、"true" に設定します。Set to "true" to specify that the SQL ServerSQL Server uses Secure Sockets Layer (SSL) 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 を新しい接続の設定 '認証が ' 既定で SSL 暗号化を使用します。Beginning with Microsoft JDBC Driver 6.0 for SQL Server, there is a new connection setting ‘authentication’ that uses SSL 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.

これで使用する必要がありますintegratedSecurityとしてtruejava Kerberos authenticationschemeします。This should be used with integratedSecurity as true and JavaKerberos authenticationscheme.
hostNameInCertificatehostNameInCertificate

StringString

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

hostNameInCertificate プロパティが指定されていないか null に設定されている場合、 Microsoft SQL Server 用 JDBC DriverMicrosoft JDBC Driver for SQL Server は、接続 URL の serverName プロパティ値をホスト名として使用して SQL ServerSQL Server の SSL 証明書を検証します。If the hostNameInCertificate property is unspecified or set to null, the Microsoft SQL Server 用 JDBC DriverMicrosoft JDBC Driver for SQL Server uses the serverName property value on the connection URL as the host name to validate the SQL ServerSQL Server SSL certificate.

注: と組み合わせてこのプロパティは、使用、暗号化/認証プロパティおよびtrustServerCertificateプロパティ。Note: This property is used in combination with the encrypt/authentication properties and the trustServerCertificate property. 接続 Secure Sockets Layer (SSL) 暗号化を使用する場合にのみ、このプロパティが証明書の検証に影響し、 trustServerCertificateが"false"に設定します。This property affects the certificate validation, if and only if the connection uses Secure Sockets Layer (SSL) encryption and the trustServerCertificate is set to "false". SSL 接続に成功するためには、hostNameInCertificate に渡された値が、サーバー証明書に含まれる Subject Alternate Name (SAN) の Common Name (CN) または DNS 名と厳密に一致している必要があります。Make sure the value passed to hostNameInCertificate exactly matches the Common Name (CN) or DNS name in the Subject Alternate Name (SAN) in the server certificate for an SSL connection to succeed. 詳細については、「SSL のサポートについて」を参照してください。For more information, see Understanding SSL 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 ドライバー サポート詳細についてはします。See JDBC Driver Support for High Availability, Disaster Recovery for more information.
integratedSecurityintegratedSecurity

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

オプションfalse
Windows 資格情報がによって使用されることを示すには、"true"に設定 SQL ServerSQL ServerWindows オペレーティング システムでします。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 have already been provided at the computer or network logon.

"True"に設定する (でauthenticationscheme = java Kerberos) Kerberos 資格情報がによって使用されることを示すために、 SQL ServerSQL Serverします。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.

"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.
既定では、ドライバーはプロパティを設定useDefaultCcache = trueIBM の Jvm のおよびuseTicketCache = true他の Jvm の。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 の設定をサポートする Java キー ストアのこのプロパティを設定する必要がありますを使用してシームレスに"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". このプロパティを使用することも必要を設定する、 keyStoreLocationkeyStoreSecret Java キー ストアのプロパティ。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 = JavaKeyStorePasswordkeyStoreLocationプロパティは、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 = JavaKeyStorePasswordkeyStoreSecretプロパティを使用して、キーの場合と同様のキーストアのパスワードを識別します。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

ssNoversionint

-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

ssNoversionint
[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 ドライバー サポート詳細についてはします。See JDBC Driver Support for High Availability, Disaster Recovery for more information.
multiSubnetFailovermultiSubnetFailover

ブール値Boolean

オプションfalse
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 によって、(現在) アクティブなサーバーを迅速に検出し、接続するように Microsoft SQL Server 用 JDBC DriverMicrosoft JDBC Driver for SQL Server が構成されます。multiSubnetFailover=true configures Microsoft SQL Server 用 JDBC DriverMicrosoft 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 ドライバー サポート詳細についてはします。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

ssNoversionint
[-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.
パスワードpassword

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

ssNoversionint
[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

ssNoversionint

-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
[「直接」 | "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".

注:sendStringParametersAsUnicodeパラメーター値を送信するときにのみプロパティがチェックCHARVARCHAR、またはLONGVARCHAR JDBC の型。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.

アプリケーションでの setNString、setNCharacterStream、setNClob national character メソッドを使用することに注意してください、 SQLServerPreparedStatementSQLServerCallableStatementクラスNCHARNVARCHAR、およびLONGNVARCHAR JDBC データ型。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"]

オプションfalse
このプロパティは SQL ServerSQL Server JDBC Driver 3.0 で追加されました。This property was added in SQL ServerSQL Server JDBC Driver 3.0.

Java.sql.Time 値としてサーバーに送信するには、"true"に設定 SQL ServerSQL Server datetime値。Set to "true" to send java.sql.Time values to the server as SQL ServerSQL Server datetime values.
"False"に設定するサーバーとして java.sql.Time 値を送信 SQL ServerSQL Server時間値。Set to "false" to send java.sql.Time values to the server as SQL ServerSQL Server time values.

今後のリリースでは、このプロパティの既定値が変更される可能性があります。The default value for this property may change in a future release.

方法の詳細については Microsoft SQL Server 用 JDBC DriverMicrosoft JDBC Driver for SQL Serverjava.sql.Time 値を構成します。 それらをサーバーに送信する前に、次を参照してください。 java.sql.Time 値を構成する方法は、サーバーに送信されるします。For more information about how the Microsoft SQL Server 用 JDBC DriverMicrosoft 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 ドライバー サポート詳細についてはします。See JDBC Driver Support for High Availability, Disaster Recovery for more information.
serverNameAsACEserverNameAsACE

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

オプションfalse
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 Driver の国際対応の詳細。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、unprepare 準備のステートメントを閉じる操作が直ちに実行されます。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.

使用しての詳細についてはserverSpn Java kerberos では、次を参照してください。を使用した 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

ssNoversionint

00
statementPoolingCacheSizestatementPoolingCacheSize

SQL Server 用 JDBC Driver 6.4 以降、このプロパティを使用して、ドライバーで準備されたステートメントはキャッシュ処理を有効にします。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 proeprty which should be set to "false". 設定disableStatementPoolingを"true"またはstatementPoolingCacheSize準備されたステートメント 0 にするには、キャッシュを処理します。Setting disableStatementPooling to "true" or statementPoolingCacheSize to 0 disables prepared statement handle caching.
socketTimeoutsocketTimeout

ssNoversionint

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
セキュリティで保護された接続時に考慮する TLS プロトコルを指定する SQL Server 用 JDBC Driver 6.4 以降、このプロパティを使用できます。Beginning with JDBC Driver 6.4 for SQL Server, this property can used to specify TLS protocol to be considered during secure connection.
指定できる値は: TLSTLSv1TLSv1.1、およびTLSv1.2します。Possible 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

このプロパティは、SQL Server 用 Microsoft JDBC Driver 6.0 以降、迅速に検出し、(現在) アクティブなサーバーへの接続を提供します。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、前に、アプリケーションが含めるへの接続文字列を設定するのには"multiSubnetFailover = true"を 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. 設定がない場合、 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
独自trustManagerConstructorArg

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"]

オプションfalse
Microsoft SQL Server 用 JDBC DriverMicrosoft JDBC Driver for SQL ServerSQL ServerSQL Server の SSL 証明書を検証しないようにするには "true" に設定します。Set to "true" to specify that the Microsoft SQL Server 用 JDBC DriverMicrosoft JDBC Driver for SQL Server does not validate the SQL ServerSQL Server SSL certificate.

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

"False"の場合、 Microsoft SQL Server 用 JDBC DriverMicrosoft JDBC Driver for SQL Serverサーバー SSL 証明書を検証します。If "false", the Microsoft SQL Server 用 JDBC DriverMicrosoft JDBC Driver for SQL Server validates the server SSL certificate. サーバー証明書の検証が失敗した場合は、ドライバーでエラーが発生して接続が終了します。If the server certificate validation fails, the driver raises an error and terminate the connection. 既定値は "false" です。The default value is "false". SSL 接続に成功するためには、serverName に渡された値が、サーバー証明書に含まれる Subject Alternate Name の Common Name (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 an SSL connection to succeed. 詳細については、「SSL のサポートについて」を参照してください。For more information, see Understanding SSL Support.

注: と組み合わせてこのプロパティは、使用、暗号化/認証プロパティ。Note: This property is used in combination with the encrypt/authentication properties. このプロパティでは、接続を SSL 暗号化を使用する場合にのみサーバー SSL 証明書の検証のみ影響します。This property only affects server SSL certificate validation if and only if the connection uses SSL 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.

注: の接続を SSL 暗号化を使用する場合にのみにこのプロパティが証明書の trustStore の検索にのみに影響し、 trustServerCertificateプロパティが"false"に設定します。Note: This property only affects the certificate trustStore lookup, if and only if the connection uses SSL 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.

注: 接続が SSL 接続を使用する場合にのみ証明書の trustStore の検索が trustStorePassword プロパティによってのみ影響し、 trustServerCertificateプロパティが"false"に設定します。Note: The trustStorePassword property only affects the certificate trustStore lookup, if and only if the connection uses SSL 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"]

オプションfalse
useBulkCopyForBatchInsertuseBulkCopyForBatchInsert

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

この機能は、ターゲット サーバーは、型の場合にのみ機能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. 挿入クエリでは、他の 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
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"]

オプションfalse
"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.
   

注意

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