De tabla a tabla (Conversión)

Resumen

Exporta las filas de una tabla a una tabla diferente.

Heredado:

Esta es una herramienta obsoleta. Esta función se ha reemplazado por la herramienta Exportar tabla.

Uso

  • La herramienta copia las filas de una tabla, vista de tabla, clase de entidad, capa de entidades, archivos delimitados 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.

  • Si el valor del parámetro Ubicación de 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.

  • 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)

  • Use el parámetro Mapa de campo para gestionar los campos y su contenido en el dataset de salida.

    • Añada y elimine campos de la lista de campos, reordene la lista de campos y cambie el nombre de los campos.
    • 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. Puede cambiar el tipo de datos a otro tipo de datos válido.
    • Use una acción para determinar cómo los valores de uno o varios campos de entrada se mezclarán en un solo campo de salida. Las acciones disponibles son Primera, Última, Concatenación, Suma, Valor medio, Mediana, Modo, Mínimo, Máximo, Desviación estándar y Recuento.
    • Al usar la acción Concatenar, pude especificar un delimitador tal como una coma u otro carácter. Haga clic en el inicio del cuadro de texto Delimitador para añadir los caracteres delimitadores.
    • Desviación estándar no es una opción válida para los valores de entrada únicos.
    • Use el botón Trocear texto en los campos de origen de texto para seleccionar qué caracteres de un valor de entrada se extraerán al campo de salida. Para acceder al botón Trocear texto, pase el cursor del ratón por encima de un campo de texto de la lista de campos de entrada; a continuación, especifique las posiciones de los caracteres de inicio y fin.
    • Los campos también se pueden asignar mediante scripts de Python.

  • 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 descripciones de dominio de campo para ello. 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 llevar más tiempo (un rendimiento más lento) que sin descripciones. Si no se necesitan descripciones de subtipo y dominio en la salida de la tabla dBASE, deje desactivado el entorno Transferir descripciones de dominio de campo para obtener 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 que se transferirán al dataset de salida con sus respectivas propiedades y campos de origen. De manera predeterminada, la salida incluirá todos los campos del dataset de entrada.

Use el campo de mapa para añadir, borrar, cambiar el nombre y reordenar los campos, así como para cambiar otras propiedades de los campos.

El mapa de campo también puede usarse para combinar valores de dos o más campos de entrada en un solo campo de salida.

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.

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.

SQL Expression
field_mapping
(Opcional)

Los campos que se transferirán al dataset de salida con sus respectivas propiedades y campos de origen. De manera predeterminada, la salida incluirá todos los campos del dataset de entrada.

Use el campo de mapa para añadir, borrar, cambiar el nombre y reordenar los campos, así como para cambiar otras propiedades de los campos.

El mapa de campo también puede usarse para combinar valores de dos o más campos de entrada en un solo campo de salida.

En Python, utilice la clase de 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.

String

Salida derivada

NombreExplicaciónTipo de datos
out_table

La tabla de salida.

Table

Muestra de código

Ejemplo 1 de TableToTable (ventana Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función TableToTable de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.TableToTable("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'"
 
# Run TableToTable
arcpy.conversion.TableToTable(inTable, outLocation, outTable, expression)