Копировать (Инструменты Управление данными)

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

Копирует входные данные в выходную рабочую область с тем же типом данных, что и входная рабочая область.

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

Этот инструмент выполняет копирование только между рабочими областями с одним и тем же типом данных: из папки в папку и из любого типа базы геоданных в любой тип базы геоданных (файловую, многопользовательскую или мобильную). Чтобы скопировать данные между различными типами рабочих областей, используйте инструмент [Копировать объекты] или другие инструменты из [../conversion/an-overview-of-the-conversion-toolbox.mdнабора инструментов Конвертация].

Этот инструмент не поддерживает копирование в рабочую область в памяти или из нее.
Если класс пространственных объектов копируется в набор классов объектов, пространственная привязка этого класса пространственных объектов и набора классов объектов должны совпадать; в противном случае инструмент не сработает.
Any data that is dependent on the input is also copied. For example, copying a feature class or table that is part of a relationship class also copies the relationship class. This also applies to a feature class that has feature-linked annotation, domains, subtypes, and indices—Все они копируются вместе с классом объектов. При копировании геометрических сетей, наборов сетевых данных и топологий также копируются участвующие классы объектов.
Этот инструмент не копирует слои, поскольку слой является всего лишь ссылкой на класс объектов.
При копировании набора данных мозаики он копируется в указанное местоположение. Изображения, на которые ссылается набор данных мозаики не копируются.
Этот инструмент не поддерживает копирование набора сетевых данных обратно в ту же базу геоданных.
Этот инструмент не поддерживает формат изображений MRF. Чтобы скопировать файл, .mrf используйте инструмент Копировать растр.
Когда входные данные имеют связанные данные, отображается значение параметра Связанные данные, что позволяет контролировать имя выходных связанных данных и ключевое слово конфигурации.

Подпись	Объяснение	Тип данных
Входные данные	Данные, которые будут копироваться.	Data Element
Выходные данные	Расположение и имя выходных данных.	Data Element
Тип данных (Дополнительный)	Тип данных на диске, которые будут копироваться. Этот параметр необходим, если в имени присутствует конфликт между двумя различными типами данных. Например, база геоданных может содержать класс отношений, с именем, совпадающем с именем класса объектов. Если присутствует этот случай, укажите соответствующее ключевое слово. `FeatureClass`—В случае повторяющихся имен будет использоваться класс пространственных объектов. `FeatureDataset`—В случае повторяющихся имен будет использоваться набор классов объектов. `MosaicDataset`—В случае повторяющихся имен будет использоваться набор данных мозаики. `ParcelFabric`—В случае повторяющихся имен будет использоваться набор данных участков. `RelationshipClass`—В случае повторяющихся имен будет использоваться класс отношений. `Topology`—В случае повторяющихся имен будет использоваться топология.	String
Связанные данные (Дополнительный)	Если входные данные имеют связанные данные, то этот параметр может использоваться для управления именем выходных связанных данных и ключевым словом конфигурации. Названия столбцов Из имени и В имя будут одинаковыми, если значение В имя не используется в значении параметра Выходные данные. Если в значении Выходные данные присутствует имя, будет создано уникальное значение В имя посредством добавления нижнего подчеркивания и цифры, (например, rivers_1Arcade, к значению Из имени. Столбцы таблицы значений: From Name–The data associated with the input data, which will also be copied. Data Type–The type of the data on disk that will be copied. The only time you need to provide a value is when a geodatabase contains a feature dataset and a feature class with the same name. In this case, use the correct data type, FeatureDataset or FeatureClass, of the item you want to copy. To Name–The name of the copied data in the output. Config Keyword–The geodatabase storage parameters (configuration).	Value Table

arcpy.management.Copy(in_data, out_data, {data_type}, {associated_data})

Имя	Объяснение	Тип данных
in_data	Данные, которые будут копироваться.	Data Element
out_data	Расположение и имя выходных данных. Расширение файла в выходных данных должно совпадать с расширением во входных данных. Например, при копировании файловых баз геоданных элемент выходных данных должен содержать `.gdb` в качестве суффикса.	Data Element
data_type (Дополнительный)	Тип данных на диске, которые будут копироваться. Этот параметр необходим, если в имени присутствует конфликт между двумя различными типами данных. Например, база геоданных может содержать класс отношений, с именем, совпадающем с именем класса объектов. Если присутствует этот случай, укажите соответствующее ключевое слово. `FeatureClass`—В случае повторяющихся имен будет использоваться класс пространственных объектов. `FeatureDataset`—В случае повторяющихся имен будет использоваться набор классов объектов. `MosaicDataset`—В случае повторяющихся имен будет использоваться набор данных мозаики. `ParcelFabric`—В случае повторяющихся имен будет использоваться набор данных участков. `RelationshipClass`—В случае повторяющихся имен будет использоваться класс отношений. `Topology`—В случае повторяющихся имен будет использоваться топология.	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`. Столбцы таблицы значений: `From Name`–The data associated with the input data, which will also be copied. `Data Type`–The type of the data on disk that will be copied. The only time you need to provide a value is when a geodatabase contains a feature dataset and a feature class with the same name. In this case, use the correct data type, FeatureDataset or FeatureClass, of the item you want to copy. `To Name`–The name of the copied data in the output. `Config Keyword`–The geodatabase storage parameters (configuration).	Value Table

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.Copy("majorrds.shp", "C:/output/majorrdsCopy.shp")

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

В следующем скрипте 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)

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

Пример скрипта 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)

Con, пример 4 (окно Python)

Следующее окно скрипта 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 #"
)

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

Следующий пример скрипта 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)

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

Текущая рабочая область, Выходное ключевое слово конфигурации, Временная рабочая область, Поддержка вложений

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