Создать слой запроса агрегации (Инструменты Управление данными)

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

Создает слой запроса, динамически суммирующий, агрегирующий и фильтрующий таблицы СУБД на основе запросов к времени, диапазону и атрибутам из связанной таблицы, а затем присоединяет результат к векторному слою.

Более подробно об агрегации значений в связанные объекты

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

Слои запроса работают только с многопользовательскими базами данных. Этот инструмент не поддерживает в качестве входной рабочей области файловые базы геоданных.
Агрегированные результаты всегда вычисляются динамически на уровне базы данных.
Значение Выходного слоя будет состоять из полей, содержащих результаты статистической операции. Статистика по количеству входит в поле ROW_COUNT по умолчанию.
Статистические операции, доступные для этого инструмента: количество, сумма, среднее, минимум, максимум и средне-квадратичное отклонение.
Поле будет создано для каждого типа статистики с использованием следующих правил именования: COUNT_<field>, SUM_<field>, AVG_<field>, MIN_<field>, MAX_<field> и STDDEV_<field> (где <field> является именем входного поля, для которого вычисляется статистика).
Значение Связанное поле соединения используется в условии Группировать по в выражении SQL, которое создается этим инструментом. Статистика будет вычисляться по отдельности для каждого уникального значения атрибута из значения Связанное поле соединения.
Слой, созданный инструментом, является временным и исчезнет после завершения сеанса, если только проект не сохранен, слой не сохранен в файл слоя или не создана его копия с помощью инструментов Копировать строки или Копировать объекты.

