Таблица в таблицу (Конвертация)

Краткая информация

Экспортирует строки таблицы, представления таблицы, слоя объектов, класса пространственных объектов или растра с атрибутивной таблицей в новую таблицу базы геоданных, .csv, .txt или .dbf.

Использование

• Этот инструмент поддерживает в качестве входных данных таблицы в следующих форматах:

  • База геоданных
  • dBASE (.dbf)
  • Значения, разделенные запятыми (.csv или .txt)
  • Листы Microsoft Excel (.xls или .xlsx)
  • Представления таблиц "в памяти"

  При вводе из файла (.csv или .txt) первая строка входного файла используется в качестве имен полей выходной таблицы. В именах полей не должно быть пробелов и специальных символов (таких как $ или *), и если в первой строчке входного файла они есть, появится соответствующее сообщение об ошибке.

• Все поля в выходном наборе данных и содержание этих полей можно контролировать с помощью Списка полей.

  • Чтобы изменить порядок полей, выберите имя поля и перетащите его в нужное положение.
  • Тип данных по умолчанию для выходного поля будет таким же, как тип данных первого входного поля (того имени), с которым он сталкивается. Вы можете вручную изменить тип данных в любое время на любой другой допустимый тип данных.
  • Применимы следующие правила слияния: первый, последний, соединение, сумма, среднее, медиана, мода, минимум, максимум, стандартное отклонение и количество.
  • Используя правило слияния Соединение, вы можете задать собственный разделитель, например, пробел, запятую, точку, тире и т.д. Чтобы использовать пробел, убедитесь, что курсор мыши находится в начале входного набора и щелкните клавишу пробел один раз.
  • Можно указать начальное и конечное положения текстовых полей, используя опцию формата.
  • Среднеквадратическое отклонение не должно быть использовано для одного входного поля, так как значения нельзя делить на ноль. Поэтому среднеквадратическое отклонение не может применяться для одного входного поля.

  Более подробно о списках полей в скриптах

• При конвертации данных базы геоданных, имеющих подтипы или домены, в таблицу dBASE, коды и описания подтипов и доменов могут быть включены в выходные данные. Для управления этим поведением используйте параметр среды геообработки Передать описания доменов полей. По умолчанию в выходные данные будут включены только коды доменов и подтипов, но не описания.

  Примечание:

  Конвертация в таблицу dBASE (.dbf) с описаниями подтипа и домена может занять больше времени (более низкая производительность), чем то же действие без использования описаний. Если нет необходимости использовать описания подтипа и домена в выходной таблице dBASE (.dbf), рекомендуется отключить опцию стандартных настроек среды Перенос описаний домена поля (False или NOT_TRANSFER_DOMAINS в скрипте) для обеспечения оптимальной производительности.

Параметры

Диалог

Подпись	Описание	Тип данных
Входная таблица	Входная таблица, которая будет экспортирована в новую таблицу.	Table View; Raster Layer
Выходное местоположение	Место назначения, куда будет записана новая таблица.	Workspace
Выходное имя	Имя выходной таблицы. Если в качестве выходного местоположения выбрана папка, укажите расширение .csv, .txt или .dbf для экспорта таблицы в соответствующий формат. Если в качестве выходного местоположения выбрана база геоданных, не указывайте расширение.	String
Выражение (Дополнительный)	SQL-выражение, использованное для выбора поднабора записей.	SQL Expression
Список полей (Дополнительный)	Контролирует, какие атрибутивные поля будут в выходных данных. По умолчанию будут включены все поля из входных данных. Поля можно добавлять, удалять, переименовывать и переупорядочивать, а также изменять их свойства. Правила слияния позволяют вам определить, каким образом значения из нескольких входных полей будут слиты или объединены в одно выходное значение. Имеется несколько правил слияния, которые можно использовать для определения способа присвоения значений выходным полям. Первое – используется первое значение входного поля. Последнее – используется последнее значение входного поля. Соединение – соединение (объединение) значений входных полей. Сумма – вычисление суммы значений входных полей. Среднее – вычисление среднего по значениям входных полей. Медиана – вычисление медианы (середины) по значениям входных полей. Мода – использование значения, встречающегося с наибольшей частотой. Минимум – использование наименьшего из всех значений входных полей. Максимум – использование наибольшего из всех значений входных полей. Среднеквадратическое отклонение – использование классификации методом среднеквадратического отклонения для всех значений входных полей. Число – Определение числа записей, входящих в расчет.	Field Mappings
Ключевое слово конфигурации (Дополнительный)	Задает параметры хранения по умолчанию (конфигурации) для баз геоданных в реляционной системе управления базами данных (РСУБД). Этот параметр применим только при использовании таблиц корпоративной базы геоданных. Ключевые слова конфигурации задаются администратором базы данных. Более подробно о ключевых словах конфигурации	String

Производные выходные данные

Подпись	Описание	Тип данных
Выходная таблица	Выходная таблица.	Таблица

Python

arcpy.conversion.TableToTable(in_rows, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})

Имя	Описание	Тип данных
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

Производные выходные данные

Имя	Описание	Тип данных
out_table	Выходная таблица.	Таблица

Пример кода

TableToTable, пример 1 (окно Python)

Пример скрипта окна Python для использования функции TableToTable в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.TableToTable_conversion("vegtable.dbf", "C:/output/output.gdb", "vegtable")

TableToTable, пример 2 (автономный скрипт)

В следующем автономном скрипте показано использование функции 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)

Параметры среды

Текущая рабочая область, Выходное ключевое слово CONFIG, Поддержка вложений, Временная рабочая область, Передать описания доменов полей, Экстент, Полноценные имена полей

Особые случаи

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да