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

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

Импортирует несколько зависящих значений и групп полей из файла со значениями, разделенными запятыми (.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

Python

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")

Параметры среды

Текущая рабочая область

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

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