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. Los tipos de estadísticas disponibles son los siguientes:
| 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:
Las siguientes propiedades están disponibles:
| Value Table |
Campo(s) de identificador único (Opcional) | Los 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.
| 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).
| Boolean |
Las coordenadas incluyen valores z (Opcional) | Especifica si la capa de salida incluirá valores de elevación (valores z).
| Boolean |
Extensión (Opcional) | Especifica la extensión de la capa. La extensión debe incluir todas las entidades de la tabla.
| Extent |
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.
Parámetros
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.
| 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:
Las siguientes propiedades están disponibles:
| Value Table |
oid_fields [oid_fields,...] (Opcional) | Los 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.
| 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).
| Boolean |
z_values (Opcional) | Especifica si la capa de salida incluirá valores de elevación (valores z).
| Boolean |
extent (Opcional) | Especifica la extensión de la capa. La extensión debe incluir todas las entidades de la tabla.
| Extent |
Muestra de código
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")
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")
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"]])
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")
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí