Etiqueta | Explicación | Tipo de datos |
Tabla de entrada | La tabla de entrada que contiene las filas que se exportarán a una tabla nueva. | Table View; Raster Layer |
Tabla de Salida | La tabla de salida que contiene las filas exportadas. Si la ubicación de salida es una carpeta, incluya una extensión como .csv, .txt o .dbf para exportar la tabla al formato correspondiente. Si la ubicación de salida es una geodatabase, no especifique ninguna extensión. | Table |
Expresión (Opcional) | Una expresión de SQL utilizada para seleccionar un subconjunto de registros. | SQL Expression |
Utilizar alias de campo como nombre | Especifica si los nombres de campo o alias de campo de entrada se utilizarán como el nombre 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 fusionarán o se combinarán en un único valor de salida. Las siguientes reglas de combinación se pueden usar para determinar cómo se rellenará con valores el campo de salida:
| 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.
| Value Table |
Resumen
Exporta las filas de una tabla o vista de tabla a una tabla.
Uso
La herramienta copia las filas de una tabla, vista de tabla, clase de entidad, capas de entidad, archivos delimitado o rásteres con una tabla de atributos a una nueva geodatabase o tabla dBASE o un archivo delimitado.
Esta herramienta soporta los siguientes formatos de tabla como entrada:
- Geodatabase
- dBASE (.dbf)
- Hojas de cálculo de Microsoft Excel (.xls y .xlsx)
- Tablas basadas en memoria
- Archivos delimitados
- Archivos delimitados por comas (.csv, .txt y .asc)
- Archivos delimitados por tabuladores (.tsv y .tab)
- Archivos delimitados por barras verticales (.psv)
Para los archivos delimitados, la primera fila del archivo de entrada se utiliza como los nombres de los campos en la tabla de salida. Los nombres de campo no pueden contener espacios ni caracteres especiales (como $ o *) y se producirá un error si la primera fila del archivo de entrada contiene espacios o caracteres especiales.
La herramienta se puede utilizar para generar un archivo delimitado agregando una de las siguientes extensiones de archivo al nombre de salida en un espacio de trabajo de carpeta:
- Archivos delimitados por comas (.csv, .txt o .asc)
- Archivos delimitados por tabulaciones (.tsv o .tab)
- Archivos delimitados por barras verticales (.psv)
Si la salida no se encuentra en una geodatabase, los campos BLOB o de ráster no se incluirán. Los campos GlobalID se convertirán en campos de texto.
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.
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 los datos de la geodatabase que tiene subtipos o dominios y el espacio de trabajo de salida no es una geodatabase, tanto el subtipo como las descripciones y los códigos de dominio pueden ser incluidos 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 una tabla dBASE con descripciones de dominio y subtipo puede tardar más (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
arcpy.conversion.ExportTable(in_table, out_table, {where_clause}, use_field_alias_as_name, {field_mapping}, {sort_field})
Nombre | Explicación | Tipo de datos |
in_table | La tabla de entrada que contiene las filas que se exportarán a una tabla nueva. | Table View; Raster Layer |
out_table | La tabla de salida que contiene las filas exportadas. Si la ubicación de salida es una carpeta, incluya una extensión como .csv, .txt o .dbf para exportar la tabla al formato correspondiente. Si la ubicación de salida es una geodatabase, no especifique ninguna extensión. | Table |
where_clause (Opcional) | Una expresión de SQL utilizada para seleccionar un subconjunto de registros. 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 | Especifica si los nombres de campo o alias de campo de entrada se utilizarán como el nombre 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 fusionarán o se combinarán en un único valor de salida. Las siguientes reglas de combinación se pueden usar para determinar cómo se rellenará con valores el campo de salida:
| 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.
| Value Table |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función ExportTable de modo inmediato.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.ExportTable("vegtable.dbf", "C:/output/output.gdb/vegtable")
El siguiente script independiente muestra cómo utilizar la función ExportTable.
# Description: Use TableToTable with an expression to create a subset
# of the original table.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inTable = "vegtable.dbf"
outTable = "C:/output/output.gdb/estuarine.csv"
# Set the expression, with help from the AddFieldDelimiters function, to select
# the appropriate field delimiters for the data type
expression = arcpy.AddFieldDelimiters(arcpy.env.workspace, "VEG_TYPE") + " = 'Estuarine'"
# Run TableToTable
arcpy.conversion.ExportTable(inTable, outTable, expression, "NOT_USE_ALIAS")
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí