Ejecutar SQL utilizando una conexión de ArcSDE
A veces, al trabajar con tablas no sometidas al control de versiones, puede parecer más fácil consultar una tabla de una base de datos utilizando el lenguaje de consultas (SQL) en lugar de utilizar una de las herramientas de geoprocesamiento. El objeto ArcSDESQLExecute admite la ejecución de la mayoría de las instrucciones SQL y devuelve al usuario los resultados de esas instrucciones. El objeto devuelve una lista de listas en el caso de que la instrucción devuelva filas de una tabla; para las instrucciones que no devuelven filas, devuelve una indicación del éxito o error de la instrucción (True para éxito, None para error).
Precaución:- Las tablas de ArcSDE y GDB no se deben modificar utilizando nada que no sea el software de ArcGIS. Se pueden producir daños si estas tablas del sistema se editan directamente utilizando SQL.
- Las ediciones con SQL de datos sometidos al control de versiones solo se deben hacer a través de vistas versionadas.
- Para las geodatabases implementadas en un sistema de administración de bases de datos relacionales (DBMS) utilizando tipos de datos y formatos de tablas del DBMS, se puede utilizar el SQL del propio DBMS para trabajar con la información almacenada en la base de datos.
- Al acceder a la información en una geodatabase a través de SQL, las aplicaciones externas pueden acceder a los datos tabulares que administra la geodatabase. Estas aplicaciones externas pueden ser aplicaciones de bases de datos no espaciales o aplicaciones espaciales personalizadas desarrolladas en un entorno distinto de ArcObjects. Sea consciente, sin embargo, de que el acceso SQL a la geodatabase omite la funcionalidad de la geodatabase, tal como topología, redes, terrenos u otras extensiones de clase o espacio de trabajo.
- Podría ser posible usar las entidades del DBMS como desencadenadores y los procedimientos almacenados para mantener las relaciones entre las tablas que son necesarias para ciertas funcionalidades de geodatabase. Sin embargo, si se ejecutan comandos SQL contra la base de datos sin tener en cuenta esta funcionalidad, por ejemplo si se emiten instrucciones INSERT para agregar registros a una tabla de negocios, se evitará la funcionalidad de la geodatabase y, probablemente, se dañarán las relaciones entre los datos de la geodatabase.
- Antes de intentar obtener acceso a objetos de ArcSDE o GDB, o de modificarlos, lea toda la documentación de ArcSDE y de la geodatabase relativa a la utilización de SQL contra los objetos GDB o ArcSDE en el DBMS.
|
Propiedad | |
|---|---|
|
transactionAutoCommit |
Intervalo de confirmación automática. Se puede utilizar para forzar confirmaciones intermedias una vez modificado un número determinado de entidades. |
|
Métodos | |
|---|---|
|
commitTransaction() |
No se confirmará ninguna instrucción DML hasta que se llame al método commitTransaction.  Nota:También se puede producir una confirmación cuando finalice la conexión con ArcSDE (consulte la documentación específica del DBMS para ver cómo trata cada DBMS las desconexiones durante una transacción). |
|
execute(sql_statement) |
Envía la instrucción SQL a la base de datos a través de una conexión de ArcSDE. Si se ejecuta execute fuera de una transacción, tendrá lugar automáticamente una confirmación cuando se ejecute la instrucción SQL (INSERT, UPDATE, DELETE). |
|
rollbackTransaction() |
Deshacer cualquier operación DML hasta la confirmación anterior. |
|
startTransaction() |
Para controlar cuándo se confirman los cambios en la base de datos, llame al método startTransaction antes de llamar a execute. Así se inicia una transacción y no se confirma ninguna instrucción DML hasta que se llama al método commitTransaction. |
El método execute envía la instrucción SQL a la base de datos a través de una conexión de ArcSDE. Si se ejecuta execute fuera de una transacción, tendrá lugar automáticamente una confirmación cuando se ejecute la instrucción SQL (INSERT, UPDATE, DELETE).
ArcSDESQLExecute admite el modelo de transacción de ArcSDE. Las transacciones son una propiedad de una conexión ArcSDE, y enlazan operaciones de modo que se acepte o se rechace un conjunto completo de cambios. Por ejemplo, si se actualiza un conjunto de parcelas en un orden determinado, puede utilizar una transacción para definir el principio y el fin de los cambios, para que todos los cambios se envíen juntos. Si un conjunto de cambios no se puede insertar correctamente, se rechaza la transacción completa. Todas las transacciones finalizan cuando un usuario se desconecta. ArcSDESQLExecute utiliza las funciones API de ArcSDE que se proporcionan para iniciar, confirmar y deshacer transacciones.
Si desea controlar cuándo se confirman los cambios en la base de datos, llame al método startTransaction antes de llamar a execute. Así se inicia una transacción y no se confirma ninguna instrucción DML hasta que se llama al método commitTransaction. También se puede producir una confirmación cuando finalice la conexión con ArcSDE (consulte la documentación específica del DBMS para ver cómo trata cada DBMS las desconexiones durante una transacción). Dentro de una transacción, también es posible deshacer cualquier operación DML hasta la confirmación anterior.
Está disponible una propiedad de confirmación automática a intervalos, transactionAutoCommit. Se puede utilizar para forzar confirmaciones intermedias una vez modificado un número determinado de entidades.
Consulte la guía de referencia de SQL del DBMS específico para ver ayuda sobre la escritura de instrucciones SQL.
Ejemplos
import arcpy from arcpy import env import sys try: # Make data path relative # env.workspace = sys.path[0] # Two ways to create the object, which also creates the connection to ArcSDE. # Using the first method, pass a set of strings containing the connection properties: # <serverName>,<portNumber>,<version>,<userName>,<password> # sdeConn = arcpy.ArcSDESQLExecute("gpserver3","5151","#","toolbox","toolbox") # Using the second method pass the path to a valid ArcSDE connection file # sdeConn = arcpy.ArcSDESQLExecute("data\Connection to GPSERVER3.sde") # Get the SQL statements, separated by ; from a text string. # SQLStatement = arcpy.GetParameterAsText(0) SQLStatementList = SQLStatement.split(";") print "+++++++++++++++++++++++++++++++++++++++++++++\n" # For each SQL statement passed in, execute it. # for sql in SQLStatementList: print "Execute SQL Statement: " + sql try: # Pass the SQL statement to the database. # sdeReturn = sdeConn.execute(sql) except Exception, ErrorDesc: print ErrorDesc sdeReturn = False # If the return value is a list (a list of lists), display each list as a row from the # table being queried. if isinstance(sdeReturn, list): print "Number of rows returned by query: " + str(len(sdeReturn)), "rows" for row in sdeReturn: print row print "+++++++++++++++++++++++++++++++++++++++++++++\n" else: # If the return value was not a list, the statement was most likely a DDL statment. # Check its status. if sdeReturn == True: print "SQL statement: " + sql + " ran sucessfully." print "+++++++++++++++++++++++++++++++++++++++++++++\n" else: print "SQL statement: " + sql + " FAILED." print "+++++++++++++++++++++++++++++++++++++++++++++\n" except Exception, ErrorDesc: print Exception, ErrorDesc except: print "Problem executing SQL."
# WARNING - DO NOT USE ON VERSIONED TABLES OR FEATURE CLASSES. # DO NOT USE ON ANY ArcSDE or GDB SYSTEM TABLES. # DOING SO MAY RESULT IN DATA CORRUPTION. import arcpy from arcpy import env import sys try: # Make data path relative (not relevant unless data is moved here and paths modified) # env.workspace = sys.path[0] #Column name:value that should be in the record. # SQLvalues = {"STREET_NAM":"'EUREKA'"} #Value that is incorrect if found in the above column. # badVal = "'EREKA'" #List of tables to look in for the bad value. # tableList = ["streetaddresses_blkA","streetaddresses_blkB", "streetaddresses_blkC"] # Two ways to create the object, which also creates the connection to ArcSDE. # Using the first method, pass a set of strings containing the connection properties: # <serverName>,<portNumber>,<version>,<userName>,<password> # sdeConn = arcpy.ArcSDESQLExecute("gpserver3","5151","#","toolbox","toolbox") # Using the second method pass the path to a valid ArcSDE connection file # sdeConn = arcpy.ArcSDESQLExecute("data\Connection to GPSERVER3.sde") for tbl in tableList: print "++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++" for col, val in SQLvalues.items(): print "++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++" #Check for the incorrect value in the column for the specific rows. If the table contains the #incorrect value, correct it using the update SQL statement. # print "Analyzing table " + tbl + " for bad data: Column:" + col + " Value: " + badVal try: sql = "select OBJECTID," + col + " from " + tbl + " where " + col + " = " + badVal print "Attempt to execute SQL Statement: " + sql sdeReturn = sdeConn.execute(sql) except Exception, ErrorDesc: print ErrorDesc sdeReturn = False if isinstance(sdeReturn, list): if len(sdeReturn) > 0: print "Identified " + str(len(sdeReturn)) + " rows with incorrect data. Starting transaction for update." # Start the transaction # sdeConn.startTransaction() print "Transaction started....." # Perform the update # try: sql = "update " + tbl + " set " + col + "=" + str(val) + " where " + col + " = " + badVal print "Changing bad value: " + badVal + " to the good value: " + val + " using update statement:\n " + sql sdeReturn = sdeConn.execute(sql) except Exception, ErrorDesc: print ErrorDesc sdeReturn = False # If the update completed sucessfully, commit the changes. If not, rollback. # if sdeReturn == True: print "Update statement: \n" + sql + " ran successfully." # Commit the changes # sdeConn.commitTransaction() print "Commited Transaction" # List the changes. # try: print "Displaying updated rows for visual inspection." sql = "select OBJECTID," + col + " from " + tbl + " where " + col + " = " + val print "Executing SQL Statement: \n" + sql sdeReturn = sdeConn.execute(sql) except Exception, ErrorDesc: print ErrorDesc sdeReturn = False if isinstance(sdeReturn, list): print len(sdeReturn), "rows" for row in sdeReturn: print row print "+++++++++++++++++++++++++++++++++++++++++++++\n" else: if sdeReturn == True: print "SQL statement: \n" + sql + "\nran successfully." print "+++++++++++++++++++++++++++++++++++++++++++++\n" else: print "SQL statement: \n" + sql + "\nFAILED." print "+++++++++++++++++++++++++++++++++++++++++++++\n" print "+++++++++++++++++++++++++++++++++++++++++++++\n" else: print "SQL statement: \n" + sql + "\nFAILED. Rolling back all changes." # Rollback changes # sdeConn.rollbackTransaction() print "Rolled back any changes." print "+++++++++++++++++++++++++++++++++++++++++++++\n" else: print "No records required updating." # Disconnect and exit del sdeConn print "++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++" except Exception, ErrorDesc: print Exception, ErrorDesc except: print "Problem executing SQL."