Экспорт таблицы (Конвертация)

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

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

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

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

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

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

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

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

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

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

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

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

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

  • SQL-выражение может использоваться для выбора поднабора ячеек растра. Более подробно о синтаксисе параметра Выражение см. Справочник по SQL для выражений запросов, применяемых в ArcGIS.

  • Строки можно переупорядочивать в порядке возрастания или убывания, указав значение параметра Сортировка полей. Если указано более одного поля, строки сначала будут отсортированы по первому полю, потом в этом порядке по второму полю и т. д.

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

    Примечание:

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

Параметры

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

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

Table View; Raster Layer
Выходная таблица

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

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

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

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

SQL Expression
Использовать псевдоним поля в качестве имени

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

  • Не отмечено — в качестве имен выходных полей будут использоваться имена входных полей. Это значение по умолчанию
  • Отмечено — в качестве имен выходных полей будут использоваться псевдонимы входных полей.
Boolean
Список полей
(Дополнительный)

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

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

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

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

Field Mappings
Поля сортировки
(Дополнительный)

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

  • По возрастанию – записи будут отсортированы от меньшего значения к большему.
  • По убыванию – записи будут отсортированы от большего значения к меньшему.

Value Table

arcpy.conversion.ExportTable(in_table, out_table, {where_clause}, use_field_alias_as_name, {field_mapping}, {sort_field})
ИмяОписаниеТип данных
in_table

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

Table View; Raster Layer
out_table

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

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

Table
where_clause
(Дополнительный)

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

SQL Expression
use_field_alias_as_name

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

  • NOT_USE_ALIASВ качестве имен выходных полей будут использоваться имена входных полей. Это значение по умолчанию
  • USE_ALIASВ качестве имен выходных полей будут использоваться псевдонимы входных полей.
Boolean
field_mapping
(Дополнительный)

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

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

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

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

Field Mappings
sort_field
[sort_field,...]
(Дополнительный)

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

  • ASCENDING – записи будут отсортированы от меньшего значения к большему.
  • DESCENDING – записи будут отсортированы от большего значения к меньшему.

Value Table

Пример кода

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

В следующем скрипте окна Python показано, как используется функция ExportTable в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.ExportTable("vegtable.dbf", "C:/output/output.gdb/vegtable")
ExportTable, пример 2 (автономный скрипт)

В следующем автономном скрипте показано использование функции ExportTable.

#  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"
outTable = "C:/output/output.gdb/estuarine.csv"

# 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.ExportTable(inTable, outTable, expression, "NOT_USE_ALIAS")

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

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

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