Definitionsabfrage aus Auswahl generieren (Data Management Tools)

Zusammenfassung

Erstellt eine Definitionsabfrage (im SQL-Format) aus den ausgewählten Features oder Zeilen des Layers oder der Tabelle.

Verwendung

Eine aktive Auswahl für die Eingabe ist erforderlich. Wenn ausgewählte Zeilen hervorgehoben wurden, werden diese zur Erstellung der Abfrage verwendet.
Der Eingabe-Layer oder die Tabellensicht muss in der Karte oder Szene vorhanden sein.
Wenn der Eingabe-Layer oder die Tabelle nicht in der Geodatabase registriert ist, wird ein Abfrage-Layer erstellt und die Definitionsabfrage wird aus diesem Layer generiert.
Für eine Definitionsabfrageklausel gilt eine Obergrenze von 1.000 Werten. Wenn die Auswahl mehr als 1.000 Werte umfasst, enthält die resultierende Definitionsabfrage mehrere Klauseln.
Wenn der Parameter Erstellungsmethode auf Auswahl abgleichen festgelegt ist, wird standardmäßig das ObjectID-Feld verwendet. Wenn ein Layer ein GlobalID-Feld aufweist, wird dieses Feld anstelle des ObjectID-Feldes verwendet. Das GlobalID-Feld wird nicht im Parameter Feld angegeben, wenn der Parameter Erstellungsmethode auf Feldwerte verwenden festgelegt ist.
Der Parameter Aktive Abfrage anhängen ist nur verfügbar, wenn der Parameter Erstellungsmethode auf Feldwerte verwenden festgelegt ist und der Eingabe-Layer oder die Eingabe-Tabelle eine aktive Definitionsabfrage aufweist. Sie können die aktive Abfrage ermitteln, indem Sie die Layer- oder Tabelleneigenschaften untersuchen.
Wenn der Parameter Generierte Abfrage ändern aktiviert ist, der Parameterwert Where-Klausel jedoch nicht geändert oder angegeben wurde, verwendet das Werkzeug die standardmäßig generierte Definitionsabfrage.

Beschriftung	Erläuterung	Datentyp
Eingabetabelle	Der Layer oder die Tabellensicht, aus der die Definitionsabfrage generiert wird.	Table View
Erstellungsmethode (Optional)	Gibt die Methode an, mit der die Definitionsabfrage generiert wird. Auswahl abgleichen—Das ObjectID-Feld der Eingabetabelle (oder das GlobalID-Feld, falls vorhanden) wird zum Generieren der Abfrage mit in der Auswahl vorhandenen Werten verwendet. Dies ist die Standardeinstellung. Feldwerte verwenden—Der Wert des Parameters Feld wird verwendet, um die Abfrage mit in der Auswahl vorhandenen Werten zu generieren.	String
Feld (Optional)	Das Feld in der Tabelle oder der Tabellensicht, das verwendet wird, um Werte für die Abfrage zu generieren. Akzeptierte Feldtypen sind: Long, Short, Text und GUID. Dieser Parameter ist erforderlich, wenn der Parameter Erstellungsmethode auf Feldwerte verwenden festgelegt wurde.	Field
Abfragename (Optional)	Der eindeutige Name der generierten Abfrage.	String
Where-Klausel umkehren (Optional)	Gibt an, ob die generierte Definitionsabfrage (Where-Klausel) umgekehrt wird und alle nicht ausgewählten Werte oder alle ausgewählten Werte der Eingabetabelle eingeschlossen werden. Aktiviert—Die Where-Klausel wird umgekehrt. Deaktiviert—Die Where-Klausel wird nicht umgekehrt. Dies ist die Standardeinstellung.	Boolean
Aktive Abfrage anhängen (Optional)	Gibt an, ob die generierte Definitionsabfrage an die aktive Abfrage angehängt wird. Dieser Parameter ist verfügbar, wenn der Layer oder die Tabelle eine aktive Definitionsabfrage aufweist und der Parameter Erstellungsmethode auf Feldwerte verwenden festgelegt wurde. Aktiviert—Die generierte Definitionsabfrage wird an die aktive Abfrage angehängt. Deaktiviert—Die generierte Definitionsabfrage wird nicht an die aktive Abfrage angehängt. Dies ist die Standardeinstellung.	Boolean
Generierte Abfrage ändern (Optional)	Gibt an, ob die Definitionsabfrage angezeigt wird und mit dem Parameter Where-Klausel geändert werden kann, bevor sie generiert wird. Aktiviert—Die Abfrage kann geändert werden, bevor sie generiert wird. Deaktiviert—Die Abfrage kann nicht geändert werden. Dies ist die Standardeinstellung.	Boolean
Where-Klausel (Optional)	Der generierte SQL-Definitionsabfrageausdruck aus den anderen Parameterwerten. Weitere Informationen zur SQL-Syntax finden Sie unter "SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke".	SQL Expression

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Tabelle	Die aktualisierte Eingabe mit der generierten Definitionsabfrage.	Feature Layer; Table View

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

Name	Erläuterung	Datentyp
in_table	Der Layer oder die Tabellensicht, aus der die Definitionsabfrage generiert wird.	Table View
method (Optional)	Gibt die Methode an, mit der die Definitionsabfrage generiert wird. `MATCH_SELECTION`—Das ObjectID-Feld der Eingabetabelle (oder das GlobalID-Feld, falls vorhanden) wird zum Generieren der Abfrage mit in der Auswahl vorhandenen Werten verwendet. Dies ist die Standardeinstellung. `USE_FIELD_VALUES`—Der Wert des Parameters `field` wird verwendet, um die Abfrage mit in der Auswahl vorhandenen Werten zu generieren.	String
field (Optional)	Das Feld in der Tabelle oder der Tabellensicht, das verwendet wird, um Werte für die Abfrage zu generieren. Akzeptierte Feldtypen sind: Long, Short, Text und GUID. Dieser Parameter ist erforderlich, wenn der Parameter `method` auf `USE_FIELD_VALUES` festgelegt wurde.	Field
query_name (Optional)	Der eindeutige Name der generierten Abfrage.	String
invert_where_clause (Optional)	Gibt an, ob die generierte Definitionsabfrage (Where-Klausel) umgekehrt wird und alle nicht ausgewählten Werte oder alle ausgewählten Werte der Eingabetabelle eingeschlossen werden. `INVERT`—Die Where-Klausel wird umgekehrt. `NON_INVERT`—Die Where-Klausel wird nicht umgekehrt. Dies ist die Standardeinstellung.	Boolean
append_active_query (Optional)	Gibt an, ob die generierte Definitionsabfrage an die aktive Abfrage angehängt wird. Dieser Parameter ist verfügbar, wenn ein Layer oder eine Tabelle eine aktive Definitionsabfrage aufweist und der Parameter `method` auf `USE_FIELD_VALUES` festgelegt wurde. `APPEND`—Die generierte Definitionsabfrage wird an die aktive Abfrage angehängt. `NOT_APPEND`—Die generierte Definitionsabfrage wird nicht an die aktive Abfrage angehängt. Dies ist die Standardeinstellung.	Boolean
overwrite_where_clause (Optional)	Gibt an, ob die Definitionsabfrage mit dem Parameter `where_clause` geändert werden kann, bevor sie generiert wird. `OVERWRITE`—Die Abfrage kann geändert werden, bevor sie generiert wird. `NOT_OVERWRITE`—Die Abfrage kann nicht geändert werden. Dies ist die Standardeinstellung.	Boolean
where_clause (Optional)	Die Definitionsabfrage, die die anderen Parameterwerte außer Kraft setzt. Weitere Informationen zur SQL-Syntax finden Sie unter "SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke".	SQL Expression

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_table	Die aktualisierte Eingabe mit der generierten Definitionsabfrage.	Feature Layer; Table View

Codebeispiel

GenerateDefinitionQueryFromSelection: Beispiel (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion GenerateDefinitionQueryFromSelection im Direkt-Modus verwendet wird.

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)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Definitionsabfrage aus Auswahl generieren (Data Management Tools)

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen