De tabla a tabla (Conversión)

Resumen

Exporta las filas de una tabla a una tabla diferente.

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)
    • Microsoft Excel hojas de cálculo (.xls y .xlsx)
    • Tablas basadas en memoria
    • Archivos delimitados
      • Archivos delimitados por comas (.csv, .txt y .asc)
      • Archivos delimitados por tabulaciones (.tsv y .tab)
      • Archivos delimitados por canalizaciones (.psv)

    Para los archivos delimitados, la primera fila del archivo de entrada se utiliza como los nombres de campo 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 canalizaciones (.psv)

  • 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

  • Al convertir los datos de la geodatabase que tiene subtipos o dominios dominios en una tabla dBASE, tanto el subtipo como las descripciones y los códigos del dominio se pueden incluir en la salida. Utilice el entorno de geoprocesamiento Transferir las 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 necesita las descripciones de subtipo y dominio en la salida de la tabla dBASE, se recomienda que utilice el comportamiento predeterminado desactivado del entorno Transferir descripciones de dominio de campo para lograr el mejor rendimiento.

Parámetros

EtiquetaExplicaciónTipo de datos
Filas de entrada

La tabla de entrada que se exportará a una tabla nueva.

Table View; Raster Layer
Localización de salida

El destino en el que se escribirá la tabla de salida.

Workspace
Nombre de salida

El nombre de la tabla de salida.

Si la ubicación de salida es una carpeta, incluya una extensión como .csv, .txt o .dbf para exportar la tabla al formato especificado. Si la ubicación de salida es una geodatabase, no especifique ninguna extensión.

String
Expresión
(Opcional)

Una expresión de SQL que se utilizará para seleccionar un subconjunto de registros.

SQL Expression
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
Palabra clave de configuración
(Opcional)

Especifica los parámetros de almacenamiento predeterminados (configuraciones) para las geodatabases en un sistema de administración de bases de datos relacionales (RDBMS). Esta configuración solo se aplica cuando se usan tablas de geodatabases corporativas.

El administrador de base de datos establece las palabras clave de configuración.

Más información sobre las palabras clave de configuración

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Tabla de Salida

La tabla de salida.

Table

arcpy.conversion.TableToTable(in_rows, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})
NombreExplicaciónTipo de datos
in_rows

La tabla de entrada que se exportará a una tabla nueva.

Table View; Raster Layer
out_path

El destino en el que se escribirá la tabla de salida.

Workspace
out_name

El nombre de la tabla de salida.

Si la ubicación de salida es una carpeta, incluya una extensión como .csv, .txt o .dbf para exportar la tabla al formato especificado. Si la ubicación de salida es una geodatabase, no especifique ninguna extensión.

String
where_clause
(Opcional)

Una expresión de SQL que se utilizará para seleccionar un subconjunto de registros.

Más información sobre las expresiones de consulta SQL

SQL Expression
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.

En Python, puede utilizar la clase FieldMappings para definir este parámetro.

Field Mappings
config_keyword
(Opcional)

Especifica los parámetros de almacenamiento predeterminados (configuraciones) para las geodatabases en un sistema de administración de bases de datos relacionales (RDBMS). Esta configuración solo se aplica cuando se usan tablas de geodatabases corporativas.

El administrador de base de datos establece las palabras clave de configuración.

Más información sobre las palabras clave de configuración

String

Salida derivada

NombreExplicaciónTipo de datos
out_table

La tabla de salida.

Table

Muestra de código

Ejemplo 1 de TableToTable (ventana Python)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.TableToTable_conversion("vegtable.dbf", "C:/output/output.gdb", "vegtable")
Ejemplo 2 de TableToTable (script independiente)

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

# 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"
outLocation = "C:/output/output.gdb"
outTable = "estuarine"

# 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'"
 
# Execute TableToTable
arcpy.TableToTable_conversion(inTable, outLocation, outTable, expression)

Información de licenciamiento

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

Temas relacionados