Agregar relación (Administración de datos)

Resumen

Relaciona una capa con otra capa o tabla basada en un valor de campo. Se admiten capas de entidades, vistas de tabla y capas ráster con una tabla de atributos ráster.

Los registros de la Tabla de relación se cotejan con los registros del Nombre de capa o Vista de tabla de entrada. Se produce una concordancia cuando el campo de relación de entrada es igual que el campo de relación de salida. Con la relación no se modifican datos; son una propiedad de la capa.

Uso

• Si la entrada es una clase de entidad o una ruta de dataset, esta herramienta creará y devolverá automáticamente una nueva capa con el resultado de la herramienta aplicada.

• Los registros de la Tabla de relación se pueden cotejar con más de un registro de la vista de capa o tabla de entrada.

• La Tabla de relación puede ser una tabla de geodatabase o un archivo dBASE. No es necesario que la Tabla de relación sea una capa.

• La entrada debe tener un campo ObjectID. No es necesario que la Tabla de relación contenga un campo ObjectID.

• Para guardar la relación y utilizarla en otro proyecto, guarde la capa en un archivo de capa con la herramienta Guardar capa en archivo. Esto sólo se aplica a las capas; las vistas de tablas no se pueden guardar de esta forma.

• Para crear una relación permanente, utilice la herramienta Crear clase de relación.

• Indexar los campos de la capa o vista de tabla de entrada y de la Tabla de relación sobre la que se basará la relación puede mejorar el rendimiento. Esto se puede realizar con la herramienta Agregar índice de atributos.

Sintaxis

arcpy.management.AddRelate(in_layer_or_view, in_field, relate_table, relate_field, relate_name, {cardinality})

Parámetro	Explicación	Tipo de datos
in_layer_or_view	Capa o vista de tabla con la que se relacionará la tabla de relación.	Mosaic Layer; Raster Layer; Table View
in_field	Campo de la capa o vista de tabla de entrada sobre el que se basará la relación.	Field
relate_table	Tabla o vista de tabla que se relacionará con la capa o vista de tabla de entrada.	Mosaic Layer; Raster Layer; Table View
relate_field	El campo de la tabla de relación que contiene los valores sobre los cuales se basará la relación.	Field
relate_name	El nombre único asignado a una relación.	String
cardinality (Opcional)	La cardinalidad de la relación. ONE_TO_ONE —Especifica que la relación entre la tabla de entrada y la tabla relacionada es de uno a uno. Por ejemplo, un registro de la tabla de entrada solo tendrá un registro coincidente en la tabla relacionada. ONE_TO_MANY —Especifica que la relación entre la tabla de entrada y la tabla relacionada es de uno a muchos. Por ejemplo, un registro de la tabla de entrada puede tener varios registros coincidentes en la tabla relacionada. Esta es la opción predeterminada. MANY_TO_MANY —Especifica que la relación entre la tabla de entrada y la tabla relacionada es de muchos a muchos. Por ejemplo, muchos registros con el mismo valor de la tabla de entrada pueden tener varios registros coincidentes en la tabla relacionada.	String

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

Ejemplo 1 de AddRelate (ventana de Python)

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

import arcpy
relate = arcpy.AddRelate_management("Parcel", "ParcelID", "owner_table", 
                                    "ParcelID", "Owner2Parcel")

Entornos

Espacio de trabajo actual

Información de licenciamiento

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