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

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

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

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

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

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

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

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

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

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

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

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

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

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

• При конвертации данных базы геоданных, имеющих подтипы или домены, в таблицу 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-запросов	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

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

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