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

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

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

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

Иллюстрация

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

Значением параметра Входная таблица должен быть векторный слой, представление таблицы или растровый слой с таблицей атрибутов. Если используется путь к данным, слой будет создан при помощи соединения. Соединение всегда будет находиться в слое, а не в данных.
Чтобы сделать постоянное соединение, либо используйте инструмент Соединение полей, либо используйте объединенный слой в качестве входных данных для одного из следующих инструментов: Копировать объекты, Копировать строки, Экспорт объектов или Экспорт таблицы. При сохранении результатов в новый класс объектов или таблицу можно использовать параметр среды Полноценные имена полей, чтобы контролировать, будут ли имена соединяемых выходных полей уточняться именем таблицы, из которой получено поле.
Если входные данные представлены классом пространственных объектов или путем к набору данных, этот инструмент будет автоматически создавать и возвращать новый слой с результатом примененного инструмента.
Если кардинальность один-ко-многим используется при соединении, результат соединения можно увидеть в таблице атрибутов, где сообщение с предупреждением укажет на дублирование поля Object ID. Так как множество инструментов геообработки не поддерживают данные с дублированными Object ID, и результаты анализа таких данных могут быть неожиданными, сначала рекомендуется скопировать слой соединения в новый класс объектов с помощью инструмента Экспорт объектов. Затем используйте новый класс объектов в качестве входных данных для инструментов геообработки.

В следующих таблицах приведены возможные результаты выполнения соединения с различными входными данными.

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

Пример добавления соединения: соединение один ко многим, когда каждая таблица имеет поле Object ID
Входная таблица		Соединяемая таблица		Результат
Входное поле	Тип	Поле соединения	Значение	Входное поле	Тип	Поле соединения	Значение
1	A	1	100	1	A	1	100
2	B	2	200	2	B	2	200
		1	300	1	A	1	300
		2	400	2	B	2	400

Во второй таблице используется таблица соединений без Object ID; возможно только соединение один-к-первому. Соединение один-к-первому также возможно только в том случае, если каждая таблица находится в отдельной рабочей области.

Пример добавления соединения: соединение типа один-к-первому, когда в какой-либо таблице нет поля Object ID
Входная таблица		Соединяемая таблица		Результат
Входное поле	Тип	Поле соединения	Значение	Входное поле	Тип	Поле соединения	Значение
1	A	1	100	1	A	1	100
2	B	2	200	2	B	2	200
		3	300
		4	400

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

Пример добавления соединения: соединение один ко многим, когда каждая таблица имеет поле Object ID и отмечен параметр Сохранить все целевые объекты
Входная таблица		Соединяемая таблица		Результат
Входное поле	Тип	Поле соединения	Значение	Входное поле	Тип	Поле соединения	Значение
1	A	1	100	1	A	1	100
2	B	2	200	2	B	2	200
3	C	1	300	1	A	1	300
4	D	2	400	2	B	2	400
				3	C	<Null>	<Null>
				4	D	<Null>	<Null>

Входная таблица должна иметь поле Object ID для выполнения соединения один-ко-многим и находиться в той же рабочей области.

Записи из соединяемой таблицы могут быть сопоставлены более чем с одной записью, если у соединяемой таблицы есть поле Object ID; в противном случае будет выполнено соединение один-к-первому.

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


Входная таблица		Соединяемая таблица		Результат
Входное поле	Тип	Поле соединения	Значение	Входное поле	Тип	Поле соединения	Значение
1	A	1	100	1	A	1	100
2	B	2	200	2	B	2	200
3	C	1	300	1	A	1	300
4	D	2	400	2	B	2	400
				3	C	<Null>	<Null>
				4	D	<Null>	<Null>

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


Входная таблица		Соединяемая таблица		Результат
Входное поле	Тип	Поле соединения	Значение	Входное поле	Тип	Поле соединения	Значение
1	A	1	100	1	A	1	100
2	B	2	200	2	B	2	200
		3	300
		4	400

Такие свойства полей, как псевдонимы, видимость и форматирование чисел, сохраняются и после добавления либо удаления соединения.
К входной таблице разрешено одно соединение за раз.
Соединение сохраняется только на протяжении существования слоя. Слой можно сохранить, сохранив сеанс ArcGIS Pro или сохранив его в файл слоя с помощью инструмента Сохранить слой в файл.

Чтобы увидеть результаты соединения, созданного инструментом-скриптом, у инструмента должен быть производный выходной параметр. Точно так же параметр Обновленный входной слой или представление таблицы должен быть установлен в качестве производного выходного параметра в инструменте модели, чтобы можно было увидеть результаты соединения.
В результирующей таблице поля будут иметь префикс с входным именем и точкой (.), а все поля из соединяемой таблицы будут иметь префикс с именем соединяемой таблицы и точкой по умолчанию.
Например, соединение landuse с полями A и B с lookup_tab с полями C и D приведет к созданию слоя или представления таблицы с полями landuse.A, landuse.B, lookup_tab.C и lookup_tab.D.
Индексирование полей во входной таблице и соединяемой таблице, на которых будет основано соединение, может повысить производительность. Если отмечен параметр Индексировать присоединенные поля, к обеим присоединенным полям будет добавлен атрибутивный индекс. Либо все присоединяемые поля можно проиндексировать с помощью инструмента Добавить атрибутивный индекс.
Если результаты соединения оказались неожиданными или неполными, посмотрите, проиндексированы ли значения параметров Поле присоединяемой таблицы и Входное поле соединения. Если нет, попробуйте удалить и заново построить индекс, а затем повторно запустить инструмент.
Если поля входного слоя или представления таблицы были изменены (переименованы или скрыты) с помощью параметра Информация поля в инструменте Создать векторный слой или в инструменте Создать представление таблицы, изменения полей не будут добавлены в выходной соединенный слой или представление таблицы.
Определяющий запрос соединяемой таблицы будет применен ко входному слою или представлению таблицы. Определяющий запрос можно удалить с помощью инструмента Удалить соединение, или можно вручную удалить определяющий запрос из слоя.
Инструмент Проверить соединение можно использовать для проверки соединения между двумя слоями или таблицами, это позволит определить, есть ли у слоев или таблиц допустимые имя полей и поля Object ID, будут ли в ходе соединения сопоставленные записи, тип кардинальности (один-к-одному или один-ко-многим) и другие свойства соединения.
Для простоты использования кнопка для проверки соединения доступна в диалоговом окне инструмента.
Любые выборки на слое не используются в инструменте Добавить соединение, но используются в инструменте Поле соединения.

