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

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

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

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

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

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

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

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

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

  • Инструмент Копировать не поддерживает формат изображений 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.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: Да

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