Подпись	Объяснение	Тип данных
Целевой класс объектов	Класс объектов или пространственная таблица из многопользовательской базы геоданных.	Feature Class
Целевое поле соединения	Поле в целевом классе объектов, на котором основано соединение.	Field
Связанная таблица	Входная таблица, содержащая поля, для которых требуется вычислить статистику. Статистика присоединяется к значению Выходной слой.	Table; Feature Class
Связанное поле соединения	Поле из суммарной таблицы, содержащее значения, на которых будет основываться соединение. Агрегирование или суммарная статистика также вычисляется по отдельности для каждого уникального значения атрибута из этого поля.	Field
Выходной слой	Выходное имя слоя запроса, который будет создан.	Feature Layer
Поля для суммирования (Дополнительный)	Указывает числовое поле или поля, содержащее значения атрибута, для которого будет вычислен определенный статистический показатель. Могут быть заданы различные комбинации статистических показателей и полей. Пустые значения не включаются в расчет статистики. Выходной слой будет включать поле `ROW_COUNT`, которое показывает общее количество (или частоту) для каждого уникального значения из значения Связанное поле соединения. Разница между полем `ROW_COUNT` и типом статистики Количество заключается в том, что `ROW_COUNT` включает нулевые значения, а поле Количество такие значения исключает. Столбцы таблицы значений: Aggregate Type–The statistic type. Count–The number of values included in the statistical calculations will be found. Each value will be counted except null values. Sum–The values for the specified field will be added together. Average–The average for the specified field will be calculated. Minimum–The smallest value for all records of the specified field will be found. Maximum–The largest value for all records of the specified field will be found. Standard deviation–The standard deviation of values in the specified field will be calculated. Field Name(s)–The field containing attribute values used to calculate the specified statistic.	Value Table
Определения параметров (Дополнительный)	Определяет один или несколько параметров запроса для критерия или условий; записи, которые соответствуют этим критериям, будут использоваться при вычислении агрегированных результатов. Параметр запроса будут таким же, как и переменная SQL-выражения, для которого будет определяться значение при запуске запроса. Это позволяет динамически менять фильтры запросов для этого выходного слоя. Вы можете рассматривать параметр как предикат или условие в предложении SQL where. Например, `Country_Name = 'Nigeria'` в условии SQL where называется предикатом, в котором = is является оператором сравнения, `Country_Name` — это имя поля слева, а `'Nigeria'` — это значение справа. Когда вы задаете более одного параметра, вы должны указать между ними логический оператор (такой как AND, OR, и т.п.). Более подробно о задании параметров в слое запроса Если на задано, то все записи из связанной таблицы будут использоваться при вычислении результатов агрегирования или суммирования. Имеются в виду следующие два типа определений параметров: Range—Соединяет числовые или временные значения динамически с бегунками диапазона и времени. Discrete—Обновляет запрос буквенными значениями при запуске запроса. Столбцы таблицы значений: Parameter Type–Specifies the parameter type. Range–Range parameters connect numeric or temporal values dynamically to the range and time sliders. Discrete–Discrete parameters update a query with literal values when the query is run. Name–The name of the parameter, which is similar to a variable name. A name cannot contain spaces or special characters. Once the output query layer is created and the layer source SQL statement is checked, this name in the SQL statement that defines the output query layer source will be prefixed with either ::r: (for range parameter) or :: (for discrete parameter). Alias–The alias for the parameter name. The alias can include spaces and special characters. Field or Expression–A field name or a valid SQL expression that will be used in the left side of a predicate or condition in a where clause. Data type–The data type of the field or expression specified in the Field or Expression column. When using a range parameter type, the data type cannot be string. Date–The data type of the field or expression will be Date (date time). String–The data type of the field or expression will be String (text). Integer–The data type of the field or expression will be Integer (whole numbers). Double–The data type of the field or expression will be Double (fractional numbers). Start Value–The default start value for the range parameter type. This is the value that will be used when the time or range slider is not enabled. When the start value and end value column values are omitted and the time or range slider is disabled, all records from the related table will be used to compute aggregated results. This value is ignored when using a discrete parameter type. End Value–The default end value for the range parameter. This is the value that will be used when the time or range slider is not enabled. When the start value and end value column values are omitted and the time or range slider is disabled, all records from the related table will be used to compute aggregated results. This value is ignored when using a discrete parameter type. Operator for Discrete Parameters–The comparison operator that will be used between the Field or Expression column value and a value in an SQL predicate or condition. None–Use this option when using a range parameter type. Equal to–Compare the equality of a field or expression to a value. Not equal to–Test whether a field or expression is not equal to a value. Greater than–Test whether a field or expression is higher than a value. Less than–Test whether a field or expression is lower than a value. Include values–Determine whether a value from a field or expression matches any value in a list. Default Discrete Parameters–When using a discrete parameter type, you must provide a default value. When the operator is include values, you can provide multiple values separated by commas, for example VANDALISM,BURGLARY/THEFT. Operator for Next Parameters–The logical operator between this operator and the next one. This column is only applicable when you have more than one parameter definition. None–Use this option when there are no more parameters And–Combine two conditions and select a record if both conditions are true. Or–Combine two conditions and select a record if at least one condition is true.	Value Table
Поля уникального идентификатора (Дополнительный)	Поля уникального идентификатора, которые будут использоваться для уникальной идентификации каждой строки в таблице.	String
Тип формы (Дополнительный)	Определяет тип формы слоя запроса. В выходном слое запроса используются только те записи из результирующего набора запроса, которые соответствуют указанному типу геометрии. По умолчанию будет использован тип геометрии из первой записи результата. Если результирующий набор запроса не возвращает поле геометрии, этот параметр игнорируется. Точка–Выходной слой запроса использует точечную геометрию. Мультиточка–Выходной слой запроса использует мультиточечную геометрию. Полигон–Выходной слой запроса использует полигональную геометрию. Полилиния–Выходной слой запроса использует полилинейную геометрию.	String
ID пространственной привязки (SRID) (Дополнительный)	Значение идентификатора пространственной привязки (SRID) для запросов, возвращающих геометрию. В выходном слое запроса используются только те записи из результирующего набора запроса, которые соответствуют указанному значению SRID. По умолчанию будет использоваться значение SRID из первой записи результата. Если результирующий набор запроса не возвращает поле геометрии, этот параметр игнорируется.	String
Система координат (Дополнительный)	Система координат, которая будет использоваться выходным слоем запроса. По умолчанию будет использоваться пространственная привязка из первой записи результата. Если результирующий набор запроса не возвращает поле геометрии, этот параметр игнорируется.	Spatial Reference
Координаты содержат M-значения (Дополнительный)	Определяет, будет ли выходной слой включать линейные измерения (m-значения). Отмечено–Слой будет включать m-значения. Не отмечено–Слой не будет включать m-значения. Используется по умолчанию.	Boolean
Координаты содержат Z-значения (Дополнительный)	Определяет, будет ли выходной слой включать значения высоты (z-значения). Отмечено–В слое будут содержаться z-значения. Не отмечено–В слое не будут содержаться z-значения. Используется по умолчанию.	Boolean
Экстент (Дополнительный)	Определяет экстент слоя. Экстент должен включать все объекты в таблице. Текущий экстент отображения — Экстент будет основан на активной карте или сцене. Нарисовать экстент - Экстент будет основан на прямоугольнике, нарисованном на карте или в сцене. Экстент слоя — Экстент будет основан на активном слое карты. Выберите доступный слой или воспользуйтесь опцией Экстент данных во всех слоях. У каждого слоя карте есть следующие опции: Все объекты - Экстент всех объектов. Выбранные объекты - используйте экстент выбранных объектов. Отображаемые объекты - Экстент отображаемых объектов. Обзор — Экстент будет основан на наборе данных. Буфер обмена - Экстент может быть скопирован в буфер обмена и вставлен из него. Копировать экстент - Копирует координаты экстента и систему координат в буфер обмена. Вставить экстент - Вставляет экстент и систему координат из буфера обмена. Если буфер обмена не содержит систему координат, экстент будет использовать систему координат карты. Сбросить экстент — Экстент будет сброшен до значения по умолчанию. Если координаты заданы вручную, они должны быть числовыми значениями в системе координат активной карты. На карте могут использоваться единицы отображения, отличные от введенных координат. Используйте знак отрицательного значения для координат юга и запада.	Extent

