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

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

Копирует строки таблицы в другую таблицу.

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

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

• Этот инструмент поддерживает в качестве входных данных таблицы в следующих форматах:

  • База геоданных
  • dBASE (.dbf)
  • Листы Microsoft Excel (.xls и .xlsx)
  • Таблицы на основе памяти
  • Файлы с разделителями
    • Файлы со значениями, разделенными запятыми (.csv, .txt и .asc)
    • Файлы с разделителями tab (.tsv и .tab)
    • Файлы, разделенные вертикальной линией (.psv)

  Для файлов с разделителями первая строка входного файла используется в качестве имен полей выходной таблицы. В именах полей не должно быть пробелов и специальных символов (например, $ или *), и если в первой строчке входного файла они есть, появится соответствующее сообщение об ошибке.

• Инструмент можно использовать для получения выходного файла с разделителями, добавив одно из следующих расширений файла к имени выходных данных в рабочей области папки:

  • Файлы со значениями, разделенными запятыми (.csv, .txt или .asc)
  • Файлы с разделителями tab (.tsv или .tab)
  • Файлы, разделенные вертикальной линией (.psv)

• Если входное представление таблицы или векторный слой включают выборку, в выходную таблицу копируются только выбранные строки.

• Если входными данными является класс пространственных объектов или таблица, копируются все строки. Если входные строки берутся из слоя или представления таблицы, в которых имеется выборка, будут использованы только выделенные объекты или строки.

• Если входные строки являются классом объектов, то, только атрибуты, а не геометрия, копируются в выходную таблицу.

• Чтобы добавить или присоединить копируемые строки к существующей таблице, используйте инструмент Присоединить.

Параметры

Диалог

Подпись	Описание	Тип данных
Входные строки	Входные строки, которые будут скопированы в новую таблицу.	Table View; Raster Layer
Выходная таблица	Создаваемая таблица, в которую будут скопированы входные строки. Если выходная таблица является папкой, добавьте расширение, например, .csv, .txt или .dbf, чтобы создать таблицу указанного формата. Если выходная таблица находится в базе геоданных, не указывайте расширение.	Table
Ключевое слово конфигурации (Дополнительный)	Параметры хранения по умолчанию для многопользовательской базы геоданных.	String

Python

arcpy.management.CopyRows(in_rows, out_table, {config_keyword})

Имя	Описание	Тип данных
in_rows	Входные строки, которые будут скопированы в новую таблицу.	Table View; Raster Layer
out_table	Создаваемая таблица, в которую будут скопированы входные строки. Если выходная таблица является папкой, добавьте расширение, например, .csv, .txt или .dbf, чтобы создать таблицу указанного формата. Если выходная таблица находится в базе геоданных, не указывайте расширение.	Table
config_keyword (Дополнительный)	Параметры хранения по умолчанию для многопользовательской базы геоданных.	String

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.CopyRows("vegtable.dbf", "C:/output/output.gdb/vegtable")

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

Следующий автономный скрипт демонстрирует использование функции CopyRows для копирования таблиц из папки в файловую базу геоданных.

# Description: Convert all dBASE tables in a folder to geodatabase tables
# Requirement: os module

# Import system modules
import arcpy
import os
 
# Set environment settings
arcpy.env.workspace = "C:/data"
 
# Set local variables
outWorkspace = "c:/output/output.gdb"
 
# Use ListTables to generate a list of dBASE tables in the
#  workspace shown above.
tableList = arcpy.ListTables()
 
# Run CopyRows for each input table
for dbaseTable in tableList:
    # Determine the new output feature class path and name
    outTable = os.path.join(outWorkspace, os.path.splitext(dbaseTable)[0])
    arcpy.management.CopyRows(dbaseTable, outTable)

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

Текущая рабочая область, Выходное ключевое слово CONFIG, Поддержка вложений, Временная рабочая область, Экстент, Сохранить Global ID

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

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