Создать правило атрибута ID (Управление данными)

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

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

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

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

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

  Более подробно об импорте правил атрибутов

Параметры

Диалог

Подпись	Описание	Тип данных
Входная таблица	Набор данных, к которому будет применено новое правило.	Table View
Выходная папка	Папка, в которой будет сохранен файл .csv. Имя файла будет взято из значения параметра Входная таблица.	Folder
Поле	Название существующего поля, к которому применяется правило.	Field
Выражение (Дополнительный)	Выражение SQL, ограничивающее строки, к которым будет применено правило атрибута.	SQL Expression
Создать последовательность (Дополнительный)	Указывает, будут ли созданы последовательности базы данных в указанной рабочей области. Отмечено — последовательности базы данных будут созданы. Это значение по умолчанию Не отмечено — последовательности базы данных не будут созданы.	Boolean
Тип определения (Дополнительный)	Задает метод, который будет использоваться для определения формата ID. Конструктор—Формат ID будет создан с использованием параметра Конструктор ID. Таблица—Формат ID будет определен из таблицы с использованием параметра Таблица определения ID. Значения кодов—Запись конфигурации и последовательность будут созданы для каждой комбинации кодированных значений из выбранных полей. Конструктор—Формат ID будет создан с использованием параметра id_builder. Таблица—Формат ID будет определен из таблицы с использованием параметра id_table. Значения кодов—Запись конфигурации и последовательность будут созданы для каждой комбинации кодированных значений из выбранных полей.	String
Конструктор ID (Дополнительный)	Набор параметров формата, которые будут определять правило атрибута. Сюда входит выражение SQL, которое будет использоваться для применения различных форматов и последовательностей для каждого актива, а также внутреннего отступа, префикса и суффикса. Фильтр SQL — дополнительное выражение SQL, которое будет использоваться для определения того, будет ли последовательность применена к строке. Описание — дополнительное описание записи, которая будет добавлена ​​в настройки правила в правиле атрибута. Имя последовательности — имя, которое будет присвоено последовательности баз данных. Для многопользовательских баз геоданных это имя должно соответствовать требованиям к имени последовательности для той платформы базы данных, которую вы используете, и должно быть уникальным для базы данных. Для файловых баз геоданных имя должно быть уникальным в файловой базе геоданных. Начальное значение — начальное число последовательности. Если вы не указываете начальный номер, последовательность будет начинаться с 1. Если вы задали начальный номер, он должен быть больше 0. Прирост значения – описывает, как будут увеличиваться значения в последовательности. Например, если последовательность начинается с 10 и значение приращения равно 5, следующим значением в последовательности будет 15, а затем 20. Если вы не указываете значение приращения, то значением приращения последовательности будет 1. Префикс — дополнительная строка или значение, которое будет помещено перед значением последовательности. Суффикс — дополнительная строка или значение, которое будет помещено после значения последовательности. Внутренний отступ — дополнительное положительное число, представляющее количество цифр, где нули будут использоваться для заполнения неиспользуемых цифр. Например, значение 5 будет представлять последовательность значений 1 как 00001. Разделитель — дополнительное значение, которое будет использоваться для объединения префикса, последовательности и суффикса. Предварительный просмотр строки будет отображаться на панели Геообработка на основе значений, введенных в параметрах формата.	Value Table
Таблица определения ID (Дополнительный)	Таблица или набор записей, определяющий формат ID. Сюда входит выражение SQL, которое будет использоваться для применения различных форматов и последовательностей для каждого актива, а также внутреннего отступа, префикса и суффикса. Таблица должна включать следующие поля: WhereClause— Дополнительное выражение SQL, которое будет использоваться для определения того, будет ли последовательность применена к строке. Description— Дополнительное описание записи, которая будет добавлена ​​в настройки правила в правиле атрибута. SequenceName— Имя, которое будет присвоено последовательности базы данных. Для многопользовательских баз геоданных это имя должно соответствовать требованиям к имени последовательности для той платформы базы данных, которую вы используете, и должно быть уникальным для базы данных. Для файловых баз геоданных имя должно быть уникальным в файловой базе геоданных. StartingValue— Начальное число последовательности. Если вы не указываете начальный номер, последовательность будет начинаться с 1. Если указано, начальное число должно быть больше 0. IncrementValue— Описывает, как будут увеличиваться порядковые номера. Например, если последовательность начинается с 10, а значение приращения равно 5, то следующим значением в последовательности будет 15, а следующим значением после него будет 20. Если вы не указываете значение приращения, то значением приращения последовательности будет 1. Prefix— Дополнительная строка или значение, которое будет помещено перед значением последовательности. Suffix— Дополнительная строка или значение, которое будет помещено после значения последовательности. Padding— Дополнительное положительное число, представляющее количество цифр, где нули будут использоваться для заполнения неиспользуемых цифр. Например, значение 5 будет представлять последовательность значений 1 как 00001. Separator— Дополнительное значение, которое будет использоваться для объединения префикса, последовательности и суффикса.	Record Set
Поля кодированных значений (Дополнительный)	Поля, которые будут использоваться для генерации выражения SQL и конфигурации идентификатора.	Field

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

