Generar regla de atributo de Id. (Herramientas de administración de datos)

Resumen

Crea una regla de atributo que genera un valor único para un campo a partir de una consulta.

La herramienta crea un archivo .csv que contiene una regla de atributos de ArcGIS Arcade basada en las entradas proporcionadas, un archivo Python que contiene el código para generar secuencias en el espacio de trabajo y un archivo de Id. para visualizar los Id. generados.

Uso

El parámetro Carpeta de salida especifica la ubicación en la que se creará una carpeta utilizando el nombre de la clase de entidad de entrada. El archivo .csv de salida que contiene la regla de atributo utilizará el nombre del valor del parámetro Tabla de entrada. Si se ejecuta la herramienta varias veces, se crearán archivos .csv adicionales en la carpeta.
Después de ejecutar la herramienta, importe la regla de atributos y aplíquela al dataset. Si el dataset se encuentra en una geodatabase corporativa, usted debe ser el propietario de los datos para aplicar la regla de atributos de la plantilla de salida.

Más información sobre cómo importar reglas de atributo
Al establecer el valor Secuencia por búsqueda del parámetro Generador de Id., se generará una secuencia de base de datos para cada valor distinto en el campo Sequence by lookup del dataset de intersección que esté presente en el momento en que se cree la regla de atributo. Las entidades creadas con posterioridad a la redacción de la regla deberán incluirse manualmente.
Si se requiere un Id. para una entidad de destino, configure el campo Id. para que no permita nulos.

Etiqueta	Explicación	Tipo de datos
Tabla de entrada	El dataset al que se aplicará la nueva regla.	Table View
Carpeta de salida	Carpeta en la que se guarda el archivo `.csv` de salida. El nombre del archivo se tomará del valor del parámetro Tabla de entrada.	Folder
Campo	El nombre del campo existente al que se aplicará la regla.	Field
Expresión (Opcional)	Una expresión SQL que limita las filas a las que se aplicará la regla de atributo.	SQL Expression
Crear secuencias (Opcional)	Especifica si se crearán secuencias de base de datos en el espacio de trabajo especificado. Activado—Se crearán secuencias de base de datos. Esta es la opción predeterminada. Desactivado—No se crearán secuencias de base de datos.	Boolean
Tipo de definición (Opcional)	Especifica el método que se utilizará para definir el formato de Id. Builder—El formato de Id. se generará utilizando el parámetro Generador de Id. Tabla—El formato de Id. se definirá a partir de una tabla utilizando el parámetro Tabla de definición de Id. Valores de código—Se generará una secuencia y una entrada de configuración para cada combinación de valores codificados de los campos seleccionados.	String
Generador de Id. (Opcional)	Un conjunto de opciones de formato que definirán la regla de atributo. Esto incluye una expresión SQL que se utilizará para aplicar diferentes formatos y secuencias por activo, así como valores de relleno, prefijos y sufijos. Se mostrará una vista previa de la cadena de caracteres en el panel Geoprocesamiento, creada a partir de los valores introducidos en las opciones de formato. Columnas de la tabla de valores: 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
Tabla de definición de Id. (Opcional)	Una tabla o conjunto de registros que define el formato de Id. Esto incluye la expresión SQL que se utilizará para aplicar diferentes formatos y secuencias por activo, así como valores de relleno, prefijos y sufijos. La tabla debe incluir los siguientes campos: `WhereClause`—Una expresión SQL opcional que se utilizará para determinar si la secuencia se aplicará a la fila. `Description`—Una descripción opcional de la entrada que se agregará a la configuración de la regla en la regla de atributo. `SequenceName`—Nombre que se asignará a la secuencia de la base de datos. En el caso de las geodatabases corporativas, el nombre debe satisfacer los requisitos de denominación de la plataforma de base de datos que esté utilizando y debe ser único en la base de datos. En el caso de las geodatabases de archivos, el nombre debe ser único para la geodatabase de archivos. `StartingValue`—El número inicial de la secuencia. Si no indica un número inicial, la secuencia empezará por 1. Si indica un número inicial, debe ser mayor que 0. `IncrementValue`—Describe cómo se incrementarán los números de secuencia. Por ejemplo, si la secuencia comienza por 10 y el valor del incremento es 5, el siguiente valor de la secuencia será 15 y el valor que le sigue será 20. Si no especifica ningún valor de incremento, los valores de secuencia se incrementarán en 1. `Prefix`—Una cadena de caracteres o valor opcional que se colocará antes del valor de la secuencia. `Suffix`—Una cadena de caracteres o valor opcional que se colocará después del valor de la secuencia. `Padding`—Un número positivo opcional que representa la cantidad de dígitos, en el que se usarán ceros para rellenar los dígitos no utilizados. Por ejemplo, un valor de 5 representará el valor de secuencia de 1 como 00001. `Separator`—Un valor opcional que se utilizará para unir el prefijo, la secuencia y el sufijo. `IntersectClass`—Valor opcional que contiene la ruta completa a un dataset de intersección. `ClassIDField`—Campo opcional que se utilizará para crear secuencias únicas para cada valor distinto del campo. `ClassFilter`—Expresión SQL opcional que se utilizará para determinar si la secuencia se aplicará a la fila en el dataset de intersección.	Record Set
Campos de valor codificado (Opcional)	Los campos que se utilizarán para generar una expresión SQL y una configuración para un Id.	Field
Secuencia por intersección (Opcional)	Las entidades del dataset de intersección que se utilizarán para generar valores de Id. únicos en las entidades de entrada. El valor del campo opcional del dtaset de intersección se utilizará para la secuencia por valor de búsqueda. Columnas de la tabla de valores: 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

Salida derivada

