Créer une couche de requête d’agrégation (Outils de gestion des données)

Résumé

Crée une couche de requête qui synthétise, agrège et filtre les tables DBMS dynamiquement en fonction de requêtes temporelles, par plage et attributaires depuis une table associée, et qui joint le résultat à une couche d’entités.

En savoir plus sur l’agrégation de valeurs dans des entités associées

Utilisation

Les couches de requête fonctionnent uniquement avec des bases de données d’entreprise. Les géodatabases fichier ne sont pas des espaces de travail en entrée valides pour cet outil.
Les résultats agrégés sont toujours calculés dynamiquement au niveau de la base de données.
La valeur Output Layer (Couche en sortie) est constituée de champs contenant le résultat de l’opération statistique. La statistique Total est incluse dans le champ ROW_COUNT par défaut.
Les opérations statistiques disponibles avec cet outil sont les suivantes : total, somme, moyenne, minimum, maximum et écart type.
Un champ est créé pour chaque type de statistique selon la convention d’affectation de noms suivante : COUNT_<field>, SUM_<field>, AVG_<field>, MIN_<field>, MAX_<field> et STDDEV_<field>, (où <field> est le nom du champ en entrée pour lequel la statistique est calculée).
La valeur Related Join Field (Champ de jointure associé) est utilisée dans la clause Group By (Regrouper par) de l’instruction SQL générée par cet outil. Les statistiques sont calculées séparément pour chaque valeur attributaire unique à partir de la valeur Related Join Field (Champ de jointure associé).
La couche qui est créée par l’outil est temporaire et n’est pas conservée une fois la session terminée, sauf si le projet est enregistré, si la couche est enregistrée dans un fichier de couche ou si les données sont conservées via la réalisation d’une copie à l’aide de l’outil Copy Rows (Copier des enregistrements) ou Copy Features (Copier des entités).

