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

サポートする型
全処理共通
テーブル読み取り処理
検索系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 2022のドキュメントを参照してください。

全処理共通

仕様制限

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

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

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

接続プロパティの設定

接続プロパティは$DATASPIDER_HOME\server\plugin\data_processing\share\classesにあるdb_sqlserver.propertiesファイルで設定できます。

プロパティ名	説明	備考
sendStringParametersAsUnicode	[true]: データがUnicodeとして送信されることを示します。 [false]: データベースの既定の照合順序でサーバに送信されます。Unicodeではない文字データのインデックス参照の際、Unicodeからの変換オーバーヘッドが発生しないのでパフォーマンスが向上します。	デフォルト値は「true」です。

テーブル読み取り処理

仕様制限

テーブル一覧の表示について
- 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型が含まれている場合、実行できません。
名前を引用符で囲う必要があるプロシージャは使用できない場合があります。

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

主な例外

例外名		原因	対策
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の標準識別子の規則にしたがっていない可能性があります。	[テーブル名]で指定したテーブルを、引用符で囲ってください。
	"encrypt" プロパティが "true" に設定され、"trustServerCertificate" プロパティが "false" に設定されていますが、ドライバーは Secure Sockets Layer (SSL) 暗号化を使用して SQL Server へのセキュリティで保護された接続を確立できませんでした: エラー: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target。	証明書がDataSpiderServerが参照するキーストアにインポートされていません。	証明書をDataSpiderServerが参照するキーストアにインポートしてください。証明書のインポート方法については、「証明書のインポート」を参照してください。