地理情報関数によって戻されるメッセージの SQLCODE は、先頭の文字が「GSE」で、その後に 3001 〜 3042 の範囲の数値が続きます。
地理情報関数によってメッセージが戻される際には、それに関連した SQLSTATE 値も戻されますが、SQLCODE は戻されません。この SQLCODE を見つける方法については、ページを参照してください。
GSE3001E | Unknown system failure. |
説明: 予期しないシステム・エラーが起きました。
ユーザーの応答: 構文を訂正してから、関数を再度呼び出してください。依然として問題が起きる場合は、技術サポート担当者に連絡してください。
GSE3002E | Invalid Well-Known Text string |
説明: 呼び出した関数の入力として、無効な事前割り当てテキスト・ストリングが入力されました。
ユーザーの応答: ストリングを訂正して、関数を再度呼び出してください。事前割り当てテキスト・ストリングの適切な形式を判別するには、 DB2 地理情報エクステンダー 使用者の手引きおよび解説書を参照してください。
GSE3003E | Invalid SRID |
説明: この関数に渡そうとした地理情報参照システム ID (SRID) は、 DB2 地理情報エクステンダーのシステム・カタログ中にリストされていません。
ユーザーの応答: DB2GSE.SPATIAL_REF_SYS カタログ視点に現在記録されている SRID を指定するか、または指定したい SRID を持つ地理情報参照システムを作成してください。
GSE3004E | Insufficient Memory |
説明: 使用可能なメモリーが足りませんでした。 DB2 地理情報エクステンダーには、最大 1 MB のメモリーが必要です。
ユーザーの応答: メモリーを再割り当てして、 DB2 地理情報エクステンダーで使用できる量を増やしてください。メモリーを再割り当てできない場合は、物理メモリーをさらに追加してください。
GSE3005E | Geometries' SRIDs differ. |
説明: DB2 地理情報エクステンダーに渡される図形は、同一のシステム参照 ID (SRID) を共用していなければなりません。
ユーザーの応答: 図形の 1 つを再作成して、その地理情報参照システムがもう一方と一致するようにしてください。
GSE3006E | Invalid binary string. |
説明: 呼び出した関数の入力として、構成が適切でない事前割り当てバイナリー・ストリングまたは ESRI バイナリー・ストリングが入力されました。
ユーザーの応答: 正しい形式でストリングを再構成してください。正しい形式を判別するには、 DB2 地理情報エクステンダー 使用者の手引きおよび解説書を参照してください。
GSE3007E | Valid geometry not specified. |
説明: 有効なタイプの図形が、呼び出した関数に渡されませんでした。有効なタイプは図形、ポイント、折れ線、ポリゴン、複数ポイント、複数折れ線、および複数ポリゴンです。
ユーザーの応答: 有効な図形タイプで SQL ステートメントを再実行依頼してください。
GSE3008E | Parenthesis not balanced. |
説明: ストリングを表す事前割り当てテキスト中の左括弧と右括弧の数が同じではありません。
ユーザーの応答: 左括弧と右括弧がそれぞれ対応するように、ストリングを再入してください。
GSE3009E | Too many parts specified. |
説明: バイナリー・ストリングかテキスト・ストリング中に示されているパーツの数が、実際に設けられているパーツの数より多くなっています。
ユーザーの応答: 正しいパーツの数を指定してストリングを再入してください。
GSE3010E | Incorrect geometry type. |
説明: 誤ったタイプの図形が、呼び出した関数に渡されました。たとえば、入力タイプがポリゴンの関数に折れ線が渡された可能性があります。
ユーザーの応答: 関数で処理できるタイプの図形を関数に渡すか、または渡したいタイプの図形を受け入れる関数を使用してください。
GSE3011E | Text string is too long. |
説明: 図形テキスト・ストリングが最大長の 4000 文字を超えています。
ユーザーの応答: 図形に含まれている詳細情報が多過ぎて、テキストに変換できません。しかしながら、代わりに WKB 形式か ESRI 形状のバイナリー形式に変換できます。
GSE3012E | Invalid parameter value. |
説明: 無効なパラメーターが関数に渡されました。
ユーザーの応答: 関数の構文と、 DB2 地理情報エクステンダー 使用者の手引きおよび解説書にリストされている構文を比較してください。無効なパラメーターを訂正してから、関数を再実行依頼してください。
GSE3013E | Invalid grid size. |
説明: 以下の無効な指定のうち 1 つが行なわれました。
ユーザーの応答: 「索引の作成 (Create Index)」ウィンドウか db2gse.gse_enable_idx ストアード・プロシージャーを使用して、有効な格子サイズを指定してください。有効な格子サイズに関する情報は、 DB2 地理情報エクステンダー 使用者の手引きおよび解説書を参照してください。
GSE3014E | Grid size too small. |
説明: 指定された格子サイズが、図形当たり格子セル 1000 個を超えました。
ユーザーの応答: 「索引の作成 (Create Index)」ウィンドウか db2gse.gse_enable_idx ストアード・プロシージャーを使用して、格子サイズを大きくするか別の格子レベルを追加してください。
GSE3015E | Invalid geometry produced. |
説明: 入力されたパラメーターにより、無効な図形が作成されました。たとえば、LineFromShape 関数を指定してパラメーターを入力すると、無効な図形が作成されます。無効な図形は、図形の特性に違反しています。
ユーザーの応答: パラメーターを訂正してから、図形を再実行依頼してください。
GSE3016E | Wrong geometries submitted. |
説明: 関数では特定のタイプの図形が 1 つ予期されていましたが、受信されませんでした。たとえば、ST_Union 関数で同じ次元の図形が 2 つ予期されていましたが、ポイントと折れ線という違う次元が受信されました。
ユーザーの応答: 有効な入力として関数に受け入れられる図形を指定してください。この関数にとって有効な図形のタイプを判別するには、 DB2 地理情報エクステンダー 使用者の手引きおよび解説書を参照してください。
GSE3017E | Geometry integrity error. |
説明: 関数に渡された図形の 1 つまたは複数の特性が保全性の制約に違反しているので、この関数でこの図形を処理できません。
ユーザーの応答: 特性を正しく定義して、図形を再実行依頼してください。図形の特性に関する情報は、 DB2 地理情報エクステンダー 使用者の手引きおよび解説書を参照してください。
GSE3018E | Too many points. |
説明: 図形の構造がストレージの限度である 1MB を超えています。図形のポイントが多過ぎます。
ユーザーの応答: 不要なポイントを除去してください。パフォーマンスとストレージの考慮事項の観点から組み込む必要があるのは、図形をレンダリングするのに必要なポイントだけです。必須でないポイントはすべて除外する必要があります。
GSE3019E | Geometry is too small. |
説明: ST_Difference、 ST_Intersection、 ST_SymmetricDiff、または ST_Union 関数によって戻される図形が小さ過ぎて、現行の座標系の値で表現できません。
ユーザーの応答: 結果が必須の場合は、 db2gse.gse_enable_sref ストアード・プロシージャーを使用して、ソース図形の地理情報参照システムの xyunits パラメーター値を大きくしてください。それからソース図形を格納する表を再作成してください。
GSE3020E | Buffer out of bounds. |
説明: バッファー関数により座標系の外側にバッファーが作成されました。
ユーザーの応答: バッファーの距離を短くするか、またはソース図形の座標系に変更を加えてください。ほとんどの場合、座標系に変更を加えるには、地理情報システムを再ロードする必要があります。
GSE3021E | Invalid scale factor. |
説明: スケール因数 (XY 単位、Z 単位、または M 単位) を 1 未満にすることはできません。
ユーザーの応答: db2gse.gse_enable_sref ストアード・プロシージャーを使用して、 DB2GSE.SPATIAL_REF_SYS カタログ視点中の 1 未満のスケール因数を訂正してください。
GSE3022E | Coordinate out of bounds. |
説明: 座標が大き過ぎるか小さ過ぎるため、座標系の境界内に適合しません。
ユーザーの応答: 座標が正しいかどうかを判別してください。正しい場合は、ご使用の座標系の境界内に適合するかどうか判別してください。この座標系に関する情報は、 DB2GSE.COORD_REF_SYS カタログ視点を参照してください。
GSE3023E | Invalid coordinate system ID. |
説明: 地理情報エクステンダーで、指定された座標系 ID を妥当性検査できません。
ユーザーの応答: この ID が DB2GSE.COORD_REF_SYS カタログ視点にリストされているかどうか判別してください。この ID がリストされていない場合は、正しいか検査し、データベース管理者に連絡して、地理情報エクステンダーのシステム・カタログ中に記録してください。
GSE3024E | Invalid annotation text. |
説明: 指定された座標系が定義されている注釈テキストを、有効な投影法に変換できません。
ユーザーの応答: DB2GSE.COORD_REF_SYS カタログ視点中で、この座標系の注釈テキストを検索してください。テキストに座標系が正しく定義されているかどうかを判別してください。役に立つ情報については、 DB2 地理情報エクステンダー 使用者の手引きおよび解説書の座標系に関する章を参照してください。
GSE3025E | Projection Error |
説明: 図形の投影の試行中にエラーが起きました。
ユーザーの応答: 図形が正しい投影法ドメイン中にあるか確認してください。
GSE3026E | Polygon rings overlap. |
説明: ポリゴンのリングは重なり合うことはできませんが、接点で交わることはできます。
ユーザーの応答: ポリゴンの座標を訂正してから再実行依頼してください。
GSE3027E | Too few points. |
説明: 折れ線は 2 つ以上のポイントで構成されていなければならず、ポリゴンは 4 つ以上のポイントで構成されていなければなりません。
ユーザーの応答: 正しいポイントの数を指定して、図形を再実行依頼してください。
GSE3028E | Polygon is not closed. |
説明: ポリゴンの始点と端点の座標が同じではありません。
ユーザーの応答: ポリゴンの座標リストを編集し、始点と端点が同じであることを確認してから、再実行依頼してください。
GSE3029E | Exterior ring is invalid. |
説明: 内部のリングが外部のリングによって囲まれていません。内部のリングは外部のリングの完全に外側になり、重なり合いません。
ユーザーの応答: 内部のリングの座標が、外部のリングの完全に内側にあるか確認してください。内部のリングが実際には別のポリゴンの外部のリングを表している場合は、図形を複数ポリゴンとして入力してください。
GSE3030E | Polygon has no area. |
説明: 図形がポリゴンなのは、その座標の空間が 2 次元にスパンしている場合だけです。
ユーザーの応答: ポリゴンの座標を編集し、領域を囲むようにして、ポリゴンを再実行依頼してください。または、該当する場合は折れ線を実行依頼してください。
GSE3031E | Polygon contains a spike. |
説明: 同じでかまわないのは、ポリゴンの端点と始点だけです。ポリゴンのリングの他の座標は違っていなければならず、全体で領域を囲んでいなければなりません。
ユーザーの応答: X 値と Y 値が同じになっている座標の対を検索してください。これらのポイントを編集し、ポリゴンが単一の領域を囲むようにしてから、ポリゴンを再実行依頼してください。
GSE3032E | Exterior rings overlap. |
説明: 複数ポリゴンの外部のリングは、接点で交わることはできますが、重なり合うことはできません。
ユーザーの応答: 外部のリングの座標を編集し、重なり合わないようにしてから、複数ポリゴンを再実行依頼してください。
GSE3033E | Polygon intersects itself. |
説明: ポリゴンのリング自体が交わることはできません。
ユーザーの応答: 自分自身と交わっているリングの座標を編集してから、ポリゴンを再実行依頼してください。
GSE3034E | Invalid number of measures. |
説明: バイナリー・ストリングの number of measures パラメーターに、そのストリングで指定されている測定値とは違う数値が含まれています。
ユーザーの応答: number of measures パラメーターを編集して、バイナリー・ストリングで指定されている数値に対応するようにしてください。
GSE3035E | Invalid number of parts. |
説明: バイナリー・ストリングの number of parts パラメーターに、そのストリングで指定されているパーツとは違う数値が指定されました。
ユーザーの応答: number of parts パラメーターを編集して、バイナリー・ストリングで指定されている数値に対応するようにしてください。
GSE3036E | Invalid part offset. |
説明: バイナリー・ストリングの part offset パラメーターに、そのストリングで指定されているパーツ・オフセットとは違うパーツ・オフセットが指定されました。
ユーザーの応答: part offset パラメーターを編集して、バイナリー・ストリングで指定されているパーツ・オフセットに対応するようにしてください。
GSE3037E | Projection error. |
説明: 無許可の図形が検出されました。この図形のパーツ区切り文字は無効です。
ユーザーの応答: IBM 技術員に連絡してください。
GSE3038E | BLOB too small. |
説明: 指定された 2 進ラージ・オブジェクト (BLOB) 中のバイト数が、備えられている BLOB 中のバイト数より小さくなっています。
ユーザーの応答: BLOB の長さを BLOB 中のバイト数と同じにしてから、関数を再実行依頼してください。
GSE3039E | Invalid entity type. |
説明: 無許可の図形が検出されました。この図形に関連したエンティティー・タイプは無効です。
ユーザーの応答: IBM 技術員に連絡してください。
GSE3040E | Invalid byte order |
説明: バイト順序は 0 または 1 でなければなりません。
ユーザーの応答: バイト順序を編集して、リトル・エンディアンの場合は 0 、ビッグ・エンディアンの場合は 1 にしてください。
GSE3041E | Invalid part. |
説明: 関数のパラメーターによって、存在しないパーツが索引付けされました。このエラーは、たとえば複数ポイントにポイントが 2 つだけある場合に、 ST_GeometryN 関数により 3 が渡されて複数ポイント中の 3 番目のポイントが戻された場合に起きます。
ユーザーの応答: パラメーターを編集してから、関数を再実行依頼してください。
GSE3042E | Empty geometry. |
説明: 空の図形が ST_AsBinary 関数に渡されましたが、この図形をこの関数に対する入力として使用することは許可されていません。
ユーザーの応答: 実行依頼した SQL ステートメントを編集して、空でない図形だけが ST_AsBinary 関数に渡されるようにしてください。たとえば、ST_IsEmpty 関数で WHERE 文節を使用して、空の図形をなくすことができます。
地理情報関数によりメッセージが戻されると、 DB2 ではメッセージ SQL0443N 中にそのメッセージの短形式と対応する SQLSTATE 値が表示されます。以下に例を示します。
DB21034E The command was processed as an SQL statement because it was not a valid Command Line Processor command. During SQL processing it returned: SQL0443N Routine "DB2GSE.ST_POINTFROMTEX" (specific name "SQL000503150228187") has returned an error SQLSTATE with diagnostic text "Invalid SRID". SQLSTATE=38601
メッセージ SQL0443N 中に戻される SQLCODE と SQLSTATE との関連を調べるには、 表 34 を参照してください。 SQLCODE に関連した全テキストを参照するには、この章を参照するか、または以下のコマンドを送出してください。
DB2 ? [SQLCODE]
表 34. 地理情報関数によって戻されるメッセージの SQLSTATE 値と SQLCODE 値
SQLSTATE 値 | . . . 対応する SQLCODE |
---|---|
38600 | GSE3002E |
38601 | GSE3003E |
38602 | GSE3004E |
38603 | GSE3005E |
38604 | GSE3006E |
38605 | GSE3007E |
38606 | GSE3008E |
38607 | GSE3009E |
38608 | GSE3010E |
38609 | GSE3011E |
38610 | GSE3012E |
38612 | GSE3013E |
38613 | GSE3014E |
38800 | GSE3015E |
38801 | GSE3016E |
38802 | GSE3017E |
38803 | GSE3018E |
38804 | GSE3019E |
38805 | GSE3020E |
38806 | GSE3021E |
38807 | GSE3022E |
38808 | GSE3023E |
38809 | GSE3024E |
38810 | GSE3025E |
38811 | GSE3026E |
38812 | GSE3027E |
38813 | GSE3028E |
38814 | GSE3029E |
38815 | GSE3030E |
38816 | GSE3031E |
38817 | GSE3032E |
38818 | GSE3033E |
38819 | GSE3034E |
38820 | GSE3035E |
38821 | GSE3036E |
38822 | GSE3037E |
38823 | GSE3038E |
38824 | GSE3039E |
38825 | GSE3040E |
38826 | GSE3041E |
38827 | GSE3042E |
38999 | GSE3043E |