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

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

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

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

  • Копирует строки таблицы, представления таблицы, класса объектов, векторного слоя, файла с разделителями или растра с таблицей атрибутов в новую таблицу базы геоданных или 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

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)

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