Etiqueter	Explication	Type de données
Classe d’entités cible	Classe d’entités ou table spatiale d’une base de données d’entreprise.	Feature Class
Champ de jointure cible	Champ de la classe d’entités cible sur lequel la jointure est basée.	Field
Table associée	Table en entrée contenant les champs utilisés pour le calcul des statistiques. Les statistiques sont jointes à la valeur Output Layer (Couche en sortie).	Table; Feature Class
Champ de jointure associé	Champ dans la table de synthèse qui contient les valeurs sur lesquelles la jointure est basée. Les statistiques d’agrégation ou de synthèse sont également calculées séparément pour chaque valeur attributaire unique de ce champ.	Field
Couche en sortie	Nom en sortie de la couche de requête à créer	Feature Layer
Champ(s) de récapitulation (Facultatif)	Spécifie le ou les champ(s) numérique(s) contenant les valeurs attributaires utilisées pour calculer les statistiques indiquées. Vous pouvez spécifier plusieurs combinaisons de statistiques et de champs. Les valeurs nulles sont exclues de tous les calculs statistiques. La couche en sortie comprend un champ `ROW_COUNT` affichant le nombre total (ou la fréquence) de chaque valeur unique pour la valeur Related Join Field (Champ de jointure associé). La différence entre le champ `ROW_COUNT` et le type de statistique Count (Total) est la suivante :`ROW_COUNT` inclut les valeurs nulles tandis que Count (Total) les exclut. Colonnes de la table de valeurs : 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
Définitions des paramètres (Facultatif)	Spécifie un ou plusieurs paramètres de requête pour les critères ou les conditions. Les enregistrements correspondant à ces critères sont utilisés lors du calcul des résultats agrégés. Un paramètre de requête est similaire à une variable d’instruction SQL dont la valeur est définie au moment de l’exécution de la requête. Vous pouvez ainsi changer dynamiquement les filtres de requête de la couche en sortie. Vous pouvez vous représenter un paramètre comme un prédicat ou une condition dans une clause Where SQL. Par exemple, `Country_Name = 'Nigeria'` dans une clause where SQL est un prédicat dans lequel le signe = est un opérateur de comparaison, `Country_Name` est un nom de champ situé à gauche du signe et `'Nigeria'` est une valeur située à droite du signe. Lorsque vous définissez plusieurs paramètres, vous devez spécifier un opérateur logique entre eux (par exemple, AND, OR, etc.). En savoir plus sur la définition de paramètres dans une couche de requête Lorsque cette option n’est pas spécifiée, tous les enregistrements de la table associée sont utilisés dans le calcul des résultats agrégés ou récapitulatifs. Les deux types de définition de paramètre sont les suivants : Range—Connecte dynamiquement des valeurs numériques ou temporelles aux curseurs de plage et temporels. Discrete—Met à jour une requête avec des valeurs littérales au moment de l’exécution de la requête. Colonnes de la table de valeurs : 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
Champ(s) d’identifiant unique (Facultatif)	Champs d’identifiant unique utilisés pour identifier de manière unique chaque ligne d’une table.	String
Type de forme (Facultatif)	Spécifie le type de forme de la couche de requête. Seuls les enregistrements du jeu de résultats de la requête qui correspondent au type de forme spécifié sont utilisés dans la couche de requête en sortie. Par défaut, le type de forme du premier enregistrement dans le jeu de résultats est utilisé. Ce paramètre est ignoré si le jeu de résultats de la requête ne renvoie pas de champ de géométrie. Point—La couche de requête en sortie utilise la géométrie de type Point. Multi-point—La couche de requête en sortie utilise la géométrie de type Multi-point. Polygone—La couche de requête en sortie utilise la géométrie de type Polygone. Polyligne—La couche de requête en sortie utilise la géométrie de type Polyligne.	String
ID de référence spatiale (SRID) (Facultatif)	La valeur d’identifiant de référence spatiale (SRID) pour les requêtes retournant une géométrie. Seuls les enregistrements du jeu de résultats de la requête qui correspondent à la valeur SRID spécifiée sont utilisés dans la couche de requête en sortie. Par défaut, la valeur SRID du premier enregistrement dans le jeu de résultats est utilisée. Ce paramètre est ignoré si le jeu de résultats de la requête ne renvoie pas de champ de géométrie.	String
Système de coordonnées (Facultatif)	Le système de coordonnées qui sera utilisé par la couche de requête en sortie. Par défaut, la référence spatiale du premier enregistrement dans le jeu de résultats est utilisée. Ce paramètre est ignoré si le jeu de résultats de la requête ne renvoie pas de champ de géométrie.	Spatial Reference
Les coordonnées comportent des valeurs M (Facultatif)	Indique si la couche en sortie contient des mesures linéaires (valeurs m). Activé—La couche contient des valeurs m. Décoché—La couche ne contient pas de valeurs m. Il s’agit de l’option par défaut.	Boolean
Les coordonnées comportent des valeurs Z (Facultatif)	Indique si la couche en sortie contient des valeurs d’élévation (valeurs z). Activé—La couche contient des valeurs z. Décoché—La couche ne contient pas de valeurs z. Il s’agit de l’option par défaut.	Boolean
Étendue (Facultatif)	Définit l’étendue de la couche. L’étendue doit inclure toutes les entités de la table. Current Display Extent (Étendue actuellement affichée) : l’étendue repose sur la carte ou scène active. Draw Extent (Dessiner l’étendue) : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Extent of a Layer (Étendue d’une couche) : l’étendue repose sur une couche de carte active. Choisissez une couche disponible ou utilisez l’option Étendue des données dans toutes les couches. Chaque couche de carte comporte les options suivantes : All Features (Toutes les entités) : étendue de toutes les entités. Selected Features (Entités sélectionnées) : étendue des entités sélectionnées. Visible Features (Entités visibles) : étendue des entités visibles. Browse (Parcourir) : l’étendue repose sur un jeu de données existant. Clipboard (Presse-papiers) : l’étendue peut être copiée depuis et vers le Presse-papiers. Copy Extent (Copier l’étendue) : copie l’étendue et le système de coordonnées dans le Presse-papiers. Paste Extent (Coller l’étendue) : colle l’étendue et les coordonnées depuis le Presse-papiers. Si le Presse-papiers n’inclut pas de système de coordonnées, l’étendue utilise celui de la carte. Reset Extent (Réinitialiser l’étendue) : la valeur par défaut de l’étendue est rétablie. Lorsque les coordonnées sont saisies manuellement, elles doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active. La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. Utilisez le signe moins pour les coordonnées sud et ouest.	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})

Nom	Explication	Type de données
target_feature_class	Classe d’entités ou table spatiale d’une base de données d’entreprise.	Feature Class
target_join_field	Champ de la classe d’entités cible sur lequel la jointure est basée.	Field
related_table	Table en entrée contenant les champs utilisés pour le calcul des statistiques. Les statistiques sont jointes à la valeur `out_layer`.	Table; Feature Class
related_join_field	Champ dans la table de synthèse qui contient les valeurs sur lesquelles la jointure est basée. Les statistiques d’agrégation ou de synthèse sont également calculées séparément pour chaque valeur attributaire unique de ce champ.	Field
out_layer	Nom en sortie de la couche de requête à créer	Feature Layer
statistics [[statistic_type, field],...] (Facultatif)	Spécifie le ou les champ(s) numérique(s) contenant les valeurs attributaires utilisées pour calculer les statistiques indiquées. Vous pouvez spécifier plusieurs combinaisons de statistiques et de champs. Les valeurs nulles sont exclues de tous les calculs statistiques. La couche en sortie comprend un champ `ROW_COUNT` affichant le nombre total (ou la fréquence) de chaque valeur unique pour la valeur `related_join_field`. La différence entre le champ `ROW_COUNT` et le type de statistique `COUNT` est la suivante : `ROW_COUNT` inclut les valeurs nulles tandis que `COUNT` les exclut. Colonnes de la table de valeurs : `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],...] (Facultatif)	Spécifie un ou plusieurs paramètres de requête pour les critères ou les conditions. Les enregistrements correspondant à ces critères sont utilisés lors du calcul des résultats agrégés. Un paramètre de requête est similaire à une variable d’instruction SQL dont la valeur est définie au moment de l’exécution de la requête. Vous pouvez ainsi changer dynamiquement les filtres de requête de la couche en sortie. Vous pouvez vous représenter un paramètre comme un prédicat ou une condition dans une clause Where SQL. Par exemple, `Country_Name = 'Nigeria'` dans une clause where SQL est un prédicat dans lequel le signe = est un opérateur de comparaison, `Country_Name` est un nom de champ situé à gauche du signe et `'Nigeria'` est une valeur située à droite du signe. Lorsque vous définissez plusieurs paramètres, vous devez spécifier un opérateur logique entre eux (par exemple, AND, OR, etc.). En savoir plus sur la définition de paramètres dans une couche de requête Lorsque cette option n’est pas spécifiée, tous les enregistrements de la table associée sont utilisés dans le calcul des résultats agrégés ou récapitulatifs. Les deux types de définition de paramètre sont les suivants : Range—Connecte dynamiquement des valeurs numériques ou temporelles aux curseurs de plage et temporels. Discrete—Met à jour une requête avec des valeurs littérales au moment de l’exécution de la requête. Colonnes de la table de valeurs : `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,...] (Facultatif)	Champs d’identifiant unique utilisés pour identifier de manière unique chaque ligne d’une table.	String
shape_type (Facultatif)	Spécifie le type de forme de la couche de requête. Seuls les enregistrements du jeu de résultats de la requête qui correspondent au type de forme spécifié sont utilisés dans la couche de requête en sortie. Par défaut, le type de forme du premier enregistrement dans le jeu de résultats est utilisé. Ce paramètre est ignoré si le jeu de résultats de la requête ne renvoie pas de champ de géométrie. `POINT`—La couche de requête en sortie utilise la géométrie de type Point. `MULTIPOINT`—La couche de requête en sortie utilise la géométrie de type Multi-point. `POLYGON`—La couche de requête en sortie utilise la géométrie de type Polygone. `POLYLINE`—La couche de requête en sortie utilise la géométrie de type Polyligne.	String
srid (Facultatif)	La valeur d’identifiant de référence spatiale (SRID) pour les requêtes retournant une géométrie. Seuls les enregistrements du jeu de résultats de la requête qui correspondent à la valeur SRID spécifiée sont utilisés dans la couche de requête en sortie. Par défaut, la valeur SRID du premier enregistrement dans le jeu de résultats est utilisée. Ce paramètre est ignoré si le jeu de résultats de la requête ne renvoie pas de champ de géométrie.	String
spatial_reference (Facultatif)	Le système de coordonnées qui sera utilisé par la couche de requête en sortie. Par défaut, la référence spatiale du premier enregistrement dans le jeu de résultats est utilisée. Ce paramètre est ignoré si le jeu de résultats de la requête ne renvoie pas de champ de géométrie.	Spatial Reference
m_values (Facultatif)	Indique si la couche en sortie contient des mesures linéaires (valeurs m). `INCLUDE_M_VALUES`—La couche contient des valeurs m. `DO_NOT_INCLUDE_M_VALUES`—La couche ne contient pas de valeurs m. Il s’agit de l’option par défaut.	Boolean
z_values (Facultatif)	Indique si la couche en sortie contient des valeurs d’élévation (valeurs z). `INCLUDE_Z_VALUES`—La couche contient des valeurs z. `DO_NOT_INCLUDE_Z_VALUES`—La couche ne contient pas de valeurs z. Il s’agit de l’option par défaut.	Boolean
extent (Facultatif)	Définit l’étendue de la couche. L’étendue doit inclure toutes les entités de la table. `MAXOF` : l’étendue maximale de toutes les entrées est utilisée. `MINOF` : l’étendue minimale commune à toutes les entrées est utilisée. `DISPLAY` : l’étendue est égale à l’affichage visible. Nom de la couche : l’étendue de la couche spécifiée est utilisée. `Extent` object : l’étendue de l’objet spécifié est utilisée. Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.	Extent

