接続プロパティの設定」を参照してください。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 メソッドのパラメーターです。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 ドライバーはこのような値の大文字と小文字の区別について検証しません。In addition, 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 DescriptionDescription
accessTokenaccessToken 文字列String nullnull このプロパティを使用して、アクセス トークンを使用して SQL データベースに接続します。Use this property to connect to a SQL database using an access token. accessToken接続 URL を使用して設定することはできません。accessToken cannot be set using the connection URL.
applicationIntentapplicationIntent 文字列String ReadWriteReadWrite アプリケーションがサーバーに接続するときのワークロードのタイプを宣言します。Declares the application workload type when connecting to a server. 指定できる値はReadOnlyReadWriteです。Possible values are ReadOnly and ReadWrite. 詳細については、次を参照してください。 High Availability, Disaster Recovery の JDBC ドライバー サポートです。For more information, see JDBC Driver Support for High Availability, Disaster Recovery.
applicationNameapplicationName 文字列String

[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 文字列String 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 データベースに接続します。Use ActiveDirectoryIntegrated to connect to a SQL Database using integrated Windows authentication.

使用してActiveDirectoryPassword Azure AD のプリンシパル名とパスワードを使用して SQL データベースに接続します。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 is 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 will 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 is available in multiple languages (both x86 and amd64) from the download center at Microsoft Active Directory Authentication Library for Microsoft SQL Server. JDBC ドライバーでは、バージョンのみがサポート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 Database を使用して 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 文字列String "NativeAuthentication""NativeAuthentication" 統合セキュリティの種類、アプリケーションを使用することを示します。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 will occur (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.
columnEncryptionSettingcolumnEncryptionSetting 文字列String

["Enabled"(&) #124;"無効な"]["Enabled"|"Disabled"]
DisabledDisabled 「有効」に設定すると、Microsoft JDBC Driver 6.0 for SQL Server 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.

参照してくださいJDBC ドライバーで Always Encrypted を使用して詳細についてはします。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、databasedatabaseName, database 文字列String

[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"(&) #124;"false"]["true"|"false"]
truetrue 現在は、値 "true" のみがサポートされています。Only the value "true" is currently supported. "false" に設定した場合は、例外が発生します。If set to "false", an exception will occur.
encryptencrypt booleanboolean

["true"(&) #124;"false"]["true"|"false"]
オプションfalse 指定するには、"true"に設定、 SQL ServerSQL Serverサーバーにインストールされている証明書がある場合に、クライアントとサーバー間で送信されるすべてのデータに Secure Sockets Layer (SSL) 暗号化を使用します。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 から始まりに、新しい接続の設定 'authentication' が既定で 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 文字列String 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.

仮想ネットワーク名を指定する場合、サーバー接続プロパティでは、データベース ミラーリングを使用することはできません。If you specify a Virtual Network Name in the Server connection property, you cannot use database mirroring. 参照してくださいHigh Availability, Disaster Recovery の JDBC ドライバー サポート詳細についてはします。See JDBC Driver Support for High Availability, Disaster Recovery for more information.
hostNameInCertificatehostNameInCertificate 文字列String 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を使用して、 serverNameを検証するホスト名として、接続 URL のプロパティの値、 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 will use 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". 渡された値を確認してくださいhostNameInCertificateで、サブジェクト代替名 (SAN) SSL 接続のサーバー証明書を成功させるのには共通名 (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 文字列String

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

仮想ネットワーク名を指定する場合、サーバー接続プロパティは使用できませんinstanceName接続プロパティです。If you specify a Virtual Network Name in the Server connection property, you cannot use instanceName connection property. 参照してくださいHigh Availability, Disaster Recovery の JDBC ドライバー サポート詳細についてはします。See JDBC Driver Support for High Availability, Disaster Recovery for more information.
integratedSecurityintegratedSecurity booleanboolean

["true"(&) #124;"false"]["true"|"false"]
オプションfalse Windows 資格情報を使用することを示すために、"true"に設定 SQL ServerSQL ServerWindows オペレーティング システムでします。Set to "true" to indicate that Windows credentials will be 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 will be 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.
keyStoreAuthenticationkeyStoreAuthentication 文字列String 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 文字列String 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 文字列String 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"(&) #124;"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. 他のすべてのメソッドの戻り値のすべての結果を実行し、カウントを更新します。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 int [0..65535]int [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.

仮想ネットワーク名を指定する場合、サーバー接続プロパティでは、フェールオーバー接続が成功するための十分な時間を許可するのには 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. 参照してくださいHigh Availability, Disaster Recovery の JDBC ドライバー サポート詳細についてはします。See JDBC Driver Support for High Availability, Disaster Recovery for more information.
multiSubnetFailovermultiSubnetFailover ブール値Boolean オプションfalse 常に指定multiSubnetFailover = trueの可用性グループ リスナーに接続するときに、 SQL Server 2012SQL Server 2012可用性グループ、または SQL Server 2012SQL Server 2012フェールオーバー クラスター インスタンス。Always specify multiSubnetFailover=true when connecting to the availability group listener of a SQL Server 2012SQL Server 2012 availability group or a SQL Server 2012SQL Server 2012 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. 参照してくださいHigh Availability, Disaster Recovery の JDBC ドライバー サポート詳細についてはします。See JDBC Driver Support for High Availability, Disaster Recovery for more information.

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

注: Microsoft JDBC Driver 6.0 for SQL Server 可用性グループ リスナーに接続するときは、true に multiSubnetFailover を設定する必要が不要になった以降します。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 int [-1 (&) #124; 0 | 512..32767]int [-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 will occur.

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

[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、portportNumber, port int [0..65535]int [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 always be specified, as this is more secure than using sqlbrowser.
responseBufferingresponseBuffering 文字列String

["full"(&) #124;"アダプティブ"]["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.

注:バージョン 1.2 の JDBC ドライバーをアップグレードした後、既定のバッファリング動作が"adaptive"にします。Note: After upgrading the JDBC driver from version 1.2, the default buffering behavior will be "adaptive." 場合は、アプリケーションでは、"responseBuffering"プロパティが設定しないと、アプリケーションで version 1.2 の既定の動作を保持する、接続のプロパティ、またはを使用して、responseBufferring プロパティを"full"を設定する必要があります、 setResponseBufferingのメソッド、 SQLServerStatementオブジェクト。If your application has never set the "responseBuffering" property and you want to keep the version 1.2 default behavior in your application, you must set the responseBufferring propery to "full" either in the connection properties or by using the setResponseBuffering method of the SQLServerStatement object.
selectMethodselectMethod 文字列String

[「直接」|"カーソル"]["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 very 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.
sendStringParametersAsUnicodesendStringParametersAsUnicode booleanboolean

["true"(&) #124;"false"]["true"|"false"]
truetrue 場合、 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. SetNString、setNCharacterStream、setNClob メソッドなど、新しい JDBC 4.0 national character メソッドSQLServerPreparedStatementSQLServerCallableStatementクラス、常にパラメーター値がこのプロパティの設定に関係なく、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.

パフォーマンスを最適化、 CHARVARCHAR、およびLONGVARCHAR JDBC データ型では、アプリケーションを設定する必要があります、 sendStringParametersAsUnicodeプロパティを"false"を使用して、setString、setCharacterStream、setClob 非 national character メソッドのSQLServerPreparedStatementSQLServerCallableStatementクラスです。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プロパティを Unicode データにアクセスする非 national character メソッドは、サーバー側の型を使用して、"false"(など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"(&) #124;"false"]["true"|"false"]
truetrue このプロパティで追加されました SQL ServerSQL ServerJDBC Driver 3.0 です。This property was added in SQL ServerSQL Server JDBC Driver 3.0.

Java.sql.Time 値としてサーバーに送信する場合は、 SQL ServerSQL Server datetime値。When true, java.sql.Time values will be sent to the server as SQL ServerSQL Serverdatetime values.

Java.sql.Time 値としてサーバーに送信する false の場合、 SQL ServerSQL Server時間値。When false, java.sql.Time values will be sent to the server as SQL ServerSQL Servertime values.

sendTimeAsDatetimeもで変更できるプログラムでSQLServerDataSource.setSendTimeAsDatetimeです。sendTimeAsDatetime can also be modified programmatically with SQLServerDataSource.setSendTimeAsDatetime.

今後のリリースでは、このプロパティの既定値が変更される可能性があります。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、serverserverName, server 文字列String 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. 参照してくださいHigh Availability, Disaster Recovery の JDBC ドライバー サポート詳細についてはします。See JDBC Driver Support for High Availability, Disaster Recovery for more information.
serverSpnserverSpn 文字列String 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 はポート番号、および領域とは大文字で 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.

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

["true"(&) #124;"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 ドライバーの国際対応機能詳細についてはします。See International Features of the JDBC Driver for more details.
TransparentNetworkIPResolutiontransparentNetworkIPResolution booleanboolean

["true"(&) #124;"false"]["true"|"false"]
truetrue Microsoft JDBC Driver 6.0 for SQL Server、このプロパティ、transparentNetworkIPResolution 以降、迅速に検出し、(現在) アクティブなサーバーへの接続を提供します。Beginning with Microsoft JDBC Driver 6.0 for SQL Server, this property, transparentNetworkIPResolution, provides faster detection of and connection to the (currently) active server. 使用可能な値は true または false 場合は true で、既定値として。Possible values are true and false with true as 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 500ms as the timeout. 後続の試みは、multiSubnetFailover プロパティで使用するタイムアウトと同じロジックを使用します。Any subsequent attemps use the same timeout logic as used by the multiSubnetFailover property.
columnEncryptionSettingcolumnEncryptionSetting booleanboolean

["true"(&) #124;"false"]["true"|"false"]
オプションfalse Microsoft JDBC Driver 6.0 for SQL Server 以降では、"true" に設定すると、Always Encrypted (AE) 機能を使用します。Set to "true" 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.

参照してくださいJDBC ドライバーで Always Encrypted を使用して詳細についてはします。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 newer versions.
trustServerCertificatetrustServerCertificate booleanboolean

["true"(&) #124;"false"]["true"|"false"]
オプションfalse 指定するには、"true"に設定、 Microsoft SQL Server 用 JDBC DriverMicrosoft JDBC Driver for SQL Serverは検証されません、 SQL ServerSQL Server SSL 証明書。Set to "true" to specify that the Microsoft SQL Server 用 JDBC DriverMicrosoft JDBC Driver for SQL Server will not validate the SQL ServerSQL Server SSL certificate.

"True"の場合、 SQL ServerSQL Server通信レイヤーが SSL で暗号化されている場合は、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 will validate the server SSL certificate. サーバー証明書の検証が失敗した場合は、エラーが発生して接続が終了します。If the server certificate validation fails, the driver will raise an error and terminate the connection. 既定値は"false"です。The default value is "false". 渡された値を確認してくださいserverNameが成功する SSL 接続のサーバー証明書のサブジェクト代替名の 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 文字列String 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 will rely on the trust manager factory's look up 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 ホーム >/ライブラリ/セキュリティ/jssecacerts"ファイル。"<java-home>/lib/security/jssecacerts" file.

"<java ホーム >/ライブラリ/セキュリティ/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 文字列String 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 will use 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 will use 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 の検索、接続が SSL 接続を使用する場合にのみ、 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".
user、userNameuserName, user 文字列String

[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 文字列String

[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"(&) #124;"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.
gsscredentialgsscredential org.ietf.jgss.GSSCredentialorg.ietf.jgss.GSSCredential nullnull SQL Server 用 Microsoft JDBC Driver 6.2 以降、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.
jaasConfigurationNamejaasConfigurationName 文字列String SQLJDBCDriverSQLJDBCDriver SQL Server 用 Microsoft JDBC Driver 6.2 以降、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.
serverPreparedStatementDiscardThresholdserverPreparedStatementDiscardThreshold IntegerInteger 1010 サーバーで未処理のハンドルをクリーンアップするための呼び出しが実行される前に、数の未処理の準備されたステートメント破棄操作 (sp_unprepare) が接続ごとの未処理できますを制御します。Controls 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 the setting is <= 1 un-prepare actions will be executed immediately on prepared statement close. 設定されている場合 > 1 これらの呼び出しは sp_unprepare の多くの呼び出しのオーバーヘッドを避けるためにまとめてバッチ処理します。If it is set to >1 these calls will be batched together to avoid overhead of calling sp_unprepare too often.
enablePrepareOnFirstPreparedStatementCallenablePrepareOnFirstPreparedStatementCall booleanboolean

["true"(&) #124;"false"]["true"|"false"]
オプションfalse この構成が false に設定されている場合、準備されたステートメントの最初の実行が sp_executesql を呼び出すし、sp_prepexec を呼び出すし、準備されたステートメント ハンドルを実際にセットアップが 2 つ目の実行が発生したら、ステートメントを準備できません。If this configuration is set to false the first execution of a prepared statement will call sp_executesql and not prepare a statement, once the second execution happens it will call sp_prepexec and actually setup a prepared statement handle.
statementPoolingCacheSizestatementPoolingCacheSize IntegerInteger 1010 プールで再利用するための構成可能なキャッシュ可能なステートメントConfigurable cachable Statements for Reuse in Pool

注意

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を ON に ANSI_DEFAULTS を自動的に設定し、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-ライブラリ-用の javaです。Important: If authentication is set to ActiveDirectoryPassword, the following library will need 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 依存関係: コピー-依存関係。Run 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