Eliminar entidades (Administración de datos)

Resumen

Elimina todas o el subconjunto seleccionado de filas desde la entrada.

Si las entidades de entrada son de una clase de entidad, se eliminarán todas las filas. Si las entidades de entrada son de una capa sin selección, se eliminarán todas las entidades.

Uso

  • Esta herramienta acepta capas con selecciones como entrada y eliminará únicamente las entidades que estén seleccionadas. Para eliminar entidades específicas de una clase de entidad, convierta la clase de entidad en una capa utilizando Crear capa de entidades o agregándola a la visualización. Se puede aplicar una selección utilizando las herramientas Seleccionar capa por atributo o Seleccionar capa por ubicación, consultando una capa de mapa o seleccionando entidades de forma interactiva utilizando las herramientas de selección del grupo Selección en la pestaña Mapa.

  • Si la entrada es una capa y esa capa no tiene una selección, se eliminarán todas las entidades. Si se introduce una clase de entidad, todas las entidades se eliminarán.

    Nota:

    Eliminar todas las filas de una clase de entidad con un gran número de filas puede ser lento. Si su intención es eliminar todas las filas en la clase de entidad, plantéese la posibilidad de utilizar la herramienta Truncar tabla en su lugar. Consulte la documentación de Truncar tabla para conocer declaraciones importantes de prevención sobre su uso.

  • Esta herramienta elimina la geometría y los atributos de las Entidades de entrada.

  • El entorno Extensión se distingue por esta herramienta. Solo las entidades que se encuentran dentro de o intersecan el entorno de la extensión de salida se eliminarán. Si la capa de entrada tiene una selección, solo las entidades seleccionadas que están dentro o intersecan la extensión de salida se eliminarán.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Clase de entidad, shapefile o capa que contiene las entidades que se eliminarán.

Feature Layer

Salida derivada

EtiquetaExplicaciónTipo de datos
Clase de entidad de salida

La clase de entidad actualizada.

Feature Layer

arcpy.management.DeleteFeatures(in_features)
NombreExplicaciónTipo de datos
in_features

Clase de entidad, shapefile o capa que contiene las entidades que se eliminarán.

Feature Layer

Salida derivada

NombreExplicaciónTipo de datos
out_feature_class

La clase de entidad actualizada.

Feature Layer

Muestra de código

Ejemplo 1 de DeleteFeatures (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función DeleteFeatures de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.CopyFeatures("majorrds.shp", "C:/output/output.gdb/majorrds2")
arcpy.management.DeleteFeatures("C:/output/output.gdb/majorrds2")
Ejemplo 2 de DeleteFeatures (script independiente)

El siguiente script independiente demuestra cómo utilizar la función DeleteFeatures para eliminar las entidades basadas en una expresión.

# Name: DeleteFeatures_Example2.py
# Description: Delete features from a feature class based on an expression
 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inFeatures = "parcels"
outFeatures = "C:/output/output.gdb/new_parcels"
tempLayer = "parcelsLayer"
expression = arcpy.AddFieldDelimiters(tempLayer, "PARCEL_ID") + " = 'Cemetery'"
 

# Run CopyFeatures to make a new copy of the feature class
arcpy.management.CopyFeatures(inFeatures, outFeatures)
 
# Run MakeFeatureLayer
arcpy.management.MakeFeatureLayer(outFeatures, tempLayer)
 
# Run SelectLayerByAttribute to determine which features to delete
arcpy.management.SelectLayerByAttribute(tempLayer, "NEW_SELECTION", 
                                        expression)
 
# Run GetCount and if some features have been selected, then 
#  run DeleteFeatures to remove the selected features.
if int(arcpy.management.GetCount(tempLayer)[0]) > 0:
    arcpy.management.DeleteFeatures(tempLayer)

Entornos

Casos especiales

Extensión

Sólo se eliminarán las entidades que estén en la extensión o la intersequen.