insertFeatures

Beschreibung

Fügt einen oder mehrere Datensätze in eine Relation 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 Relation 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 Relationen von PostgreSQL/PostGIS, Oracle, SQL Server, 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 Relation muss über einen Primärschlüssel verfügen. Anderenfalls wird sie als schreibgeschützte Relation 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 Relation. AttributeDefinitionList definiert die Spalten der Relation, 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>