insertBySQL
説明
MI SQL Update コマンド文字列とオプションの commitInterval を使用してテーブルにクエリを実行し、フィーチャをテーブルに挿入します。データ プロバイダとクエリによっては、テーブルにプライマリー キー列が必要となる場合があります。MI SQL コマンドおよび関数の詳細については、『 MapInfo SQL 言語リファレンス 』を参照してください。
注: 書き込み可能テーブルに対して挿入、更新、および削除の操作を実行するには、名前付きテーブルに対する表示権限、および名前付きテーブルの関連するデータセットに対する作成/変更/削除権限が必要です。詳細については、「管理」セクションの ユーザと役割を参照してください。
注: 挿入は、PostGIS、Oracle、SQL Server、SAP HANA、GeoPackage、および汎用 JDBC の各テーブルでサポートされます。Windows システムに限り、MapInfo ネイティブ TAB およびネイティブ拡張 TAB (NativeX) ファイルでもサポートされます (commitInterval は無視されます)。複合プライマリ キーを持つ名前付きテーブルは、書き込み可能ではありません。
メッセージ
次の表に、insertBySQL 操作のリクエスト メッセージとレスポンス メッセージを示します。
メッセージ名をクリックすると、メッセージの詳細を確認できます。
メッセージ | 説明 |
---|---|
InsertBySQLRequest | insertBySQL 操作のリクエスト メッセージ。 |
InsertBySQLResponse | insertBySQL 操作のレスポンス メッセージ。 |
例
この例では、バウンド パラメータと commitInterval を指定して MI SQL Insert コマンドを実行し、テーブルへのフィーチャーの挿入を要求します。
<InsertBySQLRequest
xmlns:ns2="http://www.mapinfo.com/midev/service/featurecollection/v1"
xmlns:ns3="http://www.mapinfo.com/midev/service/style/v1"
xmlns:ns4="http://www.mapinfo.com/midev/service/geometries/v1"
xmlns:ns5="http://www.mapinfo.com/midev/service/table/v1"
xmlns:ns6="http://www.mapinfo.com/midev/service/feature/v1">
<ns6:SQL>"INSERT INTO "\NameTable" (COL1, COL2, COL3, OBJ) VALUES
(@param1,'New Feature1', 20, MI_Line('-92.2,13.1,-87.4,16.6','epsg:4326')),
(@param2, 'New Feature2', 30, MI_Line('-92,13,-87,16','epsg:4326')),
(@param3, 'New Feature3', 40, MI_Line('-92,13,-87,16','epsg:4326'))
commit_interval 1</ns6:SQL>
<ns6:BoundParameterList>
<ns6:BoundParameter name="param1">
<ns6:Value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="ns2:IntValue">
<ns2:Value>10</ns2:Value>
</ns6:Value>
</ns6:BoundParameter>
<ns6:BoundParameter name="param2">
<ns6:Value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="ns2:IntValue">
<ns2:Value>20</ns2:Value>
</ns6:Value>
</ns6:BoundParameter>
<ns6:BoundParameter name="param3">
<ns6:Value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="ns2:IntValue">
<ns2:Value>30</ns2:Value>
</ns6:Value>
</ns6:BoundParameter>
</ns6:BoundParameterList>
</InsertBySQLRequest>