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

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

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

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

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

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

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

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

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

  • Этот инструмент не поддерживает формат изображений 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)

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