arcpy.management.MakeAggregationQueryLayer(target_feature_class, target_join_field, related_table, related_join_field, out_layer, {statistics}, {parameter_definitions}, {oid_fields}, {shape_type}, {srid}, {spatial_reference}, {m_values}, {z_values}, {extent})

Имя	Объяснение	Тип данных
target_feature_class	Класс объектов или пространственная таблица из многопользовательской базы геоданных.	Feature Class
target_join_field	Поле в целевом классе объектов, на котором основано соединение.	Field
related_table	Входная таблица, содержащая поля, для которых требуется вычислить статистику. Статистика присоединяется к значению `out_layer`.	Table; Feature Class
related_join_field	Поле из суммарной таблицы, содержащее значения, на которых будет основываться соединение. Агрегирование или суммарная статистика также вычисляется по отдельности для каждого уникального значения атрибута из этого поля.	Field
out_layer	Выходное имя слоя запроса, который будет создан.	Feature Layer
statistics [[statistic_type, field],...] (Дополнительный)	Указывает числовое поле или поля, содержащее значения атрибута, для которого будет вычислен определенный статистический показатель. Могут быть заданы различные комбинации статистических показателей и полей. Пустые значения не включаются в расчет статистики. Выходной слой будет включать поле `ROW_COUNT`, которое показывает общее количество (или частоту) для каждого уникального значения из значения `related_join_field`. Разница между полем `ROW_COUNT` и типом статистики `COUNT` заключается в том, что `ROW_COUNT` включает нулевые значения, а поле `COUNT` такие значения исключает. Столбцы таблицы значений: `Aggregate Type`–The statistic type. `COUNT`–The number of values included in the statistical calculations will be found. Each value will be counted except null values. `SUM`–The values for the specified field will be added together. `AVG`–The average for the specified field will be calculated. `MIN`–The smallest value for all records of the specified field will be found. `MAX`–The largest value for all records of the specified field will be found. `STDDEV`–The standard deviation of values in the specified field will be calculated. `Field Name(s)`–The field containing attribute values used to calculate the specified statistic.	Value Table
parameter_definitions [[parameter_def_type, name, alias, field_or_expression, data_type, start_value, end_value, operator, default_value, operator_for_next_parameter],...] (Дополнительный)	Определяет один или несколько параметров запроса для критерия или условий; записи, которые соответствуют этим критериям, будут использоваться при вычислении агрегированных результатов. Параметр запроса будут таким же, как и переменная SQL-выражения, для которого будет определяться значение при запуске запроса. Это позволяет динамически менять фильтры запросов для этого выходного слоя. Вы можете рассматривать параметр как предикат или условие в предложении SQL where. Например, `Country_Name = 'Nigeria'` в условии SQL where называется предикатом, в котором = is является оператором сравнения, `Country_Name` — это имя поля слева, а `'Nigeria'` — это значение справа. Когда вы задаете более одного параметра, вы должны указать между ними логический оператор (такой как AND, OR, и т.п.). Более подробно о задании параметров в слое запроса Если на задано, то все записи из связанной таблицы будут использоваться при вычислении результатов агрегирования или суммирования. Имеются в виду следующие два типа определений параметров: Range—Соединяет числовые или временные значения динамически с бегунками диапазона и времени. Discrete—Обновляет запрос буквенными значениями при запуске запроса. Столбцы таблицы значений: `Parameter Type`–Specifies the parameter type. `RANGE`–Range parameters connect numeric or temporal values dynamically to the range and time sliders. `DISCRETE`–Discrete parameters update a query with literal values when the query is run. `Name`–The name of the parameter, which is similar to a variable name. A name cannot contain spaces or special characters. Once the output query layer is created and the layer source SQL statement is checked, this name in the SQL statement that defines the output query layer source will be prefixed with either ::r: (for range parameter) or :: (for discrete parameter). `Alias`–The alias for the parameter name. The alias can include spaces and special characters. `Field or Expression`–A field name or a valid SQL expression that will be used in the left side of a predicate or condition in a where clause. `Data type`–The data type of the field or expression specified in the Field or Expression column. When using a range parameter type, the data type cannot be string. `DATE`–The data type of the field or expression will be Date (date time). `STRING`–The data type of the field or expression will be String (text). `INTEGER`–The data type of the field or expression will be Integer (whole numbers). `DOUBLE`–The data type of the field or expression will be Double (fractional numbers). `Start Value`–The default start value for the range parameter type. This is the value that will be used when the time or range slider is not enabled. When the start value and end value column values are omitted and the time or range slider is disabled, all records from the related table will be used to compute aggregated results. This value is ignored when using a discrete parameter type. `End Value`–The default end value for the range parameter. This is the value that will be used when the time or range slider is not enabled. When the start value and end value column values are omitted and the time or range slider is disabled, all records from the related table will be used to compute aggregated results. This value is ignored when using a discrete parameter type. `Operator for Discrete Parameters`–The comparison operator that will be used between the Field or Expression column value and a value in an SQL predicate or condition. `NONE`–Use this option when using a range parameter type. `EQUAL TO`–Compare the equality of a field or expression to a value. `NOT EQUAL TO`–Test whether a field or expression is not equal to a value. `GREATER THAN`–Test whether a field or expression is higher than a value. `LESS THAN`–Test whether a field or expression is lower than a value. `INCLUDE VALUES`–Determine whether a value from a field or expression matches any value in a list. `Default Discrete Parameters`–When using a discrete parameter type, you must provide a default value. When the operator is include values, you can provide multiple values separated by commas, for example VANDALISM,BURGLARY/THEFT. `Operator for Next Parameters`–The logical operator between this operator and the next one. This column is only applicable when you have more than one parameter definition. `NONE`–Use this option when there are no more parameters `AND`–Combine two conditions and select a record if both conditions are true. `OR`–Combine two conditions and select a record if at least one condition is true.	Value Table
oid_fields [oid_fields,...] (Дополнительный)	Поля уникального идентификатора, которые будут использоваться для уникальной идентификации каждой строки в таблице.	String
shape_type (Дополнительный)	Определяет тип формы слоя запроса. В выходном слое запроса используются только те записи из результирующего набора запроса, которые соответствуют указанному типу геометрии. По умолчанию будет использован тип геометрии из первой записи результата. Если результирующий набор запроса не возвращает поле геометрии, этот параметр игнорируется. `POINT`–Выходной слой запроса использует точечную геометрию. `MULTIPOINT`–Выходной слой запроса использует мультиточечную геометрию. `POLYGON`–Выходной слой запроса использует полигональную геометрию. `POLYLINE`–Выходной слой запроса использует полилинейную геометрию.	String
srid (Дополнительный)	Значение идентификатора пространственной привязки (SRID) для запросов, возвращающих геометрию. В выходном слое запроса используются только те записи из результирующего набора запроса, которые соответствуют указанному значению SRID. По умолчанию будет использоваться значение SRID из первой записи результата. Если результирующий набор запроса не возвращает поле геометрии, этот параметр игнорируется.	String
spatial_reference (Дополнительный)	Система координат, которая будет использоваться выходным слоем запроса. По умолчанию будет использоваться пространственная привязка из первой записи результата. Если результирующий набор запроса не возвращает поле геометрии, этот параметр игнорируется.	Spatial Reference
m_values (Дополнительный)	Определяет, будет ли выходной слой включать линейные измерения (m-значения). `INCLUDE_M_VALUES`–Слой будет включать m-значения. `DO_NOT_INCLUDE_M_VALUES`–Слой не будет включать m-значения. Используется по умолчанию.	Boolean
z_values (Дополнительный)	Определяет, будет ли выходной слой включать значения высоты (z-значения). `INCLUDE_Z_VALUES`–В слое будут содержаться z-значения. `DO_NOT_INCLUDE_Z_VALUES`–В слое не будут содержаться z-значения. Используется по умолчанию.	Boolean
extent (Дополнительный)	Определяет экстент слоя. Экстент должен включать все объекты в таблице. `MAXOF` – Будет использоваться максимальный экстент всех входных данных. `MINOF` – Будет использоваться минимальная область, которая является общей для всех входных данных. `DISPLAY` — Экстент равен видимому отображению. Имя слоя — Будет использоваться экстент указанного слоя. `Extent` Объект — будет использоваться экстент указанного объекта. Строка координат, разделенная пробелами – Будет использоваться экстент указанной строки. Координаты выражаются в порядке x-мин, y-мин, x-макс, y-макс.	Extent

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data/localhost.sde"
arcpy.management.MakeAggregationQueryLayer(
    "PoliceDistricts", "district", "Crime_locations", "PdDistrict", "SF_Crimes")

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

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

