Felder berechnen (mehrere) (Data Management Tools)

Zusammenfassung

Hiermit werden die Werte von mindestens zwei Feldern für eine Feature-Class, einen Feature-Layer oder ein Raster berechnet.

Verwendung

Achtung:

Mit diesem Werkzeug werden die Eingabedaten geändert. Weitere Informationen und Strategien zur Vermeidung unerwünschter Datenänderungen finden Sie unter "Werkzeuge, die Eingabedaten ändern oder aktualisieren".

Weitere Informationen zu Python-Ausdrücken finden Sie unter "Feld berechnen: Python-Beispiele".

Weitere Informationen zu Arcade-Ausdrücken finden Sie unter "ArcGIS Arcade" in der Hilfe für Entwickler.

Weitere Informationen zu SQL-Ausdrücken finden Sie unter "Syntax für einen SQL-Ausdruck" und "Berechnen von Feldwerten".

Weitere Informationen über VBScript-Ausdrücke finden Sie unter "Feld berechnen – VBScript-Beispiele".
Die Arcade-Ausdrücke dieses Werkzeugs verwenden das Arcade-Profil "Feldberechnung". Ein Arcade-Profil ist ein Kontext, in dem ein Arcade-Ausdruck ausgewertet und verstanden wird. Wenn ein Arcade-Ausdruck ausgewertet wird, wird der Rückgabewert in den Feldtyp des Ausgabewerts umgewandelt.
Achtung:

Mit Windows 11, Version 24H2, wird VBScript zu einem Feature on Demand und erfordert die VBScript-Funktion.

Führen Sie einen der folgenden Schritte aus, um die Option VBScript weiterhin zu verwenden:
- Konvertieren Sie den Ausdruckstyp in Python, Arcade oder SQL.
- Aktivieren Sie die optionale VBScript-Unterstützung in den Windows-Systemeinstellungen.
Weitere Informationen finden Sie unter Hinweise zur Abkündigung und zu veralteten Funktionen.
Bei Verwendung mit einem ausgewählten Feature-Satz, wie zum Beispiel den mit einer Abfrage im Werkzeug Feature-Layer erstellen oder Layer nach Attributen auswählen erstellten Features, werden nur die ausgewählten Datensätze aktualisiert.
Vorhandene Feldwerte werden überschrieben. Um die ursprünglichen Werte beizubehalten, erstellen Sie eine Kopie der Eingabetabelle als Sicherung, oder verwenden Sie die Option Rückgängig aktivieren im Bereich Geoverarbeitung.
Bei Berechnungen mit Python müssen Feldnamen in Ausrufezeichen eingeschlossen werden (z. B. !fieldname!).

Bei Berechnungen mit Arcade müssen Feldnamen das Präfix $feature. (beispielsweise $feature.fieldname) erhalten.

Hinweis:

Um Zeitwerte zwischen Feldtypen (Datum, Nur Datum, Nur Zeit, Zeitstempelversatz und Text) zu übertragen, verwenden Sie stattdessen das Werkzeug [Zeitfeld](convert-time-field.yml) konvertieren.
Wenn Sie eine Zeichenfolge für ein Text- oder Zeichenfeld berechnen möchten, muss die Zeichenfolge im Dialogfeld in doppelte Anführungszeichen (z. B. "Zeichenfolge") gesetzt werden, in Skripten dagegen muss die Zeichenfolge zusätzlich in einfache Anführungszeichen eingeschlossen werden (z. B. '"string"').
Wenn Sie einen numerischen Wert für ein Feld berechnen möchten, geben Sie im Parameter Ausdruck nur den numerischen Wert ohne Anführungszeichen an.
Sie können komplexe Ausdrücke mit dem Parameter Code-Block erstellen. Geben Sie den Codeblock direkt im Dialogfeld oder als Zeichenfolge bei der Skripterstellung ein. Der Ausdruck und der Code-Block sind miteinander verbunden. Der Code-Block muss zurück auf den Ausdruck verweisen. Das Ergebnis des Code-Blocks muss an den Ausdruck übergeben werden.

Der Parameter Code-Block wird nur für Python-Ausdrücke unterstützt.
Sie können das Python-Modul math und die Formatierung im Code-Block verwenden. Sie können auch weitere Module importieren. Das Modul math enthält neben zahlentheoretischen und Repräsentationsfunktionen auch Potenz- und Logarithmusfunktionen sowie trigonometrische Funktionen, Winkelkonvertierungsfunktionen, hyperbolische Funktionen und mathematische Konstanten. Weitere Informationen zum Modul math finden Sie in der Hilfe von Python.
Zum Berechnen von Geometrieinformationen in Python verwenden Sie Geometry-Objekteigenschaften. Verwenden Sie beispielsweise zum Berechnen der Anzahl der Stützpunkte in einem Feature den Ausdruck !shape!.pointCount!.

