SQL EXECUTE SCRIPT
SQL EXECUTE SCRIPT ( rutaScript ; accionError {; nomAtrib ; valAtrib} {; nomAtrib2 ; valAtrib2 ; ... ; nomAtribN ; valAtribN} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| rutaScript | Text | → | Ruta de acceso completa del archivo que contiene el script SQL a ejecutar |
| accionError | Integer | → | Acción a efectuar en caso de error durante la ejecución del script |
| nomAtrib | Text | → | Nombre del atributo a utilizar |
| valAtrib | Text | → | Valor del atributo |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando SQL EXECUTE SCRIPT permite ejecutar una serie de instrucciones SQL ubicadas en el archivo de script designado por rutaScript.
Este comando sólo puede ejecutarse en un equipo local (4D local o procedimiento almacenado en 4D Server). Funciona con la base de datos actual (base interna o externa)
Nota: este comando no puede utilizarse con una conexión externa que se abre directamente o vía ODBC.
Pase en el parámetro rutaScript la ruta de acceso completa del archivo texto que contiene las instrucciones SQL a ejecutar. La ruta de acceso debe expresarse utilizando la sintaxis del sistema actual. Si pasa una cadena vacía ("") en rutaScript, se muestra una caja de diálogo de apertura estándar de manera que el usuario pueda seleccionar el archivo de script a ejecutar.
Nota: los comandos SQL EXPORT DATABASE y SQL EXPORT SELECTION generan automáticamente este archivo de script.
El parámetro accionError se utiliza para configurar el funcionamiento del comando cuando ocurre un error durante la ejecución del script. Puede pasar una de las siguientes tres constantes, ubicadas en el tema "":
| Constante | Tipo | Valor | Comentario |
|---|---|---|---|
| SQL On error abort | Entero largo | 1 | En caso de error, 4D detiene de inmediato la ejecución del script. |
| SQL On error confirm | Entero largo | 2 | En caso de error, 4D muestra una caja de diálogo que describe el error y permite al usuario interrumpir o continuar la ejecución del script. |
| SQL On error continue | Entero largo | 3 | En caso de error, 4D lo ignoras y continua la ejecución del script. |
Los parámetros nomAtrib y valAtrib deben pasarse en pares. Estos parámetros permiten definir los atributos específicos para la ejecución del script. En la versión actual de 4D, en nomAtrib sólo puede pasarse un atributo, disponible vía la constante siguiente, ubicada en el tema "":
| Constante | Tipo | Valor | Comentario |
|---|---|---|---|
| SQL use access rights | Cadena | SQL_Use_Access_Rights | Permite restringir los derechos de acceso a aplicar durante la ejecución de los comandos SQL del script. Cuando utilice este atributo, debe pasar 0 ó 1 en attribValue: attribValue = 1: 4D utiliza los derechos de acceso del usuario 4D actual.attribValue = 0 (o atributo no definido): 4D no restringe el acceso, se utilizan los derechos del Diseñador. |
Si el archivo de registro de peticiones de 4D está activo (vía los selectores 28 o 45 del comando SET DATABASE PARAMETER), cada comando SQL ejecutado generará una entrada con la siguiente información:
- Tipo de comando SQL
- Número de registros afectados por el comando
- Duración de ejecución del comando
- Para cada error encontrado:
- el código de error
- el texto del error si está disponible
Si el script se ejecuta correctamente (no se encuentra ningún error), la variable sistema OK toma el valor 1. En el evento de un error, la variable sistema OK toma o no el valor 0 en función del parámetro accionError:
- Si errorAction es SQL On error abort (valor 1), OK toma el valor 0.
- Si errorAction es SQL On error confirm (valor 2), OK toma el valor 0 si el usuario elije detener la operación y 1 si elije continuar.
- Si errorAction es SQL On error continue (valor 3), la variable OK siempre toma el valor 1.
Nota: si utiliza este comando para ejecutar acciones consumidoras de memoria tales como importación masiva de datos, puede considerar llamar al comando SQL ALTER DATABASE para desactivar temporalmente las opciones SQL.