Сводка
Экспортирует строки таблицы, представления таблицы, слоя объектов, класса пространственных объектов или растра с атрибутивной таблицей в новую таблицу базы геоданных, .csv, .txt или .dbf.
Использование
Этот инструмент поддерживает в качестве входных данных таблицы в следующих форматах:
- База геоданных
- dBASE (.dbf)
- Значения, разделенные запятыми (.csv или .txt)
- Листы Microsoft Excel (.xls или .xlsx)
- Представления таблиц "в памяти"
При вводе из файла (.csv или .txt) первая строка входного файла используется в качестве имен полей выходной таблицы. В именах полей не должно быть пробелов и специальных символов (таких как $ или *), и если в первой строчке входного файла они есть, появится соответствующее сообщение об ошибке.
Все поля в выходном наборе данных и содержание этих полей можно контролировать с помощью Списка полей.
- Чтобы изменить порядок полей, выберите имя поля и перетащите его в нужное положение.
- Тип данных по умолчанию для выходного поля будет таким же, как тип данных первого входного поля (того имени), с которым он сталкивается. Вы можете вручную изменить тип данных в любое время на любой другой допустимый тип данных.
- Применимы следующие правила слияния: первый, последний, соединение, сумма, среднее, медиана, мода, минимум, максимум, стандартное отклонение и количество.
- Используя правило слияния Соединение, вы можете задать собственный разделитель, например, пробел, запятую, точку, тире и т.д. Чтобы использовать пробел, убедитесь, что курсор мыши находится в начале входного набора и щелкните клавишу пробел один раз.
- Можно указать начальное и конечное положения текстовых полей, используя опцию формата.
- Среднеквадратическое отклонение не должно быть использовано для одного входного поля, так как значения нельзя делить на ноль. Поэтому среднеквадратическое отклонение не может применяться для одного входного поля.
При конвертации данных базы геоданных, имеющих подтипы или домены, в таблицу dBASE, коды и описания подтипов и доменов могут быть включены в выходные данные. Для управления этим поведением используйте параметр среды геообработки Передать описания доменов полей. По умолчанию в выходные данные будут включены только коды доменов и подтипов, но не описания.
Примечание:
Конвертация в таблицу dBASE (.dbf) с описаниями подтипа и домена может занять больше времени (более низкая производительность), чем то же действие без использования описаний. Если нет необходимости использовать описания подтипа и домена в выходной таблице dBASE (.dbf), рекомендуется отключить опцию стандартных настроек среды Перенос описаний домена поля (False или NOT_TRANSFER_DOMAINS в скрипте) для обеспечения оптимальной производительности.
Синтаксис
arcpy.conversion.TableToTable(in_rows, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})
Parameter | Объяснение | Тип данных |
in_rows | Входная таблица, которая будет экспортирована в новую таблицу. | Table View; Raster Layer |
out_path | Место назначения, куда будет записана новая таблица. | Workspace |
out_name | Имя выходной таблицы. Если в качестве выходного местоположения выбрана папка, укажите расширение .csv, .txt или .dbf для экспорта таблицы в соответствующий формат. Если в качестве выходного местоположения выбрана база геоданных, не указывайте расширение. | String |
where_clause (Дополнительный) | SQL-выражение, использованное для выбора поднабора записей. Более подробно о выражениях SQL-запросов | SQL Expression |
field_mapping (Дополнительный) | Контролирует, какие атрибутивные поля будут в выходных данных. По умолчанию будут включены все поля из входных данных. Поля можно добавлять, удалять, переименовывать и переупорядочивать, а также изменять их свойства. Правила слияния позволяют вам определить, каким образом значения из нескольких входных полей будут слиты или объединены в одно выходное значение. Имеется несколько правил слияния, которые можно использовать для определения способа присвоения значений выходным полям.
В Python можно использовать класс FieldMappings для определения этого параметра. | Field Mappings |
config_keyword (Дополнительный) | Задает параметры хранения по умолчанию (конфигурации) для баз геоданных в реляционной системе управления базами данных (РСУБД). Этот параметр применим только при использовании таблиц корпоративной базы геоданных. Ключевые слова конфигурации задаются администратором базы данных. | String |
Производные выходные данные
Name | Объяснение | Тип данных |
out_table | Выходная таблица. | Таблица |
Пример кода
Пример скрипта окна Python для использования функции TableToTable в режиме прямого запуска.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.TableToTable_conversion("vegtable.dbf", "C:/output/output.gdb", "vegtable")
В следующем автономном скрипте показано использование функции TableToTable.
# 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"
outLocation = "C:/output/output.gdb"
outTable = "estuarine"
# 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.TableToTable_conversion(inTable, outLocation, outTable, expression)
Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да