Выбрать в слое по атрибуту (Управление данными)—ArcGIS AllSource

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

Добавляет, обновляет или удаляет выборку на основе запроса к атрибутам.

Использование

Если входные данные представлены классом пространственных объектов или путем к набору данных, этот инструмент будет создавать и возвращать новый слой с результатом примененного инструмента.
Если для входных данных задан определяющий запрос, в выборке будут представлены только объекты или строки, которые отвечают параметрам этого запроса.
Число выбранных записей будет перечислено в истории геообработки. Щелкните Параметры > Количество. Дополнительно, инструмент Посчитать строки может использоваться для определения числа выбранных записей. В Python количество выбранных записей также можно получить из объекта Result инструмента.
При применении выборки можно применить выбор из нулевых записей. Например, при выборе несуществующего значения поля результатом будет нулевая выборка. Инструмент геообработки, использующий этот слой в качестве входных данных, не будет использовать записи из входных данных.
Разделители полей, используемые в выражении SQL различаются, в зависимости от формата запрашиваемых данных. Например, в файловых базах геоданных и шейп-файлах используются двойные кавычки, а многопользовательские базы геоданных не используют разделители. Вы можете использовать функцию AddFieldDelimiters, чтобы проверить, корректно ли использованы разделители полей в выражении SQL.
Если выходной источник данных - векторный слой, рекомендуется, чтобы ArcGIS Server использовал стандартизированные SQL-запросы.

Параметры

Подпись	Описание	Тип данных
Входные строки	Данные, к которым будет применяться эта выборка.	Table View; Raster Layer; Mosaic Layer
Тип выборки (Дополнительный)	Определяет, как будет применяться выборка и что произойдет, если выборка уже существует. Новая выборка—Результирующая выборка заменяет текущую. Это значение по умолчанию Добавить к текущей выборке—Результирующая выборка добавляется к текущей, если таковая существует. Если никакой выборки нет, данная опция работает так же, как и опция создания новой выборки. Удалить из текущей выборки—Результирующая выборка будет удалена из текущей выборки. Если во входном слое объекты не были выбраны, выбор данной опции не приведет ни к какому результату. Выбрать поднабор из текущей выборки.—Результирующая выборка будет соединена с текущей выборкой. Выбранными останутся только те записи, которые являются общими для обеих выборок. Переключить текущую выборку—Выборка переключится. Все записи, которые были выбраны, удаляются из нее, а все ранее не выбранные записи становятся выбранными. Выражение игнорируется, если установлена эта опция. Очистить текущую выборку—Выборка очищается или удаляется. Выражение игнорируется, если установлена эта опция.	String
Выражение (Дополнительный)	SQL-выражение, использованное для выбора поднабора записей.	SQL Expression
Инвертировать условие Where (Дополнительный)	Определяет, будет ли выражение использоваться как есть или будет использоваться противоположное ему выражение. Не отмечено – запрос останется в исходном виде. Это значение по умолчанию Отмечено – выражение запроса будет инвертировано. Если используется параметр Тип выборки, до того, как выборка будет объединена с существующими выборками, произойдет ее инвертирование.	Boolean

Производные выходные данные

Подпись	Описание	Тип данных
Обновленный слой или представление таблицы	Обновленный входной слой с применением выборки.	Table View; Raster Layer; Feature Layer
Количество	Число выбранных записей.	Long

arcpy.management.SelectLayerByAttribute(in_layer_or_view, {selection_type}, {where_clause}, {invert_where_clause})

Имя	Описание	Тип данных
in_layer_or_view	Данные, к которым будет применяться эта выборка.	Table View; Raster Layer; Mosaic Layer
selection_type (Дополнительный)	Определяет, как будет применяться выборка и что произойдет, если выборка уже существует. NEW_SELECTION—Результирующая выборка заменяет текущую. Это значение по умолчанию ADD_TO_SELECTION—Результирующая выборка добавляется к текущей, если таковая существует. Если никакой выборки нет, данная опция работает так же, как и опция создания новой выборки. REMOVE_FROM_SELECTION—Результирующая выборка будет удалена из текущей выборки. Если во входном слое объекты не были выбраны, выбор данной опции не приведет ни к какому результату. SUBSET_SELECTION—Результирующая выборка будет соединена с текущей выборкой. Выбранными останутся только те записи, которые являются общими для обеих выборок. SWITCH_SELECTION—Выборка переключится. Все записи, которые были выбраны, удаляются из нее, а все ранее не выбранные записи становятся выбранными. Параметр where_clause игнорируется, если установлена эта опция. CLEAR_SELECTION—Выборка очищается или удаляется. Параметр where_clause игнорируется, если установлена эта опция.	String
where_clause (Дополнительный)	SQL-выражение, использованное для выбора поднабора записей.	SQL Expression
invert_where_clause (Дополнительный)	Определяет, будет ли выражение использоваться как есть или будет использоваться противоположное ему выражение. NON_INVERT—Запрос останется в исходном виде. Это значение по умолчанию INVERT—Выражение запроса будет инвертировано. Если используется параметр selection_type, до того, как выборка будет объединена с существующими выборками, произойдет ее инвертирование.	Boolean

Производные выходные данные

Имя	Описание	Тип данных
out_layer_or_view	Обновленный входной слой с применением выборки.	Table View; Raster Layer; Feature Layer
count	Число выбранных записей.	Long

Пример кода

SelectLayerByAttribute, пример (окно Python)

В следующем скрипте окна Python показано, как используется функция SelectLayerByAttribute в режиме прямого запуска.

import arcpy
arcpy.management.SelectLayerByAttribute("states", "NEW_SELECTION", 
                                        "[NAME] = 'California'")

SelectLayerByAttribute, пример 2 (автономный скрипт)

Пример скрипта окна Python для выполнения функции SelectLayerByAttribute в рабочем процессе, чтобы извлечь пространственные объекты в новый класс пространственных объектов на основе расположения и атрибутивного запроса.

# Name: ExtractFeaturesByLocationAndAttribute.py
# Description: Extract features to a new feature class based on a spatial 
# relationship to another layer and an attribute query

# Import system modules
import arcpy

# Set the workspace
arcpy.env.workspace = 'c:/data/mexico.gdb'

# Select all cities that overlap the chihuahua polygon
chihuahua_cities = arcpy.management.SelectLayerByLocation('cities', 'INTERSECT', 
                                                          'chihuahua', 0, 
                                                          'NEW_SELECTION')

# Within selected features, further select only those cities with a 
# population > 10,000   
arcpy.management.SelectLayerByAttribute(chihuahua_cities, 'SUBSET_SELECTION', 
                                        '"population" > 10000')

# Write the selected features to a new feature class
arcpy.management.CopyFeatures(chihuahua_cities, 'chihuahua_10000plus')

Параметры среды

Этот инструмент не использует параметры среды геообработки

Отзыв по этому разделу?

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

Использование

Параметры

Производные выходные данные

Производные выходные данные

Пример кода

Параметры среды

В этом разделе