Подпись	Описание	Тип данных
Выходное правило CSV	Выходной файл .csv, содержащий правило атрибута Arcade, основанное на предоставленных входных данных. Этот файл используется для импорта правила атрибута в набор данных.	File
Таблица определения ID	Таблица конфигураций определения последовательности. Этот файл можно редактировать и повторно использовать с помощью инструмента, используя опцию Таблица параметра Тип определения.	File
Скрипт последовательности Python	Файл выходной последовательности Python. Файл может использоваться в других рабочих пространствах или любым лицом, имеющим права на создание последовательностей баз данных.	File

Python

arcpy.management.GenerateIDAttributeRule(in_table, out_folder, field, {where_clause}, {create_seq}, {definition_method}, {id_builder}, {id_table}, {id_coded_value})

Имя	Описание	Тип данных
in_table	Набор данных, к которому будет применено новое правило.	Table View
out_folder	Папка, в которой будет сохранен файл .csv. Имя файла будет взято из значения параметра in_table.	Folder
field	Название существующего поля, к которому применяется правило.	Field
where_clause (Дополнительный)	Выражение SQL, ограничивающее строки, к которым будет применено правило атрибута.	SQL Expression
create_seq (Дополнительный)	Указывает, будут ли созданы последовательности базы данных в указанной рабочей области. CREATE—Будут созданы последовательности базы данных. Это значение по умолчанию NO_CREATE—Последовательности базы данных не будут созданы.	Boolean
definition_method (Дополнительный)	Задает метод, который будет использоваться для определения формата ID.	String
id_builder [id_builder,...] (Дополнительный)	Набор параметров формата, которые будут определять правило атрибута. Сюда входит выражение SQL, которое будет использоваться для применения различных форматов и последовательностей для каждого актива, а также внутреннего отступа, префикса и суффикса. Filter SQL — дополнительное выражение SQL, которое будет использоваться для определения того, будет ли последовательность применена к строке. Description — дополнительное описание записи, которая будет добавлена ​​в настройки правила в правиле атрибута. Sequence Name — имя, которое будет присвоено последовательности базы данных. Для многопользовательских баз геоданных это имя должно соответствовать требованиям к имени последовательности для той платформы базы данных, которую вы используете, и должно быть уникальным для базы данных. Для файловых баз геоданных имя должно быть уникальным в файловой базе геоданных. Starting Value — начальное число последовательности. Если вы не указываете начальный номер, последовательность будет начинаться с 1. Если вы задали начальный номер, он должен быть больше 0. Increment Value – описывает, как будут увеличиваться значения в последовательности. Например, если последовательность начинается с 10 и значение приращения равно 5, следующим значением в последовательности будет 15, а затем 20. Если вы не указываете значение приращения, то значением приращения последовательности будет 1. Prefix — дополнительная строка или значение, которое будет помещено перед значением последовательности. Suffix — дополнительная строка или значение, которое будет помещено после значения последовательности. Padding — дополнительное положительное число, представляющее количество цифр, где нули будут использоваться для заполнения неиспользуемых цифр. Например, значение 5 будет представлять последовательность значений 1 как 00001. Separator — дополнительное значение, которое будет использоваться для объединения префикса, последовательности и суффикса.	Value Table
id_table (Дополнительный)	Таблица или набор записей, определяющий формат ID. Сюда входит выражение SQL, которое будет использоваться для применения различных форматов и последовательностей для каждого актива, а также внутреннего отступа, префикса и суффикса. Таблица должна включать следующие поля: WhereClause— Дополнительное выражение SQL, которое будет использоваться для определения того, будет ли последовательность применена к строке. Description— Дополнительное описание записи, которая будет добавлена ​​в настройки правила в правиле атрибута. SequenceName— Имя, которое будет присвоено последовательности базы данных. Для многопользовательских баз геоданных это имя должно соответствовать требованиям к имени последовательности для той платформы базы данных, которую вы используете, и должно быть уникальным для базы данных. Для файловых баз геоданных имя должно быть уникальным в файловой базе геоданных. StartingValue— Начальное число последовательности. Если вы не указываете начальный номер, последовательность будет начинаться с 1. Если указано, начальное число должно быть больше 0. IncrementValue— Описывает, как будут увеличиваться порядковые номера. Например, если последовательность начинается с 10, а значение приращения равно 5, то следующим значением в последовательности будет 15, а следующим значением после него будет 20. Если вы не указываете значение приращения, то значением приращения последовательности будет 1. Prefix— Дополнительная строка или значение, которое будет помещено перед значением последовательности. Suffix— Дополнительная строка или значение, которое будет помещено после значения последовательности. Padding— Дополнительное положительное число, представляющее количество цифр, где нули будут использоваться для заполнения неиспользуемых цифр. Например, значение 5 будет представлять последовательность значений 1 как 00001. Separator— Дополнительное значение, которое будет использоваться для объединения префикса, последовательности и суффикса.	Record Set
id_coded_value [id_coded_value,...] (Дополнительный)	Поля, которые будут использоваться для генерации выражения SQL и конфигурации идентификатора.	Field

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

