Подпись | Описание | Тип данных |
Входная таблица | Входная таблица, содержащая строки, которые необходимо экспортировать в новую таблицу. | Table View; Raster Layer |
Выходная таблица | Выходная таблица, содержащая экспортированные строки. | Table |
Выражение (Дополнительный) | SQL-выражение, использованное для выбора поднабора записей. | SQL Expression |
Использовать псевдоним поля в качестве имени | Указывает, будут ли в качестве имени выходного поля использоваться имена входных полей или псевдонимы полей.
| Boolean |
Список полей (Дополнительный) | Атрибутивные поля выходного набора данных, с соответствующими свойствами полей, и исходные поля. По умолчанию будут включены все поля из входных данных. Поля можно добавлять, удалять, переименовывать и переупорядочивать, а также изменять их свойства. Правила слияния позволяют вам определить, каким образом значения из нескольких входных полей будут слиты или объединены в одно выходное значение. Имеется несколько правил слияния, которые можно использовать для определения способа присвоения значений выходным полям.
| Field Mappings |
Поля сортировки (Дополнительный) | Поле или поля, значения которых будут использоваться для изменения порядка входных записей, а также направление, в котором будут отсортированы записи.
| Value Table |
Краткая информация
Экспортирует строки таблицы или представление таблицы в таблицу.
Использование
Инструмент копирует строки таблицы, представление таблицы, класс пространственных объектов, векторный слой, файл с разделителями или растр с таблицей атрибутов в новую базу геоданных, таблицу dBASE или файл с разделителями.
Этот инструмент поддерживает в качестве входных данных таблицы в следующих форматах:
- База геоданных
- dBASE (.dbf)
- Листы Microsoft Excel (.xls и .xlsx)
- Таблицы на основе памяти
- Файлы с разделителями
- Файлы со значениями, разделенными запятыми (.csv, .txt и .asc)
- Файлы с разделителями tab (.tsv и .tab)
- Файлы, разделенные вертикальной линией (.psv)
Для файлов с разделителями первая строка входного файла используется в качестве имен полей выходной таблицы. В именах полей не должно быть пробелов и специальных символов (например, $ или *), и если в первой строчке входного файла они есть, появится соответствующее сообщение об ошибке.
Инструмент можно использовать для получения выходного файла с разделителями, добавив одно из следующих расширений файла к имени выходных данных в рабочей области папки:
- Файлы со значениями, разделенными запятыми (.csv, .txt или .asc)
- Файлы с разделителями tab (.tsv или .tab)
- Файлы, разделенные вертикальной линией (.psv)
Если выходные данные не находятся в базе геоданных, поля BLOB или поля растра не будут включены. Поля GlobalID будут преобразованы в текстовые поля.
Для управления полями в выходном наборе данных, содержащим эти поля, используйте параметр Список полей.
- Чтобы изменить порядок полей, выберите имя поля и перетащите его в новое положение.
- Тип данных по умолчанию для выходного поля будет таким же, как тип данных первого входного поля (того имени), с которым он сталкивается. Вы можете вручную изменить тип данных в любое время на любой другой допустимый тип данных.
- Доступны следующие правила слияния: первый, последний, соединение, сумма, среднее, медиана, мода, минимум, максимум, среднеквадратическое отклонение и количество.
- Используя правило слияния Соединение, вы можете задать собственный разделитель, например, пробел, запятую, точку, тире и т.д. Чтобы использовать пробел, убедитесь, что курсор мыши находится в начале входной строки и щелкните клавишу Пробел один раз.
- Можно указать начальное и конечное положения текстовых полей, используя опцию формата.
- Среднеквадратическое отклонение не должно быть использовано для одного входного поля, так как значения нельзя делить на ноль. Поэтому среднеквадратическое отклонение не может применяться для одного входного поля.
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 | Выходная таблица, содержащая экспортированные строки. | 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.ExportTable_conversion("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'"
# Execute TableToTable
arcpy.ExportTable_conversion(inTable, outTable, expression, "NOT_USE_ALIAS",
None, None)
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да