Добавить связь (Управление данными)

Краткая информация

Связывает слой с другим слоем или таблицей на основе значения поля. Поддерживаются векторные слои, представления таблиц, слои значения подтипа или таблицы, и растровые слои с таблицей атрибутов растра.

Записи из значения параметра Связанная таблица сопоставляются с записями в значении параметра Имя слоя или Представление таблицы. Соответствие устанавливается, если значение поля в параметре Входное поле связи и в параметре Выходное поле связи - равны.

Использование

  • Если входные данные представлены классом пространственных объектов или путем к набору данных, этот инструмент будет создавать и возвращать новый слой с результатом примененного инструмента.

  • Связь не изменяют данные; связь является свойством слоя или представления таблицы.

  • Записи из связанной таблицы могут соответствовать нескольким записям входного слоя или представления таблицы.

  • Связанной таблицей может быть таблица базы геоданных или файл dBASE. Связанная таблица не обязательно должна быть слоем.

  • Входные данные должны содержать поле Object ID. Связанная таблица не обязательно должна содержать поле ObjectID.

  • Чтобы сохранить связь для использования в другом проекте, сохраните слой в файл слоя с помощью инструмента Сохранить слой в файл. Это применяется только к слоям, представления таблицы нельзя сохранять таким образом.

  • Если необходимо создать постоянную связь, используйте инструмент Создать класс отношений.

  • Индексация полей во входном слое или представлении таблицы и в связанной таблице, на которых будет основана связь, может повысить производительность. Индексация выполняется с помощью инструмента Добавить атрибутивный индекс.

  • Когда у входного слоя есть отношение и отмечено свойство Автоматически выбирать связанные данные, то выборка во входном слое также приведет к выбору записей в связанной таблице.

Параметры

ПодписьОписаниеТип данных
Имя слоя или представления таблицы

Слой или представление таблицы, с которым будет связываться соответствующая таблица.

Mosaic Layer; Raster Layer; Table View
Входное поле связи

Поле первичного ключа входного слоя или представления таблицы, на котором будет основана связь.

Field
Связанная таблица

Таблица или представление таблицы, которая будет связана со входным слоем или представлением таблицы.

Mosaic Layer; Raster Layer; Table View
Выходное поле связи

Поле внешнего ключа связываемой таблицы, которое будет использовано для сопоставления со значениями поля первичного ключа.

Field
Имя связи

Уникальное имя связи.

String
Кардинальность
(Дополнительный)

Укажите кардинальность отношений.

  • Один-к-одномуОтношение между входной таблицей и связанной таблицей – один-к-одному. Например, одна строка входной таблицы будет связана только с одной соответствующей строкой связанной таблицы.
  • Один-ко-многимОтношение между входной таблицей и связанной – один-ко-многим. Одна строка входной таблицы может соотноситься с несколькими строками связанной таблицы. Это значение по умолчанию
  • Многие-ко-многимОтношение между входной таблицей и связанной таблицей – многие-ко-многим. Несколько строк входной таблицы с одинаковым значением могут соответствовать нескольким строкам в связанной таблице.
String

Производные выходные данные

ПодписьОписаниеТип данных
Обновленный входной слой или представление таблицы

Обновленный входной набор данных.

Table View; Raster Layer; Mosaic Layer

arcpy.management.AddRelate(in_layer_or_view, in_field, relate_table, relate_field, relate_name, {cardinality})
ИмяОписаниеТип данных
in_layer_or_view

Слой или представление таблицы, с которым будет связываться соответствующая таблица.

Mosaic Layer; Raster Layer; Table View
in_field

Поле первичного ключа входного слоя или представления таблицы, на котором будет основана связь.

Field
relate_table

Таблица или представление таблицы, которая будет связана со входным слоем или представлением таблицы.

Mosaic Layer; Raster Layer; Table View
relate_field

Поле внешнего ключа связываемой таблицы, которое будет использовано для сопоставления со значениями поля первичного ключа.

Field
relate_name

Уникальное имя связи.

String
cardinality
(Дополнительный)

Укажите кардинальность отношений.

  • ONE_TO_ONEОтношение между входной таблицей и связанной таблицей – один-к-одному. Например, одна строка входной таблицы будет связана только с одной соответствующей строкой связанной таблицы.
  • ONE_TO_MANYОтношение между входной таблицей и связанной – один-ко-многим. Одна строка входной таблицы может соотноситься с несколькими строками связанной таблицы. Это значение по умолчанию
  • MANY_TO_MANYОтношение между входной таблицей и связанной таблицей – многие-ко-многим. Несколько строк входной таблицы с одинаковым значением могут соответствовать нескольким строкам в связанной таблице.
String

Производные выходные данные

ИмяОписаниеТип данных
out_layer_or_view

Обновленный входной набор данных.

Table View; Raster Layer; Mosaic Layer

Пример кода

AddRelate, пример 1 (окно Python)

Пример скрипта окна Python для использования функции AddRelate в режиме прямого запуска.

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

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы