Таблица в таблицу (Table to Table) (Конвертация)
Резюме
Конвертирует входную таблицу в таблицу dBASE или таблицу базы геоданных.
Использование
-
Этот инструмент поддерживает в качестве входных данных таблицы в следующих форматах:
- dBASE (.dbf)
- Значения, разделенные запятыми (.csv)
- текст, разделенный табуляцией (.txt)
- Листы рабочих книг Microsoft Excel (.xls или .xlsx)
- INFO
- VPF
- OLE базы данных
- персональные, файловые и SDE базы геоданных
- представления таблиц "в памяти"
При вводе из файла (.csv или .txt) первая строка входного файла используется в качестве имен полей выходной таблицы. В именах полей не должно быть пробелов и специальных символов (например, $ или *), и если в первой строчке входного файла они есть, появится соответствующее сообщение об ошибке.
-
Этот инструмент может конвертировать таблицы в dBASE (.dbf), а также таблицы баз геоданных (персональных, файловых или SDE) и таблицы INFO.
Этот инструмент можно использовать, чтобы экспортировать таблицу ArcGIS в таблицу dBASE (.dbf), которая доступна для чтения и редактирования в Microsoft Excel.
Параметр Список полей (Field Map) контролирует, как входные поля в Входных объектах (Input Features) будут записываться в Выходные объекты (Output Features).
- Чтобы удалить поля при конвертации, удалите входные поля из Списка полей (Field Map). Это не повлияет на входной класс объектов.
- Одно выходное поле может быть создано из нескольких входных полей, если создается новое поле, и содержимое выходного поля создается из нескольких полей с разными именами.
- Тип данных выходного поля по умолчанию будет таким же, как тип данных первого входного поля (того имени), с которым он сталкивается. Тип данных можно поменять вручную в любое время на любой действительный тип данных. Если используется диалоговое окно инструмента, все корректные типы данных будут перечислены.
- Используя Правило слияния, вы можете задать собственный разделитель, например, пробел, запятую, точку, тире и т.д. Если вы хотите использовать пробел, убедитесь, что курсор мыши находится в начале входного набора и щелкните клавишу пробел один раз.
- Существует ряд доступных Правил объединения: первый (first), последний (last), соединение (join), сумма (sum), среднее значение (mean), медиана (median), минимум (min), максимум (max) и среднеквадратическое отклонение (standard deviation).
- Опции форматирования доступны только во входных полях типа текст (при использовании правила слияния Соединение (Join)). Вы можете определить начальную точку, конечную точку и т.д. Форматирование позволяет применить изменения к выбранному входному полю или ко всем таким случаям в том же входном поле.
- Среднеквадратическое отклонение не должно быть использовано для одного входного поля, т.к. значения нельзя делить на ноль. Поэтому среднеквадратическое отклонение не допустимо использовать для одного входного поля.
При конвертации данных базы геоданных, имеющих подтипы или домены, в таблицу dBASE, коды подтипов и коды и описания доменов могут быть включены в выходные данные. Для управления этим поведением используйте среду геообработки Перенос описаний домена поля (Transfer Field Domain Descriptions). По умолчанию в выходные данные будут включены только коды доменов и подтипов, но не описания.
Примечание:Конвертация в таблицу dBASE (DBF) с описаниями подтипа и домена может занять больше времени (более низкая производительность), чем то же действие без использования описаний. Если нет необходимости использовать описания подтипа и домена в выходной таблице (DBF), рекомендуется снять флажок (задать значения False или NOT_TRANSFER_DOMAINS при написании скриптов) и использовать поведение по умолчанию в среде Перенос описаний домена поля (Transfer Field Domain Descriptions), что позволит достичь наилучшей производительности.
Синтаксис
| Параметр | Объяснение | Тип данных |
in_rows |
Входная таблица, которая будет конвертирована в новую таблицу. | Table View; Raster Layer |
out_path |
Место назначения, куда будет записана новая таблица. | Workspace |
out_name |
Имя выходной таблицы. Если Выходное местоположение (Output Location) является папкой, конвертируйте входные строки (Input Rows) в таблицу dBASE, указав имя с расширением .dbf, или конвертируйте входные строки (Input Rows) в таблицу INFO, указав имя без расширения. Если Выходное местоположение (Output Location) - это база геоданных, конвертируйте Входные строки (Input Rows) в таблицу базы геоданных, указав имя без расширения. | String |
where_clause (дополнительно) |
SQL-выражение, использованное для выбора поднабора записей. Синтаксис выражения различается в зависимости от формата данных. Например, если вы строите запрос к файловой или ArcSDE базам геоданных, шейп-файлам, покрытиям, dBASE или таблицам INFO, заключите имена полей в двойные кавычки: "ИМЯ_ПОЛЯ" Если вы запрашиваете персональную базу геоданных, заключите поля в квадратные скобки: [ИМЯ_ПОЛЯ] В Python строковые значения заключаются в соответствующие одинарные или двойные кавычки. Чтобы создать строку с кавычками (что часто требуется при написании условия WHERE в выражениях SQL), можно использовать перед кавычками escape-символ (символ обратной косой черты) или заключить всю строку в три пары кавычек. Например, если требуется написать в условии WHERE "CITY_NAME" = 'Чикаго', можно заключить всю строку в двойные кавычки и добавить escape-символ перед внутренними двойными кавычками: " \"CITY_NAME\" = 'Чикаго' ", Или можно заключить всю строку в одинарные кавычки и добавить escape-символ перед внутренними одинарными кавычками: ' "CITY_NAME" = \'Чикаго\' ' Или можно заключить всю строку в три пары кавычек и не добавлять escape-символ: """ "CITY_NAME" = 'Чикаго' """, Более подробно о синтаксисе SQL и о том, как он различается между источниками данных, смотрите разделы справки: Литература по SQL для выражений запросов, используемых в ArcGIS. | SQL Expression |
field_mapping (дополнительно) |
Поля и параметры полей входной таблицы. Можно добавлять, переименовывать или удалять выходные поля, а также менять их свойства, такие как тип данных и правила слияния. | Field Mappings |
config_keyword (дополнительно) |
Задает параметры хранения по умолчанию (конфигурации) для баз геоданных в реляционной системе управления базами данных (RDBMS). Этот параметр применим только при использовании таблиц баз геоданных SDE. Ключевые слова конфигурации ArcSDE задаются администратором базы данных. | String |
Пример кода
Следующий скрипт окна Python демонстрирует, как используется инструмент Таблица в таблицу (Table To Table) в непосредственном режиме.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.TableToTable_conversion("vegtable.dbf", "C:/output/output.gdb", "vegtable")
Следующий автономный скрипт демонстрирует, как используется инструмент Таблица в таблицу (Table To Table).
# Name: TableToTable_Example2.py
# Description: Use TableToTable with an expression to create a subset
# of the original table.
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
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(env.workspace, "VEG_TYPE") + " = 'Estuarine'"
# Execute TableToTable
arcpy.TableToTable_conversion(inTable, outLocation, outTable, expression)