| Подпись | Описание | Тип данных |
Входные данные | Данные, которые будут копироваться. | Data Element |
Выходные данные | Расположение и имя выходных данных. | Data Element |
Тип данных (Дополнительный) | Тип данных на диске, которые будут копироваться. Этот параметр необходим, если в имени присутствует конфликт между двумя различными типами данных. Например, база геоданных может содержать класс отношений, с именем, совпадающем с именем класса объектов. Если присутствует этот случай, укажите соответствующее ключевое слово.
| String |
Связанные данные (Дополнительный) | Если входные данные имеют связанные данные, то этот параметр может использоваться для управления именем выходных связанных данных и ключевым словом конфигурации.
Названия столбцов От имени и До имени будут одинаковыми, если значение До имени не используется в значении параметра Выходные данные. Если в значении Выходные данные присутствует имя, будет создано уникальное значение До имени посредством добавления нижнего подчеркивания и цифры, например, rivers_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 путем добавления нижнего подчеркивания и цифры, например, rivers_1, к значению from_name. | 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)Следующее окно скрипта Python демонстрирует, как использовать функцию Copy с набором классов объектов и указанным значением associated_data в параметре среды многопользовательская база геоданных.
import arcpy
arcpy.management.Copy(
in_data=r"C:\Users\GIS\SQLServerDatabase.sde\DBO.Mexico",
out_data=r"C:\Users\GIS\SQLServerDatabase.sde\DBO.PyCmd_Mexico",
data_type="FeatureDataset",
associated_data="DBO.Rivers FeatureClass DBO.PyCmd_Rivers #;DBO.Lakes FeatureClass DBO.PyCmd_Lakes #;DBO.Cities FeatureClass DBO.PyCmd_Cities #"
)Следующий пример скрипта Python демонстрирует, как использовать функцию Copy с набором классов объектов и указанным значением associated_data в параметре среды многопользовательская база геоданных.
# Description: Copy a feature dataset and specify associated_data within an
# Enterprise geodatabase environment
# Import system modules
import arcpy
# The input is a feature dataset containing 3 feature classes: lakes, cities,
# rivers.
in_data = r"C:\Users\GIS\SQLServerDatabase.sde\DBO.Mexico"
# The output is a new feature dataset that the feature classes from in_data will
# be copied to
out_data = r"C:\Users\GIS\SQLServerDatabase.sde\DBO.Py_Mexico"
# Define schema of the from_name and to_name values when preparing data to be
# created in an enterprise geodatabase
associated_data = ";".join(["DBO.Lakes FeatureClass DBO.Py_Lakes #",
"DBO.Cities FeatureClass DBO.Py_Cities #",
"DBO.Rivers FeatureClass DBO.Py_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)Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да