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

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

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

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

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

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

Более подробно об импорте правил атрибутов
При задании для параметра Конструктор ID значения Последовательность поиска будет сгенерирована последовательность базы геоданных для каждого отдельного значения в поле Sequence by lookup пересекающегося набора данных, которое присутствует на момент создания атрибутивного правила. Объект, созданные после написания правила, необходимо будет включить вручную.
Если для целевого объекта требуется ID, настройте поле ID таким образом, чтобы в нем не было значений null.

Подпись	Объяснение	Тип данных
Входная таблица	Набор данных, к которому будет применено новое правило.	Table View
Выходная папка	Папка, в которой будет сохранен файл `.csv`. Имя файла будет взято из значения параметра Входная таблица.	Folder
Поле	Название существующего поля, к которому применяется правило.	Field
Выражение (Дополнительный)	Выражение SQL, ограничивающее строки, к которым будет применено правило атрибута.	SQL Expression
Создать последовательность (Дополнительный)	Указывает, будут ли созданы последовательности базы данных в указанной рабочей области. Отмечено–Будут созданы последовательности базы данных. Используется по умолчанию. Не отмечено–Последовательности базы данных не будут созданы.	Boolean
Тип определения (Дополнительный)	Задает метод, который будет использоваться для определения формата ID. Конструктор–Формат ID будет создан с использованием параметра Конструктор ID. Таблица–Формат ID будет определен из таблицы с использованием параметра Таблица определения ID. Значения кодов–Запись конфигурации и последовательность будут созданы для каждой комбинации кодированных значений из выбранных полей.	String
Конструктор ID (Дополнительный)	Набор параметров формата, которые будут определять правило атрибута. Сюда входит выражение SQL, которое будет использоваться для применения различных форматов и последовательностей для каждого актива, а также внутреннего отступа, префикса и суффикса. Предварительный просмотр строки будет отображаться на панели Геообработка на основе значений, введенных в параметрах формата. Столбцы таблицы значений: Filter SQL–An optional SQL expression that will be used to determine whether the sequence will be applied to the row. Description–An optional description of the entry that will be added to the rule settings in the attribute rule. Sequence Name–The name that will be assigned to the database sequence. For enterprise geodatabases, the name must meet sequence name requirements for the database platform you're using and must be unique in the database. For file geodatabases, the name must be unique to the file geodatabase. Starting Value–The starting number of the sequence. If you do not provide a starting number, the sequence will start at 1. If you do provide a starting number, it must be greater than 0. Increment Value–Describes how the sequence numbers will be incremented. For example, if the sequence starts at 10 and the increment value is 5, the next value in the sequence is 15, and the next value after that is 20. If you do not specify an increment value, sequence values will increment by 1. Prefix–An optional string or value that will be placed before the sequence value. Suffix–An optional string or value that will be placed after the sequence value. Padding–An optional positive number that represents the number of digits in which zeros will be used to fill the unused digits. For example, a value of 5 will represent the sequence value of 1 as 00001. Separator–An optional value that will be used to join the prefix, sequence, and suffix. Sequence by lookup–An optional value that will be used to create unique sequences for each distinct value in the field.	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`—Дополнительное значение, которое будет использоваться для объединения префикса, последовательности и суффикса. `IntersectClass`—Дополнительное значение, содержащее полный путь к пересекающемуся набору данных. `ClassIDField`—Необязательное значение поля, которое будет использоваться для создания уникальных последовательностей для каждого отдельного значения в поле. `ClassFilter`—Дополнительное выражение SQL, которое будет использоваться для определения того, будет ли последовательность применена к строке в пересекающемся наборе данных.	Record Set
Поля кодированных значений (Дополнительный)	Поля, которые будут использоваться для генерации выражения SQL и конфигурации идентификатора.	Field
Последовательность по пересечению (Дополнительный)	Объекты из пересекающегося набора данных, которые будут использоваться для генерации уникальных значений ID во входных объектах. Дополнительное значение поля из пересекающегося набора данных будет использоваться для значения последовательности поиска. Столбцы таблицы значений: Intersect Class–The features from the intersecting dataset that will be used to generate unique ID values in the input features. Row ID Field–The optional field value from the intersecting dataset will be used for the sequence by lookup value.	Value Table

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

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

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

