- Lectura de datos durante la inicialización
- Texto de la consulta SQL
- Ejecutar una consulta SQL con parámetros
- inyección SQL: ¿Cómo prevenirlo?
- Combinaciones
- ¿Por qué debe utilizarse la constante hQueryWithoutCorrection?
- Condición de una clave compuesta en una consulta SQL
- Consultas sobre archivos de datos HFSQL
- Optimización para ejecutar la misma consulta varias veces (sólo accesos nativos de Oracle y SQL Server)
- Especificación y recuperación de valores al ejecutar una consulta (procedimientos almacenados)
- Consultas SQL (HExecuteSQLQuery o ejecución de consultas SQL creadas en el editor de consultas)
- Consultas de navegación (HReadFirst)
HExecuteSQLQuery (Función)
 No disponible con este tipo de conexión
CustomerQry is Data Source
// Initialize the "Customer" query
HExecuteSQLQuery(CustomerQry, "SELECT NAME FROM CUSTOMER")
TaskQry is Data Source
// Initialize the "TaskQry" query
// This query is using a WLanguage function
// This query selects the tasks exceeding 5 days
HExecuteSQLQuery(TaskQry, ...
"SELECT Task.Caption FROM Task" +...
"WHERE WL.DateDifference(Task.StartTime, Task.EndDate) > 5")
// Dynamic modification of the LIMIT condition of a SQL query
QRY is Data Source
sMyQry is string = [
SELECT * FROM
ZIPCODES
%1
]
sMyQry = StringBuild(sMyQry, "LIMIT 1, 10")
IF NOT HExecuteSQLQuery(QRY, hQueryDefault, sMyQry) THEN
Error(HErrorInfo())
ELSE
Info("The query contains " + HNbRec(QRY) + " records.")
END
Sintaxis
Running an SQL query (without connection) Ocultar los detalles
<Result> = HExecuteSQLQuery(<Query name> [, <Mode>] , <Texto de la consulta SQL>)
<Result>: Boolean - True si la consulta SQL fue inicializada,
- en casoFalse contrario. HErrorInfo devuelve más detalles sobre el problema.
<Query name>: Character string (with or without quotes) or data source - Nombre de la consulta que se ejecutará. Este nombre se utiliza para manipular el resultado de <Texto de la consulta SQL> por programación. Si ya se ha declarado una consulta con el mismo nombre, se sustituye por la nueva consulta.
 Versiones 23 y posterioresNombre de la consulta SQL variable que contiene el código SQL de la consulta. En este caso, no se debe especificar el parámetro <Text of SQL query>..  Este tipo de variable no está disponible.  Nueva funcionalidad versión 23Nombre de la consulta SQL variable que contiene el código SQL de la consulta. En este caso, no se debe especificar el parámetro <Text of SQL query>.. Este tipo de variable no está disponible.
