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

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

Создаёт копию входных данных.

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

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

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

  • Этот инструмент не копирует слои, поскольку слой является всего лишь ссылкой на класс объектов.

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

  • Этот инструмент не поддерживает копирование набора сетевых данных обратно в ту же базу геоданных.

  • Этот инструмент не поддерживает формат изображений MRF. Чтобы копировать файл .mrf, используйте инструмент Копировать растр.

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

Параметры

ПодписьОписаниеТип данных
Входные данные

Данные, которые будут копироваться.

Data Element
Выходные данные

Расположение и имя выходных данных.

Data Element
Тип данных
(Дополнительный)

Тип данных на диске для копирования.

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

String
Связанные данные
(Дополнительный)

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

  • Из имени – данные, связанные с входными данными, которые также будут скопированы.
  • Тип данных – тип данных на диске, которые будут копироваться. Если база геоданных содержит набор классов объектов и класс пространственных объектов с одним именем, необходимо указать, что именно вы собираетесь переименовать. В этом случае выберите корректный тип данных - FeatureDataset или FeatureClass,для элемента, который хотите скопировать.
  • В имя – имя копируемых данных в значении параметра Выходные данные.
  • Ключевое слово конфигурации – параметры хранения базы геоданных (конфигурация).

Названия столбцов От имени и До имени будут одинаковыми, если значение До имени уже не используется в Выходных данных. Если в значении Выходные данные имя уже существует, будет создано уникальное значение До имени посредством добавления нижнего подчеркивания и цифры, _1.

Value Table

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 – данные, связанные с входными данными, которые также будут скопированы.
  • data_type – тип данных на диске для копирования. Если база геоданных содержит набор классов объектов и класс пространственных объектов с одним именем, необходимо указать, что именно вы собираетесь переименовать. В этом случае используйте корректный тип данных - FeatureDataset или FeatureClass, для элемента, который вы хотите скопировать.
  • to_name – имя копируемых данных в значении параметра out_data.
  • config_keyword – параметры хранения базы геоданных (конфигурация).

Названия столбцов from_name и to_name будут одинаковыми, если значение to_name уже не используется в out_data. Если в значении out_data имя уже существует, будет создано уникальное значение to_name путем добавления нижнего подчеркивания и цифры, _1.

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)