SIS 9.1
SQLコントロールバー

 


コマンド名:AComControlBarSQL

SQLコントロールバーの表示

SQL [表示タブ-表示] チェックボックスにチェックを入れるとSQLコントロールバーが表示されます。

STコマンド

.mode コマンド

例 - オーバーレイのアイテムをカウントする

例 - 値の数をカウントし並べ替える

例 - アイテムを作成する

テーブルの接続

STコマンド

SQLコンソールでは、マップドキュメントをデータベース、オーバーレイをデータベース内のテーブル、スキーマカラムをテーブルのカラムとして扱います。SQLiteをベースとしており、 SQLite SELECT文をサポートしていますが、CREATE TABLEなどのデータ定義言語(DDL)はサポートしていません。 SISアイテムジオメトリ (OGCシンプルフィーチャ互換に自動変換されるもの)はビルトインのsis_geometry カラムで取り扱います。通常のSQLシンタックスに加え、ISO SQL/MM規格に相当するものとして以下を用意しています:

ST_Area ポリゴンまたはマルチポリゴンの面積を返します。

                コマンドライン例:

SELECT ST_Area(overlay1.sis_geometry) FROM overlay1;

ST_Binary

ジオメトリのWKB(Well-Known Binary)を返します。

コマンドライン例:

SELECT ST_Binary

ST_AsGeoJSON ジオメトリをGeoJSON要素として返します。

コマンドライン例:

SELECT ST_AsGeoJSON

ST_AsText ジオメトリのWKT(Well-Known Text)を返します。

コマンドライン例:

SELECT ST_AsText

ST_Boundary ジオメトリの組み合わせから閉じた境界を返します。

コマンドライン例:

SELECT ST_Boundary(overlay1.sis_geometry) FROM overlay1;

ST_Buffer 入力ジオメトリから指定距離内にあるすべてのポイントを含むジオメトリを返します。

コマンドライン例:

SELECT ST_Buffer(overlay2.sis_geometry, 100) from overlay2;

ST_Centroid ジオメトリの中心を返します。

コマンドライン例:

SELECT ST_Centroid

ST_Contains ジオメトリBが完全にジオメトリAの内側になる場合はTrueを返します。

コマンドライン例:

SELECT ST_Contains

ST_ConvexHull ジオメトリオブジェクトの凸包塗りつぶしを返します。

コマンドライン例:

SELECT ST_ConvexHull(overlay2.sis_geometry) from overlay2;

ST_Crosses 複数のジオメトリがすべてではなくいくつかのポイントを共有している場合にTrueを返します。

コマンドライン例:

SELECT ST_Crosses

ST_Difference ジオメトリBと交差しないジオメトリAの部分を表すジオメトリを返します。

コマンドライン例:

SELECT ST_Difference(overlay1.sis_geometry,overlay2.sis_geometry) from overlay1,overlay2;

ST_Dimension ジオメトリオブジェクトのディメンション(次元)を返します。座標系の次元より少ないか同じになります。

コマンドライン例:

SELECT ST_Dimension(overlay3.sis_geometry) from overlay3

Returns:
0 for Point items
1 for LineString items
2 for Polygon items

ST_Disjoint ジオメトリが「空間的に交差していない」つまり空間を共有していない場合にTrueを返します。

コマンドライン例:

SELECT ST_Disjoint

ST_Distance 2つのジオメトリ間の距離を返します。距離は2つのジオメトリの最も近い頂点を使用して計測します。

コマンドライン例:

SELECT ST_Distance

ST_DWithin ジオメトリが指定した距離内にある場合にTrueを返します。

コマンドライン例:

SELECT ST_DWithin

ST_Envelope ジオメトリのバウンディングボックスをポリゴンとして返します。

コマンドライン例:

SELECT ST_Envelope(overlay2.sis_geometry) from overlay2;

ST_Equals 2つのジオメトリを比較し、同じ場合にTrueを返します。方向は考慮されません。

コマンドライン例:

SELECT ST_Equals

ST_Expand ジオメトリのバウンディングボックスからすべての方向に拡張したバウンディングボックスのポリゴンを返します。

コマンドライン例:

SELECT ST_Expand

ST_Extent ジオメトリの集合を含むバウンディングボックスを返します。

コマンドライン例:

SELECT ST_Extent

ST_First SQLクエリの結果を集合させるために使用する関数です。

コマンドライン例:

SELECT ST_First

ST_GeomFromGeoJSON GeoJSON表現からPostGISジオメトリオブジェクトを生成します。

コマンドライン例:

