概要

3つの方法のうちの1つでデータセットを検索します：

1. 属性値に基づいた表検索。例えば、人口50万人を超えるカナダの全都市を問い合わせる属性検索を行なう場合。
2. マップ上で選択されたフィーチャに基づいた空間検索。例えば、いくつかの都市を選択するために、アメリカ西部上で矩形がドラッグされる場合。
3. 表検索と空間検索の併用。例えば、いくつかの都市は選択されるが、人口50万人を超える都市のみが表示される場合。

SPATIALQUERYは、シェープファイルとテーブル結合したDBFファイルや、ArcSDEのリレーション テーブルにも使用できます。

制限

• ArcSDEテーブルにjointable属性が使用されている場合、where属性は必須です。それ以外の場合、この属性はオプションです。
• accuracy属性はGET_FEATURESリクエストでのみ有効です。
• ArcMapイメージ サービスで使用する場合、featurelimit属性はGET_FEATURESリクエストでのみ有効です。イメージとフィーチャ サービスでは、featurelimitはマップ設定ファイルでも使用可能です。
• フィールド名としてArcSDEの完全な形式、あるいは結合テーブル（例：TABLE.FIELD）を含むSPATIALQUERYを使用するマップ設定ファイルは、ArcIMSサービスでのみ使用可能です。そのファイルは、ArcIMS Author、ArcExplorer 9、ArcIMS Javaビューアで直接読むことはできません。
• シェープファイルをテーブル結合する場合、シェープファイル レイヤは、シェープファイルと同じディレクトリに存在する他のDBFファイルにのみ結合することができます。ArcIMSサービスで現在使用されている、別のシェープファイルのDBFファイルを結合することはできません。
• DBFの結合テーブル名は10文字に制限されます。
• ArcSDEでテーブル結合を行なう場合、ArcSDEレイヤはリレーショナルデータベース管理システム（RDBMS）の同じスキーマ内の他のテーブルにのみ結合できます。
• subfieldsを使用する場合、リスト可能なフィールド数は254に制限されます。
• シェープファイルを使用する場合、DBFのフィールド値にダブルクォーテーション記号(")を含めることはできません。ダブルクォーテーション記号は'where'ステートメントで正しく処理されません。
  
  

  <SPATIALQUERY where="myfield = '&quot;myvalue&quot;'" />

  
  この制限はArcSDEレイヤには該当しません。フィールド値はダブルクォーテーション記号を含めることができます。

注意

• SPATIALFILTERを使用しない場合、データベース属性の検索において、SPATIALQUERYはQUERYと全く同じ働きをします。
  
  
• featurelimitの使用方法：イメージ サービスとフィーチャ サービスのマップ設定ファイルでは、要求されるフィーチャ数に関わらず、レイヤに対して返却されるフィーチャ数を制限するためにfeaturelimit属性が使用できます。この例では、返却されるフィーチャ数は100を超えることができません。
  
  

  <SPATIALQUERY featurelimit="100" />

  
  レイヤが多くのフィーチャを持っており、GET_FEATURESあるいはGET_EXTRACTリクエストでユーザにすべてのフィーチャをリクエストして欲しくない場合、この属性は有用です。フィーチャ数が多いとArcIMS空間サーバは遅くなり、潜在的にダウンさせることができます。さらに、大量のレスポンスはクライアント ビューアをハングさせることができます。ArcMapイメージ サービスでは、マップ ドキュメントでフィーチャの最大数を設定できないことに注意して下さい。
  
  フィーチャの最大数はSPATIALQUERYに加えて、いくつかの場所に設定することができます：
  • 空間サーバ設定ファイル（.cfg）
  • GET_FEATURES
  
  全サービスの全レイヤでリクエストされるフィーチャ数を制限する、全体的なフィーチャの最大数は、空間サーバ設定ファイルで設定することができます。デフォルトでは、フィーチャの最大数は、イメージ サービスとArcMapイメージ サービスへの検索で2000フィーチャです。フィーチャ サービスについては上限が設定されません。ArcMapイメージ サービスについては、これがリクエストされるフィーチャ数を制限するサーバ上の唯一の場所です。このフィーチャ最大数の設定についての詳細はArcIMS Helpを参照して下さい。
  
  featurelimit属性はGET_FEATURESでも有効です。多くの場合、フィーチャ数を扱いやすいように制限したいでしょう。例えば、一度に10レコードだけを返却し、ユーザが次あるいは前の10レコードにページをつけたい場合です。
  
  すべてのフィーチャ最大数の設定に関する階層は以下の通りです：
  1. 空間サーバ設定ファイル中のフィーチャ最大数は、1リクエストで常に返却できる最大値です。
  2. マップ設定ファイル中のSPATIALQUERYのfeaturelimitの方が小さい場合、1番の値を無視します。
  3. GET_FEATURESのfeaturelimitの方が小さい場合、1番と2番の値を無視します。
  4. GET_FEATURESリクエストでは、SPATIALQUERYのfeaturelimitがGET_FEATURESのfeaturelimitを無視します。両方の要素でフィーチャ最大数が1番または2番より小さい必要がありますが、そうでない場合は無視されます。
  
  
• 空のwhereステートメント：ユーザはGET_FEATURESリクエストで、空のwhereステートメント（where=""）あるいは常にtrueであるステートメント（where="1=1"）を送ることができます。どちらの場合もすべてのフィーチャが返却されます。フィーチャ数を制限する最も良い方法は、前述の注意に記述されるようなフィーチャの最大数を制限することです。
  
  
• マップ設定ファイルで定義された、あるいはArcMapドキュメントで作成された定義検索は、常にデータのフィルタリングを行ない、リクエストを通して変更することはできません。マップ設定ファイルでフィルタが設定されたレイヤに対する全てのリクエストは、フィルタリングされたフィーチャのみを選択することができます。例えば、人口が1,000,000人を超える都市のみを表示するようにフィルタが設定された、世界都市レイヤを持つマップ設定ファイルがあると仮定します。このレイヤに対する全てのリクエストは、属性検索でも空間検索でも、人口が1,000,000人を超える都市にのみに実行されます。データベースの他の都市は無視されます。
  
  
• マップ設定ファイル（ImageとFeatureサーバ）におけるsubfieldsの使用方法： subfields属性は、結合テーブルを含めたシェープファイルあるいはArcSDEレイヤで、使用可能なフィールド数を制限するために使用することができます。SERVICEINFOレスポンスでは、subfieldsにリストされたフィールドのみが含まれます。FEATURESレスポンスでは、リストされたフィールドのみが検索対象として有効です。適用ルールは以下の通りです：
  • マップ設定ファイルでは、subfieldsのリストに#SHAPE#と#ID#のフィールドを常に含める必要があります。#SHAPE#と#ID#が含まれていない場合、マップは表示されますが、検索は正しく実行されません。
  • CHARTSYMBOL、CHARTVALUE、SIMPLELABELRENDERER、VALUEMAPRENDERER、VALUEMAPLABELRENDERER、TRUETYPEMARKERSYMBOLを使用する場合、これらの要素で使われているフィールドをsubfieldsのリストに含める必要があります。
  • ArcSDEレイヤを使用する場合、ArcSDEレイヤと結合テーブルの全てのフィールドには、"ARCSDENAME.TABLE.NAME"のような完全な形式の名前を使用する必要があります。完全な形式の名前を使用する場合、マップ設定ファイルはArcIMS AuthorあるいはArcExplorer 9で直接読むことができない点に注意して下さい。
  
  
• GET_FEATURESリクエストでは、geometry属性を"true"に設定することにより、選択されたフィーチャのジオメトリ情報を返却することができます。この場合、SPATIALQUERYのsubfieldsのリストに、#SHAPE#フィールド（または#ALL#）が含まれている必要があります。
  
  

  <GET_FEATURES outputmode="XML" geometry="true" > <LAYER id="4" /> <SPATIALQUERY subfields="#ALL#" where="NAME='Los Angeles'" /> </GET_FEATURES>

  
  
• GET_FEATURESリクエストで使用する場合、フィールド名にUPPERパラメータを付加することにより、大文字小文字を区別せずに検索を実行することができます。この場合、検索する値は全て大文字で記述する必要があることに注意して下さい。
  
  シェープファイルでの例：
  

  <SPATIALQUERY subfields="#ALL#" where="UPPER(NAME)="TORONTO" >

  
  ArcSDEレイヤでの例：
  

  <SPATIALQUERY subfields="#ALL#" where="UPPER(MYSDE.US_STATES.STATE_NAME)="FLORIDA" >

  
  
• where句を作成する場合、同じ属性テーブルから二つのフィールドを使用して比較することができます。以下の例では、女性の人口が男性の人口を上回る州を検索することができます。
  
  

  <SPATIALQUERY where="COUNTRY.STATE.FEMALES &gt; COUNTRY.STATE.MALES" />

  
  
• where句において、いくつかの特殊記号はエスケープ表現する必要があります。
        アンパサンド (&) → &
        ダブルクオート (") → "
        シングルクオート (') → '
        大なり記号 (>) → >
        小なり記号 (<) → &lt;
  
  
• where句で使用できる演算子は「=, >, >=, <, <=, <>, LIKE, BETWEEN, IN, NOT IN」です。ORDER BYとDISTINCTは使用できません。
  
  
• デフォルトの設定では、検索条件式は大文字小文字を区別します。多くの場合、ユーザがどのような入力をするかが予測できないため、大文字小文字を区別しない検索が必要です。ほとんどのデータソースがUPPERパラメータをサポートします。大文字小文字を区別しない検索を行なうためには、フィールド名にUPPERパラメータを付加して、比較文字列をすべて大文字に変換して下さい。
  
  

  <SPATIALQUERY subfields="#ALL#" where="UPPER(NAME) = 'CANADA'">

  
  ただし、UPPERパラメータは、パーソナルジオデータベースやArcSDE for Coveragesを含むいくつかのデータソースでは使用できません。
  
  
• ArcSDEテーブルの結合
  ArcSDEテーブルのテーブル結合を行なう場合、RDBMSとArcSDE間の全ての有効な結合はArcIMSにおいても有効です。ArcSDEテーブルとテーブル結合するためには、'where'句を使用してどのテーブルが結合されるのかを定義します。また、SQL構文による追加のフィルタを使用する際にもwhere句を使用します。複数のテーブル結合も可能です。
  
  以下の例では、'where'ステートメントは2つのリレーション（太字の部分）と選択結果へのフィルタ（CNTY_FIPS='013'、斜体の部分）を含んでいます。
  
  

  <SPATIALQUERY where= "DB.CITY.CITY_FIPS = DB.SCHOOLS.CITY_FIPS and DB.SCHOOLS.SCHOOL_ID = DB.SCHOOL_STATS.SCHOOL_ID and DB.CITY.CNTY_FIPS=&apos;013&apos;" jointables="DB.SCHOOLS DB.SCHOOL_STATS" />

  
  このステートメントでは、都市データ（DB.CITY）と学校データ（DB.SCHOOLS）が、CITY_FIPSフィールドを結合フィールドとして最初に結合されます。次に、学校データ（DB.SCHOOLS）がSCHOOL_IDフィールドを結合フィールドとして、学校統計データ（DB.SCHOOL_STATS）と結合されます。さらに、検索結果を指定した郡の学校だけに絞り込むためのフィルタ（この例では"CNTY_FIPS='013'"）が定義されています。
  
  結合されるテーブルは、jointables属性にリストされる必要があります。複数のテーブルが結合される場合、テーブル名は空白文字で区切られます。テーブルを指定する場合、ArcSDEテーブルの完全な名前を使う必要があります。上記の例では、2つの結合テーブル名はDB.SCHOOLSとDB.SCHOOL_STATSです。
  
  
• DBFファイルの結合
  DBFテーブルのテーブル結合を行なう場合、シェープファイルのDBFテーブルと、1つ以上の外部DBFテーブル（シェープファイルと同じディレクトリに存在する）との間で結合を行なうことができます。ArcIMSサービスで現在使用されている、別のシェープファイルのDBFファイルを結合することはできません。
  
  DBFファイルを結合するためにjoinexpression属性が使用されます。この属性は"To=[結合に使用するマスターテーブルのフィールド(カラム)], From=[結合されるテーブルのフィールド(カラム)], Type=[exactまたはscan]"という書式で使用します。
  
  

  To	マスターDBFテーブルを参照して、結合のために使用されるフィールドを定義します。このテーブルを参照する場合、フィールド名の前にDBFテーブル名を付ける必要があります。定義式全体はカギ括弧で囲みます。 例：joinexpression="To=[mastertable.fieldname]"
  From	マスターDBFテーブルに結合されるDBFテーブルを参照して、結合のために使用されるフィールドを定義します。 例：joinexpression="From=[jointable.fieldname]"
  Type=[exact]	マスターテーブルと結合テーブルの間で、単一のマッチングのみを許可する"exact matchリレーション"を定義します。"1対1"と"多対1"のリレーションが"exact matchリレーション"です。1対1のリレーションでは、マスターテーブルの1レコードのみが、結合テーブルの1レコードとマッチします。多対1のリレーションでは、マスターテーブルの複数レコードが、結合テーブルの1レコードとマッチします。結合テーブルの複数レコードがマスターテーブルの1レコードとマッチする場合、最初に結合したレコードのみが参照されます。
  Type=[scan]	"scanリレーション"では、マスターテーブルの1レコードに対して結合テーブルの複数レコードが対応する場合、マッチする各レコードについて結合レコードが生成されます。"1対多"と"多対多"のリレーションが"scanリレーション"です。1対多のリレーションでは、マスターテーブルの各レコードが、結合テーブルの複数レコードにマッチすることができます。多対多リレーションも1対多と同様ですが、マスターテーブルの複数レコードが結合テーブルの同一レコードにマッチできるところが異なります。

  
  
  To、From、Typeパラメータは大文字小文字を区別し（先頭文字が大文字）、それらはカンマ","で区切られます。いくつもの結合テーブルがjoinexpression属性で定義することができます。この場合、結合テーブル名は以下の例のようにセミコロン";"で区切られます：
  
  

  joinexpression="To=[A.ID],From=[B.ID],Type=[scan];To=[B.NAME],From=[C.NAME], Type=[exact] "

  
  全ての結合DBFテーブルは、jointables属性にリストされる必要があります。複数のテーブルが結合される場合、テーブル名は空白文字で区切られます。テーブルを指定する場合、DBFファイル名から拡張子を除いた名前が使用されます。DBFの検索式の例は以下の通りです：
  
  

  <SPATIALQUERY joinexpression="To=[counties.CNTY_FIPS],From=[countyinfo.FIPS],Type=[scan]; To=[countyinfo.FIPS],From=[state_roads.FIPS],Type=[scan]" jointables="countyinfo state_roads" where="counties. NAME=&apos;Washoe&apos;" />

  
  この例では、郡データのDBFファイル（counties.dbf）と郡の諸情報が格納されたDBFファイル（countyinfo.dbf）が最初に結合されます。2つのテーブルはFIPSフィールド（counties.CNTY_FIPSとcountyinfo.FIPS）で結合されています。次に、countyinfo.dbfとstate_roads.dbfが、やはりFIPSフィールドを結合フィールドとして結合されます。jointabelsはcountyinfoとstate_roadsという名前で、空白文字で区切られてリストされています。検索結果はただ1つの郡（この場合はWashoe）のみを含むようにフィルタが定義されています。
  
  
• DBFファイルをシェープファイルと結合する場合、DBFファイルを読み取り専用にすることはできません。この場合、結合テーブルからのFIELD情報はSERVICEINFOで参照することができますが、マップ上にデータは表示されません。
  
  
• 検索中の日付書式(イメージ サービス)：日付の検索には、言語セットに関係なく次の文法を用います。
  {ts 'YYYY-MM-DD hh:mi:ss'}
  
  日付書式の項目説明
  

  YYYY	年	必須	年を4桁の数字で記述します。
  MM	月 (01-12)	必須	月を2桁の数字で記述します。3月は「03」となります。
  DD	日 (01-31)	必須	日を2桁の数字で記述します。4日は「04」となります。
  hh	時 (00-23)	オプション	24時間表記を用います。午前8時は「08」、午後8時は「20」となります。
  mi	分 (00-59)	オプション	分を2桁の数字で記述します。分を指定する場合は、時も必要となります。
  ss	秒 (00-59)	オプション	秒を2桁の数字で記述します。秒を指定する場合は、時と分も必要となります。

  
  年, 月, 日の区切り文字はハイフン記号(-)です。また、時, 分, 秒の区切り文字はコロン記号(:)です。日付の文字列は、中括弧({})の内部でシングルクオート(')で囲みます。日付文字列の前には、必ず「ts (time stampの略)」を付けます。
  
  「2000年1月4日 午前8時3分23秒」という条件でDBFファイルに対してクエリを実行する場合、次のような記述となります。
  

  <SPATIALQUERY where="MYDATE = {ts '2000-01-04 08:03:32'}" />

  
  また、「2002年3月8日 午後9時18分」という条件でArcSDEレイヤに対してクエリを実行する場合は次のような記述となります。
  

  <SPATIALQUERY where="ARCSDE.TABLE.MYDATE = {ts '2002-03-08 21:18:00'}" />

  
  
• 検索中の日付書式(ArcMapイメージ サービス)：日付の検索はArcMapで使用するのと同じ文法を使用します。そのフォーマットはマップが参照しているデータのタイプに依存して異なります。
  
  カバレッジ、シェープファイル、ArcSDEジオデータベースの日付はSQL標準に従います。以下の例は「2003年1月31日」を検索します。

  <SPATIALQUERY where="DATE_ = date '2003-01-31' " >

  
  パーソナル ジオデータベースの日付は以下の例のように定められます。

  <SPATIALQUERY where="[DATE_] = #2003-01-31# " >

  
  ArcSDEジオデータベースを使用する場合、元々のデータベースによってサポートされる日付フォーマットも使用できます。

属性の概要

サンプル