Параметры

Подпись	Описание	Тип данных
Входная таблица	Слой или представление таблицы, к которым будет присоединяться соединяемая таблица.	Mosaic Layer; Raster Layer; Table View
Входное поле соединения	Поле входного слоя или представления таблицы, на котором будет основано соединение.	Field
Соединяемая таблица	Таблица или представление таблицы, которые будут присоединяться к входному слою или представлению таблицы.	Mosaic Layer; Raster Layer; Table View
Поле соединяемой таблицы	Поле соединяемой таблицы, содержащее значения, на которых будет основываться соединение.	Field
Сохранить все целевые объекты (Дополнительный)	Указывает, будут ли включены в результат только записи из входных данных, для которых есть сопоставления в соединяемой таблице. Отмечено – все записи входного слоя или представления таблицы будут включены в выходные данные. Это также называется внешним соединением. Это значение по умолчанию Не отмечено – только те записи во входных данных, для которых есть сопоставления в соединяемой таблице, будут включены в выходные данные. Это также известно как внутреннее соединение.	Boolean
Индексировать присоединяемые поля (Дополнительный)	Определяет, будет ли атрибутивный индекс добавляться к обоим присоединенным полям. Отмечено - будут проиндексированы оба присоединенных поля. Если у таблицы уже есть индекс, новый индекс добавлен не будет. Не отмечено - индексы добавляться не будут. Это значение по умолчанию	Boolean

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

Подпись	Описание	Тип данных
Обновленный входной слой или представление таблицы	Обновленный входной набор данных.	Table View; Raster Layer; Mosaic Layer

arcpy.management.AddJoin(in_layer_or_view, in_field, join_table, join_field, {join_type}, {index_join_fields})

Имя	Описание	Тип данных
in_layer_or_view	Слой или представление таблицы, к которым будет присоединяться соединяемая таблица.	Mosaic Layer; Raster Layer; Table View
in_field	Поле входного слоя или представления таблицы, на котором будет основано соединение.	Field
join_table	Таблица или представление таблицы, которые будут присоединяться к входному слою или представлению таблицы.	Mosaic Layer; Raster Layer; Table View
join_field	Поле соединяемой таблицы, содержащее значения, на которых будет основываться соединение.	Field
join_type (Дополнительный)	Указывает, будут ли включены в результат только записи из входных данных, для которых есть сопоставления в соединяемой таблице. KEEP_ALL—Все записи входного слоя или представления таблицы будут включены в выходные данные. Это также называется внешним соединением. Это значение по умолчанию KEEP_COMMON—Только те записи во входных данных, для которых есть сопоставления в соединяемой таблице, будут включены в выходные данные. Это также известно как внутреннее соединение.	Boolean
index_join_fields (Дополнительный)	Определяет, будет ли атрибутивный индекс добавляться к обоим присоединенным полям. INDEX_JOIN_FIELDS—Будут проиндексированы оба присоединенных поля. Если у таблицы уже есть индекс, новый индекс добавлен не будет. NO_INDEX_JOIN_FIELDS—Индексы добавляться не будут. Это значение по умолчанию	Boolean

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

Имя	Описание	Тип данных
out_layer_or_view	Обновленный входной набор данных.	Table View; Raster Layer; Mosaic Layer

Пример кода

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

В следующем скрипте окна Python показано, как используется функция AddJoin в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"
veg_joined_table = arcpy.management.AddJoin("vegetation", "HOLLAND95", 
                                            "vegtable", "HOLLAND95")
arcpy.management.CopyFeatures(veg_joined_table, "vegjoin")

AddJoin, пример 2 (автономный скрипт)

Этот автономный скрипт описывает функцию AddJoin как часть рабочего процесса для присоединения таблицы к классу пространственных объектов с последующим извлечением нужных пространственных объектов.

# Name: AttributeSelection.py
# Purpose: Join a table to a featureclass and select the desired attributes

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"
# The qualifiedFieldNames environment is used by Copy Features when persisting 
# the join field names.
arcpy.env.qualifiedFieldNames = False

# Set local variables
inFeatures = "vegtype"
joinTable = "vegtable"
joinField = "HOLLAND95"
expression = "vegtable.HABITAT = 1"
outFeature = "vegjoin"

# Join the feature layer to a table
veg_joined_table = arcpy.management.AddJoin(inFeatures, joinField, joinTable, 
                                            joinField)

# Select desired features from veg_layer
arcpy.management.SelectLayerByAttribute(veg_joined_table, "NEW_SELECTION", 
                                        expression)

# Copy the layer to a new permanent feature class
arcpy.management.CopyFeatures(veg_joined_table, outFeature)

Параметры среды

Текущая рабочая область

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

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

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

Отзыв по этому разделу?

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

Иллюстрация

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

Параметры

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

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

Пример кода

Параметры среды

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

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

В этом разделе