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

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

Копирует строки таблицы, представления таблицы, векторного слоя или растра с таблицей атрибутов в новую базу геоданных, файлы .csv, .txt или в таблицу .dbf.

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

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

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

    • База геоданных
    • dBASE (.dbf)
    • Значения, разделенные запятыми (.csv или .txt)
    • Листы Microsoft Excel (.xls или .xlsx)
    • Представления таблиц "в памяти"

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входная таблица

Входные строки, которые будут скопированы в новую таблицу.

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.CopyRows_management("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()
 
# Execute 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.CopyRows_management(dbaseTable, outTable)

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

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

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