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, capas o tablas de valores de subtipo y capas ráster con una tabla de atributos ráster.

Los registros del valor del parámetro Tabla de relación coinciden con los registros del valor del parámetro Nombre de capa o Vista de tabla de entrada. La coincidencia se produce cuando un valor de campo del valor del parámetro Campo de relación de entrada y un valor de campo del valor del parámetro Campo de relación de salida son iguales.

Uso

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

• La relación no modifica los datos; la relación es una propiedad de la vista de tabla o capa.

• Los registros de la tabla de relación se pueden cotejar con más de un registro de la capa o vista de 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 Object ID. 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.

• Cuando la capa de entrada tenga una relación y la propiedad Seleccionar automáticamente datos relacionados esté activada, una selección en la capa de entrada también seleccionará registros en la tabla relacionada.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Nombre de capa o vista de tabla	Capa o vista de tabla con la que se relacionará la tabla de relación.	Mosaic Layer; Raster Layer; Table View
Campo de relación de entrada	Campo de clave principal de la capa o vista de tabla de entrada sobre el que se basará la relación.	Field
Tabla de relación	Tabla o vista de tabla que se relacionará con la capa o vista de tabla de entrada.	Mosaic Layer; Raster Layer; Table View
Campo de relación de salida	Cambio de clave externa de la tabla de relación que se utilizará en la coincidencia de la clave principal.	Field
Nombre de relación	Nombre único de una relación.	String
Cardinalidad (Opcional)	Especifica la cardinalidad de la relación. Uno a uno—La relación entre la tabla de entrada y la tabla relacionada será de uno a uno. Por ejemplo, un registro de la tabla de entrada tendrá un solo registro coincidente en la tabla relacionada. Uno a muchos—La relación entre la tabla de entrada y la tabla relacionada será 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. Muchos a muchos—La relación entre la tabla de entrada y la tabla relacionada será 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

Etiqueta	Explicación	Tipo de datos
Capa de entrada o vista de tabla actualizadas	El dataset de entrada actualizado.	Table View; Raster Layer; Mosaic Layer

Python

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

Nombre	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 clave principal 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	Cambio de clave externa de la tabla de relación que se utilizará en la coincidencia de la clave principal.	Field
relate_name	Nombre único de una relación.	String
cardinality (Opcional)	Especifica la cardinalidad de la relación. ONE_TO_ONE—La relación entre la tabla de entrada y la tabla relacionada será de uno a uno. Por ejemplo, un registro de la tabla de entrada tendrá un solo registro coincidente en la tabla relacionada. ONE_TO_MANY—La relación entre la tabla de entrada y la tabla relacionada será 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—La relación entre la tabla de entrada y la tabla relacionada será 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.	Table View; Raster Layer; Mosaic Layer

Muestra de código

Ejemplo 1 de AddRelate (ventana de Python)

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

import arcpy
arcpy.management.AddRelate("Parcel", "ParcelID", "owner_table", "ParcelID", 
                           "Owner2Parcel")

Entornos

Espacio de trabajo actual

Información de licenciamiento

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