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

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

Экспортирует строки таблицы в другую таблицу.

Прежние версии:

Это устаревший инструмент. Эта функциональность заменена инструментом Экспорт таблицы.

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

• Копирует строки таблицы, представления таблицы, класса объектов, векторного слоя, файла с разделителями или растра с таблицей атрибутов в новую таблицу базы геоданных или dBASE, или в файл с разделителями.

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

  • База геоданных
  • dBASE (.dbf)
  • Рабочие листы Microsoft Excel (.xls и .xlsx)
  • Виртуальные таблицы
  • Файлы с разделителями
    • Файлы с разделителями-запятыми (.csv, .txt и .asc)
    • Файлы с разделителями табуляции (.tsv и .tab)
    • Файлы с разделителями вертикальной чертой (.psv)

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

• Если значение параметра Выходное местоположение не является базой геоданных, BLOB или растром, поля не будут включены. Поля GlobalID будут преобразованы в текстовые поля.

• Инструмент может создавать выходной файл с разделителями, путем добавления одного из следующих расширений к выходному имени в папке, определенной как рабочая область:

  • файлы с разделителями-запятыми (.csv, .txt или .asc)
  • Файлы с разделителями табуляции (.tsv или .tab)
  • Файлы с разделителями вертикальной чертой (.psv)

• Используйте параметр Список полей для управления полями и их содержанием во входных наборах данных.

  • Добавляйте и удаляйте поля из списка полей, изменяйте порядок и переименовывайте поля.
  • Тип данных выходного поля по умолчанию будет таким же, как тип данных первого входного поля (того имени), которое он находит. Вы можете изменить тип данных на другой допустимый тип.
  • Используйте действие, чтобы определить, как значения из одного или нескольких входных полей будут объединены в одно выходное поле. Доступны следующие действия: Первое, Последнее, Соединить, Сумма, Среднее, Медиана, Режим, Минимум, Максимум, Стандартное отклонение и Число.
  • При использовании действия Соединить, вы можете задать разделитель, например, точку или другой символ. Щелкните начало текстового поля Разделитель, чтобы добавить символы-разделители.
  • Стандартное отклонение не является допустимым параметром для одиночных входных значений.
  • Используйте опцию Экспорт для сохранения списка полей как файл .fieldmap.
  • Используйте опцию Загрузить , чтобы загрузить файл .fieldmap. Векторный слой или набор данных, указанный в файле, должен соответствовать набору данных, используемому в инструменте. Иначе параметр Список полей будет сброшен.
  • Используйте кнопку Фрагмент текста в исходных текстовых полях, чтобы выбрать, какие символы из входного значения будут извлечены в выходное поле. Чтобы получить доступ к кнопке Фрагмент текста, наведите курсор на текстовое поле в списке входных полей, затем укажите начальную и конечную позиции символов.
  • Поля также можно сопоставить в скрипте Python.

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

  Примечание:

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

Параметры

Диалог

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

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

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

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 Expression
field_mapping (Дополнительный)	Поля, которые будут перенесены в выходной набор данных с соответствующими свойствами и исходными полями. По умолчанию выходные данные включают все поля из входных наборов данных. Используйте список полей для добавления, удаления, переименования и изменения порядка полей, а также для изменения других свойств полей. Список полей также может использоваться для объединения значений из двух или более входных полей в одно выходное. В Python используйте класс FieldMappings для задания этого параметра.	Field Mappings
config_keyword (Дополнительный)	Задает параметры хранения по умолчанию (конфигурации) для баз геоданных в реляционной системе управления базами данных (РСУБД). Этот параметр применим только при использовании таблиц корпоративной базы геоданных. Ключевые слова конфигурации задаются администратором базы данных.	String

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

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

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.TableToTable("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'"
 
# Run TableToTable
arcpy.conversion.TableToTable(inTable, outLocation, outTable, expression)

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

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