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

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

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

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

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

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

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

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

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

  • файлы с разделителями-запятыми (.csv, .txt или .asc)
  • Файлы с разделителями табуляции (.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: Да