Python ArcGIS FeatureLayer.append用法及代碼示例

本文簡要介紹 python 語言中 arcgis.features.FeatureLayer.append 的用法。

用法:

append(item_id=None, upload_format='featureCollection', source_table_name=None, field_mappings=None, edits=None, source_info=None, upsert=False, skip_updates=False, use_globalids=False, update_geometry=True, append_fields=None, rollback=False, skip_inserts=None, upsert_matching_field=None, upload_id=None, *, return_messages=None, future=False)

返回：

指示成功 (True) 或失敗 (False) 的布爾值。當 return_messages 為 True 時，除了布爾值之外，還將返回響應消息作為 tuple 。如果 future = True ，則結果是 Future 對象。調用 result() 獲取響應。

append 方法用於更新現有托管的FeatureLayer 對象。有關更多信息，請參閱ArcGIS REST API 文檔中的Append (Feature Service/Layer) 頁麵。

注意：

append 方法僅在 ArcGIS Online 和 ArcGIS Enterprise 10.8.1+ 中可用

Parameter	Description
item_id	可選字符串。包含源文件的門戶項目的 ID。與editsUploadFormat 結合使用。
upload_format	必需的字符串。源追加數據格式。默認值為特征集合。值：‘sqlite’ | ‘shapefile’ | ‘filegdb’ | '函數集合' | ‘geojson’ | ‘csv’ | ‘excel’
source_table_name	必需的字符串。即使源數據僅包含一個表(例如，對於文件地理數據庫)也需要。 # Example usage: source_table_name= "Building"
field_mappings	可選列表。用於將源數據映射到目標圖層。語法：field_mappings=[{“name”:<”targetName”>, “sourceName” : < “sourceName”>}, …] # Example usage: field_mappings=[{"name" : "CountyID", "sourceName" : "GEOID10"}]
edits	可選字典。僅支持特征集合 json。追加支持通過 upload_id 或 item_id 的所有格式。
source_info	可選字典。這僅在從 excel 或 csv 附加數據時才需要。 appendSourceInfo 可以是分析 csv 或 excel 文件返回的發布參數。
upsert	可選的布爾值。可選參數，指定在函數已存在時是否需要將編輯作為更新應用。默認為假。
skip_updates	可選的布爾值。僅當 upsert 為真時才使用參數。
use_globalids	可選的布爾值。指定upsert在匹配特征時是否需要使用GlobalId。
update_geometry	可選的布爾值。該參數僅在 upsert 為真時使用。如果現有要素通過 objectId 或 globalId 匹配源要素，則跳過更新幾何並僅更新其屬性。(由 useGlobalIds 參數指定)。
append_fields	可選列表。要附加到的目標字段列表。當 upsert=true 或 false 時支持這一點。 #Values: ["fieldName1", "fieldName2",....]
rollback	可選的布爾值。可選參數，指定在失敗的情況下是否需要回滾 upsert 編輯。默認為假。
skip_inserts	僅在 upsert 為真時使用。如果值為 true，則用於跳過插入。默認值為假。
upsert_matching_field	可選字符串。通過 upsert 匹配要素時要使用的圖層字段。 ObjectId、GlobalId 和任何其他具有唯一索引的字段都可以與 upsert 一起使用。該參數覆蓋use_globalids；例如，即使指定 use_globalids = True，也會使用指定 upsert_matching_field。示例：upsert_matching_field=”MyfieldWithUniqueIndex”
upload_id	可選字符串。 upload() 響應中的 itemID 字段，與 appendUploadId REST API 參數相對應。此參數不應與 item_id 參數一起使用。
return_messages	可選布爾值。當設置為 True 時，將從追加返回的消息將被返回。如果 False ，則不會返回響應消息。這會將輸出更改為由 (Boolean, Dictionary) 組成的元組。
future	可選布爾值。如果為 True，則將返回 future 對象，並且進程不會等待任務完成。默認為False，表示等待結果。

例子：

# Usage Example

>>> feature_layer.append(source_table_name= "Building",
                        field_mappings=[{"name" : "CountyID",
                                        "sourceName" : "GEOID10"}],
                        upsert = True,
                        append_fields = ["fieldName1", "fieldName2",...., fieldname22],
                        return_messages = False)
<True>