Имя	Описание	Тип данных
out_rule_csv	Выходной файл .csv, содержащий правило атрибута Arcade, основанное на предоставленных входных данных. Этот файл используется для импорта правила атрибута в набор данных.	File
out_id_file	Таблица конфигураций определения последовательности. Этот файл может быть отредактирован и повторно использован инструментом с помощью опции TABLE параметра definition_method.	File
out_seq_script	Файл выходной последовательности Python. Файл может использоваться в других рабочих пространствах или любым лицом, имеющим права на создание последовательностей баз данных.	File

Пример кода

GenerateIDAttributeRule, пример (сценарий выполнения)

Автономный скрипт – пример использования функции GenerateIDAttributeRule.

# Name: GenerateIDAttributeRule_Example.py
# Description: GenerateIDAttributeRule of a template attribute rule in a file geodatabase

# Import the system modules
import arcpy

# Set local variables
in_table = "C:/data/data.gdb"
out_folder = "C:/out/"
field = "ID"
where_clause = ""
create_seq = "CREATE"
definition_method = "BUILDER"
id_builder = "# # 2 2 # # # #"
id_table = r"in_memory\record_set1"
id_coded_value_fields = None

arcpy.management.GenerateIDAttributeRule(
   in_table,
   out_folder,
   field,
   where_clause,
   create_seq,
   definition_method,
   id_builder,
   id_table,
   coded_value_fields
)

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

Этот инструмент не использует параметры среды геообработки