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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Примечание:

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

Параметры

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

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

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

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

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

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

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.ExportTable_conversion("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'"
 
# Execute TableToTable
arcpy.ExportTable_conversion(inTable, outTable, expression, "NOT_USE_ALIAS", 
                             None, None)

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

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

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