fbsql_query
(PHP 4 >= 4.0.6, PHP 5)
fbsql_query — Realiza una consulta FrontBase
Descripción
Envia la query a la base de datos activa en el servidor.
Si la consulta tiene éxito, se puede llamar fbsql_num_rows() para saber cuantas filas se devolvieron para una instrucción SELECT, o fbsql_affected_rows() para saber cuantas filas se vieron afectadas por una instrucción DELETE, INSERT, REPLACE, o UPDATE.
Parámetros
- query
-
La consulta SQL a ejecutar.
Note:
La cadena de consulta debe acabar siempre con punto y coma.
- link_identifier
-
Un identificador de enlace FrontBase devuelto por fbsql_connect() o fbsql_pconnect().
Es opcional y si no se especifica, la función intentará encontrar un enlace abierto al servidor FrontBase y de no encontrarse ningún enlace abierto intentará crear uno como si fbsql_connect() fuese invocada sin parámetros.
- batch_size
-
Valores devueltos
fbsql_query() devuelve TRUE (non-zero) o FALSE para indicar si la consulta tuvo éxito. Un valor devuelto TRUE implica que la consulta significa que la consulta es lícita y podría ser ejecutada por el servidor. No indica nada acerca del número de filas afectadas o devueltas. Es perfectamente posible que una consulta tenga éxito pero no devuelva o afecte ninguna fila.
Para instrucciones SELECT, fbsql_query() devuelve un nuevo identificador de resultado que se puede pasar a fbsql_result().
fbsql_query() también fallará y devolverá FALSE si no se tiene permiso para acceder a la(s) tabla(s) referidas por la consulta.
Ejemplos
La siguiente consulta es sintácticamente inválida, así que fbsql_query() falla y devuelve FALSE:
Example #1 Ejemplo fbsql_query()
<?php
$result = fbsql_query("SELECT * WHERE 1=1")
or die ("Consulta inválida");
?>
La siguiente consulta es semánticamente inválida si my_col no es una columna de la tabla my_tbl, así que fbsql_query() falla y devuelve FALSE:
Example #2 Ejemplo fbsql_query()
<?php
$result = fbsql_query ("SELECT my_col FROM my_tbl;")
or die ("Consulta inválida");
?>
Ver también
- fbsql_affected_rows() - Obtiene el numero de filas afectadas en la anterior operación de FrontBase
- fbsql_db_query() - Ejecuta una consulta a FrontBase
- fbsql_free_result() - Libera la memoria de resultados
- fbsql_result() - Obtiene los datos de resultado
- fbsql_select_db() - Selecciona una base de datos FrontBase
- fbsql_connect() - Abre una conexión a un servidor FrontBase
