Resumen
Une permanentemente el contenido de una tabla a otra tabla basándose en un campo de atributos común. La tabla de entrada se actualiza para contener los campos de la tabla a unir. Puede seleccionar qué campos de la tabla a unir se agregarán a la tabla de entrada.
Los registros de la Tabla de entrada se hacen coincidir con los registros de la Tabla a unir basándose en los valores de los parámetros Campo de unión de entrada y Campo de tabla de unión. Opcionalmente, puede seleccionar campos concretos de la Tabla a unir que se va a anexar a la Tabla de entrada durante la unión.
Uso
La Tabla de entrada puede ser una clase de entidad (incluyendo shapefile) o una tabla.
Se mantendrán todos los campos de la Tabla de entrada durante la unión. Opcionalmente, puede seleccionar campos concretos de la Tabla a unir para agregarlos a la salida. Esto se puede activar en el parámetro Campos de transferencia.
Los registros de la Tabla a unir pueden coincidir con más de un registro de la Tabla de entrada.
Si no hay campos seleccionados para el parámetro opcional Campos de transferencia, se unirán todos los campos de la Tabla a unir a la salida.
Las uniones pueden estar basadas en campos de tipo texto, fecha o número.
Las uniones basadas en campos de texto distinguen entre mayúsculas y minúsculas.
Los campos de formatos de número distinto se pueden unir siempre y cuando los valores sean iguales. Por ejemplo, un campo de tipo flotante se puede unir a un campo de entero corto.
El Campo de unión de entrada y el Campo de Tabla de unión pueden tener nombres distintos.
Si un campo de unión tiene el mismo nombre que un campo de la tabla de entrada, el campo unido se incorporará con _1 (o _2, _3, etc.) para que sea único.
Si los valores del Campo de tabla de unión no son únicos, solo se utilizará la primera ocurrencia de cada valor.
- Para dar cuenta de los valores de la tabla a unir que no sean la primera ocurrencia, comience por ejecutar la herramienta Resumen de estadísticas utilizando la Tabla a unir como entrada. El Resumen de estadísticas le permite resumir campos (por ejemplo, suma, valor medio, mínimo).
- Para fusionar dos o más campos en la tabla a unir antes de la unión, primero exporte la tabla o clase de entidad utilizando la herramienta De tabla a tabla. Luego fusiónelos mediante el uso del mapa de campo de la herramienta.
La herramienta Validar unión se puede utilizar para validar una unión entre dos capas o tablas con el fin de determinar si las capas o tablas tienen nombres de campo y campos ObjectID válidos, si la unión produce registros coincidentes, si es una unión de uno a uno o de uno a muchos y otras propiedades de la unión.
El cuadro de diálogo de esta herramienta contiene un botón para validar la unión que facilita esta operación.
Sintaxis
arcpy.management.JoinField(in_data, in_field, join_table, join_field, {fields})
Parámetro | Explicación | Tipo de datos |
in_data | Tabla o clase de entidad a la cual se unirá la tabla a unir. | Mosaic Layer; Raster Layer; Table View |
in_field | Campo de la tabla de entrada en el cual se basará la unión. | Field |
join_table | Tabla que se unirá a la tabla de entrada. | Mosaic Layer; Raster Layer; Table View |
join_field | El campo en la tabla a unir que contiene los valores sobre los cuales se basará la unión. | Field |
fields [fields,...] (Opcional) | Campos de la tabla a unir que se transferirán a la tabla de entrada basándose en una unión entre la tabla de entrada y la tabla a unir. | Field |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_layer_or_view | El dataset de entrada actualizado. | Vista de tabla; Capa ráster; Capa de mosaico |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función JoinField en modo inmediato.
import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.JoinField_management("zion_park", "zonecode", "zion_zoning", "zonecode",
["land_use", "land_cover"])
Esta secuencia de comandos Python independiente muestra la función JoinField utilizada para unir una tabla a una clase de entidad y solo incluye dos de los campos de la tabla en la unión.
# PermanentJoin.py
# Purpose: Join two fields from a table to a feature class
# Import system modules
import arcpy
# Set the current workspace
arcpy.env.workspace = "c:/data/data.gdb"
# Set the local parameters
inFeatures = "zion_park"
joinField = "zonecode"
joinTable = "zion_zoning"
fieldList = ["land_use", "land_cover"]
# Join two feature classes by the zonecode field and only carry
# over the land use and land cover fields
arcpy.JoinField_management(inFeatures, joinField, joinTable, joinField,
fieldList)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí