Создать определяющий запрос из выборки (Управление данными)

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

Создает определяющий запрос (в формате SQL) из выбранных объектов или строк слоя или таблицы.

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

• Требуется активная выборка на входе.

• Входной слой или представление таблицы должны присутствовать на карте или сцене.

• Условие определяющего запроса содержит ограничение в 1000 значений. Если выборка включает более 1000 значений, итоговый определяющий запрос будет содержать несколько условий.

• Если слой содержит поле GlobalID, а для параметра Метод построения задано значение Соответствовать выбранному, вместо поля ObjectID будет использоваться поле GlobalID. Поле GlobalID не будет указано в параметре, если для параметра Метод построения задано значение Использовать значения полей.

• Параметр Присоединить активный запрос доступен только в том случае, если для параметра Метод построения задано значение Использовать значения полей, а у входного слоя или таблицы есть активный определяющий запрос. Задать активный запрос можно, изучив свойства слоя или таблицы.

• Если параметр Перезаписать условие Where отмечен, но значение параметра Условие Where не было изменено или указано, инструмент будет использовать построенный по умолчанию определяющий запрос.

Параметры

Диалог

Подпись	Описание	Тип данных
Входная таблица	Слой или представление таблицы, из которых будет сформирован определяющий запрос.	Table View
Метод построения (Дополнительный)	Указывает метод, который будет использоваться для создания определяющего запроса. Сопоставление выборки—Поле ObjectID входной таблицы (или поле GlobalID, если оно присутствует) будет использоваться для создания запроса со значениями, присутствующими в выборке. Это значение по умолчанию Использовать значения полей—Значение параметра Поле будет использовано для формирования запроса со значениями, присутствующими в выборке.	String
Поле (Дополнительный)	Поле в таблице или представлении таблицы, которое будет использоваться для генерации значений для запроса. Этот параметр необходим, если параметр Метод построения имеет значение Использовать значения полей.	Field
Имя запроса (Дополнительный)	Уникальное имя запроса, который будет сгенерирован.	String
Инвертировать условие Where (Дополнительный)	Указывает, будет ли построенный определяющий запрос (условие where) инвертирован и включит все невыбранные значения или включит все выбранные значения входной таблицы. Отмечено – условие where будет инвертировано. Не отмечено – условие where не будет инвертировано. Это значение по умолчанию	Boolean
Присоединить активный запрос (Дополнительный)	Указывает, будет ли построенный определяющий запрос добавлен к активному запросу. Этот параметр доступен, если у слоя или таблицы есть активный определяющий запрос, а для параметра Метод построения задано Использовать значения полей. Отмечено — построенный определяющий запрос будет добавлен к активному запросу. Не отмечено — построенный определяющий запрос не будет добавлен к активному запросу. Это значение по умолчанию	Boolean
Перезаписать условие Where (Дополнительный)	Указывает, будет ли отображаться определяющий запрос (условие where) и может ли он быть изменен с помощью параметра Условие Clause перед его построением. Отмечено – условие where будет отображено и может быть изменено перед построением. Не отмечено – условие where не может быть изменено. Это значение по умолчанию	Boolean
Условие Where (Дополнительный)	Построенное выражение определяющего запроса SQL из значений других параметров. Более подробно о синтаксисе SQL см. Справочник по SQL для выражений запросов, применяемых в ArcGIS.	SQL Expression

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

Подпись	Описание	Тип данных
Обновленная таблица	Обновленные входные данные с построенным определяющим запросом.	Feature Layer, Table View

Python

arcpy.management.GenerateDefinitionQueryFromSelection(in_table, {method}, {field}, {query_name}, {invert_where_clause}, {append_active_query}, {overwrite_where_clause}, {where_clause})

Имя	Описание	Тип данных
in_table	Слой или представление таблицы, из которых будет сформирован определяющий запрос.	Table View
method (Дополнительный)	Указывает метод, который будет использоваться для создания определяющего запроса. MATCH_SELECTION—Поле ObjectID входной таблицы (или поле GlobalID, если оно есть) будет использоваться для создания запроса со значениями, присутствующими в выборке. Это значение по умолчанию USE_FIELD_VALUES—Значение параметра field будет использовано для формирования запроса со значениями, присутствующими в выборке.	String
field (Дополнительный)	Поле в таблице или представлении таблицы, которое будет использоваться для генерации значений для запроса. Этот параметр необходим, если для параметра method задано USE_FIELD_VALUES.	Field
query_name (Дополнительный)	Уникальное имя запроса, который будет сгенерирован.	String
invert_where_clause (Дополнительный)	Указывает, будет ли построенный определяющий запрос (условие where) инвертирован и включит все невыбранные значения или включит все выбранные значения входной таблицы. INVERT—Условие where будет инвертировано. NON_INVERT—Условие where не будет инвертировано. Это значение по умолчанию	Boolean
append_active_query (Дополнительный)	Указывает, будет ли построенный определяющий запрос добавлен к активному запросу. Этот параметр доступен, если у слоя или таблицы есть активный определяющий запрос, а для параметра method задано USE_FIELD_VALUES. APPEND—Построенный определяющий запрос будет добавлен к активному запросу. NOT_APPEND—Построенный определяющий запрос не будет добавлен к активному запросу. Это значение по умолчанию	Boolean
overwrite_where_clause (Дополнительный)	Указывает, может ли быть изменен определяющий запрос (условие where) с помощью параметра where_clause перед его построением. OVERWRITE—Условие where может быть изменено перед построением. NOT_OVERWRITE—Условие where не может быть изменено. Это значение по умолчанию	Boolean
where_clause (Дополнительный)	Определяющий запрос, который переопределит значения других параметров. Более подробно о синтаксисе SQL см. Справочник по SQL для выражений запросов, применяемых в ArcGIS.	SQL Expression

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

Имя	Описание	Тип данных
out_table	Обновленные входные данные с построенным определяющим запросом.	Feature Layer, Table View

Пример кода

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

Пример скрипта окна Python для использования функции GenerateDefinitionQueryFromSelection в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data"

# Set local variables
in_table = "WisconsinAirports.lyrx"
where_clause = '"TRAFFICCOUNT" >= \'100\''

# Run the tool
arcpy.management.GenerateDefinitionQueryFromSelection(
    in_table,
    "MATCH_SELECTION",
    "MyPythonQueryName",
    "NON_INVERT",
    "NOT_APPEND",
    "OVERWRITE",
    where_clause)

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

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

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да