Hitachi

インメモリデータグリッド Hitachi Elastic Application Data Store ユーザーズガイド


20.2 クライアントライブラリのエラーコード(C言語)

C言語のクライアントライブラリで使用できる関数は,引数error_codeに指定された領域に次に示すエラーコードを返却します。

エラーコードとエラーの内容,発生要因を次の表に示します。

表20‒2 C言語のクライアントライブラリで使用できる関数が返却するエラーコード

error_codeの値

記号定数

エラーの内容

発生要因

データを更新するAPIの処理状態

クライアント定義のeads.client.compatパラメタに0300を指定した場合のerror_codeの値

0

EAD_OK

処理は正常に終了しました。

該当しません。

0

1000

EAD_ERROR_UNEXPECTED

予期しないエラーが発生しました。

プログラム内で予期しないエラーが発生しました。

1000

1010

EAD_ERROR_ILLEGAL_ARGUMENT

指定されたパラメタが不正です。

APIの引数に不正なパラメタが指定されています。

×

1010

1040

EAD_ERROR_CACHE_NOT_STARTED

キャッシュが開始されていないため実行できません。

キャッシュの終了後(ead_stop_cache()の実行後)に,データを操作しました。

×

1040

1100

EAD_ERROR_CACHE_NOT_NEED_STOP

すでに終了しているキャッシュに対して,終了処理をしています。

キャッシュはすでに終了しているため,ead_stop_cache()を実行する必要はありません。

1100

1110

EAD_ERROR_INVALID_NODE_ADDRESS

指定したEADSサーバのアドレス情報が,EADSクライアントが保持するEADSサーバのアドレス情報と一致しません。

APIの引数に指定したEADSサーバのアドレス情報(IPアドレスおよびポート番号)が,EADSクライアントが保持するどのEADSサーバのアドレス情報とも一致しません。

1110

1120

EAD_ERROR_EXCEED_MAX_CONNECTION_POOL_SIZE

同一接続先に対してプールしておくコネクションがすでに最大個数に達していて,すべて使用中です。

特定のEADSサーバに対して同時にリクエストしているスレッド数が,コネクションの最大個数を超えています。

×

1120

1200

EAD_ERROR_EVENTLISTENER_NOT_INITIALIZED

クラスタイベントリスナとノードイベントリスナを追加できません。

イベントリスナが無効になっている状態(クライアント定義のeads.client.eventListener.enableパラメタにtrueが指定されていない)で,次の処理を実行しました。

  • クラスタイベントリスナの追加(ead_add_cluster_eventlistener()の実行)

  • ノードイベントリスナの追加(ead_add_node_eventlistener()の実行)

1210

EAD_ERROR_EVENTLISTENER_EXIST

すでに追加されているクラスタイベントリスナまたはノードイベントリスナを,追加しようとしました。

次の要因が考えられます。

  • クラスタイベントリスナの追加後(ead_add_cluster_eventlistener()の実行後)に,クラスタイベントリスナの追加をした。

  • ノードイベントリスナの追加後(ead_add_node_eventlistener()の実行後)に,ノードイベントリスナの追加をした。

1220

EAD_ERROR_EVENTLISTENER_NOT_NEED_REMOVE

削除する必要がないクラスタイベントリスナまたはノードイベントリスナを,削除しようとしました。

次の要因が考えられます。

  • クラスタイベントリスナの削除後(ead_remove_cluster_eventlistener()の実行後)に,クラスタイベントリスナの削除をした。

  • ノードイベントリスナの削除後(ead_remove_node_eventlistener()の実行後)に,ノードイベントリスナの削除をした。

  • クラスタイベントリスナの追加(ead_add_cluster_eventlistener()の実行)をしていない状態で,クラスタイベントリスナの削除(ead_remove_cluster_eventlistener()の実行)をした。

  • ノードイベントリスナの追加(ead_add_node_eventlistener()の実行)をしていない状態で,ノードイベントリスナの削除(ead_remove_node_eventlistener()の実行)をした。

