Подпись | Описание | Тип данных |
Входная таблица | Входная таблица, содержащая строки, которые необходимо экспортировать в новую таблицу. | Table View; Raster Layer |
Выходная таблица | Выходная таблица, содержащая экспортированные строки. Если в качестве выходного местоположения выбрана папка, укажите расширение .csv, .txt или .dbf для экспорта таблицы в соответствующий формат. Если в качестве выходного местоположения выбрана база геоданных, не указывайте расширение. | Table |
Выражение (Дополнительный) | SQL-выражение, использованное для выбора поднабора записей. | SQL Expression |
Использовать псевдоним поля в качестве имени | Указывает, будут ли в качестве имени выходного поля использоваться имена входных полей или псевдонимы полей.
| Boolean |
Список полей (Дополнительный) | Поля, которые будут перенесены в выходной набор данных с соответствующими свойствами и исходными полями. По умолчанию выходные данные включают все поля из входного набора данных. Используйте Список полей для добавления, удаления, переименования и изменения порядка полей, а также для изменения других свойств полей. Список полей также может использоваться для объединения значений из двух или более входных полей в одно выходное. | Field Mappings |
Поля сортировки (Дополнительный) | Поле или поля, значения которых будут использоваться для изменения порядка входных записей, а также направление, в котором будут отсортированы записи.
| Value Table |
Краткая информация
Экспортирует строки таблицы или представление таблицы в новую таблицу.
Использование
Инструмент копирует строки таблицы, представление таблицы, класс пространственных объектов, векторный слой, файл с разделителями или растр с таблицей атрибутов в новую базу геоданных, таблицу dBASE или файл с разделителями.
Этот инструмент поддерживает в качестве входных данных таблицы в следующих форматах:
- База геоданных
- dBASE (.dbf)
- Рабочие листы Microsoft Excel (.xls и .xlsx)
- Виртуальные таблицы
- Файлы с разделителями
- Файлы с разделителями-запятыми (.csv, .txt и .asc)
- Файлы с разделителями табуляции (.tsv и .tab)
- Файлы с разделителями вертикальной чертой (.psv)
Для файлов с разделителями первая строка входного файла используется в качестве имен полей выходной таблицы. В именах полей не должно быть пробелов и специальных символов (таких как $ или *), и если в первой строчке входного файла они есть, появится соответствующее сообщение об ошибке.
Инструмент может создавать выходной файл с разделителями, путем добавления одного из следующих расширений к выходному имени в папке, определенной как рабочая область:
- файлы с разделителями-запятыми (.csv, .txt или .asc)
- Файлы с разделителями табуляции (.tsv или .tab)
- Файлы с разделителями вертикальной чертой (.psv)
Если выходные данные не находятся в базе геоданных, поля BLOB или поля растра не будут включены. Поля GlobalID будут преобразованы в текстовые поля.
Используйте параметр Список полей для управления полями и их содержанием в входных наборах данных.
- Добавляйте и удаляйте поля из списка полей, изменяйте порядок и переименовывайте поля.
- Тип данных выходного поля по умолчанию будет таким же, как тип данных первого входного поля (того имени), которое он находит. Вы можете изменить тип данных на другой допустимый тип.
- Используйте действие, чтобы определить, как значения из одного или нескольких входных полей будут объединены в одно выходное поле. Доступны следующие действия: Первое, Последнее, Соединить, Сумма, Среднее, Медиана, Режим, Минимум, Максимум, Стандартное отклонение и Число.
- При использовании действия Соединить, вы можете задать разделитель, например, точку или другой символ. Щелкните начало текстового поля Разделитель, чтобы добавить символы-разделители.
- Стандартное отклонение не является допустимым параметром для одиночных входных значений.
- Используйте кнопку Фрагмент текста в исходных текстовых полях, чтобы выбрать, какие символы из входного значения будут извлечены в поле вывода. Чтобы получить доступ к кнопке Фрагмент текста, наведите курсор на текстовое поле в списке входных полей, затем укажите начальную и конечную позиции символов.
- Поля также можно сопоставить, используя скрипты Python.
SQL-выражение может использоваться для выбора поднабора ячеек растра. Более подробно о синтаксисе параметра Выражение см. Справочник по SQL для выражений запросов, применяемых в ArcGIS.
Строки можно переупорядочивать в порядке возрастания или убывания, указав значение параметра Сортировка полей. Если указано более одного поля, строки сначала будут отсортированы по первому полю, потом в этом порядке по второму полю и т. д.
При конвертации данных базы геоданных с подтипами или доменами, если при этом выходная рабочая область не является базой геоданных, и коды, и описания домена могут быть включены в выходные данные. Для управления этим поведением используйте параметр среды Перенос описаний домена поля. По умолчанию в выходные данные будут включены только коды доменов и подтипов, но не описания.
Примечание:
Конвертация в таблицу dBASE с описаниями подтипа и домена может занять больше времени (более низкая производительность), чем то же действие без использования описаний. Если описания подтипов и доменов не требуются в выходных данных, оставьте поле переноса описания домена в среде не отмеченным для достижения наилучшей производительности.
Параметры
arcpy.conversion.ExportTable(in_table, out_table, {where_clause}, use_field_alias_as_name, {field_mapping}, {sort_field})
Имя | Описание | Тип данных |
in_table | Входная таблица, содержащая строки, которые необходимо экспортировать в новую таблицу. | Table View; Raster Layer |
out_table | Выходная таблица, содержащая экспортированные строки. Если в качестве выходного местоположения выбрана папка, укажите расширение .csv, .txt или .dbf для экспорта таблицы в соответствующий формат. Если в качестве выходного местоположения выбрана база геоданных, не указывайте расширение. | Table |
where_clause (Дополнительный) | SQL-выражение, использованное для выбора поднабора записей. Более подробно о синтаксисе SQL смотрите в разделах справки: Литература по SQL для выражений запросов, используемых в ArcGIS. | SQL Expression |
use_field_alias_as_name | Указывает, будут ли в качестве имени выходного поля использоваться имена входных полей или псевдонимы полей.
| Boolean |
field_mapping (Дополнительный) | Поля, которые будут перенесены в выходной набор данных с соответствующими свойствами и исходными полями. По умолчанию выходные данные включают все поля из входного набора данных. Используйте Список полей для добавления, удаления, переименования и изменения порядка полей, а также для изменения других свойств полей. Список полей также может использоваться для объединения значений из двух или более входных полей в одно выходное. | Field Mappings |
sort_field [sort_field,...] (Дополнительный) | Поле или поля, значения которых будут использоваться для изменения порядка входных записей, а также направление, в котором будут отсортированы записи.
| Value Table |
Пример кода
В следующем скрипте окна Python показано, как используется функция ExportTable в режиме прямого запуска.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.ExportTable("vegtable.dbf", "C:/output/output.gdb/vegtable")
В следующем автономном скрипте показано использование функции ExportTable.
# Description: Use TableToTable with an expression to create a subset
# of the original table.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inTable = "vegtable.dbf"
outTable = "C:/output/output.gdb/estuarine.csv"
# Set the expression, with help from the AddFieldDelimiters function, to select
# the appropriate field delimiters for the data type
expression = arcpy.AddFieldDelimiters(arcpy.env.workspace, "VEG_TYPE") + " = 'Estuarine'"
# Run TableToTable
arcpy.conversion.ExportTable(inTable, outTable, expression, "NOT_USE_ALIAS")