SELECT ST_GeomFromGeoJSON

ST_GeomFromText Well-Known Text representation (WKT)から指定したST_Gometryの値を返します。

コマンドライン例:

SELECT ST_GeomFromText

ST_GeomFromWKB WKT(Well-Known Binary)のジオメトリとオプションのSRID (空間参照ID)からジオメトリインスタンスを生成します。

コマンドライン例:

SELECT ST_GeomFromWKB

ST_Intersection 2つのジオメトリが交差する部分のジオメトリを返します。集合関数としても使用できます。

コマンドライン例:

Select ST_Intersection(overlay1.sis_geometry,overlay2.sis_geometry) from overlay1,overlay2;

ST_Intersects ジオメトリが2次元で空間的に交差している場合にTrueを、そうでない場合はFalseを返します。

コマンドライン例:

SELECT ST_Intersects

ST_Length ジオメトリがラインまたはマルチラインの場合に2次元の長さを返します。

コマンドライン例:

Select ST_Length(linestring4326.sis_geometry) FROM linestring4326;

ST_Length_Spheroid 楕円体上のジオメトリの2次元または3次元の長さ/外周を返します。

コマンドライン例:

Select ST_Length_Spheroid(linestring.sis_geometry) from linestring;

ST_MakeLine ポイント、マルチポイント、ラインからラインを生成します(agregate関数も使用できます)。

コマンドライン例:

SELECT ST_MakeLine

ST_Overlaps 2つのジオメトリが同じ次元で空間を共有しているが完全に重なっていない場合にTrueを返します。

コマンドライン例:

SELECT ST_Overlaps

ST_Perimeter ST_SurfaceまたはST_MultiSurface geometryの境界の長さを返します。

コマンドライン例:

SELECT ST_Perimeter(overlay1.sis_geometry) FROM overlay1;

