Crear capa de consulta de agregación (Herramientas de administración de datos)

Resumen

Crea una capa de consulta que resume, agrega y filtra dinámicamente las tablas DBMS basadas en consultas de tiempo, rango y atributos de una tabla relacionada, y une el resultado a una capa de entidades.

Más información sobre cómo agregar valores a entidades relacionadas

Uso

Las capas de consulta solamente funcionarán con bases de datos corporativas. Las geodatabases de archivos no son un espacio de trabajo de entrada válido para esta herramienta.
Los resultados agregados siempre se calculan de forma dinámica en el nivel de base de datos.
El valor de Capa de salida constará de campos que contienen el resultado de la operación estadística. La estadística de recuento se incluye en el campo ROW_COUNT de forma predeterminada
Las operaciones estadísticas que están disponibles con esta herramienta son recuento, suma, promedio, mínimo, máximo y desviación estándar.
Se creará un campo para cada tipo estadístico utilizando el siguiente formato de nombre: COUNT_<field>, SUM_<field>, AVG_<field>, MIN_<field>, MAX_<field> y STDDEV_<field>, (donde <field> es el nombre del campo de entrada para el que se calculan las estadísticas).
El valor de Campo de unión relacionado se utiliza en la cláusula Agrupar por en la sentencia SQL generada por esta herramienta. Las estadísticas se calcularán por separado para cada valor de atributo único del valor de Campo de unión relacionado.
La capa creada por la herramienta es temporal y, una vez finalizada la sesión, no permanece en el sistema a menos que se guarde el proyecto, la capa se guarde en un archivo de capa o los datos se conviertan en persistentes haciendo una copia con Copiar filas o Copiar entidades.

Etiqueta	Explicación	Tipo de datos
Clase de entidad de destino	La clase de entidad o tabla espacial de una base de datos corporativa.	Feature Class
Campo de unión de destino	El campo de la clase de entidad de destino en el cual se basará la unión.	Field
Tabla relacionada	La tabla de entrada que contiene los campos que se utilizarán para calcular las estadísticas. Las estadísticas se unen al valor de Capa de salida.	Table; Feature Class
Campo de unión relacionado	El campo de la tabla de resumen que contiene los valores sobre los cuales se basará la unión. Las estadísticas de agregación o resumen también se calculan por separado para cada valor de atributo único de este campo.	Field
Capa de salida	El nombre de salida de la capa de consulta que se creará.	Feature Layer
Campos de resumen (Opcional)	Especifica el campo o los campos numéricos que contienen los valores de atributo que se utilizarán para calcular la estadística especificada. Se pueden especificar varias estadísticas y combinaciones de campos. Los valores nulos se excluyen de todos los cálculos estadísticos. La capa de salida incluirá un campo `ROW_COUNT` que muestra el recuento total (o la frecuencia) de cada valor único del valor de Campo de unión relacionado. La diferencia entre el campo `ROW_COUNT` y el tipo de estadística Recuento es que `ROW_COUNT` incluye los valores nulos, mientras que Recuento excluye los valores nulos. Columnas de la tabla de valores: 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
Definiciones de parámetros (Opcional)	Especifica uno o más parámetros de consulta para criterios o condiciones; se utilizan los registros que coinciden con estos criterios al calcular los resultados agregados. Un parámetro de consulta es similar a una variable de sentencia SQL para la que se define el valor al ejecutar la consulta. Esto le permite cambiar dinámicamente los filtros de consulta para la capa de salida. Puede entender un parámetro como un predicado o condición de una cláusula WHERE de SQL. Por ejemplo, `Country_Name = 'Nigeria'` en una cláusula WHERE de SQL se denomina predicado, donde = es un operador de comparación, `Country_Name` es un nombre de campo a la izquierda y `'Nigeria'` es un valor a la derecha. Cuando define más de un parámetro, debe especificar un operador lógico entre ellos (como AND, OR, etc.). Más información sobre la definición de parámetros en una capa de consulta Si no se especifica, se utilizarán todos los registros de la tabla relacionada para calcular los resultados agregados o de resumen. Los dos tipos de definición de parámetro son los siguientes: Range—Conectar dinámicamente los valores numéricos o temporales a los controles deslizantes de rango y tiempo. Discrete—Actualizar una consulta con valores literales al ejecutar la consulta. Columnas de la tabla de valores: 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
Campo(s) de identificador único (Opcional)	Campos de identificador único que se utilizarán para identificar de forma única cada fila de la tabla.	String
Tipo de forma (Opcional)	Especifica el tipo de forma de la capa de consulta. Solamente aquellos registros del conjunto de resultados de la consulta que coinciden con el tipo de forma específico que se usará en la capa de consulta de salida. De forma predeterminada, se utilizará el tipo de forma del primer registro del conjunto de resultados. Este parámetro se ignora si el resultado establecido de la consulta no devuelve un campo de geometría. Punto—La capa de consulta de salida utilizará geometría de punto. Multipunto—La capa de consulta de salida usará geometría de multipunto. Polígono—La capa de consulta de salida usará geometría de polígono. Polilínea—La capa de consulta de salida usará geometría de polilínea.	String
Id. de referencia espacial (SRID) (Opcional)	El valor de identificador de referencia espacial (SRID) para consultas que devuelven geometría. Solamente aquellos registros del conjunto de resultados de la consulta que coinciden con el valor SRID específico que se usará en la capa de consulta de salida. De forma predeterminada, se utilizará el valor de SRID del primer registro del conjunto de resultados. Este parámetro se ignora si el resultado establecido de la consulta no devuelve un campo de geometría.	String
Sistema de coordenadas (Opcional)	El sistema de coordenadas que usará la capa de consulta de salida. De forma predeterminada, se utilizará la referencia espacial del primer registro del conjunto de resultados. Este parámetro se ignora si el resultado establecido de la consulta no devuelve un campo de geometría.	Spatial Reference
Las coordenadas incluyen valores M (Opcional)	Especifica si la capa de salida incluirá mediciones lineales (valores m). Activado—La capa incluirá valores m. Desactivado—La capa no incluirá valores m. Esta es la opción predeterminada.	Boolean
Las coordenadas incluyen valores z (Opcional)	Especifica si la capa de salida incluirá valores de elevación (valores z). Activado—La capa incluirá valores z. Desactivado—La capa no incluirá valores z. Esta es la opción predeterminada.	Boolean
Extensión (Opcional)	Especifica la extensión de la capa. La extensión debe incluir todas las entidades de la tabla. Extensión de visualización actual : la extensión se basará en el mapa o la escena activa. Extensión de dibujo : la extensión se basará en un rectángulo dibujado en el mapa o la escena. Extensión de capa : la extensión se basará en una capa de mapa activa. Elija una capa disponible o utilice la opción Extensión de datos en todas las capas. Cada capa de mapas tiene las opciones siguientes: Todas las entidades : la extensión de todas las entidades. Entidades seleccionadas : utilice la extensión de las entidades seleccionadas. Entidades visibles : la extensión de las entidades visibles. Examinar : la extensión se basará en un dataset. Portapapeles : la extensión puede copiarse en y desde el portapapeles. Copiar extensión : copia las la extensión y el sistema de coordenadas en el portapapeles. Pegar extensión : pega la extensión y el sistema de coordenadas del portapapeles. Si el portapapeles no incluye un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa. Restablecer extensión : la extensión se restablecerá al valor predeterminado. Cuando las coordenadas se proporcionan de forma manual, las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo. El mapa podría utilizar unidades de visualización distintas de las coordenadas proporcionadas. Utilice un valor de signo negativo para las coordenadas sur y oeste.	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})