2000

EAD_ERROR_INIT

EADSクライアントの初期設定でエラーが発生しました。

ead_init_client()またはead_init_client_n()実行中に予期しないエラーが発生しました。

2000

2010

EAD_ERROR_INIT_PROPERTIES

クライアント定義ファイルが読み込めませんでした。

次の要因が考えられます。

  • クライアント定義ファイルが存在しない。

  • クライアント定義ファイルに読み込み権限がない。

  • 格納先パス名がファイルではなくディレクトリを指している。

2010

2020

EAD_ERROR_INIT_INVALID_PROPERTY

クライアント定義ファイルの定義内容に不正があります。

クライアント定義ファイルの定義内容が不正です。

2020

2030

EAD_ERROR_INIT_LOGGER

ログの初期化に失敗しました。

次の要因が考えられます。

  • 指定されたディレクトリ,または出力先のログファイルに書き込み権限がない。

  • 指定されたディレクトリに同名のファイルが存在する。

  • 指定されたパス名,またはファイル名が不正である。

  • ログファイル名と同名のディレクトリが存在した。

  • ログ出力を開始するためのメモリが不足している。

2030

2040

EAD_ERROR_INIT_CLUSTERINFO

クライアント定義ファイルで指定されたEADSサーバへの接続に失敗しました。

次の要因が考えられます。

  • クライアント定義に指定した接続先EADSサーバの指定に誤りがある。

  • 接続先EADSサーバとの通信に失敗した。または接続先EADSサーバで障害が発生している。

  • 接続先EADSサーバの最大同時接続数を超えた。

  • 接続先EADSサーバがリクエストの受付を開始できる状態でない。

  • 接続先EADSサーバでノンブロッキングI/O通信バッファが不足した。

  • 接続先EADSサーバとの通信中にタイムアウトが発生した。

2040

3000

EAD_ERROR_NET

EADSサーバとの間で通信エラーが発生しました。

次の要因が考えられます。

  • 通信中にネットワーク障害が発生した。

  • 通信先のEADSサーバで問題が発生した。

  • 通信先のホストで問題が発生した。

3000

3001

EAD_ERROR_NET_SEND_REQUEST

EADSサーバへのリクエスト送信処理で通信エラーが発生しました。

次の要因が考えられます。

  • 通信中にネットワーク障害が発生した。

  • 通信先のEADSサーバで問題が発生した。

  • 通信先のホストで問題が発生した。

3000

3002

EAD_ERROR_NET_RECEIVE_RESPONSE

EADSサーバへのレスポンス受信処理で通信エラーが発生しました。

次の要因が考えられます。

  • 通信中にネットワーク障害が発生した。

  • 通信先のEADSサーバで問題が発生した。

  • 通信先のホストで問題が発生した。

3000

3010

EAD_ERROR_NET_TIMEOUT

EADSサーバとの通信中にタイムアウトが発生しました。

次の要因が考えられます。

  • 接続先EADSサーバで問題が発生した。

  • 接続先のホストで問題が発生した。

  • ネットワークで問題が発生した。

  • タイムアウト時間の設定が誤っている。

3010

3011

EAD_ERROR_NET_SEND_TIMEOUT

EADSサーバへのリクエスト送信処理でタイムアウトが発生しました。

次の要因が考えられます。

  • 接続先EADSサーバで問題が発生した。

  • 接続先のホストで問題が発生した。

  • ネットワークで問題が発生した。

  • タイムアウト時間の設定が誤っている。

3010

3012

EAD_ERROR_NET_RECEIVE_TIMEOUT

EADSサーバへのレスポンス受信処理でタイムアウトが発生しました。

次の要因が考えられます。

  • 接続先EADSサーバで問題が発生した。

  • 接続先のホストで問題が発生した。

  • ネットワークで問題が発生した。

  • タイムアウト時間の設定が誤っている。

3010

3020

EAD_ERROR_NET_CONNECTION

EADSサーバとの接続に失敗しました。

