Symfoware Server V12.0.1 クラスタ運用ガイド

3.5 アプリケーション作成時の注意と対処

アプリケーション作成時の注意、および状態遷移発生時のアプリケーションの対処について説明します。

アプリケーション作成時の注意

アプリケーションの作成の際に指定するIPアドレスは、Glsリソースの作成、または、引継ぎネットワークリソースの作成時に指定したIPアドレスを指定してください。状態遷移が発生した場合、アプリケーションを変更することなく、再実行のみで実行が可能です。

状態遷移発生時のアプリケーションの対処

アプリケーションサーバなどの他ノード上で動作するアプリケーションからアクセスしている際、Symfoware/RDBの動作するノードの異常などが発生した場合に返却するエラー情報と対処について示します。

表3.1 JDBC driverの場合

状態		エラー情報(注)	対処
ノードダウン または Symfoware Serverシステムダウン	アクセス中にダウンしたとき	57P01 08006	切替え完了後、コネクションの再接続、または、アプリケーションの再実行をしてください。
	ダウン中にアクセスしたとき	08001
待機ノードへの切替え	アクセス中に切替えたとき	57P01 08006
	切替え中にアクセスしたとき	08001

注) SQLExceptionのgetSQLState()の返却値となります。

表3.2 ODBC driverの場合

状態		エラー情報(注)	対処
ノードダウン または Symfoware Serverシステムダウン	アクセス中にダウンしたとき	57P01 08S01	切替え完了後、コネクションの再接続、または、アプリケーションの再実行をしてください。
	ダウン中にアクセスしたとき	08001
待機ノードへの切替え	アクセス中に切替えたとき	57P01 08S01
	切替え中にアクセスしたとき	08001

注) SQLSTATEの返却値となります。

表3.3 .NET Data Providerの場合

状態		エラー情報	対処
ノードダウン または Symfoware Serverシステムダウン	アクセス中にダウンしたとき	57P01(注) 空文字列(注) NullReferenceExceptionが発生	切替え完了後、コネクションの再接続、または、アプリケーションの再実行をしてください。
	ダウン中にアクセスしたとき	空文字列(注)
待機ノードへの切替え	アクセス中に切替えたとき	57P01(注) 空文字列(注) NullReferenceExceptionが発生
	切替え中にアクセスしたとき	空文字列(注)

注) NpgsqlExceptionの属性Codeの返却値となります。

表3.4 libpq-Cライブラリの場合

状態		エラー情報	対処
ノードダウン または Symfoware Serverシステムダウン	アクセス中にダウンしたとき	PGRES_FATAL_ERROR(注1) 57P01(注2) NULL(注2)	切替え完了後、コネクションの再接続、または、アプリケーションの再実行をしてください。
	ダウン中にアクセスしたとき	CONNECTION_BAD(注3)
待機ノードへの切替え	アクセス中に切替えたとき	PGRES_FATAL_ERROR(注1) 57P01(注2) NULL(注2)
	切替え中にアクセスしたとき	CONNECTION_BAD(注3)

注1) PQresultStatus()の返却値となります。

注2) PQresultErrorField()のPG_DIAG_SQLSTATEの返却値となります。

注3) PQstatus()の返却値となります。

表3.5 ECPG-C言語による埋め込みSQLの場合

状態		エラー情報(注)	対処
ノードダウン または Symfoware Serverシステムダウン	アクセス中にダウンしたとき	57P01 57P02 YE000 26000	切替え完了後、コネクションの再接続、または、アプリケーションの再実行をしてください。
	ダウン中にアクセスしたとき	08001
待機ノードへの切替え	アクセス中に切替えたとき	57P01 57P02 YE000 26000
	切替え中にアクセスしたとき	08001

注) SQLSTATEの返却値となります。