描述
RecordSet 对象是表的轻量级表示。它们是一种既包含方案又包含数据的特殊数据元素。RecordSet 对象也表示通过服务器发送和接收表的方式。
讨论
注:
如果要将某个表加载到新的 RecordSet,并使用可对诸如计算字段等输入或诸如 UpdateCursor 等函数进行修改的地理处理工具来修改 RecordSet,那么也将对原始表进行修改。
语法
RecordSet ({table})
参数 | 说明 | 数据类型 |
table | 要加载到 RecordSet 对象中的表。 | String |
属性
属性 | 说明 | 数据类型 |
JSON (只读) | 返回一个字符串形式的几何 Esri JSON 制图表达。 提示:通过 Python 的 json.loads 函数,返回的字符串可转换至字典。 | String |
方法概述
方法 | 说明 |
load (table_path, {where_clause}) | 从表导入。 |
save (table_path) | 导出到表。 |
方法
load (table_path, {where_clause})
参数 | 说明 | 数据类型 |
table_path | 要导入的表。 输入可以为要素类的目录路径、托管要素图层的 URL 或具有语法 {"url":"<url>", "token":"<token", "referer":"<referer>"} 的 URL JSON,用于从需要访问令牌的外部源加载数据。 | String |
where_clause | 用于选择记录子集的 SQL 表达式。 有关 SQL 语法的详细信息,请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考。 (默认值为 None) | String |
可选参数仅为位置参数;无法通过关键字来传递可选参数。
save (table_path)
参数 | 说明 | 数据类型 |
table_path | 要创建的输出表。 | String |
代码示例
导入服务器工具箱;从服务器工具的指定参数获取 RecordSet。
import arcpy
# Add a custom server toolbox
arcpy.ImportToolbox("http://myserver/arcgis/services;Geocode")
# Get recordset from server tool's first parameter to use as schema
in_recordset = arcpy.GetParameterValue("GeocodeAddress", 0)
创建 RecordSet 并加载托管表的子集。
import arcpy
# Set data
in_dataset = "https://maps.my.org/arcgis/rest/services/Tables/MapServer/0"
query = "Country_Code: 'IT'"
# Create empty RecordSet
record_set = arcpy.RecordSet()
# Load data into RecordSet with query
record_set.load(in_dataset, query)