SELECT ST_Perimeter(ST_GeomFromText(('POLYGON((743238,2967416,743238 2967450,743265 2967450, 743265.625 2967416,743238 2967416))', 2249))

ST_PointOnSurface ST_PolygonまたはST_MultiPolygonの表面にあると保証されたST_Pointを返します。

コマンドライン例:

SELECT ST_PointOnSurface

ST_Relate 2つのジオメトリを比較し、内部、境界、外部の交差状態から空間的に関係していると判断された場合にTrueを返します。

コマンドライン例:

SELECT ST_Relate

ST_SetSRID ジオメトリのSRID (空間参照ID)を指定した整数値で設定します。

コマンドライン例:

SELECT ST_SetSRID(circle.sis_geometry,4326) FROM circle;

ST_SRID ジオメトリオブジェクトのSRID (空間参照ID)を返します。

コマンドライン例:

SELECT ST_SRID(overlay1.sis_geometry) FROM overlay1;

ST_SRIDFromText テキストの表現と空間参照IDからジオメトリオブジェクトを返します。

コマンドライン例:

SELECT ST_SRIDFromText

ST_SymDifference 対称差を返します(aggregate関数も使用できます)。

コマンドライン例:

SELECT ST_SymDifference(overlay1.sis_geometry,overlay.sis_geometry) FROM overlay1,overlay2;

ST_Touches 2つのジオメトリに共通のポイントがどちらのジオメトリの内部とも交差していない場合にTrueを返します。

コマンドライン例:

SELECT ST_Touches

ST_Transform ST_GeometryをSRID(空間参照ID)で指定された空間参照に変換します。

コマンドライン例:

SELECT ST_Transform (circles.sis_geometry, 3857) FROM circles;
SELECT ST_Transform (circles.sis_geometry, 26986) FROM circles;

'circles'オーバーレイはEPSG 4326とします。

ST_Union 2つのソースオブジェクトを結合したST_Geometryを返します。(aggregate関数も使用できます).

コマンドライン例:

SELECT ST_Union (features.sis_geometry) FROM features WHERE Value='A';

ST_Within 最初のオブジェクトが2つ目のオブジェクトの中に完全に入っている場合にTrueを返します。

コマンドライン例:

SELECT ST_Within

SQLコンソールは以下のSQLでないコマンドも使用できます:

.cls コンソール画面をクリアします。
.echo on|off コマンドエコーのオン/オフを設定します。
.explain ?on|off? EXPLAINに適したアウトプットモードのオン/オフを設定します。設定がない場合はオンになります。
.headers on|off ディスプレイヘッダのオン/オフを設定します。
.help 非SQLコマンドのヘルプを表示します。
.mode MODE ?TABLE?

アウトプットモードを以下より設定します:

add - テスト結果のアイテムをカレントの編集可能なオーバーレイに追加します。

column - 左揃えのカラムです。(.widthを参照)

copy - テスト結果のアイテムを保存する内部データセットを新規作成します。

csv - カンマ区切りのテキスト

find - ヒット可能な場合にテスト結果のアイテムを選択します。

insert - TABLEへのSQLインサートステートメントです。

line - 1行ごとに1つの値です。

list - カンマで区切られた値のリストです。

tabs - タブ区切りの値のリストです。

モードを変更する場合は.modeとタイプしてモード名を続けます(セミコロンは不要)

例 “.mode find”

.nullvalue STRING Null値の代わりに文字列を使用します。
.output ?FILENAME? 実行結果をファイルまたはコンソールに出力します。
.read FILENAME ファイルからSQLをインポートして実行します。
.schema TABLE テーブルのスキーマを表示します。
.separator COL ?ROW? 出力モードでカラムの区切り文字をCOLに、オプションで行の区切り文字をROWに変更します。
.show 現在の設定値を表示します。
.tables ?TABLE? テーブル名の一覧を表示します。テーブルが指定されている場合は、LIKE PATTERN ?TABLE?に一致するテーブルのみ。
.width NUM1 NUM2 ... 「カラム」モードのときのカラム幅を設定します。負の値を指定すると右寄せになります。

 

クエリデータセットはSQLコントロールバーのSQL SELECTクエリの結果のアイテムを保存します。データセットの更新は更新コマンドで行います。また、クエリデータセットを含むマップドキュメントファイルを開くときに必ず再構築されます。

Execute APIメソッドはSQLコントロールバーでSQLクエリを実行し、JSONで結果を得るときに使用します。

空間結合はSQLiteのMATCHキーワードでオーバーロードされます。 例 SELECT ovl2.*,ovl1.column1,ovl2.column2 FROM ovl2 INNER JOIN ovl1 ON ovl2.sis_geometry MATCH ovl1.sis_geometry AND ST_Intersects(ovl2.sis_geometry,ovl1.sis_geometry).

もしSQL>プロンプトの入力が間違っていて..>プロンプトが表示されたら、;をタイプしてプロセスを停止すると、SQL>プロンプトに戻ります。

.mode コマンド

".mode" コマンドは上記の出力フォーマット間でスイッチする場合に使用します。こちらは使用例です。

add

column

copy

csv

find

insert

line

list

tabs

.mode addの例

「Mastermap.gz」オーバーレイからし、編集可能なカレントオーバーレイに地物コード10172のアイテムを追加するSQL>プロンプトの例です:

.mode add
select * from "Mastermap.gz" where featurecode=10172;

この例では次のような結果になります:

.mode columnの例

「Mastermap.gz」 オーバーレイから、地物コード10172のアイテムを検索しcsvファイルに保存するSQL>プロンプトの例です:

.mode column
select * from "Mastermap.gz" where featurecode=10172;

これはデフォルトの状態です。カラムの幅を変更したりヘッダを表示する場合の例です。

.width 20 20 20 20 20 20

最初の6つのカラムの幅を20文字に設定します。

.mode copyの例

「Mastermap.gz」 オーバーレイから、地物コード10172のアイテムを新しい内部データセットにコピーするSQL>プロンプトの例です:

.mode copy
select * from "Mastermap.gz" where featurecode=10172;

Untitled 1 はこのSQLで新規に作成された内部データセットです。

.mode csvの例

「Mastermap.gz」 オーバーレイから、地物コード10172のアイテムを抽出してcsvファイルに保存するSQL> プロンプトの例です:

.mode csv
select * from "Mastermap.gz" where featurecode=10172;

 

.mode findの例

「Mastermap.gz」 オーバーレイから、地物コード10172のアイテムを抽出するSQL>プロンプトの例です:

.mode find
select * from "Mastermap.gz" where featurecode=10172;

抽出されたアイテムは選択状態になります。

 

.mode insertの例

「Mastermap.gz」 オーバーレイから、地物コード10172のアイテムを抽出し、TABLEのSQL insertステートメントに追加するSQL> プロンプトです:

.mode insert
select * from "Mastermap.gz" where featurecode=10172;

次のような結果になります:

.mode lineの例

「Mastermap.gz」 オーバーレイから、地物コード10172のアイテムを抽出し、行ごとに値をリスト表示する場合のSQL> プロンプトです:

.mode line
select * from "Mastermap.gz" where featurecode=10172;

次のような結果になります:

.mode listの例

「Mastermap.gz」 オーバーレイから、地物コード10172のアイテムを抽出し、区切り文字列で区切られた値のリストを作成するSQL> プロンプトです:

.mode list
select * from "Mastermap.gz" where featurecode=10172;

次のような結果になります:

行と列の区切り文字は.separatorコマンドで設定できます。

.separator * -

と指定すると、「*」を列、「-」を行の区切り文字に使用します。

.mode tabsの例

「Mastermap.gz」 オーバーレイから、地物コード10172のアイテムを抽出し、Tab区切りのアイテム値のリストを作成するSQL> プロンプトです:

.mode tabs
select * from "Mastermap.gz" where featurecode=10172;

次のような結果になります:

例 - オーバーレイのアイテムをカウントする

この例では次のように表示されます:

SELECT COUNT(column_name) FROM table_name WHERE condition;

スキーマカラム値がリストされます:

例 - 値の数をカウントし並べ替える

Select owningstation,count(*) as c from incidents group by owningstation order by c:

例 - アイテムを作成する

補足: 作成されたアイテムを確認するためには、 .mode add が有効になっている必要があります。

事件と管轄署を結ぶ放射状のラインを作成:

結果 (緑色のライン):

管轄署ごとに結果の放射ライン(マルチライン)が作成されます。

 

結果をカレントの編集可能なオーバーレイに追加:

.mode add

Select st_collect(st_makeline(stations.sis_geometry,incidents.sis_geometry)) from incidents join stations on stations.baseid=incidents.owningstation group by stations.baseid;

 

属性テーブルデータセットはデータベースからデータをエンプティアイテムとして読み込みます。この非空間データを使用して、SQLコンソールでSQL JOINステートメントを使用してクエリデータセットなどで使用できます。必要なカラムをSELECTリストに追加する必要があります。

例;

SELECT Oracle_CENSUSUK11DATA.POPY,OA2011_Greater_London.* FROM Oracle_CENSUSUK11DATA JOIN OA2011_Greater_London ON Oracle_CENSUSUK11DATA.OACODE = OA2011_Greater_London.OA11CD;

1. SQLコンソールでアウトプットモードを'add'に指定しておく必要があります。

2. 属性テーブルデータセットオーバーレイからスキーマカラムを接続する場合は、空間オーバーレイはカレントにしておく必要があります。カレントのオーバーレイがない場合は、内部データセットが作成されます。

テーブルの接続

1つのカラムをほかのテーブルに追加する

SQL> プロンプトで .mode add と入力して出力モードを設定し、Enterキーを押します。

SQL> プロンプトで SELECT Oracle_CENSUSUK11DATA.POPY,OA2011_Greater_London.* FROM Oracle_CENSUSUK11DATA JOIN OA2011_Greater_London ON Oracle_CENSUSUK11DATA.OACODE = OA2011_Greater_London.OA11CD; と入力します。

Enterキーを押します。

この例ではOracle_CENSUSUK11DATA オーバーレイの POPY カラムがOA2011_Greater_London オーバーレイテーブルに接続されます。

複数のカラム をほかのテーブルに追加する

SQL> プロンプトで .mode add と入力して出力モードを設定し、Enterキーを押します。

SQL> プロンプトでSELECT OA2011_Greater_London.*,Oracle_CENSUSUK11DATA.POPY,Oracle_CENSUSUK11DATA.POPX FROM Oracle_CENSUSUK11DATA JOIN OA2011_Greater_London ON Oracle_CENSUSUK11DATA.OACODE = OA2011_Greater_London.OA11CD; と入力します。

Enterキーを押します。

この例では Oracle_CENSUSUK11DATAオーバーレイの POPXとPOPY カラムがOA2011_Greater_Londonオーバーレイテーブルに接続されます。

すべてのカラムをほかのテーブルに追加する

SQL> プロンプトで .mode add と入力して出力モードを設定し、Enterキーを押します。

SQL> プロンプトでSELECT OA2011_Greater_London.*, Oracle_CENSUSUK11DATA.* FROM Oracle_CENSUSUK11DATA JOIN OA2011_Greater_London ON Oracle_CENSUSUK11DATA.OACODE = OA2011_Greater_London.OA11CD;と入力します。

Enterキーを押します。

この例ではOracle_CENSUSUK11DATA オーバーレイのすべてのカラムがOA2011_Greater_Londonオーバーレイテーブルに接続されます。


互換性:

リボングループ:

表示タブ-表示

関連コマンド


ページの先頭に戻る AComControlBarSQL