次の要因が考えられます。

  • 接続先EADSサーバで問題が発生した。

  • 接続先EADSサーバに関する設定が誤っている。

  • ネットワークで問題が発生した。

  • タイムアウト時間の設定が誤っている。

×

3020

3030

EAD_ERROR_NET_PROTOCOL

EADSサーバとの通信中にプロトコル障害が発生しました。

次の要因が考えられます。

  • 接続先EADSサーバが誤っている。

  • 実行したユーザファンクションがバイト配列,またはNULL以外を戻り値として返却した。

  • 接続しているクラスタのキャッシュがJava言語のクライアントライブラリで使用中である。

3030

3040

EAD_ERROR_NET_CLUSTERINFO

接続できる,すべてのEADSサーバへの接続に失敗しました。

次の要因が考えられます。

  • 接続先EADSサーバで問題が発生した。

  • 接続先EADSサーバに関する設定が誤っている。

  • ネットワークで問題が発生した。

  • 指定したキャッシュが接続先EADSサーバに存在しない。

  • 接続先EADSサーバが閉塞状態となっている。

  • EADSクライアントが保持するクラスタ構成情報と,再起動した接続先EADSサーバが保持するクラスタ構成情報が一致しない。

  • 接続先EADSサーバの最大同時接続数を超えた。

  • 接続先EADSサーバとの通信中にタイムアウトが発生した。

3040

4000

EAD_ERROR_SERVER

予期しない内部エラーがEADSサーバで発生しました。

予期しない内部エラーが接続先EADSサーバで発生しました。

4000

4010

EAD_ERROR_SERVER_UNSUPPORTED_REQUEST

EADSクライアントが送信したリクエストを,接続先EADSサーバが処理できませんでした。

次の要因が考えられます。

  • データが破損しているなどの理由で,接続先EADSサーバがリクエストを処理できない。

  • 接続先EADSサーバがサポートしていないAPIを使用した。

×

4010

4030

EAD_ERROR_SERVER_UNAVAILABLE

EADSサーバが一時的に利用できません。

接続先EADSサーバの最大同時接続数を超えました。

×

4030

4040

EAD_ERROR_SERVER_INCOMPATIBLE_CLUSTERINFO

接続先EADSサーバが保持するクラスタ構成情報と,EADSクライアントが保持するクラスタ構成情報に互換性がありません。

再起動した接続先EADSサーバのクラスタ構成情報が,EADSクライアントが保持するクラスタ構成情報と一致しません。

×

4040

4060

EAD_ERROR_SERVER_REPLACE_METHOD_NOT_MATCHED

ead_replace()実行時,すでに格納されているvalueが条件に指定したvalueと一致しなかったため,valueを格納できませんでした。

ead_replace()で条件に指定したvalueとキャッシュ上のvalueが一致しませんでした。

×

4060

4070

EAD_ERROR_SERVER_REPLACE_METHOD_KEY_NOT_EXIST

ead_replace()実行時,指定したkeyが存在しなかったため(keyに関連づけられたvalueが存在しなかったため),処理を続行できませんでした。

ead_replace()で指定したkeyに関連づけられたvalueが存在しなかったため,valueの比較ができませんでした。

×

4070

4080

EAD_ERROR_SERVER_CREATE_METHOD_KEY_EXIST

ead_create()実行時,指定したkeyがすでに存在したため,valueを格納できませんでした。

ead_create()で指定したkeyに関連づけられたvalueがすでに格納されています。

×

4080

4090

EAD_ERROR_SERVER_UPDATE_METHOD_KEY_NOT_EXIST

ead_update()実行時,指定したkeyが存在しなかったため,valueを格納できませんでした。

ead_update()で指定したkeyに関連づけられたvalueが格納されていません。

×

4090

4100

EAD_ERROR_SERVER_NOT_RUNNING

リクエストを処理できるEADSサーバがありません。