import arcpy
arcpy.env.workspace = "C:/data/localhost.sde"
arcpy.management.MakeAggregationQueryLayer(
    "PoliceDistricts", "district", "Crime_locations", "PdDistrict", "SF_Crimes",
    None,
    "DISCRETE crime_type # Category STRING # # 'INCLUDE VALUES' 'VANDALISM, BURGLARY/THEFT' NONE")

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

Следующий скрипт окна Python демонстрирует, как вычислить общее и среднее количество осадков из таблицы временных рядов и присоединить результат к классу объектов водных станций.

import arcpy
arcpy.env.workspace = "C:/data/localhost.sde"
arcpy.management.MakeAggregationQueryLayer(
    "weather_stations", "station_id", "observed_rainfall", "station_id",
    "Total_Rainfall", [["SUM", "rainfall_inch"], ["MIN", "rainfall_inch"]])

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

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

import arcpy
arcpy.env.workspace = "C:/data/localhost.sde"
arcpy.management.MakeAggregationQueryLayer(
    "weather_stations", "station_id", "observed_rainfall", "station_id",
    "Total_Rainfall", [["SUM", "rainfall_inch"], ["MIN", "rainfall_inch"]],
    "RANGE TimeVar # collection_date DATE 1/1/2020 12/1/2020 NONE # NONE")

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

Текущая рабочая область, Выходная система координат

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