Импорт зависящих значений (Управление данными)

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

Импортирует несколько зависящих значений и групп полей из файла со значениями, разделенными запятыми (.csv), в набор данных.

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

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

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

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

  • Этот инструмент может использоваться с инструментом Экспорт зависящих значений.

  • После добавления к набору данных группы полей, его версия становится ArcGIS Pro 2.3. Это означает, что набор данных больше не может использоваться в ArcMap.

  • Файл групп полей .csv включает столбцы NAME, IS_RESTRICTIVE и FIELD. Имя столбца FIELD будет увеличено на число всех полей в группе полей, например, FIELD1, FIELD2, FIELD3 и т.п.

    Столбцы .csv групп полей

    СтолбецОписаниеПример

    NAME

    Имя группы полей

    AnimalCategories

    IS_RESTRICTIVE

    Указывает, является ли группа полей ограничительной

    TRUE

    FIELD1

    Название поля

    category

  • Файл зависимых значений .csv включает следующие столбцы: CAV_ID, IS_RETIRED, FIELD_GROUP, SUBTYPE, SUBTYPE_NAME, CV_TYPE, CV_VALUE и DESCRIPTION.

    Там будет столько столбцов CV_TYPE, CV_VALUE и DESCRIPTION, сколько потребуется для сопоставления структуры определения зависящих значений. Эти имена столбцов будут дополнены (например, CV_TYPE1, CV_VALUE1, DESCRIPTION1, CV_TYPE2, CV_VALUE2, DESCRIPTION2 и т.п.) и будут соответствовать порядку полей в файле групп полей .csv. Например, CV_TYPE1, CV_VALUE1 и DESCRIPTION1 в файле зависящих значений .csv совпадают с FIELD1 в группах полей файла .csv.

    Столбцы зависящих значений в.csv

    СтолбецОписаниеПример

    CAV_ID

    ID зависящего значения.

    1

    IS_RETIRED

    Логическое значение, определяющее, удаляется ли зависящее значение.

    False

    FIELD_GROUP

    Имя группы полей, которой соответствует зависящее значение.

    AnimalCategories

    SUBTYPE

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

    2

    SUBTYPE_NAME

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

    Хладнокровные

    CV_TYPE1

    Тип зависящего значения. Значение типа хранится в виде целого числа следующим образом:

    • 1 – Любой
    • 2 – Null
    • 3 – Кодированное значение
    • 4 – Диапазон

    3

    CV_VALUE1

    Определенное значение поля. Если тип любой или null, значение в файле .csv является пустым.

    1

    DESCRIPTION1

    Если тип зависящего значения – Кодированное значение, то это текстовое описание кодированного значения.

    Рыба

Параметры

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

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

Table View
Входной файл групп полей (.csv)

Файл .csv со специальными именами столбцов, которые содержат информацию о группах полей.

File
Входной файл зависящих значений (.csv)

Файл .csv со специальными именами столбцов, которые содержат информацию о зависящих значениях.

File
Замена существующих зависящих значений
(Дополнительный)

Указывает, будут ли существующие значения заменены или объединены при импорте.

  • Отмечено – существующие значения для целевой таблицы будут заменены значениями во входных файлах .csv.
  • Не отмечено – существующие значения для целевой таблицы будут объединены со значениями во входных файлах .csv. Все дублирующиеся значения будут удалены. Это значение по умолчанию

Boolean

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

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

Обновленная целевая таблица с импортированными группами полей и зависящими значениями.

Table View; Raster Layer; Mosaic Layer

arcpy.management.ImportContingentValues(target_table, field_group_file, contingent_value_file, {import_type})
ИмяОписаниеТип данных
target_table

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

Table View
field_group_file

Файл .csv со специальными именами столбцов, которые содержат информацию о группах полей.

File
contingent_value_file

Файл .csv со специальными именами столбцов, которые содержат информацию о зависящих значениях.

File
import_type
(Дополнительный)

Указывает, будут ли существующие значения заменены или объединены при импорте.

  • REPLACEСуществующие значения для целевой таблицы будут заменены значениями во входных файлах .csv.
  • UNIONСуществующие значения для целевой таблицы будут объединены со значениями во входных файлах .csv. Все дублирующиеся значения будут удалены. Это значение по умолчанию
Boolean

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

ИмяОписаниеТип данных
updated_table

Обновленная целевая таблица с импортированными группами полей и зависящими значениями.

Table View; Raster Layer; Mosaic Layer

Пример кода

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

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

import arcpy
arcpy.management.ImportContingentValues("C:\\MyProject\\myConn.sde\\pro.USER1.Animals",
                                        "C:\\MyProject\\MyFieldGroups.csv",
                                        "C:\\MyProject\\MyContingentValues.csv",
                                        "REPLACE")

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