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

Сводка

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

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

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

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

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

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

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

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

Синтаксис

arcpy.management.Copy(in_data, out_data, {data_type}, {associated_data})
ParameterОбъяснениеТип данных
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.
  • config_keyword – параметры хранения базы геоданных (конфигурация).

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

Value Table

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.Copy_management("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"
# Execute Copy
arcpy.Copy_management(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"
# Rename each feature class during the copy operation using the associated_data parameter
arcpy.Copy_management(in_data, out_data, associated_data=";".join(["lakes FeatureClass mexico_lakes #",
                                                                   "cities FeatureClass mexico_cities #",
                                                                   "rivers FeatureClass mexico_rivers #"
                                                                   ]))

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

  • Basic: Да
  • Standard: Да
  • Advanced: Да

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