次の要因が考えられます。

  • EADSクライアントからのリクエストを処理するEADSサーバと,データのコピー先EADSサーバがすべて縮退状態または停止状態になっている。

  • クラスタが稼働していない状態になっている。

×

4100

4110

EAD_ERROR_SERVER_STATUS

EADSサーバの状態が,リクエストを実行できる状態ではありません。

接続先EADSサーバの状態がリクエストを実行できる状態でないため,リクエストを処理できませんでした。

×

4000

4120

EAD_ERROR_SERVER_NOT_EXECUTE_REQUEST_TEMPORARILY

EADSサーバは,一時的にリクエストを実行できません。

スケールアウト処理中のため,受付済みのリクエストを一時的に処理できませんでした。スケールアウト処理が完了するまで待機しないでエラーとなる設定になっています。そのため,スケールアウト処理が完了したあとに,リクエストを再実行してください。

×

4000

4200

EAD_ERROR_SERVER_CACHE

キャッシュに対する操作を実行できませんでした。

接続先EADSサーバで何らかの問題が発生しているため,キャッシュを操作できない状態になっています。操作を中止してEADSサーバの状態を確認してください。

×

4000

4210

EAD_ERROR_SERVER_CACHE_NOT_FOUND

指定したキャッシュが存在しないため,キャッシュに対する操作を実行できませんでした。

指定したキャッシュが存在しないため,キャッシュを操作できませんでした。指定したキャッシュに対する操作を中止して,EADSサーバの状態を確認してください。

×

4000

4230

EAD_ERROR_SERVER_CACHE_CLUSTER_UPDATE

リクエスト処理中にクラスタ構成変更が発生したため,キャッシュに対する操作を実行できませんでした。

リクエスト処理中にクラスタ構成変更が発生したため,キャッシュを操作できませんでした。クラスタ構成の変更が完了したあとに,キャッシュに対する操作を再度実行してください。

×

4000

4300

EAD_ERROR_SERVER_CACHE_BEFORE_REPLICATION

キャッシュに対する操作中に内部エラーが発生しましたが,データの多重化は発生しませんでした。

接続先EADSサーバでキャッシュに対する操作中,内部エラーが発生しました。データの多重化は発生していないため,ほかの正常なEADSサーバへの影響はありません。EADSサーバが縮退したあと,正常なEADSサーバに接続先が変更されると,同じ操作から処理を再開できます。

×

4000

4310

EAD_ERROR_SERVER_CACHE_AFTER_REPLICATION

キャッシュに対する操作中にEADSサーバで内部エラーが発生し,データ更新処理が失敗しました。

接続先EADSサーバでキャッシュに対する操作中,内部エラーが発生しました。データの多重化はすでに実行されているため,問題が発生した接続先EADSサーバが縮退したあとに正常なサーバに接続先が変更されると,データが更新された状態から操作を再開できます。

4000

4400

EAD_ERROR_SERVER_LIMIT_RECEIVE_BUFFER

EADSサーバのリクエスト受信処理でノンブロッキングI/O通信バッファが不足しました。

接続先EADSサーバのリクエスト受信処理でノンブロッキングI/O通信バッファが不足しているため,リクエストを処理できませんでした。

×

4000

4410

EAD_ERROR_SERVER_LIMIT_SEND_BUFFER

EADSサーバのレスポンス送信処理でノンブロッキングI/O通信バッファが不足しました。

接続先EADSサーバのレスポンス送信処理でノンブロッキングI/O通信バッファが不足しているため,レスポンスを送信できませんでした。

4000

4700

EAD_ERROR_SERVER_FUNCTION_EXECUTE

EADSサーバのユーザファンクション内でエラーが発生しました。

接続先EADSサーバのユーザファンクション内でエラーが発生しました。ユーザファンクション内の処理を確認してください。

4000

4710

EAD_ERROR_SERVER_FUNCTION_RETURN_SERIALIZE

EADSサーバでユーザファンクションの戻り値のシリアライズに失敗しました。

接続先EADSサーバで実行したユーザファンクションの戻り値に,シリアライズできないオブジェクトを指定しています。

