Löschen von Features nach Primärschlüssel
Beschreibung
Löscht Features in einer Relation, indem eine Sammlung von Primärschlüsseln mit einem optionalen Übergabeintervall weitergeleitet wird. Der Text der Anforderung enthält die JSON-Darstellung der Primärschlüssel. Die Antwort enthält die Anzahl der Features, die erfolgreich gelöscht wurden.
ACL-Autorisierungsfluss
Um Features in einer benannten Tabelle zu löschen, indem eine Sammlung von Primärschlüsseln übergeben wird, muss der Benutzer (oder alle Rollen, denen er angehört) wie folgt Ausführungs- und Löschungsberechtigungen für die benannte Tabelle haben:
- „EXECUTE“ für den Entitätstyp „Location Intelligence.Named Resources“
- „DELETE“ für den Entitätstyp „Location intelligence.Dataset.DML“
URL-Format von HTTP-POST-Anforderungen
Für HTTP-POST-Anforderungen wird zum Löschen mehrerer Datensätze das folgende Format verwendet:
HTTP POST: /FeatureService/tables/tablename/features.rep?
POST Data: action=delete&[commitInterval=c]
POST BODY: Content-Type:application/json {table delete}
table delete ist ein POST-JSON-Textkörper (Content-Type: application/json) für den Tabellenlöschvorgang, der die zu löschenden Primärschlüssel enthält. Bei mehreren gelöschten Datensätzen wird der JSON-Textkörper wie folgt formatiert:
{
“keys”: ["key1", "key2", …]
}
Weitere Informationen zu den unten aufgeführten Parametertypen finden Sie unter URL-Anforderungsdatentypen.
Parameter | Typ | Erforderlich | Beschreibung |
---|---|---|---|
tablename | Zeichenfolge | ja | Der Name der Relation, für die Sie Features löschen. Die Relation wird durch einen vollständig qualifizierten Namen für die benannte Tabelle angegeben, der auf dem Speicherort der benannten Tabelle in der Datenbank basiert. Der Name der benannten Tabelle wird zwischen dem „/tables“-Teil der URL und dem „/features.rep“-Teil der URL definiert. Zum Löschen von Features in einer benannten Tabelle, die sich unter „/Samples/NamedTables/WorldTable“ in der Datenbank befindet, würde beispielsweise folgende URL verwendet:.../FeatureService/tables/Samples/NamedTables /WorldTable/features.json;... |
rep | Zeichenfolge | ja | Die zurückzugebende Darstellung. Die unterstützte Darstellung ist JSON. |
action=delete | Zeichenfolge | ja | Die Aktion zum Löschen der Features in der Relation. |
commitInterval=c | Ganze Zahl | no | Die Anzahl der Löschvorgänge, die in einer Transaktion verarbeitet werden. Wenn Sie etwa 50 Features in einer Relation löschen und „commitInterval“ auf 20 festgelegt ist, führt dies zu drei Transaktionen (20, 20, 10). Der Standardwert ist 50. Das Übergabeintervall wird bei Native TAB- und NativeX-Dateien ignoriert. |
URL-Format von HTTP-DELETE-Anforderungen
Für HTTP-DELETE-Anforderungen wird zum Löschen eines Datensatzes das folgende Format verwendet:
HTTP DELETE /FeatureService/tables/tablename/features.rep/key
Weitere Informationen zu den unten aufgeführten Parametertypen finden Sie unter URL-Anforderungsdatentypen.
Parameter | Typ | Erforderlich | Beschreibung |
---|---|---|---|
tablename | Zeichenfolge | ja | Der Name der Relation, für die Sie Features löschen. Die Relation wird durch einen vollständig qualifizierten Namen für die benannte Tabelle angegeben, der auf dem Speicherort der benannten Tabelle in der Datenbank basiert. Der Name der benannten Tabelle wird zwischen dem „/tables“-Teil der URL und dem „/features.rep“-Teil der URL definiert. Zum Löschen von Features in einer benannten Tabelle, die sich unter „/Samples/NamedTables/WorldTable“ in der Datenbank befindet, würde beispielsweise folgende URL verwendet:.../FeatureService/tables/Samples/NamedTables /WorldTable/features.json;... |
rep | Zeichenfolge | ja | Die zurückzugebende Darstellung. Die unterstützte Darstellung ist JSON. |
Schlüssel | Zeichenfolge | ja | Der Primärschlüssel für das zu löschende Feature. |
Gibt zurück:
Gibt die Anzahl der einzelnen gelöschten Features zurück.
Beispiele
Löscht die Features mit 6, 7 und 8 als Primärschlüssel:
http://www.pbbi.com/rest/Spatial/FeatureService/tables/MyTable/features.json?action=delete&commitInterval=2
{
keys:["6", "7", "8"]
}
Löscht ein einzelnes Feature mit dem Primärschlüssel 6:
http://www.pbbi.com/rest/Spatial/FeatureService/tables/MyTable/features.json/6