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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Примечание:

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

Параметры

ПодписьОписаниеТип данных
Входные строки

Входная таблица, которая будет экспортирована в новую таблицу.

Table View; Raster Layer
Выходное местоположение

Место назначения, куда будет записана новая таблица.

Workspace
Выходное имя

Имя выходной таблицы.

Если в качестве выходного местоположения выбрана папка, укажите расширение .csv, .txt или .dbf, чтобы экспортировать таблицы в соответствующий формат. Если в качестве выходного местоположения выбрана база геоданных, не указывайте расширение.

String
Выражение
(Дополнительный)

SQL-выражение, которое будет использоваться для выбора поднабора записей.

SQL Expression
Список полей
(Дополнительный)

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

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

Правила слияния позволяют вам определить, каким образом значения из нескольких входных полей будут слиты или объединены в одно выходное значение. Следующие правила слияния можно использовать для определения того, как выходное поле будет заполняться значениями:

  • Первое - используется первое входное значение.
  • Последнее – используется последнее значение входного поля.
  • Соединение – соединение (объединение) значений входных полей.
  • Сумма – вычисление суммы значений входных полей.
  • Среднее – вычисление среднего по значениям входных полей.
  • Медиана – вычисление медианы (середины) по значениям входных полей.
  • Мода – использование значения, встречающегося с наибольшей частотой.
  • Минимум – использование наименьшего из всех значений входных полей.
  • Максимум – использование наибольшего из всех значений входных полей.
  • Среднеквадратическое отклонение – использование классификации методом среднеквадратического отклонения для всех значений входных полей.
  • Количество – определяет количество записей, участвующих в вычислениях.

Field Mappings
Ключевое слово конфигурации
(Дополнительный)

Задает параметры хранения по умолчанию (конфигурации) для баз геоданных в реляционной системе управления базами данных (РСУБД). Этот параметр применим только при использовании таблиц корпоративной базы геоданных.

Ключевые слова конфигурации задаются администратором базы данных.

Более подробно о ключевых словах конфигурации

String

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

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

Выходная таблица.

Table

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

Выходная таблица.

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)

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

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

Связанные разделы