Eliminar entidades (Administración de datos)

Resumen

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

La eliminación de todas las entidades o de un subconjunto de ellas depende de lo siguiente:

  • Si la entrada es una clase de entidad, se eliminarán todas las entidades.
  • Si la entrada es una capa sin selección, se eliminarán todas las entidades.
  • Si la entrada es una capa con selección, solo se eliminarán las entidades seleccionadas.

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 la herramienta 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 herramientas de selección del grupo Selección en la pestaña Mapa.

  • Nota:

    Eliminar todas las entidades de una clase de entidad con un gran número de entidades puede llevar algún tiempo. Si la intención es eliminar todas las entidades, considere 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 del valor de 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)

La siguiente secuencia de comandos de la ventana de Python muestra 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.

# 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, 
#  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.