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

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

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

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

Требуется активная выборка на входе. Если какие-либо выбранные строки выделены, они будут использованы для формирования запроса.
Входной слой или представление таблицы должны присутствовать на карте или сцене.
Если входной слой или таблица не зарегистрированы в базе геоданных, будет создан слой запроса, и из этого слоя будет сгенерирован определяющий запрос.
Условие определяющего запроса содержит ограничение в 1000 значений. Если выборка включает более 1000 значений, итоговый определяющий запрос будет содержать несколько условий.
Если для параметра Метод построения задано значение Соответствовать выбранному, вместо поля ObjectID будет использоваться поле по умолчанию. Если в слое есть поле GlobalID, это поле будет использоваться вместо поля ObjectID. Поле GlobalID не будет указано в параметре Поле, если для параметра Метод построения задано значение Использовать значения полей.
Параметр Присоединить активный запрос доступен только в том случае, если для параметра Метод построения задано значение Использовать значения полей, а у входного слоя или таблицы есть активный определяющий запрос. Задать активный запрос можно, изучив свойства слоя или таблицы.
Если параметр Изменение построенного запроса отмечен, но значение параметра Условие Where не было изменено или указано, инструмент будет использовать построенный по умолчанию определяющий запрос.

Подпись	Объяснение	Тип данных
Входная таблица	Слой или представление таблицы, из которых будет сформирован определяющий запрос.	Table View
Метод построения (Дополнительный)	Указывает метод, который будет использоваться для создания определяющего запроса. Сопоставление выборки–Поле ObjectID входной таблицы (или поле GlobalID, если оно есть) будет использоваться для создания запроса со значениями, присутствующими в выборке. Используется по умолчанию. Использовать значения полей–Значение параметра Поле будет использовано для формирования запроса со значениями, присутствующими в выборке.	String
Поле (Дополнительный)	Поле в таблице или представлении таблицы, которое будет использоваться для генерации значений для запроса. Поддерживаемые типы полей: Short, Long, Text и GUID. Этот параметр необходим, если параметр Метод построения имеет значение Использовать значения полей.	Field
Имя запроса (Дополнительный)	Уникальное имя запроса, который будет сгенерирован.	String
Инвертировать условие Where (Дополнительный)	Указывает, будет ли построенный определяющий запрос (условие where) инвертирован и включит все невыбранные значения или включит все выбранные значения входной таблицы. Отмечено–Условие where будет инвертировано. Не отмечено–Условие where не будет инвертировано. Используется по умолчанию.	Boolean
Присоединить активный запрос (Дополнительный)	Указывает, будет ли построенный определяющий запрос добавлен к активному запросу. Этот параметр доступен, если у слоя или таблицы есть активный определяющий запрос, а для параметра Метод построения задано Использовать значения полей. Отмечено–Построенный определяющий запрос будет добавлен к активному запросу. Не отмечено–Построенный определяющий запрос не будет добавлен к активному запросу. Используется по умолчанию.	Boolean
Изменение построенного запроса (Дополнительный)	Указывает, будет ли отображаться определяющий запрос и может ли он быть изменен с помощью параметра Условие Where перед его построением. Отмечено–Запрос может быть изменен перед построением. Не отмечено–Запрос не может быть изменен. Используется по умолчанию.	Boolean
Условие Where (Дополнительный)	Построенное выражение определяющего запроса SQL из значений других параметров. Более подробно о синтаксисе SQL см. [Справочник по SQL для выражений запросов, применяемых в ArcGIS] (../../help/mapping/navigation/sql-reference-for-elements-used-in-query-expressions.md).	SQL Expression

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

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

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 (Дополнительный)	Поле в таблице или представлении таблицы, которое будет использоваться для генерации значений для запроса. Поддерживаемые типы полей: Short, Long, Text и GUID. Этот параметр необходим, если параметр `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_clause` перед его построением. `OVERWRITE`–Запрос может быть изменен перед построением. `NOT_OVERWRITE`–Запрос не может быть изменен. Используется по умолчанию.	Boolean
where_clause (Дополнительный)	Определяющий запрос, который переопределит значения других параметров. Более подробно о синтаксисе SQL см. [Справочник по SQL для выражений запросов, применяемых в ArcGIS] (../../help/mapping/navigation/sql-reference-for-elements-used-in-query-expressions.md).	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: Да

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

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

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

Параметры

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

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

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

Связанные разделы