Имя	Объяснение	Тип данных
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. `BUILDER`–Формат ID будет создан с использованием параметра `id_builder`. `TABLE`–Формат ID будет определен из таблицы с использованием параметра `id_table`. `CODED_VALUES`–Запись конфигурации и последовательность будут созданы для каждой комбинации кодированных значений из выбранных полей.	String
id_builder [id_builder,...] (Дополнительный)	Набор параметров формата, которые будут определять правило атрибута. Сюда входит выражение SQL, которое будет использоваться для применения различных форматов и последовательностей для каждого актива, а также внутреннего отступа, префикса и суффикса. Столбцы таблицы значений: `Filter SQL`–An optional SQL expression that will be used to determine whether the sequence will be applied to the row. `Description`–An optional description of the entry that will be added to the rule settings in the attribute rule. `Sequence Name`–The name that will be assigned to the database sequence. For enterprise geodatabases, the name must meet sequence name requirements for the database platform you're using and must be unique in the database. For file geodatabases, the name must be unique to the file geodatabase. `Starting Value`–The starting number of the sequence. If you do not provide a starting number, the sequence will start at 1. If you do provide a starting number, it must be greater than 0. `Increment Value`–Describes how the sequence numbers will be incremented. For example, if the sequence starts at 10 and the increment value is 5, the next value in the sequence is 15, and the next value after that is 20. If you do not specify an increment value, sequence values will increment by 1. `Prefix`–An optional string or value that will be placed before the sequence value. `Suffix`–An optional string or value that will be placed after the sequence value. `Padding`–An optional positive number that represents the number of digits in which zeros will be used to fill the unused digits. For example, a value of 5 will represent the sequence value of 1 as 00001. `Separator`–An optional value that will be used to join the prefix, sequence, and suffix. `Sequence by lookup`–An optional value that will be used to create unique sequences for each distinct value in the field.	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`—Дополнительное значение, которое будет использоваться для объединения префикса, последовательности и суффикса. `IntersectClass`—Дополнительное значение, содержащее полный путь к пересекающемуся набору данных. `ClassIDField`—Необязательное значение поля, которое будет использоваться для создания уникальных последовательностей для каждого отдельного значения в поле. `ClassFilter`—Дополнительное выражение SQL, которое будет использоваться для определения того, будет ли последовательность применена к строке в пересекающемся наборе данных.	Record Set
id_coded_value [id_coded_value,...] (Дополнительный)	Поля, которые будут использоваться для генерации выражения SQL и конфигурации идентификатора.	Field
intersect_class_field [intersect_class_field,...] (Дополнительный)	Объекты из пересекающегося набора данных, которые будут использоваться для генерации уникальных значений ID во входных объектах. Дополнительное значение поля из пересекающегося набора данных будет использоваться для значения последовательности поиска. Столбцы таблицы значений: `Intersect Class`–The features from the intersecting dataset that will be used to generate unique ID values in the input features. `Row ID Field`–The optional field value from the intersecting dataset will be used for the sequence by lookup value.	Value Table

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

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

Пример кода

GenerateIDAttributeRule, пример (автономный скрипт)

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

# Name: GenerateIDAttributeRule_Example.py

# Import the system modules
import arcpy

# Set local variables
in_table = "C:/data/data.gdb/target_class"
out_folder = "C:/out/"
field = "genID"
where_clause = ""
create_seq = "CREATE"
definition_method = "BUILDER"
id_builder = "# # sequence_name 2 # # # # poly_class::lookup"
id_table = ""
id_coded_value_fields = None
intersect_class_field = "\path\to\gdb.gdb\intersecting_class lookup"

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

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

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

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

Basic: Нет
Standard: Да
Advanced: Да

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

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

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

Параметры

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

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

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

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