4000

4730

EAD_ERROR_SERVER_FUNCTION_NOT_FOUND

指定したユーザファンクション名のユーザファンクションが,EADSサーバに存在しません。

指定したユーザファンクション名のユーザファンクションが,接続先EADSサーバに存在しません。

4000

4800

EAD_ERROR_SERVER_LIMIT_EXTERNAL_MEMORY

データを格納するメモリの容量が不足しています。

接続先EADSサーバでデータを格納するメモリ(Explicitヒープ)の容量が不足しているため,リクエストを処理できませんでした。

×

4000

4810

EAD_ERROR_SERVER_LIMIT_CACHE_FILE

データを格納するキャッシュファイルの容量が不足しています。

接続先EADSサーバでデータを格納するキャッシュファイルの容量が不足しているため,リクエストを処理できませんでした。

×

4000

4820

EAD_ERROR_SERVER_LIMIT_KV_COUNT

EADSサーバに格納できるkeyの数が上限に達しています。

接続先EADSサーバに格納できるkeyの数が上限に達しているため,リクエストを処理できませんでした。

×

4000

4830

EAD_ERROR_SERVER_LIMIT_KEY_VALUE_LENGTH

指定したkey,グループ名,またはvalueのサイズがクラスタに格納できる最大サイズを超えています。

指定したkey,グループ名,またはvalueのサイズがクラスタに格納できる最大サイズを超えているため,リクエストを処理できませんでした。

×

4000

4840

EAD_ERROR_SERVER_LIMIT_EXTERNAL_MEMORY_TEMPORARILY

接続先EADSサーバで,データを格納するメモリの容量が一時的に不足しています。

リバランス処理中は,EADSサーバでデータを格納するメモリ(Explicitヒープ)の容量が一時的に減少します。そのため,接続先EADSサーバでリクエストを処理できませんでした。

×

4000

4850

EAD_ERROR_SERVER_LIMIT_KV_COUNT_TEMPORARILY

接続先EADSサーバで,格納できるkeyの数が一時的に上限に達しています。

リバランス処理中は,EADSサーバに格納できるkeyの数の上限が一時的に減少します。そのため,接続先EADSサーバでリクエストを処理できませんでした。

×

4000

4999

EAD_ERROR_SERVER_UNKNOWN

解析できない内部エラーがEADSサーバで発生しました。

接続先EADSサーバで内部エラーが発生しましたが,接続先EADSサーバのバージョンがEADSクライアントライブラリのバージョンより新しいため,解析できませんでした。

4000

5000

EAD_ERROR_CLIENT

EADSクライアントで内部エラーが発生しました。

クライアントライブラリ内で予期しないエラーが発生しました。

5000

5010

EAD_ERROR_CLIENT_OUT_OF_MEMORY

EADSクライアント内でメモリ確保に失敗しました。

クライアントライブラリ内でメモリ確保に失敗しました。

5010

5020

EAD_ERROR_CLIENT_BATCH_CANCEL

一括操作の実行をキャンセルしました。

一括操作を継続できないため,未実行の操作をキャンセルしました。

×

5020

6000

EAD_ERROR_BATCH_FAILED_ALL

一括操作のすべての操作に失敗しました。

データを一括で操作するAPIで実行しようとした操作は,すべて失敗しました。

6000

6010

EAD_ERROR_BATCH_FAILED_PART

一括操作の一部の操作に失敗しました。

データを一括で操作するAPIで実行しようとした操作のうち,一部が失敗しました。

6010

注※

ead_put(),ead_remove()などのデータを更新するAPIの実行時にエラーコードが出力された場合に,データが更新されているかどうかを表しています。

記号の意味を次に示します。

○:データは更新されています。

△:データが更新されているかどうかは不明です。処理が完了したかどうか,確認してください。

×:データは更新されていません。

−:ead_put(),ead_remove()などのデータを更新するAPIの実行時に,このエラーコードは出力されません。