Подпись | Описание | Тип данных |
Входные данные | Данные, которые будут копироваться. | Data Element |
Выходные данные | Расположение и имя выходных данных. | Data Element |
Тип данных (Дополнительный) | Тип данных на диске для копирования. Этот параметр будет использоваться в случае конфликта имен. База геоданных может содержать разные наборы данных с одним и тем же именем, например, в одной и той же базе геоданных с одним и тем же именем могут существовать класс объектов, набор данных объектов, набор данных мозаики и набор данных участков. Указание значения заставит инструмент использовать этот тип данных в случае наличия двух или более наборов данных с одинаковым именем.
| String |
Связанные данные (Дополнительный) | Если входные данные имеют связанные данные, то этот параметр может использоваться для управления именем выходных связанных данных и ключевым словом конфигурации.
Названия столбцов От имени и До имени будут одинаковыми, если значение До имени уже не используется в Выходных данных. Если в значении Выходные данные имя уже существует, будет создано уникальное значение До имени посредством добавления нижнего подчеркивания и цифры, _1. | Value Table |
Краткая информация
Создаёт копию входных данных.
Использование
Если класс пространственных объектов копируется в набор классов объектов, пространственная привязка этого класса пространственных объектов и набора классов объектов должны совпадать; в противном случае инструмент не сработает.
Любые данные, зависящие от входных, также копируются. Например, при копировании класса пространственных объектов или таблицы, являющихся частью класса отношений, также копируется класс отношений. Это также применяется к классу пространственных объектов, который имеет объектно-связанные аннотации, домены, подтипы и индексы; все они копируются с классом пространственных объектов. При копировании геометрических сетей, наборов сетевых данных и топологий также копируются участвующие классы объектов.
Этот инструмент не копирует слои, поскольку слой является всего лишь ссылкой на класс объектов.
При копировании набора данных мозаики он копируется в указанное местоположение. Изображения, на которые ссылается набор данных мозаики не копируются.
Этот инструмент не поддерживает копирование набора сетевых данных обратно в ту же базу геоданных.
Этот инструмент не поддерживает формат изображений MRF. Чтобы копировать файл .mrf, используйте инструмент Копировать растр.
Когда входные данные имеют связанные данные, отображается значение параметра Связанные данные, которое контролирует имя выходных связанных данных и ключевое слово конфигурации.
Параметры
arcpy.management.Copy(in_data, out_data, {data_type}, {associated_data})
Имя | Описание | Тип данных |
in_data | Данные, которые будут копироваться. | Data Element |
out_data | Расположение и имя выходных данных. Расширение файла в выходных данных должно совпадать с расширением во входных данных. Например, при копировании файловых баз геоданных элемент выходных данных должен содержать .gdb в качестве суффикса. | Data Element |
data_type (Дополнительный) | Тип данных на диске для копирования. Этот параметр будет использоваться в случае конфликта имен. База геоданных может содержать разные наборы данных с одним и тем же именем, например, в одной и той же базе геоданных с одним и тем же именем могут существовать класс объектов, набор данных объектов, набор данных мозаики и набор данных участков. Указание значения заставит инструмент использовать этот тип данных в случае наличия двух или более наборов данных с одинаковым именем.
| String |
associated_data [[from_name, data_type, to_name, config_keyword],...] (Дополнительный) | Если входные данные имеют связанные данные, то этот параметр может использоваться для управления именем выходных связанных данных и ключевым словом конфигурации.
Названия столбцов from_name и to_name будут одинаковыми, если значение to_name уже не используется в out_data. Если в значении out_data имя уже существует, будет создано уникальное значение to_name путем добавления нижнего подчеркивания и цифры, _1. | Value Table |
Пример кода
В следующем скрипте окна Python показано, как используется функция Copy в режиме прямого запуска.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.Copy("majorrds.shp", "C:/output/majorrdsCopy.shp")
В следующем скрипте Python показано, как используется функция Copy в автономном скрипте:
# Name: Copy_Example2.py
# Description: Copy major roads dataset to preserve the original data
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/data"
# Set local variables
in_data = "majorrds.shp"
out_data = "C:/output/majorrdsCopy.shp"
# Run Copy
arcpy.management.Copy(in_data, out_data)
В следующем скрипте окна Python показано, как используется параметр associated_data в функции Copy:
# Name: Copy_Example3.py
# Description: Copy a feature dataset and specify associated_data
# Import system modules
import arcpy
# The input is a feature dataset containing 3 feature classes: lakes, cities, rivers
in_data = "C:/data/proj.gdb/mexico"
out_data = "C:/data/proj.sde/mexico"
associated_data = ";".join(["lakes FeatureClass mexico_lakes #",
"cities FeatureClass mexico_cities #",
"rivers FeatureClass mexico_rivers #"])
# Rename each feature class during the copy operation using the associated_data parameter
arcpy.management.Copy(in_data, out_data, associated_data=associated_data)