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

EtiquetaExplicaciónTipo 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 unoLa 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 muchosLa 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 muchosLa 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

EtiquetaExplicaciónTipo de datos
Capa de entrada o vista de tabla actualizadas

El dataset de entrada actualizado.

Table View; Raster Layer; Mosaic Layer

arcpy.management.AddRelate(in_layer_or_view, in_field, relate_table, relate_field, relate_name, {cardinality})
NombreExplicaciónTipo 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_ONELa 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_MANYLa 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_MANYLa 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

NombreExplicaciónTipo 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")

Información de licenciamiento

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

Temas relacionados