Hinweis:

Das Werkzeug Geometrieattribute berechnen berechnen unterstützt ähnliche Berechnungen.

Zum Berechnen der Fläche und Länge in Python verwenden Sie die Methoden getArea und getLength mit einer Methode und einem Einheitstyp.
- Zum Berechnen der geodätischen Fläche von Polygonen in Quadratkilometern verwenden Sie den folgenden Ausdruck:
  
  !shape!.getArea('GEODESIC', 'SQUAREKILOMETERS')!
- Zum Berechnen der planaren Länge von Polylinien (oder Polygonen) in Yards verwenden Sie den folgenden Ausdruck:
  
  !shape!.getLength('PLANAR', 'YARDS')
Weitere Informationen finden Sie unter "ArcPy- Polygon- und Polyline-Objekte".

Weitere Informationen zu Geoverarbeitungswerkzeugen und linearen Einheiten sowie Flächeneinheiten
Beim Arbeiten mit verbundenen Daten können Sie nur Felder aus der Quelltabelle aktualisieren. Sie können keine Felder aus der verbundenen Tabelle aktualisieren. Zum Durchführen einer Berechnung für die verbundene Tabelle führen Sie die Berechnung direkt für die Tabelle durch.
Python-Ausdrücke, bei denen versucht wird, Zeichenfolgenfelder, die NULL enthalten oder einen durch Null geteilten Wert, zu verbinden, geben NULL für diesen Feldwert zurück.
SQL-Ausdrücke ermöglichen schnellere Berechnungen für Feature-Services. Statt Features oder Zeilen einzeln nacheinander zu berechnen, wird eine einzelne Anforderung an den Server gesendet. Dies führt zu schnelleren Berechnungen.

Nur Feature-Services unterstützen SQL-Ausdrücke. Verwenden Sie für andere Formate Python- oder Arcade-Ausdrücke.

Die Verwendung der Option SQL des Parameters Ausdruckstyp unterliegt den folgenden Beschränkungen:
- Die Berechnung von Feldwerten in verbundenen Tabellen wird nicht unterstützt.
- Das Rückgängigmachen von Geoverarbeitungsvorgängen wird nicht unterstützt.

Beschriftung	Erläuterung	Datentyp
Eingabetabelle	Die Tabelle, die die Felder enthält, die mit den neuen Berechnungen aktualisiert werden.	Table View; Raster Layer; Mosaic Layer
Ausdruckstyp	Gibt den zu verwendenden Ausdruckstyp an. Wenn die Eingabe ein Feature-Service ist, lautet der Standardausdruckstyp SQL. Für alle anderen Eingabearten lautet der Standardausdruckstyp Python. Weitere Informationen zu Python-Ausdrücken finden Sie unter "Feld berechnen: Python-Beispiele". Weitere Informationen zu Arcade-Ausdrücken finden Sie unter "ArcGIS Arcade" in der Hilfe für Entwickler. Weitere Informationen zu SQL-Ausdrücken finden Sie unter "Syntax für einen SQL-Ausdruck" und "Berechnen von Feldwerten". Weitere Informationen über VBScript-Ausdrücke finden Sie unter "Feld berechnen – VBScript-Beispiele". Python—Es wird der Ausdruckstyp "Python" verwendet. Arcade—Es wird der Ausdruckstyp "ArcGIS Arcade" verwendet. SQL—Es wird der SQL-Ausdruckstyp verwendet. VBScript (Veraltet)—Es wird der Ausdruckstyp "VBScript" verwendet.	String
Felder	Die Felder, die berechnet werden sollen, die Ausdrücke, die berechnet werden sollen, und optionale WHERE-Klauseln und Feldtypen. Der optionale SQL-Ausdruck wird zum Auswählen einer Teilmenge der Datensätze verwendet. Nur Datensätze, die mit dieser WHERE-Klausel übereinstimmen, werden berechnet. Wenn die WHERE-Klausel leer gelassen wird, werden alle Datensätze berechnet. Weitere Informationen zur SQL-Syntax finden Sie unter "SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke". Wenn unter dem angegebenen Namen kein Feld in der Eingabetabelle vorhanden ist, wird ein entsprechendes Feld hinzugefügt. Der Typ des Feldes wird anhand des Wertes für den Feldtyp festgelegt. Wird der Feldtyp nicht angegeben, wird das Feld als Textfeld hinzugefügt. Spalten der Wertetabelle: Field Name (Existing or New)—The field that will be updated with the new calculation. If a field with the specified name does not exist in the input table, it will be added. Expression—The expression that will be used to create a value that will populate the selected rows. Where Clause—The SQL expression that will be used to select a subset of records. Field Type—Specifies the field type of the new field. This value is only used when the field name does not exist in the input table. Short (16-bit integer)—The field type will be short. Short fields support whole numbers between -32,768 and 32,767. Long (32-bit integer)—The field type will be long. Long fields support whole numbers between -2,147,483,648 and 2,147,483,647. Big integer (64-bit integer)—The field type will be big integer. Big integer fields support whole numbers between -(253) and 253. Float (32-bit floating point)—The field type will be float. Float fields support fractional numbers between -3.4E38 and 1.2E38. Double (64-bit floating point)—The field type will be double. Double fields support fractional numbers between -2.2E308 and 1.8E308. Text—The field type will be text. Text fields support a string of characters. Date—The field type will be date. Date fields support date and time values. Date (high precision)—The field type will be high precision date. High precision date fields support date and time values with millisecond time. Date only—The field type will be date only. Date only fields support date values with no time values. Time only—The field type will be time only. Time only fields support time values with no date values. Timestamp offset—The field type will be timestamp offset. Timestamp offset fields support a date, time, and offset from a UTC value. BLOB (binary data)—The field type will be BLOB. BLOB fields support data stored as a long sequence of binary numbers. You need a custom loader or viewer or a third-party application to load items into a BLOB field or view the contents of a BLOB field. GUID (globally unique identifier)—The field type will be GUID. GUID fields store registry-style strings consisting of 36 characters enclosed in curly brackets. Raster—The field type will be raster. Raster fields can store raster data in or alongside the geodatabase. All ArcGIS software-supported raster dataset formats can be stored, but it is recommended that only small images be used.	Value Table
Code-Block (Optional)	Ein Block mit Code, der für komplexe Ausdrücke verwendet wird. Zum Zurückgeben von mehreren Werten kann keine Funktion verwendet werden.	String
Domänen erzwingen (Optional)	Gibt an, ob Felddomänenregeln erzwungen werden. Aktiviert—Felddomänenregeln werden erzwungen. Deaktiviert—Felddomänenregeln werden nicht erzwungen. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabetabelle	Die aktualisierte Tabelle.	Table View; Raster Layer; Mosaic Layer

arcpy.management.CalculateFields(in_table, expression_type, fields, {code_block}, {enforce_domains})

