Générer un ensemble de définition à partir de la sélection (Gestion des données)

Synthèse

Crée un ensemble de définition (au format SQL) à partir des entités ou lignes sélectionnées dans la couche ou table.

Utilisation

• Une sélection active dans l’entrée est requise.

• La vue tabulaire ou couche en entrée doit être présente dans la carte ou scène.

• La clause d’un ensemble de définition a une limite de 1 000 valeurs. Si la sélection inclut plus de 1 000 valeurs, l’ensemble de définition obtenu comprend plusieurs clauses.

• Lorsqu’une couche comporte un champ GlobalID et que le paramètre Méthode de génération est défini sur Apparier la sélection, le champ GlobalID est utilisé à la place du champ ObjectID. Le champ GlobalID n’est pas répertorié dans le paramètre si le paramètre Méthode de génération est défini sur Utiliser les valeurs de champ.

• Le paramètre Ajouter la requête active est disponible uniquement si le paramètre Méthode de génération est défini sur Utiliser les valeurs de champ et que la table ou couche en entrée comporte un ensemble de définition actif. Vous pouvez déterminer la requête active en examinant les propriétés de la table ou couche.

• Lorsque le paramètre Remplacer la clause Where est sélectionné, mais que la valeur du paramètre Clause Where n’a pas été modifiée ou spécifiée, l’outil utilise l’ensemble de définition généré par défaut.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Table en entrée	Vue tabulaire ou couche à partir de laquelle l’ensemble de définition est généré.	Table View
Méthode de génération (Facultatif)	Indique la méthode utilisée pour générer l’ensemble de définition. Apparier la sélection—Le champ ObjectID de la table en entrée (ou le champ GlobalID s’il est présent) est utilisé pour générer la requête avec les valeurs présentes dans la sélection. Il s’agit de l’option par défaut. Utiliser les valeurs de champ—La valeur du paramètre Champ est utilisée pour générer la requête avec les valeurs présentes dans la sélection.	String
Terrain (Facultatif)	Champ dans la vue tabulaire ou la table qui est utilisée pour générer les valeurs de la requête. Ce paramètre est requis lorsque le paramètre Méthode de génération est défini sur Utiliser les valeurs de champ.	Field
Nom de la requête (Facultatif)	Nom unique de la requête qui est générée.	String
Inverser la clause Where (Facultatif)	Indique si l’ensemble de définition généré (clause Where) est inversé et inclut toutes les valeurs non sélectionnées ou s’il inclut toutes les valeurs sélectionnées de la table en entrée. Activé : la clause Where est inversée. Désactivé : la clause Where n’est pas inversée. Il s’agit de l’option par défaut.	Boolean
Ajouter la requête active (Facultatif)	Indique si l’ensemble de définition généré est ajouté à la requête active. Ce paramètre est disponible lorsque la couche ou la table comporte un ensemble de définition actif et que le paramètre Méthode de génération est défini sur Utiliser les valeurs de champ. Activé : l’ensemble de définition généré est ajouté à la requête active. Désactivé : l’ensemble de définition généré n’est pas ajouté à la requête active. Il s’agit de l’option par défaut.	Boolean
Remplacer la clause Where (Facultatif)	Indique si l’ensemble de définition (clause Where) est affiché et peut être modifié à l’aide du paramètre Clause Where avant d’être généré. Activé : la clause Where est affichée et peut être modifiée avant d’être générée. Désactivé : la clause Where ne peut pas être modifiée. Il s’agit de l’option par défaut.	Boolean
Clause Where (Facultatif)	Expression SQL de l’ensemble de définition généré à partir des autres valeurs de paramètre. Pour plus d’informations sur la syntaxe SQL, reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.	SQL Expression

Sortie obtenue

Étiquette	Explication	Type de données
Table mise à jour	Entrée mise à jour avec l’ensemble de définition généré.	Feature Layer, Table View

Python

arcpy.management.GenerateDefinitionQueryFromSelection(in_table, {method}, {field}, {query_name}, {invert_where_clause}, {append_active_query}, {overwrite_where_clause}, {where_clause})

Nom	Explication	Type de données
in_table	Vue tabulaire ou couche à partir de laquelle l’ensemble de définition est généré.	Table View
method (Facultatif)	Indique la méthode utilisée pour générer l’ensemble de définition. MATCH_SELECTION—Le champ ObjectID de la table en entrée (ou le champ GlobalID s’il est présent) est utilisé pour générer la requête avec les valeurs présentes dans la sélection. Il s’agit de l’option par défaut. USE_FIELD_VALUES—La valeur du paramètre field est utilisée pour générer la requête avec les valeurs présentes dans la sélection.	String
field (Facultatif)	Champ dans la vue tabulaire ou la table qui est utilisée pour générer les valeurs de la requête. Ce paramètre est requis lorsque le paramètre method est défini sur USE_FIELD_VALUES.	Field
query_name (Facultatif)	Nom unique de la requête qui est générée.	String
invert_where_clause (Facultatif)	Indique si l’ensemble de définition généré (clause Where) est inversé et inclut toutes les valeurs non sélectionnées ou s’il inclut toutes les valeurs sélectionnées de la table en entrée. INVERT—La clause Where est inversée. NON_INVERT—La clause Where n’est pas inversée. Il s’agit de l’option par défaut.	Boolean
append_active_query (Facultatif)	Indique si l’ensemble de définition généré est ajouté à la requête active. Ce paramètre est disponible lorsque la couche ou la table comporte un ensemble de définition actif et que le paramètre method est défini sur USE_FIELD_VALUES. APPEND—L’ensemble de définition généré est ajouté à la requête active. NOT_APPEND—L’ensemble de définition généré n’est pas ajouté à la requête active. Il s’agit de l’option par défaut.	Boolean
overwrite_where_clause (Facultatif)	Indique si l’ensemble de définition (clause Where) peut être modifié à l’aide du paramètre where_clause avant d’être généré. OVERWRITE—La clause Where peut être modifiée avant d’être générée. NOT_OVERWRITE—La clause Where ne peut pas être modifiée. Il s’agit de l’option par défaut.	Boolean
where_clause (Facultatif)	Ensemble de définition qui remplace les autres valeurs de paramètre. Pour plus d’informations sur la syntaxe SQL, reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.	SQL Expression

Sortie obtenue

Nom	Explication	Type de données
out_table	Entrée mise à jour avec l’ensemble de définition généré.	Feature Layer, Table View

Exemple de code

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

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction GenerateDefinitionQueryFromSelection en mode immédiat.

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)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui