Краткая информация
Инструмент записывает строки из входной таблицы, представления таблицы, класса пространственных объектов в новую таблицу, включая текстовый файл с разделителями строк (.txt). Если в классе объектов или в слое есть выборка, будут копироваться только выбранные строки.
Использование
Если входными данными является класс пространственных объектов или таблица, копируются все строки. Если входные строки берутся из слоя или представления таблицы, в которых имеется выборка, то используются только выделенные объекты или строки.
Если входные строки являются классом объектов, то только атрибуты, а не геометрия, копируются в выходную таблицу.
Этот инструмент поддерживает в качестве входных данных таблицы в следующих форматах:
- База геоданных
- dBASE (.dbf)
- Значения, разделенные запятыми (.csv)
- Текст, разделенный табуляцией (.txt)
- Листы Microsoft Excel (.xls или .xlsx)
- INFO
- VPF
- OLE базы данных
- Представления таблиц "в памяти"
При вводе из файла (.csv или .txt) первая строка входного файла используется в качестве имен полей выходной таблицы. В именах полей не должно быть пробелов и специальных символов (таких как $ или *), и если в первой строчке входного файла они есть, появится соответствующее сообщение об ошибке.
Чтобы добавить или присоединить копируемые строки к существующей таблице, используйте инструмент Присоединить.
Выходная таблица может быть сохранена в формате dBASE, в базе геоданных или в файле .txt с разделителями строк.
Синтаксис
CopyRows_management (in_rows, out_table, {config_keyword})
Параметр | Объяснение | Тип данных |
in_rows | Строки из входной таблицы, представления таблицы, класса объектов или слоя пространственных объектов, которые будут скопированы. | Table View ; Raster Layer |
out_table | Таблица, в которую будет записаны строки. Выходная таблица может быть сохранена в формате dBASE, в базе геоданных или файле с разделителями. Чтобы сохранить таблицу dBASE, укажите имя с расширением .dbf. Чтобы сохранить файл с разделителями, укажите имя с расширением .txt. | Table |
config_keyword (Дополнительный) | Ключевое слово конфигурации задает параметры хранения по умолчанию для многопользовательской базы геоданных. | String |
Пример кода
CopyRows, пример 1 (окно Python)
На следующем скрипте окна Python продемонстрировано, как использовать функцию CopyRows с запуском из окна Python.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.CopyRows_management("vegtable.dbf", "C:/output/output.gdb/vegtable")
CopyRows, пример 2 (автономный скрипт)
Пример автономного скрипта для использования функции CopyRows, чтобы копировать несколько таблиц из папки в файловую базу геоданных.
# Name: CopyRows_Example2.py
# Description: Convert all dBASE tables in a folder to geodatabase tables
# Requirement: os module
# Import system modules
import arcpy
from arcpy import env
import os
# Set environment settings
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, dbaseTable.strip(".dbf"))
arcpy.CopyRows_management(dbaseTable, outTable)
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Да
- ArcGIS Desktop Standard: Да
- ArcGIS Desktop Advanced: Да