Exemple de code

Exemple 1 d’utilisation de la fonction MakeAggregationQueryLayer (fenêtre Python)

Le script ci-dessous pour la fenêtre Python indique comment calculer le nombre total de délits pour chaque district à partir d’une classe d’entités ponctuelles, et ajouter le résultat obtenu à une classe d’entités Districts de police.

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

Exemple 2 d’utilisation de la fonction MakeAggregationQueryLayer (fenêtre Python)

Le script ci-dessous pour la fenêtre Python indique comment calculer le nombre total de délits pour chaque district et pour chaque type de délit à partir d’une classe d’entités ponctuelles, et ajouter le résultat obtenu à une classe d’entités Districts de police.

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

Exemple 3 d’utilisation de la fonction MakeAggregationQueryLayer (fenêtre Python)

Le script ci-dessous pour la fenêtre Python indique comment calculer les précipitations totales et moyennes à partir d’une table de série chronologique, et ajouter le résultat obtenu à une classe d’entités Stations météo.

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

Exemple 4 d’utilisation de la fonction MakeAggregationQueryLayer (fenêtre Python)

Le script ci-dessous pour la fenêtre Python indique comment calculer les précipitations totales et moyennes à partir d’une table de série chronologique pour n’importe quelle fenêtre temporelle, et ajouter le résultat obtenu à une classe d’entités Stations météo.

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

Environnements

Espace de travail courant, Système de coordonnées en sortie

Informations de licence