Nombre	Explicación	Tipo de datos
target_feature_class	La clase de entidad o tabla espacial de una base de datos corporativa.	Feature Class
target_join_field	El campo de la clase de entidad de destino en el cual se basará la unión.	Field
related_table	La tabla de entrada que contiene los campos que se utilizarán para calcular las estadísticas. Las estadísticas se unen al valor de `out_layer`.	Table; Feature Class
related_join_field	El campo de la tabla de resumen que contiene los valores sobre los cuales se basará la unión. Las estadísticas de agregación o resumen también se calculan por separado para cada valor de atributo único de este campo.	Field
out_layer	El nombre de salida de la capa de consulta que se creará.	Feature Layer
statistics [[statistic_type, field],...] (Opcional)	Especifica el campo o los campos numéricos que contienen los valores de atributo que se utilizarán para calcular la estadística especificada. Se pueden especificar varias estadísticas y combinaciones de campos. Los valores nulos se excluyen de todos los cálculos estadísticos. La capa de salida incluirá un campo `ROW_COUNT` que muestra el recuento total (o la frecuencia) de cada valor único del valor de `related_join_field`. La diferencia entre el campo `ROW_COUNT` y el tipo de estadística `COUNT` es que `ROW_COUNT` incluye los valores nulos, mientras que `COUNT` excluye los valores nulos. Columnas de la tabla de valores: `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],...] (Opcional)	Especifica uno o más parámetros de consulta para criterios o condiciones; se utilizan los registros que coinciden con estos criterios al calcular los resultados agregados. Un parámetro de consulta es similar a una variable de sentencia SQL para la que se define el valor al ejecutar la consulta. Esto le permite cambiar dinámicamente los filtros de consulta para la capa de salida. Puede entender un parámetro como un predicado o condición de una cláusula WHERE de SQL. Por ejemplo, `Country_Name = 'Nigeria'` en una cláusula WHERE de SQL se denomina predicado, donde = es un operador de comparación, `Country_Name` es un nombre de campo a la izquierda y `'Nigeria'` es un valor a la derecha. Cuando define más de un parámetro, debe especificar un operador lógico entre ellos (como AND, OR, etc.). Más información sobre la definición de parámetros en una capa de consulta Si no se especifica, se utilizarán todos los registros de la tabla relacionada para calcular los resultados agregados o de resumen. Los dos tipos de definición de parámetro son los siguientes: Range—Conectar dinámicamente los valores numéricos o temporales a los controles deslizantes de rango y tiempo. Discrete—Actualizar una consulta con valores literales al ejecutar la consulta. Columnas de la tabla de valores: `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,...] (Opcional)	Campos de identificador único que se utilizarán para identificar de forma única cada fila de la tabla.	String
shape_type (Opcional)	Especifica el tipo de forma de la capa de consulta. Solamente aquellos registros del conjunto de resultados de la consulta que coinciden con el tipo de forma específico que se usará en la capa de consulta de salida. De forma predeterminada, se utilizará el tipo de forma del primer registro del conjunto de resultados. Este parámetro se ignora si el resultado establecido de la consulta no devuelve un campo de geometría. `POINT`—La capa de consulta de salida utilizará geometría de punto. `MULTIPOINT`—La capa de consulta de salida usará geometría de multipunto. `POLYGON`—La capa de consulta de salida usará geometría de polígono. `POLYLINE`—La capa de consulta de salida usará geometría de polilínea.	String
srid (Opcional)	El valor de identificador de referencia espacial (SRID) para consultas que devuelven geometría. Solamente aquellos registros del conjunto de resultados de la consulta que coinciden con el valor SRID específico que se usará en la capa de consulta de salida. De forma predeterminada, se utilizará el valor de SRID del primer registro del conjunto de resultados. Este parámetro se ignora si el resultado establecido de la consulta no devuelve un campo de geometría.	String
spatial_reference (Opcional)	El sistema de coordenadas que usará la capa de consulta de salida. De forma predeterminada, se utilizará la referencia espacial del primer registro del conjunto de resultados. Este parámetro se ignora si el resultado establecido de la consulta no devuelve un campo de geometría.	Spatial Reference
m_values (Opcional)	Especifica si la capa de salida incluirá mediciones lineales (valores m). `INCLUDE_M_VALUES`—La capa incluirá valores m. `DO_NOT_INCLUDE_M_VALUES`—La capa no incluirá valores m. Esta es la opción predeterminada.	Boolean
z_values (Opcional)	Especifica si la capa de salida incluirá valores de elevación (valores z). `INCLUDE_Z_VALUES`—La capa incluirá valores z. `DO_NOT_INCLUDE_Z_VALUES`—La capa no incluirá valores z. Esta es la opción predeterminada.	Boolean
extent (Opcional)	Especifica la extensión de la capa. La extensión debe incluir todas las entidades de la tabla. `MAXOF`: se usará la extensión máxima de todas las entradas. `MINOF`: se usará el área mínima común a todas las entradas. `DISPLAY`: la extensión es igual a la visualización visible. Nombre de capa: se usará la extensión de la capa especificada. `Extent` objeto: se usará la extensión del objeto especificado. Cadena de caracteres con las coordenadas delimitadas por espacios: se usará la extensión de la cadena especificada. Las coordenadas se expresan en el orden x-min, y-min, x-max, y-max.	Extent

Muestra de código

Ejemplo 1 de "MakeAggregationQueryLayer" (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo calcular el total de delitos para cada distrito desde una clase de entidad de puntos y cómo unir el resultado a una clase de entidad de distrito policial.

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

Ejemplo 2 de "MakeAggregationQueryLayer" (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo calcular el total de delitos para cada distrito y para cada tipo de delito desde una clase de entidad de puntos y cómo unir el resultado a una clase de entidad de distrito policial.

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")

Ejemplo 3 de "MakeAggregationQueryLayer" (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo calcular el total y el promedio de precipitaciones desde una tabla de serie temporal y cómo unir el resultado a una clase de entidad de estaciones de agua.

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"]])

Ejemplo 4 de "MakeAggregationQueryLayer" (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo calcular el total y el promedio de precipitaciones desde una tabla de serie temporal para cualquier ventana de tiempo y cómo unir el resultado a una clase de entidad de estaciones de agua.

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")

Entornos

Espacio de trabajo actual, Sistema de coordenadas de salida

Información de licenciamiento

Basic: No
Standard: No
Avanzado: Sí

Crear capa de consulta de agregación (Herramientas de administración de datos)

Resumen

Uso

Parámetros

Entornos

Información de licenciamiento

Temas relacionados