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

Сводка

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

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

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

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

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

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

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

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

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

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

    NAME

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

    AnimalCategories

    IS_RESTRICTIVE

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

    TRUE

    FIELD1

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

    категория

  • Файл зависящих значений .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

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

    Ложь

    FIELD_GROUP

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

    AnimalCategories

    SUBTYPE

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

    2

    SUBTYPE_NAME

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

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

    CV_TYPE1

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

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

    3

    CV_VALUE1

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

    1

    DESCRIPTION1

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

    Рыба

Синтаксис

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

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

Table View
field_group_file

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

File
contingent_value_file

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

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

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

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

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

NameОбъяснениеТип данных
updated_table

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

Представление таблицы; Растровый слой; Слой мозаики

Пример кода

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

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

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

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

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

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