Name	Erläuterung	Datentyp
in_table	Die Tabelle, die die Felder enthält, die mit den neuen Berechnungen aktualisiert werden.	Table View; Raster Layer; Mosaic Layer
expression_type	Gibt den zu verwendenden Ausdruckstyp an. Wenn die Eingabe ein Feature-Service ist, lautet der Standardausdruckstyp `SQL`. Für alle anderen Eingabearten lautet der Standardausdruckstyp `PYTHON3`. Weitere Informationen zu Python-Ausdrücken finden Sie unter "Feld berechnen: Python-Beispiele". Weitere Informationen zu Arcade-Ausdrücken finden Sie unter "ArcGIS Arcade" in der Hilfe für Entwickler. Weitere Informationen zu SQL-Ausdrücken finden Sie unter "Syntax für einen SQL-Ausdruck" und "Berechnen von Feldwerten". Weitere Informationen über VBScript-Ausdrücke finden Sie unter "Feld berechnen – VBScript-Beispiele". `PYTHON3`—Es wird der Ausdruckstyp "Python" verwendet. `ARCADE`—Es wird der Ausdruckstyp "ArcGIS Arcade" verwendet. `SQL`—Es wird der SQL-Ausdruckstyp verwendet. `VB`—Es wird der Ausdruckstyp "VBScript" verwendet.	String
fields [[Field Name, Expression, {Where Clause}, {Field Type}],...]	Die Felder, die berechnet werden sollen, die Ausdrücke, die berechnet werden sollen, und optionale WHERE-Klauseln und Feldtypen. Der optionale SQL-Ausdruck wird zum Auswählen einer Teilmenge der Datensätze verwendet. Nur Datensätze, die mit dieser WHERE-Klausel übereinstimmen, werden berechnet. Wenn die WHERE-Klausel leer gelassen wird, werden alle Datensätze berechnet. Weitere Informationen zur SQL-Syntax finden Sie unter "SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke". Wenn unter dem angegebenen Namen kein Feld in der Eingabetabelle vorhanden ist, wird ein entsprechendes Feld hinzugefügt. Der Typ des Feldes wird anhand des Wertes für den Feldtyp festgelegt. Wird der Feldtyp nicht angegeben, wird das Feld als Textfeld hinzugefügt. Spalten der Wertetabelle: `Field Name`—The field that will be updated with the new calculation. If a field with the specified name does not exist in the input table, it will be added. `Expression`—The expression that will be used to create a value that will populate the selected rows. `Where Clause`—The SQL expression that will be used to select a subset of records. `Field Type`—Specifies the field type of the new field. This value is only used when the field name does not exist in the input table. `SHORT`—The field type will be short. Short fields support whole numbers between -32,768 and 32,767. `LONG`—The field type will be long. Long fields support whole numbers between -2,147,483,648 and 2,147,483,647. `BIGINTEGER`—The field type will be big integer. Big integer fields support whole numbers between -(253) and 253. `FLOAT`—The field type will be float. Float fields support fractional numbers between -3.4E38 and 1.2E38. `DOUBLE`—The field type will be double. Double fields support fractional numbers between -2.2E308 and 1.8E308. `TEXT`—The field type will be text. Text fields support a string of characters. `DATE`—The field type will be date. Date fields support date and time values. `DATEHIGHPRECISION`—The field type will be high precision date. High precision date fields support date and time values with millisecond time. `DATEONLY`—The field type will be date only. Date only fields support date values with no time values. `TIMEONLY`—The field type will be time only. Time only fields support time values with no date values. `TIMESTAMPOFFSET`—The field type will be timestamp offset. Timestamp offset fields support a date, time, and offset from a UTC value. `BLOB`—The field type will be BLOB. BLOB fields support data stored as a long sequence of binary numbers. You need a custom loader or viewer or a third-party application to load items into a BLOB field or view the contents of a BLOB field. `GUID`—The field type will be GUID. GUID fields store registry-style strings consisting of 36 characters enclosed in curly brackets. `RASTER`—The field type will be raster. Raster fields can store raster data in or alongside the geodatabase. All ArcGIS software-supported raster dataset formats can be stored, but it is recommended that only small images be used.	Value Table
code_block (Optional)	Ein Block mit Code, der für komplexe Ausdrücke verwendet wird. Zum Zurückgeben von mehreren Werten kann keine Funktion verwendet werden.	String
enforce_domains (Optional)	Gibt an, ob Felddomänenregeln erzwungen werden. `ENFORCE_DOMAINS`—Felddomänenregeln werden erzwungen. `NO_ENFORCE_DOMAINS`—Felddomänenregeln werden nicht erzwungen. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_table	Die aktualisierte Tabelle.	Table View; Raster Layer; Mosaic Layer

Codebeispiel

CalculateFields: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion CalculateFields im unmittelbaren Modus mit dem Ausdruckstyp Python verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data/airport.gdb"
arcpy.management.CalculateFields("parcels", "PYTHON3",
                                 [["xCentroid", "!SHAPE.CENTROID.X!"],
                                  ["yCentroid", "!SHAPE.CENTROID.Y!"]])

CalculateFields: Beispiel 2 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion CalculateFields im unmittelbaren Modus mit dem Ausdruckstyp SQL verwendet wird.

import arcpy
arcpy.management.CalculateFields("<a feature service url>", "SQL",
                                 [["ceiling_field", "CEILING(field1)"],
                                  ["floor_field", "FLOOR(field1)"]])

CalculateFields: Beispiel 3 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion CalculateFields im unmittelbaren Modus mit dem Ausdruckstyp Arcade verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data/airport.gdb"
arcpy.management.CalculateFields(
    "parcels", "ARCADE",
    [["max_value", "Max($feature.field1, $feature.field2)"],
     ["min_value", "Min($feature.field1, $feature.field2)"]])

CalculateFields: Beispiel 4 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion CalculateFields mit SQL-Ausdrücken verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data/airport.gdb"

# Calculate the Field1 field to -1 if the value is null.
# Calculate the Title field to remove any leading spaces if the first character
# is a space.
arcpy.management.CalculateFields(
    "parcels", "PYTHON3",
    [['Field1', -1, "Field1 IS NULL"],
     ['Title', '!Address!.lstrip()', "Title LIKE ' %'"]])

Umgebungen

Global-IDs beibehalten

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Felder berechnen (mehrere) (Data Management Tools)

Zusammenfassung

Verwendung

Achtung:

Achtung:

Hinweis:

Hinweis:

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen