UpdateCursor (arcpy)

Краткая информация

Функция 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.	String
spatial_reference	Координаты указаны в предоставленной пространственной привязке spatial_reference и конвертируются на лету в систему координат набора данных.	SpatialReference
fields [fields,...]	Поля, которые будут включены в курсор. По умолчанию включаются все поля.	String
sort_fields	Поля, используемые для сортировки строк в курсоре. Порядок по возрастанию и убыванию для каждого поля обозначается, соответственно, буквами А и D.	String

Возвращено значение

Тип данных	Объяснение
Cursor	Объект Cursor, который может обрабатывать строковые объекты.

Пример кода

Пример UpdateCursor

Значения полей обновления в классе объектов на основе значения другого поля.

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