Este tipo de variable no está disponible.
<Mode>: Optional Integer constant Opción para inicializar la consulta: | | hWithFilter
(constante que se puede combinar con las otras constantes) | Si se especifica este parámetro:- el resultado de la consulta corresponde a una selección de registros de filtro si el motor HFSQL lo permite. De lo contrario, el resultado de la consulta corresponde a una vista HFSQL.
- no se permiten las siguientes operaciones: buscar en el resultado de la consulta, consulta sobre consulta, ver sobre consulta, consulta sobre consulta.
- se ignoran los elementos de búsqueda especificados al navegar por el resultado.
- la lupa no está disponible para las tablas relacionado de una consulta.
- HNbRec no se puede utilizar en las consultas.
Atención: si se especifica esta opción, se utiliza automáticamente la constante hModifyFile.
Si no se especifica este parámetro (por defecto):- el resultado de la consulta corresponde a una vista HFSQL.
- se pueden realizar las siguientes operaciones en las consultas: buscar en el resultado de la consulta, consulta sobre consulta, ver sobre consulta, consulta sobre consulta.
- se tienen en cuenta los elementos de búsqueda especificados al navegar por el resultado.
- la lupa está disponible para las tablas relacionado a una consulta.
- HNbRec se puede utilizar en las consultas.
| | hWithTransaction | La consulta se ejecuta en una operación. Se inicia una transacción, los registros se bloquean en lectura/escritura durante la ejecución de la consulta y se desbloquean al final de su ejecución, independientemente del resultado (fracaso o éxito). Si la consulta no puede finalizar correctamente (registros bloqueados, corte de energía,...), la transacción se cancela y los archivos de datos se restauran a su estado anterior (antes de la ejecución de la consulta). señalar: la ejecución de la consulta puede ralentizarse. | hModifyFile
(constante que se puede combinar con las otras constantes) | - En archivos de datos HFSQL : Al modificar el resultado de la consulta (HAddHWrite, HModify, , , HCross,HDelete), estas modificaciones se aplicarán a los ficheros de datos que intervienen en la consulta..
Si no se especifica esta opción, sólo se modifica el resultado de la consulta..
Ver Modificar el contenido de la consulta para más detalles. - En archivos de datos en un formato distinto a HFSQL, la constante hModifyFile es inútil.: los ficheros de datos que intervienen en la consulta se modifican automáticamente al modificar el resultado de la consulta.
| | hQueryBreakable | La inicialización de la consulta se puede interrumpir con la tecla ESC. | hQueryDefault
(valor por defecto) | La consulta se inicializa sin interrupción. | | hQueryWithoutCorrection | | | hQueryWithoutHFCorrection | | | hNoBind | | Versiones 21 y posterioreshNoHourglass Nueva funcionalidad versión 21hNoHourglass hNoHourglass | Al leer el resultado de la consulta, esta operación de lectura puede bloquearse y por defecto aparece un reloj de arena.. Esta constante se utiliza para no mostrar el reloj de arena en este caso.
| | hSQLUnicode | | | hYield | Para las consultas UPDATE y DELETE realizadas sobre un número importante de registros y siendo bastante larga, esta constante se utiliza para devolver el control a las demás aplicaciones que utilizan los ficheros de datos..
En este caso:- la consulta es un poco más lenta,
- el servidor de archivos no está saturado,
- los demás usuarios de archivos de datos pueden acceder a ellos sin estar bloqueados.
| | hCheckDuplicates | Permite la gestión de duplicados durante la ejecución de la consulta.. La consulta no se ejecuta si se produce un error duplicado.
Esta constante fuerza la constante hWithTransaction.. Se inicia una transacción, los registros se bloquean en lectura/escritura durante la ejecución de la consulta y se desbloquean al final de su ejecución, independientemente del resultado (fracaso o éxito).. Si la aplicación se detiene durante la ejecución de la consulta (por ejemplo, corte de energía), la transacción se cancelará la próxima vez que se utilicen los archivos de datos de la consulta..
señalar: la ejecución de la consulta puede ralentizarse. | | hCheckIntegrity | Permite la gestión de la integridad durante la ejecución de la consulta.. La consulta no se ejecuta si se produce un error de integridad.
Esta constante fuerza la constante hWithTransaction. Se inicia una transacción, los registros se bloquean en lectura/escritura durante la ejecución de la consulta y se desbloquean al final de su ejecución, independientemente del resultado (fracaso o éxito).. Si la aplicación se detiene durante la ejecución de la consulta (por ejemplo, corte de energía), la transacción se cancelará la próxima vez que se utilicen los archivos de datos de la consulta..
señalar: la ejecución de la consulta puede ralentizarse. |
Versiones 16 y posteriores Nueva funcionalidad versión 16 <Texto de la consulta SQL>: Character string (with quotes) Texto de la consulta SQL a ejecutar. Este texto puede corresponder a una cadena de caracteres en formato ANSI o en formato Unicode.. Versiones 16 y posteriores Nueva funcionalidad versión 16 Versiones 23 y posterioresEste parámetro no está disponible si <Query name> corresponde a una variable de consulta SQL. Nueva funcionalidad versión 23Este parámetro no está disponible si <Query name> corresponde a una variable de consulta SQL. Este parámetro no está disponible si <Query name> corresponde a una variable de consulta SQL.
Running an SQL query via a connection Ocultar los detalles
<Result> = HExecuteSQLQuery(<Query name> [, <Connection> [, <Mode>]] , <Texto de la consulta SQL>)
<Result>: Boolean - True si la consulta SQL fue inicializada,
- en casoFalse contrario. HErrorInfo devuelve más detalles sobre el problema.
<Query name>: Character string (with or without quotes) or data source - Nombre de la consulta que se ejecutará. Este nombre se utiliza para manipular el resultado de <Texto de la consulta SQL> por programación. Si ya se ha declarado una consulta con el mismo nombre, se sustituye por la nueva consulta.
Versiones 23 y posterioresNombre de la consulta SQL variable que contiene el código SQL de la consulta. En este caso, no se debe especificar el parámetro <Text of SQL query>.. Este tipo de variable no está disponible. Nueva funcionalidad versión 23Nombre de la consulta SQL variable que contiene el código SQL de la consulta. En este caso, no se debe especificar el parámetro <Text of SQL query>.. Este tipo de variable no está disponible. Nombre de la consulta SQL variable que contiene el código SQL de la consulta. En este caso, no se debe especificar el parámetro <Text of SQL query>..
Este tipo de variable no está disponible.
<Connection>: Optional character string or connection variable Nombre de la conexión utilizada para ejecutar la consulta. Esta conexión se definió en el editor de modelos de datos, programando con HDescribeConnection o HOpenConnection, o especificando las propiedades de la variable de conexión. <Resultado> se ajusta a si este False parámetro no corresponde a una conexión existente. <Mode>: Optional Integer constant Opción para inicializar la consulta: | | hWithFilter
(constante que se puede combinar con las otras constantes) | Si se especifica este parámetro:- el resultado de la consulta corresponde a una selección de registros de filtro si el motor HFSQL lo permite. De lo contrario, el resultado de la consulta corresponde a una vista HFSQL.
- no se permiten las siguientes operaciones: buscar en el resultado de la consulta, consulta sobre consulta, ver sobre consulta, consulta sobre consulta.
- se ignoran los elementos de búsqueda especificados al navegar por el resultado.
- la lupa no está disponible para las tablas relacionado de una consulta.
- HNbRec no se puede utilizar en las consultas.
Atención: si se especifica esta opción, se utiliza automáticamente la constante hModifyFile.
Si no se especifica este parámetro (por defecto):- el resultado de la consulta corresponde a una vista HFSQL.
- se pueden realizar las siguientes operaciones en las consultas: buscar en el resultado de la consulta, consulta sobre consulta, ver sobre consulta, consulta sobre consulta.
- se tienen en cuenta los elementos de búsqueda especificados al navegar por el resultado.
- la lupa está disponible para las tablas relacionado a una consulta.
- HNbRec se puede utilizar en las consultas.
| | hWithTransaction | La consulta se ejecuta en una operación. Se inicia una transacción, los registros se bloquean en lectura/escritura durante la ejecución de la consulta y se desbloquean al final de su ejecución, independientemente del resultado (fracaso o éxito). Si la consulta no puede finalizar correctamente (registros bloqueados, corte de energía,...), la transacción se cancela y los archivos de datos se restauran a su estado anterior (antes de la ejecución de la consulta). señalar: la ejecución de la consulta puede ralentizarse. | hModifyFile
(constante que se puede combinar con las otras constantes) | - En archivos de datos HFSQL : Al modificar el resultado de la consulta (HAddHWrite, HModify, , , HCross,HDelete), estas modificaciones se aplicarán a los ficheros de datos que intervienen en la consulta..
Si no se especifica esta opción, sólo se modifica el resultado de la consulta..
Ver Modificar el contenido de la consulta para más detalles. - En archivos de datos en un formato distinto a HFSQL, la constante hModifyFile es inútil.: los ficheros de datos que intervienen en la consulta se modifican automáticamente al modificar el resultado de la consulta.
| | hQueryBreakable | La inicialización de la consulta se puede interrumpir con la tecla ESC. | hQueryDefault
(valor por defecto) | La consulta se inicializa sin interrupción. | | hQueryWithoutCorrection | | | hQueryWithoutHFCorrection | | | hNoBind | | Versiones 21 y posterioreshNoHourglass Nueva funcionalidad versión 21hNoHourglass hNoHourglass | Al leer el resultado de la consulta, esta operación de lectura puede bloquearse y por defecto aparece un reloj de arena.. Esta constante se utiliza para no mostrar el reloj de arena en este caso.
| | hSQLUnicode | | | hYield | Para las consultas UPDATE y DELETE realizadas sobre un número importante de registros y siendo bastante larga, esta constante se utiliza para devolver el control a las demás aplicaciones que utilizan los ficheros de datos..
En este caso:- la consulta es un poco más lenta,
- el servidor de archivos no está saturado,
- los demás usuarios de archivos de datos pueden acceder a ellos sin estar bloqueados.
| | hCheckDuplicates | Permite la gestión de duplicados durante la ejecución de la consulta.. La consulta no se ejecuta si se produce un error duplicado.
Esta constante fuerza la constante hWithTransaction.. Se inicia una transacción, los registros se bloquean en lectura/escritura durante la ejecución de la consulta y se desbloquean al final de su ejecución, independientemente del resultado (fracaso o éxito).. Si la aplicación se detiene durante la ejecución de la consulta (por ejemplo, corte de energía), la transacción se cancelará la próxima vez que se utilicen los archivos de datos de la consulta..
señalar: la ejecución de la consulta puede ralentizarse. | | hCheckIntegrity | Permite la gestión de la integridad durante la ejecución de la consulta.. La consulta no se ejecuta si se produce un error de integridad.
Esta constante fuerza la constante hWithTransaction. Se inicia una transacción, los registros se bloquean en lectura/escritura durante la ejecución de la consulta y se desbloquean al final de su ejecución, independientemente del resultado (fracaso o éxito).. Si la aplicación se detiene durante la ejecución de la consulta (por ejemplo, corte de energía), la transacción se cancelará la próxima vez que se utilicen los archivos de datos de la consulta..
señalar: la ejecución de la consulta puede ralentizarse. |
Versiones 16 y posteriores Nueva funcionalidad versión 16 <Texto de la consulta SQL>: Character string (with quotes) Texto de la consulta SQL a ejecutar. Este texto puede corresponder a una cadena de caracteres en formato ANSI o en formato Unicode.. Versiones 16 y posteriores Nueva funcionalidad versión 16 Versiones 23 y posterioresEste parámetro no está disponible si <Query name> corresponde a una variable de consulta SQL. Nueva funcionalidad versión 23Este parámetro no está disponible si <Query name> corresponde a una variable de consulta SQL. Este parámetro no está disponible si <Query name> corresponde a una variable de consulta SQL. Observaciones Lectura de datos durante la inicialización Dependiendo de la consulta (clasificaciones, grupos,...), los datos pueden ser leídos (o no) cuando se inicializa la consulta. señalar: ..EjecuciónCompletada se utiliza para averiguar si la consulta está completa (y por lo tanto si las operaciones de lectura se pueden realizar sin bloqueo).. Para acceder a las posiciones de consulta, se debe declarar una Fuente de datos variable (véase Ejemplo).. La consulta se libera automáticamente cuando se destruye la variable. Para forzar la liberación de los recursos de esta consulta, utilice: Si el nombre de un artículo archivo de datos o el nombre de un artículo contiene caracteres de espacio, estos nombres deben incluirse entre corchetes en el texto de la consulta.. Por ejemplo:
SELECT [My File1].MyItem, [My File1].[My item1], MyFile2.[My key1]
From [My File1], MyFile2
WHERE [My File1].[My key1] = MyFile2.[My key1]
Ejecutar una consulta SQL con parámetros Una consulta SQL puede contener parámetros. Para ejecutar este tipo de consulta SQL con ,HExecuteSQLQuery debe: - En el texto de la consulta SQL, defina los diferentes parámetros utilizando la notación {Nombre de parámetro}.. Por ejemplo::
"SELECT * FROM customer WHERE name={p_name}"
- Definir una variable Fuente de datos.. El nombre de esta variable debe corresponder al parámetro <Nombre de la consulta> de la función HExecuteSQLQuery.
Ejemplo:
- Especifique el valor de los parámetros mediante la siguiente sintaxis:
<Data source variable >.<Name of Parameter1> = xxx
<Data source variable >.<Name of Parameter2> = xxx
<Data Source Variable >.<Name of Parameter3> = xxx
Ejemplo:
- Ejecutar la consulta SQL con la función HExecuteSQLQuery. Ejemplo:
HExecuteSQLQuery(MyQuery, "SELECT * FROM customer WHERE name={p_name}")
Nota: La estructura de los parámetros de consulta se reinicia cada vez que se ejecuta la consulta con parámetros. inyección SQL: ¿Cómo prevenirlo? La inyección SQL es una técnica de hacking; consiste en inyectar código SQL en los parámetros de las consultas, forzando la ejecución de código SQL no deseado.. Para evitar la inyección SQL al ejecutar consultas a través de ,HExecuteSQLQuery debe utilizar consultas con parámetros y no debe concatenar cadenas para crear la consulta.. Ejemplo:
// Build the query by concatenation
// -> security failure
sdQuery is Data Source
HExecuteSQLQuery(sdQuery, "SELECT * FROM customer WHERE name = '" + EDT_Name + "'")
// Using parameters in the query
// -> secure code
sdQuery is Data Source
sdQuery.p_name = EDT_Name
HExecuteSQLQuery(sdQuery, "SELECT * FROM customer WHERE name={p_name}")
La utilización de parámetros no permite interpretar el contenido como código SQL. Esta técnica evita la inyección de código SQL y elimina varios riesgos de hacking. Condición de una clave compuesta en una consulta SQL Para definir una condición en una clave compuesta en una consulta SQL, se deben especificar las condiciones para cada componente de la clave . No intente asignar directamente un valor a la clave compuesta (de hecho, las claves compuestas se almacenan como valores binarios). Ejemplo: La clave compuesta se compone de los elementos LASTNAME y FIRSTNAME (Last Name First Name):
SELECT MyFile.MyItem, MyFile.MyItem1
FROM MyFile
WHERE FileName.LastName = "Smith" and FileName.FirstName = "Fred"
Esta página también está disponible para…
|
|
|
| |
| | https://forum.pcsoft.fr/fr-FR/pcsoft.br.windev/3133-winformatica-example-hexecutesqlquery-with-break-and-filter-custom/read.awp |
|
|
|
| |
| |
| |
|
| Exemplo HexecuteSqlQuery com WHILE HOut () = False |
|
| numero_corrida é int = 0
MyProcedureUltimaCorrida é fonte de dados
IF HExecuteSQLQuery (MyProcedureUltimaCorrida, ConnNativa, hQueryWithoutCorrection, "NG0002_Procedure_UltimaCorrida") THEN
HReadFirst (MyProcedureUltimaCorrida, num_corrida)
ENQUANTO Hout () = False
ok = HReadNext (MyProcedureUltimaCorrida, num_corrida)
numero_corrida = MyProcedureUltimaCorrida.num_corrida
END
ELSE
Erro (HErrorInfo ())
END
info(numero_corrida) |
|
|
|
| |
| |
| |
|
| | n_value_demo_number is int = 1
s_value_demo_string is string = "abc"
ds_result is Data Source
b_result is boolean
s_sql is string = "CALL pr_test ("+n_value_demo_number+","+"'"+s_value_demo_string+"')"
b_resultado = HExecuteSQLQuery(ds_result,CONNECTION_NAME_HERE,hQueryDefault+hQueryWithoutCorrection,s_sql)
IF b_resultado = False THEN
error("Error Running Procedure ",herrorinfo())
END |
|
|
|
| |
| |
| |
| |
| |
| |
| | |
|