Etiqueta	Explicación	Tipo de datos
CSV de regla de salida	Archivo `.csv` de salida que contiene una regla de atributo de Arcade basada en las entradas proporcionadas. Este archivo se utiliza para importar la regla de atributo al dataset.	File
Tabla de definición de Id.	Una tabla de las configuraciones de definición de secuencias. La herramienta puede editar y reutilizar este archivo utilizando la opción Tabla del parámetro Tipo de definición.	File
Script de secuencia de Python	El archivo de secuencia de salida de Python. Este archivo puede utilizarse en otros espacios de trabajo o por cualquier persona con permisos para crear secuencias de bases de datos.	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})

Nombre	Explicación	Tipo de datos
in_table	El dataset al que se aplicará la nueva regla.	Table View
out_folder	Carpeta en la que se guarda el archivo `.csv` de salida. El nombre del archivo se tomará del valor del parámetro `in_table`.	Folder
field	El nombre del campo existente al que se aplicará la regla.	Field
where_clause (Opcional)	Una expresión SQL que limita las filas a las que se aplicará la regla de atributo.	SQL Expression
create_seq (Opcional)	Especifica si se crearán secuencias de base de datos en el espacio de trabajo especificado. `CREATE`—Se crearán secuencias de base de datos. Esta es la opción predeterminada. `NO_CREATE`—No se crearán secuencias de base de datos.	Boolean
definition_method (Opcional)	Especifica el método que se utilizará para definir el formato de Id. `BUILDER`—El formato de Id. se generará utilizando el parámetro `id_builder`. `TABLE`—El formato de Id. se definirá a partir de una tabla utilizando el parámetro `id_table`. `CODED_VALUES`—Se generará una secuencia y una entrada de configuración para cada combinación de valores codificados de los campos seleccionados.	String
id_builder [id_builder,...] (Opcional)	Un conjunto de opciones de formato que definirán la regla de atributo. Esto incluye una expresión SQL que se utilizará para aplicar diferentes formatos y secuencias por activo, así como valores de relleno, prefijos y sufijos. Columnas de la tabla de valores: `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 (Opcional)	Una tabla o conjunto de registros que define el formato de Id. Esto incluye la expresión SQL que se utilizará para aplicar diferentes formatos y secuencias por activo, así como valores de relleno, prefijos y sufijos. La tabla debe incluir los siguientes campos: `WhereClause`—Una expresión SQL opcional que se utilizará para determinar si la secuencia se aplicará a la fila. `Description`—Una descripción opcional de la entrada que se agregará a la configuración de la regla en la regla de atributo. `SequenceName`—Nombre que se asignará a la secuencia de la base de datos. En el caso de las geodatabases corporativas, el nombre debe satisfacer los requisitos de denominación de la plataforma de base de datos que esté utilizando y debe ser único en la base de datos. En el caso de las geodatabases de archivos, el nombre debe ser único para la geodatabase de archivos. `StartingValue`—El número inicial de la secuencia. Si no indica un número inicial, la secuencia empezará por 1. Si indica un número inicial, debe ser mayor que 0. `IncrementValue`—Describe cómo se incrementarán los números de secuencia. Por ejemplo, si la secuencia comienza por 10 y el valor del incremento es 5, el siguiente valor de la secuencia será 15 y el valor que le sigue será 20. Si no especifica ningún valor de incremento, los valores de secuencia se incrementarán en 1. `Prefix`—Una cadena de caracteres o valor opcional que se colocará antes del valor de la secuencia. `Suffix`—Una cadena de caracteres o valor opcional que se colocará después del valor de la secuencia. `Padding`—Un número positivo opcional que representa la cantidad de dígitos, en el que se usarán ceros para rellenar los dígitos no utilizados. Por ejemplo, un valor de 5 representará el valor de secuencia de 1 como 00001. `Separator`—Un valor opcional que se utilizará para unir el prefijo, la secuencia y el sufijo. `IntersectClass`—Valor opcional que contiene la ruta completa a un dataset de intersección. `ClassIDField`—Campo opcional que se utilizará para crear secuencias únicas para cada valor distinto del campo. `ClassFilter`—Expresión SQL opcional que se utilizará para determinar si la secuencia se aplicará a la fila en el dataset de intersección.	Record Set
id_coded_value [id_coded_value,...] (Opcional)	Los campos que se utilizarán para generar una expresión SQL y una configuración para un Id.	Field
intersect_class_field [intersect_class_field,...] (Opcional)	Las entidades del dataset de intersección que se utilizarán para generar valores de Id. únicos en las entidades de entrada. El valor del campo opcional del dtaset de intersección se utilizará para la secuencia por valor de búsqueda. Columnas de la tabla de valores: `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

Salida derivada

Nombre	Explicación	Tipo de datos
out_rule_csv	Archivo `.csv` de salida que contiene una regla de atributo de Arcade basada en las entradas proporcionadas. Este archivo se utiliza para importar la regla de atributo al dataset.	File
out_id_file	Una tabla de las configuraciones de definición de secuencias. La herramienta puede editar y reutilizar este archivo utilizando la opción `TABLE` del parámetro `definition_method`.	File
out_seq_script	El archivo de secuencia de salida de Python. Este archivo puede utilizarse en otros espacios de trabajo o por cualquier persona con permisos para crear secuencias de bases de datos.	File

Muestra de código

Ejemplo de "GenerateIDAttributeRule" (script independiente)

La siguiente secuencia de comandos independiente es un ejemplo de cómo utilizar la función GenerateIDAttributeRule en un entorno de secuencias de comandos.

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

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

Basic: No
Standard: Sí
Avanzado: Sí

Generar regla de atributo de Id. (Herramientas de administración de datos)

Resumen

Uso

Parámetros

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados