Краткая информация
Функция UpdateCursor создает курсор, который позволяет обновлять или удалять строки в указанном классе объектов, шейп-файле или таблице. Курсор устанавливает блокировку данных, которая остается до завершения работы скрипта или пока курсор не будет удален.
Обсуждение
Прежние версии:
Эта функция была заменена на arcpy.da.UpdateCursor в ArcGIS 10.1. Для более быстрой работы, используйте arcpy.da.UpdateCursor.
Курсоры обновления могут работать циклически с помощью цикла for или while, с использованием метода курсора next для перехода к следующей строке. При использовании метода next для курсора с целью выбора всех строк таблицы с количеством строк n, скрипт должен выполнить количество вызовов n к методу next. Вызов next после последней строки в полученном наборе результатов возвращает None, являющийся типом данных Python, который действует здесь в качестве местозаполнителя.
Использование UpdateCursor с циклом for.
import arcpy
fc = "c:/data/base.gdb/roads"
field1 = "field1"
field2 = "field2"
cursor = arcpy.UpdateCursor(fc)
for row in cursor:
# field2 will be equal to field1 multiplied by 3.0
row.setValue(field2, row.getValue(field1) * 3.0)
cursor.updateRow(row)
Использование UpdateCursor с циклом while.import arcpy
fc = "c:/data/base.gdb/roads"
field1 = "field1"
field2 = "field2"
cursor = arcpy.UpdateCursor(fc) row = cursor.next() while row:
# field2 will be equal to field1 multiplied by 3.0 row.setValue(field2, row.getValue(field1) * 3.0) cursor.updateRow(row)
row = cursor.next()
Синтаксис
UpdateCursor (dataset, {where_clause}, {spatial_reference}, {fields}, {sort_fields})
Параметр | Описание | Тип данных |
dataset | Класс объектов, шейп-файл или таблица, содержащая строки для обновления или удаления. | String |
where_clause |
Дополнительное выражение, ограничивающее строки, возвращаемые в курсоре. Более подробно о выражении WHERE и о условиях SQL см. в разделе Справочник по SQL для выражений запросов, применяемых в ArcGIS. | String |
spatial_reference | Координаты указаны в предоставленной пространственной привязке spatial_reference и конвертируются на лету в систему координат набора данных. | SpatialReference |
fields | Строка полей, разделенных точкой с запятой, которые будут включены в курсор. По умолчанию включаются все поля. | String |
sort_fields | Поля, используемые для сортировки строк в курсоре. Порядок по возрастанию и убыванию для каждого поля обозначается буквами A и D, соответственно, в виде "field1 A;field2 B". | String |
Тип данных | Описание |
Cursor | Объект Cursor, который может распределять объекты Row. |
Пример кода
Обновляет значения полей в классе объектов на основе значения другого поля.
import arcpy
# Create update cursor for feature class
rows = arcpy.UpdateCursor("c:/data/base.gdb/roads")
# Update the field used in buffer so the distance is based on the
# road type. Road type is either 1, 2, 3, or 4. Distance is in meters.
for row in rows:
# Fields from the table can be dynamically accessed from the
# row object. Here fields named BUFFER_DISTANCE and ROAD_TYPE
# are used
row.setValue("BUFFER_DISTANCE", row.getValue("ROAD_TYPE") * 100)
rows.updateRow(row)
# Delete cursor and row objects to remove locks on the data.
del row
del rows