insertFeatures

説明

1 つ以上のレコードをテーブルに挿入します。リクエスト本体には、挿入するフィーチャーコレクションの個々の列と値が含まれます。それぞれのフィーチャーには、0 個以上の列の値が含まれます。テーブル内に存在する列が指定されていない場合は、null 値が挿入されます。データベースで処理されない値を持つプライマリキーの一部である場合には、(自動インクリメントの制約またはシーケンスによって) 列の値を指定する必要があります。プライマリキーを判断するには、describeTable レスポンスのキー定義を調べます。レスポンスには、正しく挿入されたフィーチャーのプライマリキーが含まれます。

注: 書き込み可能テーブルに対して挿入、更新、および削除の操作を実行するには、名前付きテーブルに対する表示権限、および名前付きテーブルの関連するデータセットに対する作成/変更/削除権限が必要です。詳細については、「管理」セクションのユーザと役割を参照してください。

注: 挿入は、PostgreSQL/PostGIS、Oracle、SQL Server、SAP HANA、GeoPackage、および汎用 JDBC の各テーブルでサポートされます。Windows システムに限り、MapInfo ネイティブ TAB およびネイティブ拡張 TAB (NativeX) ファイルでもサポートされます (commitInterval は無視されます)。テーブルにプライマリキーがない場合、そのテーブルは読み取り専用であるとみなされます。複合プライマリキーを持つ名前付きテーブルは、書き込み可能ではありません。

メッセージ

次の表に、insertFeatures 操作のリクエストメッセージとレスポンスメッセージを示します。

メッセージ名をクリックすると、メッセージの詳細を確認できます。


メッセージ	説明
InsertFeaturesRequest	insertFeatures 操作のリクエストメッセージ。
InsertFeaturesResponse	insertFeatures 操作のレスポンスメッセージ。

例

フィーチャーをテーブルに挿入する例を示します。AttributeDefinitionList は、テーブルの列を定義し、FeatureList は挿入する値を定義します。


						
<?xml version="1.0" encoding="UTF-8"?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" 
		xmlns="http://www.mapinfo.com/midev/service/feature/v1" 
		xmlns:ns3="http://www.mapinfo.com/midev/service/featurecollection/v1" 
		xmlns:ns4=http://www.mapinfo.com/midev/service/geometries/v1"
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<S:Header/>
		<S:Body>
			<InsertFeaturesRequest table="/MyTable" commitInterval="1">
				<ns3:FeatureCollection>
					<ns3:FeatureCollectionMetadata>
						<ns3:AttributeDefinitionList>
							<ns3:AttributeDefinition xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:ScalarAttributeDefinition" dataType="Double" name="Column1"/>
							<ns3:AttributeDefinition xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:GeometryAttributeDefinition" srsName="epsg:4267" dataType="Geometry" name="SP_GEOMETRY"/>
						</ns3:AttributeDefinitionList>
					</ns3:FeatureCollectionMetadata>
					<ns3:FeatureList>
						<ns3:Feature>
							<ns3:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:DoubleValue">
								<ns3:Value>123.456</ns3:Value>
							</ns3:AttributeValue>
							<ns3:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:GeometryValue">
								<ns4:FeatureGeometry xsi:type="ns4:Point" srsName="epsg:4326">
									<ns4:Pos>
										<ns4:X>-72</ns4:X>
										<ns4:Y>42</ns4:Y>
									</ns4:Pos>
								</ns4:FeatureGeometry>
							</ns3:AttributeValue>
						</ns3:Feature>
					</ns3:FeatureList>
				</ns3:FeatureCollection>
			</InsertFeaturesRequest>
		</S:Body>
	</S:Envelope>