Exportar entidades (Conversión)

Resumen

Exporta las filas de una clase de entidad o capa de entidades a una clase de entidad.

Uso

  • Para administrar los campos del dataset de salida y el contenido de esos campos, utilice el parámetro Mapa de campo.

    • Para cambiar el orden de campos, seleccione un nombre de campo y arrástrelo a la nueva posición.
    • El tipo de datos predeterminado de un campo de salida coincide con el tipo de datos del primer campo de entrada (de ese nombre) que encuentre. El tipo de datos se puede cambiar por cualquier otro tipo de datos válido de forma manual en cualquier momento.
    • Están disponibles las siguientes reglas de fusión: primero, último, unir, suma, valor medio, mediana, modo, mínimo, máximo, desviación estándar y recuento.
    • Cuando utiliza la regla de fusión Unir, puede especificar un delimitador como un espacio, una coma, un punto, un guion, etc. Para utilizar un espacio, asegúrese de que el puntero del ratón esté al comienzo del cuadro de entrada y pulse la barra espaciadora una vez.
    • Puede especificar las posiciones inicial y final de los campos de texto usando la opción de formato.
    • No realice la desviación estándar en una sola entrada, ya que los valores no se pueden dividir por cero, por lo que esta no es una opción válida para las entradas individuales.

    Más información sobre la asignación de campos en scripts

  • Se puede emplear una expresión SQL para seleccionar un subconjunto de entidades. Para obtener más información sobre la sintaxis del parámetro Expresión, consulte Referencia de SQL para las expresiones de consulta utilizadas en ArcGIS.

  • Las filas se pueden reordenar en orden ascendente o descendente especificando el valor del parámetro Campo de ordenación. Si se especifica más de un campo, las filas se ordenarán por el primer campo y, dentro de ese orden, por el segundo campo y así sucesivamente.

  • Al convertir datos de geodatabase que tienen subtipos o dominios, tanto las descripciones como los códigos de subtipo y dominio se pueden incluir en la salida. Utilice el entorno Transferir descripciones de dominio de campo para controlar este comportamiento. De forma predeterminada, solo los códigos de dominio y de subtipo se incluirán en la salida, no las descripciones.

    Nota:

    La conversión a shapefiles con descripciones de dominio y subtipo puede tomar más tiempo (un rendimiento más lento) que sin descripciones. Si no se necesitan descripciones de subtipo y dominio en la salida, se recomienda que utilice la configuración predeterminada (desactivada) para el entorno Transferir descripciones de dominio de campo para obtener el mejor rendimiento.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades de entrada que se exportarán a una nueva clase de entidad.

Feature Layer
Clase de entidad de salida

La clase de entidad de salida que contiene las entidades exportadas.

Feature Class
Expresión
(Opcional)

Una expresión SQL utilizada para seleccionar un subconjunto de entidades.

SQL Expression
Utilizar alias de campo como nombre
(Opcional)

Especifica si los nombres de campo o alias de campo de entrada se utilizarán como el nombre de campo de salida.

  • Desactivado: se utilizarán los nombres de campo de la entrada como nombres de campo de salida. Esta es la opción predeterminada.
  • Activado: se utilizarán los alias de campo de entrada como nombres de campo de salida.
Boolean
Mapa de campo
(Opcional)

Los campos de atributo que estarán en la salida con las propiedades de campo y los campos de origen correspondientes. De forma predeterminada se incluirán todos los campos de las entradas.

Se puede añadir, eliminar y reordenar los campos, además de cambiar su nombre y sus propiedades.

Las reglas de fusión le permiten especificar cómo los valores de dos o más campos de entrada se fusionan o se combinan en un único valor de salida. Hay varias reglas de fusión que puede utilizar para determinan cómo se rellena con valores el campo de salida.

  • Primero: utilizar el primer valor de los campos de entrada.
  • Último: utilizar el último valor de los campos de entrada.
  • Unir: concatenar (unir) los valores de los campos de entrada.
  • Sumar: calcular el total de los valores de los campos de entrada.
  • Valor medio: calcular el valor medio (promedio) de los valores de los campos de entrada.
  • Mediana: calcular el valor de la mediana (mitad) de los valores de los campos de entrada.
  • Modo: utilizar el valor con la mayor frecuencia.
  • Mín.: usar el valor mínimo de todos los valores de los campos de entrada.
  • Máx.: usar el valor máximo de todos los valores de los campos de entrada.
  • Desviación estándar: utilizar el método de clasificación de la desviación estándar en todos los valores de campos de entrada.
  • Conteo: buscar la cantidad de registros incluidos en los cálculos.

Field Mappings
Campo de ordenamiento
(Opcional)

Los campos cuyos valores se utilizarán para reordenar los registros de entrada y la dirección en que se ordenarán los registros.

  • Ascendente: los registros se ordenarán del valor bajo al valor alto.
  • Descendente: los registros se ordenarán del valor alto al valor bajo.

Value Table

arcpy.conversion.ExportFeatures(in_features, out_features, {where_clause}, {use_field_alias_as_name}, {field_mapping}, {sort_field})
NombreExplicaciónTipo de datos
in_features

Las entidades de entrada que se exportarán a una nueva clase de entidad.

Feature Layer
out_features

La clase de entidad de salida que contiene las entidades exportadas.

Feature Class
where_clause
(Opcional)

Una expresión SQL utilizada para seleccionar un subconjunto de entidades. Para obtener más información sobre la sintaxis SQL, consulte el tema de ayuda Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.

SQL Expression
use_field_alias_as_name
(Opcional)

Especifica si los nombres de campo o alias de campo de entrada se utilizarán como el nombre de campo de salida.

  • NOT_USE_ALIASSe utilizarán los nombres de campo de la entrada como nombres de campo de salida. Esta es la opción predeterminada.
  • USE_ALIASSe utilizarán los alias de campo de entrada como nombres de campo de salida.
Boolean
field_mapping
(Opcional)

Los campos de atributo que estarán en la salida con las propiedades de campo y los campos de origen correspondientes. De forma predeterminada se incluirán todos los campos de las entradas.

Se puede añadir, eliminar y reordenar los campos, además de cambiar su nombre y sus propiedades.

Las reglas de fusión le permiten especificar cómo los valores de dos o más campos de entrada se fusionan o se combinan en un único valor de salida. Hay varias reglas de fusión que puede utilizar para determinan cómo se rellena con valores el campo de salida.

  • Primero: utilizar el primer valor de los campos de entrada.
  • Último: utilizar el último valor de los campos de entrada.
  • Unir: concatenar (unir) los valores de los campos de entrada.
  • Sumar: calcular el total de los valores de los campos de entrada.
  • Valor medio: calcular el valor medio (promedio) de los valores de los campos de entrada.
  • Mediana: calcular el valor de la mediana (mitad) de los valores de los campos de entrada.
  • Modo: utilizar el valor con la mayor frecuencia.
  • Mín.: usar el valor mínimo de todos los valores de los campos de entrada.
  • Máx.: usar el valor máximo de todos los valores de los campos de entrada.
  • Desviación estándar: utilizar el método de clasificación de la desviación estándar en todos los valores de campos de entrada.
  • Conteo: buscar la cantidad de registros incluidos en los cálculos.

Field Mappings
sort_field
[sort_field,...]
(Opcional)

Los campos cuyos valores se utilizarán para reordenar los registros de entrada y la dirección en que se ordenarán los registros.

  • ASCENDING: los registros se ordenarán del valor bajo al valor alto.
  • DESCENDING: los registros se ordenarán del valor alto al valor bajo.

Value Table

Muestra de código

Ejemplo 1 de ExportFeatures (ventana de Python)

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

import arcpy
arcpy.env.workspace = "C:/data/SFValley.gdb"
arcpy.conversion.ExportTable("streets", "C:/output/output.gdb/streets")
Ejemplo 2 de ExportFeatures (script independiente)

El siguiente script independiente muestra cómo utilizar la función ExportFeatures.

# Name: ExportFeatures_Example2.py
# Description: Use Export Features with an expression to create a subset of the
# original feature class.

# Import system modules

import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/SFValley.gdb"

# Set local variables
inFeatures = "streets"
outFeatureClass =  "C:/output/output.gdb/arterials"
expression = arcpy.AddFieldDelimiters(arcpy.env.workspace, "Category") + " = 'Arterials'"

# Execute ExportFeatures
arcpy.ExportTable_conversion(inFeatures, outFeatureClass, expression,
                             "NOT_USE_ALIAS", None, None)

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados