Amazon RDS for SQL Server 2019アダプタ制限事項

サポートする型
全処理共通
テーブル読み取り処理
検索系SQL実行処理
テーブル書き込み処理
更新系SQL実行処理
ストアドプロシージャ実行処理
主な例外

サポートする型

本アダプタでサポートする型は以下の通りです。

型名	サポート	備考
BIGINT型	○
INT型	○
SMALLINT型	○
TINYINT型	○
BIT型	○
NUMERIC型	○
DECIMAL型	○
MONEY型	○
SMALLMONEY型	○
FLOAT型	○
REAL型	○
TIME型	△
DATE型	○
SMALLDATETIME型	○
DATETIME型	△
DATETIME2型	△
DATETIMEOFFSET型	△	Stringとしてデータを扱います。
CHAR型	○
VARCHAR型	○
NCHAR型	○
NVARCHAR型	○
TEXT型	○
NTEXT型	○
BINARY型	○
VARBINARY型	○
IMAGE型	○
VARCHAR(MAX)型	○
NVARCHAR(MAX)型	○
VARBINARY(MAX)型	○
XML型	△
SQL_VARIANT型	×
UNIQUEIDENTIFIER型	×

○:サポートします。
△:サポートしますが、制限事項があります。
×:サポートしません。

型による範囲やデータの丸めなどデータベースの仕様については、SQL Server 2019のドキュメントを参照してください。

全処理共通

仕様制限

名前に以下の文字を含むデータベースに接続することはできません。また、これ以外の文字でも、データベース名に含めると接続できなくなる場合があります。
詳細については、データベースベンダーに問い合わせてください。

文字 - % & ( ) = [ ] { } ' ^ ;
データはUnicodeとして送信されます。

文字	-	%	&	(	)	=	[	]	{	}	'	^	;

テーブル読み取り処理

仕様制限

テーブル一覧の表示について
- dboスキーマ以外のスキーマに存在しているテーブルは、「<スキーマ名>.<テーブル名>」と表示されます。
TIME型
- ミリ秒まで取得することができます。
DATETIME2型
- ミリ秒まで取得することができます。
テーブル名が引用符で囲われた状態でもテーブル名の大文字小文字は区別しません。

検索系SQL実行処理

仕様制限

TIME型
- ミリ秒まで取得することができます。
DATETIME型
- WHERE句にSQLパラメータを使用していて、ミリ秒まであるDATETIME型の値を代入する場合、比較演算子などで正確に判定されません。ただし、この事象は、Mapperで値を"yyyy-MM-dd HH:mm:ss.SSS"形式の文字列に変換し、SQLパラメータの型をVARCHAR型へ変更することで回避できます。
DATETIME2型
- ミリ秒まで取得することができます。

テーブル書き込み処理

仕様制限

テーブル一覧の表示について
- dboスキーマ以外のスキーマに存在しているテーブルは、「<スキーマ名>.<テーブル名>」と表示されます。
TIME型
- ミリ秒まで指定することができます。
DATETIME2型
- ミリ秒まで指定することができます。
テーブル名が引用符で囲われた状態でもテーブル名の大文字小文字は区別しません。

更新系SQL実行処理

仕様制限

TIME型
- SQLパラメータを使用する場合、ミリ秒まで指定することができます。
DATETIME型
- WHERE句にSQLパラメータを使用していて、ミリ秒まであるDATETIME型の値を代入する場合、比較演算子などで正確に判定されません。ただし、この事象は、Mapperで値を"yyyy-MM-dd HH:mm:ss.SSS"形式の文字列に変換し、SQLパラメータの型をVARCHAR型へ変更することで回避できます。
DATETIME2型
- SQLパラメータを使用する場合、ミリ秒まで指定することができます。

ストアドプロシージャ実行処理

仕様制限

TIME型
- 入力パラメータは、ミリ秒まで指定することができます。
- 出力パラメータは、ミリ秒まで取得することができます。
DATETIME2型
- 入力パラメータは、ミリ秒まで指定することができます。
- 出力パラメータは、ミリ秒まで取得することができます。
XML型
- プロシージャの引数にXML型が含まれている場合、実行できません。
SQL_VARIANT型
- プロシージャの引数にSQL_VARIANT型が含まれている場合、実行できません。
UNIQUEIDENTIFIER型
- プロシージャの引数にUNIQUEIDENTIFIER型が含まれている場合、実行できません。
名前を引用符で囲う必要があるプロシージャは使用できない場合があります。

出力パラメータを使用するプロシージャを指定した場合、入力パラメータ設定にも出力パラメータと同様のパラメータが表示され、入力データが必要になります。

主な例外

例外名		原因	対策
com.microsoft.sqlserver.jdbc.SQLServerException	ユーザー '<ユーザ名>' はログインできませんでした。	ユーザ名またはパスワードが不正です。	グローバルリソースの[ユーザ名]または[パスワード]を確認してください。
	このログインで要求されたデータベース "<データベース名>" を開けません。ログインに失敗しました。"	データベースが不正です。	グローバルリソースの[データベース名]を確認してください。
	ホスト <ホスト名>、ポート <ポート番号> への TCP/IP 接続が失敗しました。エラー: "<ホスト名>。接続プロパティを調べて、SQL Server のインスタンスがホスト上で実行されていて、ポートへの TCP/IP 接続が許可されており、そのポートへの TCP 接続がファイアウォールにブロックされていないことを確認してください。"。	データベースに接続できません。	グローバルリソースの[ホスト名]、またはネットワークを確認してください。
	ホスト <ホスト名>、ポート <ポート番号> への TCP/IP 接続が失敗しました。エラー: "connect timed out。接続プロパティを調べて、SQL Server のインスタンスがホスト上で実行されていて、ポートへの TCP/IP 接続が許可されており、そのポートへの TCP 接続がファイアウォールにブロックされていないことを確認してください。"。	データベースに接続できません。	グローバルリソースの[ポート番号]、またはネットワークを確認してください。
	Invalid object name '<テーブル名>'.	テーブルが存在しません。	[テーブル名]で存在するテーブルを指定してください。
	Incorrect syntax near '<テーブル名>'.	テーブル名がTransact-SQLの標準識別子の規則にしたがっていない可能性があります。	[テーブル名]で指定したテーブルを、引用符で囲ってください。