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

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

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

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

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

Входные строки

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

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

in_rows

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

Table View; Raster Layer

out_table

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

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)

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

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

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