Validar nombres de tabla y de campo en Python

Validar nombres de tabla

Las geodatabases utilizan diversos sistemas de administración de bases de datos relacionales (RDBMS) para mantener las muchas tablas que componen una geodatabase. Todas las tablas de una geodatabase deben tener un nombre válido, de modo que es esencial un mecanismo para comprobar si un nombre de tabla es válido al crear datos en una geodatabase. Con la función ValidateTableName(), una secuencia de comandos puede determinar si un nombre específico es válido para un espacio de trabajo específico.

Los siguientes son errores de nombre de tablas que se validarán:

NotaNota:

La función ValidateTableName no determina que el nombre especificado sea único para el espacio de trabajo especificado. La función Exists() puede comprobar si el nombre de tabla es único para un espacio de trabajo determinado.

Función

Explicación

ValidateTableName(nombre, {espacio de trabajo})

Toma un nombre de tabla y una ruta de acceso de espacio de trabajo y devuelve un nombre de tabla válido para el espacio de trabajo

función ValidateTableName

Especificar el espacio de trabajo como un parámetro permite a ArcPy comprobar todos los nombres de tabla existentes y determinar si hay restricciones de denominación impuestos por el espacio de trabajo de salida. Si el espacio de trabajo de salida es un RDBMS, puede tener palabras reservadas que no se puedan utilizar en un nombre de tabla. También puede tener caracteres no válidos que no se pueden utilizar en una tabla o nombre de campo. Todos los caracteres no válidos se reemplazan por un subrayado (_). ValidateTableName() devuelve una cadena de caracteres que representa un nombre de tabla válido, que puede ser igual que el nombre de entrada si el nombre de entrada es válido. El ejemplo siguiente garantiza que la nueva clase de entidad de salida creada por la herramienta Copiar entidades tenga un nombre único válido en cualquier geodatabase:

# Move all shapefiles from a folder into a geodatabase # import arcpy from arcpy import env  # Set the workspace. List all of the shapefiles # env.workspace = "d:/St_Johns" fcs = arcpy.ListFeatureClasses("*")  # Set the workspace to SDE for ValidateTableName # env.workspace = "Database Connections/Bluestar.sde"  # For each feature class name # for fc in fcs:      # Validate the output name so it is valid     #     outfc = arcpy.ValidateTableName(fc)      # Copy the features from the workspace to a geodatabase     #     arcpy.CopyFeatures_management(fc, outfc)

Validar nombres de campo

Cada base de datos puede tener restricciones de denominación para los nombres de campo de una tabla. Los objetos tales como las clases de entidad o las clases de relación se almacenan como tablas en un RDBMS, de modo que estas restricciones afectan a algo más que a tablas independientes. Estas restricciones pueden o no ser comunes entre varios sistemas de bases de datos, de modo que las secuencias de comandos deben comprobar todos los nuevos nombres de campo para asegurarse de que no se produzca un error en una herramienta durante la ejecución.

Los siguientes son errores de nombre de campo que se validarán:

Función

Explicación

ValidateFieldName(nombre, {espacio de trabajo})

Acepta una cadena de caracteres (nombre de campo) y una ruta de acceso de espacio de trabajo, y devuelve un nombre de campo válido basado en las restricciones de denominación de la geodatabase de salida

función ValidateFieldName

El ejemplo siguiente garantiza que se agregue un campo, independientemente del nombre de entrada, utilizando la función ValidateFieldName:

# Create a new numeric field containing the ratio of polygon area to #   polygon perimeter. Two arguments, a feature class and field name, #   are expected.  # Define a pair of simple exceptions for error handling # class ShapeError(Exception):     pass class FieldError(Exception):     pass  import arcpy import os  try:     # Get the input feature class and make sure it contains polygons     #     input = arcpy.GetParameterAsText(0)     desc = arcpy.Describe(input)     if desc.shapeType.lower() != "polygon":         raise ShapeError      # Get the new field name and validate it     #     fieldname = arcpy.GetParameterAsText(1)     fieldname = arcpy.ValidateFieldName(fieldname, os.path.dirname(input))      # Make sure shape_length and shape_area fields exist     #     if len(arcpy.ListFields(input,"Shape_area")) > 0 and \         len(arcpy.ListFields(input,"Shape_length")) > 0:          # Add the new field and calculate the value         #         arcpy.AddField_management(input, fieldname, "double")         arcpy.CalculateField_management(input,fieldname,                                         "[Shape_area] / [Shape_length]")     else:         raise FieldError  except ShapeError:     print "Input does not contain polygons"  except FieldError:     print "Input does not contain shape area and length fields"  except:     print arcpy.GetMessages(2)

Siempre que una secuencia de comandos actualice un dataset, tal como una clase de entidad o una tabla, tenga cuidado para evitar situaciones en las que el dataset se bloquee. Si se ha abierto una geodatabase personal o de archivos en ArcCatalog, una secuencia de comandos no podrá actualizar ningún contenido de la geodatabase hasta que se anule la selección y se actualice la carpeta, o se cierre ArcCatalog. Esto incluye las herramientas de secuencia de comandos.

Temas relacionados

5/9/2014