insertFeatures

Beschreibung

Fügt einen oder mehrere Datensätze in eine Tabelle ein. Der Text der Anforderung enthält die einzelnen Spalten und Werte der einzufügenden Feature-Sammlung. Jedes dieser Features enthält null oder mehr Spaltenwerte. Wenn eine in der Tabelle vorhandene Spalte nicht angegeben ist, wird ein Nullwert eingefügt. Ein Spaltenwert muss angegeben sein, wenn er Teil eines Primärschlüssels ist, dessen Werte nicht von der Datenbank verarbeitet werden (sondern über eine automatisch erhöhte Einschränkung oder Folge). Untersuchen Sie die Schlüsseldefinition in der Antwort „describeTable“, um den Primärschlüssel zu bestimmen. Die Antwort enthält die Primärschlüssel der Features, die erfolgreich eingefügt wurden.

Anmerkung: Sie müssen über Berechtigungen zum Anzeigen für die benannte Tabelle verfügen und über Berechtigungen zum Erstellen/Ändern/Löschen für das zur benannten Tabelle gehörende Dataset, um Einfügungs-, Aktualisierungs- und Löschvorgänge für beschreibbare Tabellen durchführen zu können. Weitere Informationen finden Sie unter Zugriffssteuerung für Datasets im Abschnitt „Verwaltung“.

Anmerkung: Einfügen wird in Tabellen von PostgreSQL/PostGIS, Oracle, SQL Server, SAP HANA, GeoPackage und generischem JDBC unterstützt. Es wird auch bei MapInfo Native TAB- und Native Extended TAB-Dateien (NativeX) in Windows-Betriebssystemen unterstützt. (Das Übergabeintervall wird ignoriert.) Die Tabelle muss über einen Primärschlüssel verfügen. Andernfalls wird sie als schreibgeschützte Tabelle betrachtet. Benannte Tabellen mit zusammengesetzten Primärschlüsseln sind nicht beschreibbar.

ACL-Autorisierungsfluss

Um einen oder mehrere Datensätze in eine benannte Tabelle einzufügen, benötigt der Benutzer (oder alle Rollen, zu denen er gehört) wie folgt Ausführungs- und Erstellungsberechtigungen für die benannte Tabelle:

„EXECUTE“ für den Entitätstyp „Location Intelligence.Named Resources“
bzw. „CREATE“ für den Entitätstyp „Location Intelligence.Dataset.DML“

Nachrichten

In der folgenden Tabelle sind die Anforderungs- und Antwortnachrichten für den Vorgang insertFeatures aufgelistet.

Klicken Sie auf einen Nachrichtennamen, um mehr Informationen zu dieser Nachricht zu erhalten.

Nachricht	Beschreibung
InsertFeaturesRequest	Die Anforderungsnachricht für den Vorgang insertFeatures.
InsertFeaturesResponse	Die Antwortnachricht für den Vorgang insertFeatures.

Beispiel

Beispiel für das Einfügen von Features in eine Tabelle. AttributeDefinitionList definiert die Spalten der Tabelle, und FeatureList definiert die einzufügenden Werte:


						
<?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>