SQLConnection  - AS3

Indica si se ha activado la compactación automática en la base de datos creada originalmente (el valor especificado para el parámetro autoCompact en la llamada open() u openAsync() que creó la base de datos). Si esta propiedad es true, el espacio no utilizado se elimina automáticamente de la base de datos tras finalizar cada operación de escritura, de modo que el archivo de base de datos se hace más pequeño. Si la propiedad es false, el espacio ocupado previamente por los datos eliminados se conserva en el archivo de base de datos y se reutiliza cuando sea necesario. Incluso cuando autoCompact es false, se puede obligar a la base de datos a reclamar el espacio no utilizado mediante una llamada al método compact().

Si la propiedad connected es false, esta propiedad se establece como false.

Elementos de API relacionados

Proporciona acceso al tamaño de la caché para esta conexión. Representa el número máximo de páginas de disco de base de datos que se conservan en memoria al mismo tiempo. Cada página utiliza aproximadamente 1,5 KB de memoria (en función del valor especificado en el parámetro pageSize de la llamada al método open() u openAsync() que creó la base de datos). El tamaño predeterminado de la caché es 2000. Si una aplicación está ejecutando operaciones UPDATE o DELETE que realicen cambios en muchas filas de una base de datos, aumentar el tamaño de la caché puede acelerar la velocidad de ejecución, pero a costa de un consumo mayor de memorian.

Elementos de API relacionados

Indica el modo en que se muestran los nombres de columna en el resultado de una declaración SELECT.

Las constantes definidas en la clase SQLColumnNameStyle representan los valores posibles de esta propiedad:

• SQLColumnNameStyle.LONG indica que los nombres de columna se devuelven con el formato [nombre-tabla]_[nombre-columna].
• SQLColumnNameStyle.SHORT especifica que los nombres de columnas se devuelven con el formato [nombre-columna]. Si hay varias columnas con el mismo nombre, sólo se añade una propiedad con dicho nombre al objeto result.
• SQLColumnNameStyle.DEFAULT es el valor predeterminado. Si se utiliza este valor, los nombres de columna del resultado se devuelven con el formato del número de tablas de la declaración SELECT que tiene un número similar de nombres de columna. Si la declaración SELECT contiene solamente una tabla, se utiliza el formato de nombre corto [nombre-columna]. Si la declaración SELECT contiene varias tablas unidas entre sí, siempre y cuando no existan conflictos de nomenclatura entre nombres idénticos de columnas, se utiliza el formato de nombre largo [nombre-tabla]_[nombre-columna] para las columnas con nombre idéntico.

Elementos de API relacionados

Indica si la instancia de SQLConnection tiene una conexión abierta en el archivo de base de datos.

Elementos de API relacionados

Indica si esta conexión está activa actualmente en una transacción.

Elementos de API relacionados

Indica si la clase SQLConnection se admite en la plataforma actual o no.

Último identificador de fila creado por una declaración SQL INSERT. Los identificadores de fila se utilizan para identificar de forma exclusiva las filas de una tabla de la base de datos. Lo habitual es que el valor se genere en la base de datos.

El valor es cero si no hay ninguna base de datos conectada o si no se ha ejecutado ninguna declaración INSERT.

El identificador de fila de una sola ejecución de declaración SQL INSERT se puede obtener mediante la propiedad lastInsertRowID del objeto SQLResult devuelto por el método getResult() del objeto SQLStatement (se realiza la llamada varias veces después de que SQLStatement distribuye el evento result).

Para obtener más información sobre las claves principales y los identificadores de fila generados, consulte las secciones “CREATE TABLE” y “Expresiones” en el apéndice “Compatibilidad de SQL en bases de datos locales”.

Elementos de API relacionados

Indica el tamaño de página de la base de datos (en bytes) especificada en la base de datos creada originalmente (el valor especificado para el parámetro pageSize en la llamada open() u openAsync() que creó la base de datos).

Si la propiedad connected es false, el valor de esta propiedad es 0.

Es posible cambiar el tamaño de página de la base de datos (con los métodos open() u openAsync()) hasta que se crea la primera tabla de la base de datos.

Elementos de API relacionados

Contiene el número total de cambios de datos realizados desde que se abrió la conexión de la base de datos. Además de hacer un seguimiento de los cambios realizados por las declaraciones INSERT, DELETE y UPDATE, este valor incluye los cambios provocados por activadores.

Si la conexión de la base de datos está cerrada, el valor se reestablece en 0. Si la instancia de SQLConnection no está conectada a ninguna de base de datos, el valor es 0.

Elementos de API relacionados

Crea una instancia de SQLConnection.

Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. Puede registrar detectores de eventos en todos los nodos de la lista de visualización para un tipo concreto de evento, fase y prioridad.

Una vez registrado correctamente un detector de eventos, no puede cambiar su prioridad mediante llamadas adicionales a addEventListener(). Para cambiar la prioridad de un detector, en primer lugar debe llamar a removeListener(). Seguidamente, puede volver a registrar el nuevo nivel de prioridad.

Recuerde que, una vez registrado el detector, las siguientes llamadas a addEventListener() con un valor type o useCapture distinto tendrán como resultado la creación de un registro independiente del detector. Por ejemplo, si registra primero un detector con useCapture definido como true, detectará únicamente durante la fase de captura. Si vuelve a llamar a addEventListener() con el mismo objeto detector, pero con useCapture definido como false, tendrá dos detectores independientes: uno que detecta durante la fase de captura y otro que lo hace durante las fases de destino y de propagación.

No es posible registrar un detector de eventos únicamente para la fase de destino o la fase de propagación. Dichas fases se acoplan durante el registro, ya que la propagación sólo se aplica a los ascendientes del nodo de destino.

Si ya no necesita ningún detector de eventos, elimínelo llamando a removeEventListener(); de lo contrario, podrían surgir problemas de memoria. Los detectores de eventos no se eliminan automáticamente de la memoria, ya que el recolector de datos innecesarios no elimina el detector siempre que el objeto distribuido exista (a no ser que el parámetro useWeakReference se establezca en true).

Al copiar una instancia EventDispatcher no se copian los detectores de eventos asociados. (Si el nodo recién creado necesita un detector de eventos, debe asociarlo después de crear el nodo.) Sin embargo, si mueve una instancia EventDispatcher, los detectores de eventos asociados se moverán también.

Si el detector de eventos se registra en un nodo mientras se procesa un evento en dicho nodo, el detector de eventos no se desencadenará durante la fase actual, aunque sí se desencadenará en una fase posterior del flujo del evento, por ejemplo, en la fase de propagación.

Si un detector de eventos se elimina de un nodo mientras se procesa un evento en dicho nodo, las acciones actual seguirán desencadenándolo. Una vez eliminado, el detector de eventos ya no se vuelve a invocar nunca más (a no ser que se registre de nuevo para otro proceso).

Parámetros

function(evt:Event):void

Reúne estadísticas sobre los índices de base de datos y las guarda en la base de datos. Estas estadísticas se pueden ser utilizadas por el optimizador de consultas (la parte del motor de la base de datos que decide la forma más eficaz de ejecutar cada declaración). Las estadísticas ayudan al optimizador de consultas a tomar mejores decisione sobre los índices que se deben utilizar en cada consulta concreta.

Si una base de datos tiene índices definidos, pero no se ha llamado al método analyze(), el motor de ejecución seguirá utilizando esos índices para ejecutar declaraciones. Sin embargo, sin la información estadística adicional generada por el método analyze(), el motor de ejecución tal vez no seleccione el índice más eficaz para cada tipo de consulta.

Si cambian los datos de una tabla (como resultado de declaraciones INSERT, UPDATE o DELETE), cambian también los índices asociados a la tabla. La información estadística generada por analyze() no se actualiza automáticamente. En consecuencia, cuando se hayan realizado muchos cambios, es conveniente llamar de nuevo al método analyze() para actualizar la información. Ahora bien, el beneficio obtenido al llamar de nuevo a analyze() dependerá de diversos factores, por ejemplo, el número de índices definidos en una tabla, la relación existente entre el número de filas cambiadas y el número total de filas de la tabla, el grado de variación en los datos indexados de la tabla o la diferencia entre los datos cambiados en esta ronda y los cambiados anteriormente.

El parámetro resourceName indica si la operación debe realizarse en los índices de todas las bases de datos asociadas, en un única base de datos o en una tabla concreta.

Cada vez que se llama a este método, todos los datos estadísticos creados anteriormente se borran y se vuelven a crear para la base de datos o la tabla especificada en el parámetro resourceName (o todas las tablas de todas las bases de datos conectadas si resourceName es null). Es posible llamar a este método en cualquier momento siempre y cuadno la conexión con la base de datos esté abierta. La operación analyze() y sus datos estadísticos no se incluyen en la transacción; sin embargo, es mejor no llamar a analyze() si hay transacciones activas en la base de datos (la propiedad inTransaction es true). Esto se debe a que todos los cambios realizados en datos, esquemas de tablas o en índices ejecutados en la transacción pero no confirmados aún no se tienen en cuenta en la llamada analyze(). Por ello, los datos de analyze() estarán desfasados en cuanto se confirme la transacción.

Para eliminar los datos estadísticos creados con el método analyze(), utilice el método deanalyze().

Parámetros

Elementos de API relacionados

Añade otra base de datos a la instancia de SQLConnection y le da el nombre especificado a la nueva base de datos. Al asociar una base de datos, se permite su uso en declaraciones SQL ejecutadas con esta instancia de SQLConnection.

Si ya hay una base de datos asociada con el nombre especificado, la llamada a attach() producirá como resultado un error. Sin embargo, es posible asociar la misma base de datos varias veces siempre y cuando se utilicen nombres exclusivos. Se puede asociar un máximo de diez bases de datos a una instancia de SQLConnection.

Se puede ejecutar cualquier declaración SQL en una base de datos conectada con attach() si se ejecuta en la base de datos principal (la base de datos conectada con open() u openAsync()). Una declaración SQL puede acceder a todas las bases de datos asociadas a la instancia de SQLConnection asociada a su vez a la declaración. Se proporciona también acceso a las tablas desde varias bases de datos en una sola declaración. Si el motor de ejecución está resolviendo nombres de tablas en una declaración, busca en las bases de datos de la instancia de SQLConnection en el orden en que se han ido asociando. Se empieza por la base de datos que se conectó con el me´todo open() u openAsync(). Utilice el nombre de base de datos (tal como se especifica en el parámetro name del método attach()) de la declaración para calificar de forma explícita un nombre de tabla.

Para eliminar una base de datos asociada con el método attach(), utilice el método detach(). Cuando se cierra la instancia de SQLConnection (al llamar al método close()), se desasocian todas las bases de datos asociadas.

La base de datos asociada utiliza el mismo modo de ejecución (sincrónico o asíncrono) que la base de datos principal. Éste depende del modo de conexión de la base de datos principal, bien con el método open() o con el método openAsync().

Parámetros

Elementos de API relacionados

Inicia una transacción en la que todas las declaraciones SQL ejecutadas en las bases de datos de conexión quedan agrupadas.

De forma predeterminada, todas las declaraciones SQL se ejecutan dentro de su propia transacción, y ésta finaliza cuando la ejecución de la declaración se realiza correctamente o falla. Al crear una transacción con el método begin() se crea una nueva transacción manual. Desde ese momento, todas las declaraciones SQL se ejecutan en la instancia de SQLConnection dentro de la transacción. Cualquier acción o modificación realizada por las declaraciones se puede confirmar (convertir en permanente) o revertir (deshacer) como un grupo.

Para finalizar una transacción, llame al método commit() o rollback(), según quiera aceptar o rechazar los cambios realizados por las declaraciones de las transacciones.

Las llamadas anidadas a begin() se omiten. Puede crear puntos guardados, que son como marcadores dentro de una transacción, llamando al método setSavepoint(). Seguidamente, puede confirmar o revertir parcialmente declaraciones SQL llamando a los métodos releaseSavepoint() o rollbackToSavepoint(). Sin embargo, si una transacción se inicia llamando a begin(), los cambios no se aceptan permanentemente en la base de datos hasta que se llama al método commit().

Si la conexión con la base de datos se cierra con una transacción abierta en curso, AIR vuelve a iniciar la transacción automáticamente. (Nota: en AIR 1.1 y en versiones anteriores, una transacción abierta se cancela automáticamente cuando se cierra la conexión.)

Una transacción no se limita a ejecuciones de declaraciones en una sola base de datos; puede incluir declaraciones ejecutadas en diversas bases de datos.

Parámetros

Elementos de API relacionados

package
{
    import flash.data.SQLConnection;
    import flash.data.SQLResult;
    import flash.data.SQLStatement;
    import flash.display.Sprite;
    import flash.events.SQLErrorEvent;
    import flash.events.SQLEvent;
    import flash.filesystem.File;
    
    public class MultiInsertTransactionExample extends Sprite
    {
        private var conn:SQLConnection;
        private var insertEmployee:SQLStatement;
        private var insertPhoneNumber:SQLStatement;
        
        public function MultiInsertTransactionExample():void
        {
            // define where to find the database file
            var appStorage:File = File.applicationStorageDirectory;
            var dbFile:File = appStorage.resolvePath("ExampleDatabase.db");
            
            // open the database connection
            conn = new SQLConnection();
            conn.addEventListener(SQLErrorEvent.ERROR, errorHandler);
            conn.addEventListener(SQLEvent.OPEN, openHandler);
            conn.openAsync(dbFile);
        }
        
        // Called when the database is connected
        private function openHandler(event:SQLEvent):void
        {
            conn.removeEventListener(SQLEvent.OPEN, openHandler);
            
            // start a transaction
            conn.addEventListener(SQLEvent.BEGIN, beginHandler);
            conn.begin();
        }
        
        // Called when the transaction begins
        private function beginHandler(event:SQLEvent):void
        {
            conn.removeEventListener(SQLEvent.BEGIN, beginHandler);
            
            // create and execute the first SQL statement:
            // insert an employee record
            insertEmployee = new SQLStatement();
            insertEmployee.sqlConnection = conn;
            insertEmployee.text = 
                "INSERT INTO employees (lastName, firstName, email) " + 
                "VALUES (:lastName, :firstName, :email, :birthday)";
            insertEmployee.parameters[":lastName"] = "Smith";
            insertEmployee.parameters[":firstName"] = "Bob";
            insertEmployee.parameters[":email"] = "bsmith@example.com";
            insertEmployee.parameters[":birthday"] = new Date(1971, 8, 12);
            
            insertEmployee.addEventListener(SQLEvent.RESULT, insertEmployeeHandler);
            insertEmployee.addEventListener(SQLErrorEvent.ERROR, errorHandler);
            
            insertEmployee.execute();
        }
        
        // Called after the employee record is inserted
        private function insertEmployeeHandler(event:SQLEvent):void
        {
            insertEmployee.removeEventListener(SQLEvent.RESULT, insertEmployeeHandler);
            insertEmployee.removeEventListener(SQLErrorEvent.ERROR, errorHandler);
            
            // Get the employee id of the newly created employee row
            var result:SQLResult = insertEmployee.getResult();
            var employeeId:Number = result.lastInsertRowID;
            
            // Add a phone number to the related phoneNumbers table
            insertPhoneNumber = new SQLStatement();
            insertPhoneNumber.sqlConnection = conn;
            insertPhoneNumber.text =
                "INSERT INTO phoneNumbers (employeeId, type, number) " +
                "VALUES (:employeeId, :type, :number)";
            insertPhoneNumber.parameters[":employeeId"] = employeeId;
            insertPhoneNumber.parameters[":type"] = "Home";
            insertPhoneNumber.parameters[":number"] = "(555) 555-1234";
            
            insertPhoneNumber.addEventListener(SQLEvent.RESULT, insertPhoneNumberHandler);
            insertPhoneNumber.addEventListener(SQLErrorEvent.ERROR, errorHandler);
            
            insertPhoneNumber.execute();
        }
        
        // Called after the phone number record is inserted
        private function insertPhoneNumberHandler(event:SQLEvent):void
        {
            insertPhoneNumber.removeEventListener(SQLEvent.RESULT, insertPhoneNumberHandler);
            insertPhoneNumber.removeEventListener(SQLErrorEvent.ERROR, errorHandler);
            
            // No errors so far, so commit the transaction
            conn.addEventListener(SQLEvent.COMMIT, commitHandler);
            conn.commit();
        }
        
        // Called after the transaction is committed
        private function commitHandler(event:SQLEvent):void
        {
            conn.removeEventListener(SQLEvent.COMMIT, commitHandler);
            
            trace("Transaction complete");
        }
        
        // Called whenever an error occurs
        private function errorHandler(event:SQLErrorEvent):void
        {
            // If a transaction is happening, roll it back
            if (conn.inTransaction)
            {
                conn.addEventListener(SQLEvent.ROLLBACK, rollbackHandler);
                conn.rollback();
            }
            
            trace(event.error.message);
            trace(event.error.details);
        }
        
        // Called when the transaction is rolled back
        private function rollbackHandler(event:SQLEvent):void
        {
            conn.removeEventListener(SQLEvent.ROLLBACK, rollbackHandler);
            
            // add additional error handling, close the database, etc.
        }
    }
}

package
{
    import flash.data.SQLConnection;
    import flash.data.SQLResult;
    import flash.data.SQLStatement;
    import flash.display.Sprite;
    import flash.events.SQLErrorEvent;
    import flash.events.SQLEvent;
    import flash.filesystem.File;
    
    public class MultiDeleteTransactionExample extends Sprite
    {
        private var conn:SQLConnection;
        private var deleteEmployee:SQLStatement;
        private var deletePhoneNumbers:SQLStatement;
        
        private var employeeIdToDelete:Number = 25;
        
        public function MultiDeleteTransactionExample():void
        {
            // define where to find the database file
            var appStorage:File = File.applicationStorageDirectory;
            var dbFile:File = appStorage.resolvePath("ExampleDatabase.db");
            
            // open the database connection
            conn = new SQLConnection();
            conn.addEventListener(SQLErrorEvent.ERROR, errorHandler);
            conn.addEventListener(SQLEvent.OPEN, openHandler);
            conn.openAsync(dbFile);
        }
        
        // Called when the database is connected
        private function openHandler(event:SQLEvent):void
        {
            conn.removeEventListener(SQLEvent.OPEN, openHandler);
            
            // start a transaction
            conn.addEventListener(SQLEvent.BEGIN, beginHandler);
            conn.begin();
        }
        
        // Called when the transaction begins
        private function beginHandler(event:SQLEvent):void
        {
            conn.removeEventListener(SQLEvent.BEGIN, beginHandler);
            
            // Create and execute the first SQL statement:
            // Delete an employee's phone number records
            deletePhoneNumbers = new SQLStatement();
            deletePhoneNumbers.sqlConnection = conn;
            deletePhoneNumbers.text =
                "DELETE FROM phoneNumbers " +
                "WHERE employeeId = :employeeId";
            deletePhoneNumbers.parameters[":employeeId"] = employeeIdToDelete;
            
            deletePhoneNumbers.addEventListener(SQLEvent.RESULT, deletePhoneNumbersHandler);
            deletePhoneNumbers.addEventListener(SQLErrorEvent.ERROR, errorHandler);
            
            deletePhoneNumbers.execute();
        }
        
        // Called after the phone number records are deleted
        private function deletePhoneNumbersHandler(event:SQLEvent):void
        {
            deletePhoneNumbers.removeEventListener(SQLEvent.RESULT, deletePhoneNumbersHandler);
            deletePhoneNumbers.removeEventListener(SQLErrorEvent.ERROR, errorHandler);
            
            deleteEmployee = new SQLStatement();
            deleteEmployee.sqlConnection = conn;
            deleteEmployee.text = 
                "DELETE FROM employees " + 
                "WHERE employeeId = :employeeId";
            deleteEmployee.parameters[":employeeId"] = employeeIdToDelete;
            
            deleteEmployee.addEventListener(SQLEvent.RESULT, deleteEmployeeHandler);
            deleteEmployee.addEventListener(SQLErrorEvent.ERROR, errorHandler);
            
            deleteEmployee.execute();
        }
        
        // Called after the employee record is deleted
        private function deleteEmployeeHandler(event:SQLEvent):void
        {
            deleteEmployee.removeEventListener(SQLEvent.RESULT, deleteEmployeeHandler);
            deleteEmployee.removeEventListener(SQLErrorEvent.ERROR, errorHandler);
            
            // No errors so far, so commit the transaction
            conn.addEventListener(SQLEvent.COMMIT, commitHandler);
            conn.commit();
        }
        
        // Called after the transaction is committed
        private function commitHandler(event:SQLEvent):void
        {
            conn.removeEventListener(SQLEvent.COMMIT, commitHandler);
            
            trace("Transaction complete");
        }
        
        // Called whenever an error occurs
        private function errorHandler(event:SQLErrorEvent):void
        {
            // If a transaction is happening, roll it back
            if (conn.inTransaction)
            {
                conn.addEventListener(SQLEvent.ROLLBACK, rollbackHandler);
                conn.rollback();
            }
            
            trace(event.error.message);
            trace(event.error.details);
        }
        
        // Called when the transaction is rolled back
        private function rollbackHandler(event:SQLEvent):void
        {
            conn.removeEventListener(SQLEvent.ROLLBACK, rollbackHandler);
            
            // add additional error handling, close the database, etc.
        }
    }
}

Anula todas las declaraciones SQL actualmente en ejecución en las bases de datos conectadas a la instancia de SQLConnection. Este método se puede utilizar para detener consultas que lleven mucho tiempo en ejecución o aparentemente bloqueadas.

Si hay declaraciones en ejecución al llamar al método cancel(), este método anula las operaciones de las declaraciones y se revierten todas las actualizaciones o transacciones incompletas. Si no hay ninguna declaración en ejecución, la llamada a este método revierte una transacción abierta, pero no hace nada más.

Parámetros

Elementos de API relacionados

Cierra la conexión de la base de datos actual. Todas las bases de datos asociadas también se desasocian.

Si hay una transacción abierta al llamar a close(), ésta se revierte. Cuando se eliminan datos innecesarios de instancias de SQLConnection, el motor de ejecución llama automáticamente a close(), incluso si se cierra una aplicación de AIR mientras SQLConnection sigue conectado a la base de datos.

Parámetros

Confirma una transacción existente. Con ello, todas las acciones realizadas por las declaraciones de la transacción se aplican de forma permanente a la base de datos.

Los puntos guardados intermedios, que son como marcadores en una transacción, se pueden crear llamando al método setSavepoint() método. Con los puntos guardados, es posible aprobar ciertas partes de una transacción llamando al método releaseSavepoint(), o bien revertir partes de una transacción llamando al método rollbackToSavepoint(). Sin embargo, si una transacción se abre con el método begin(), los cambios no se guardan permanentemente en la base de datos hasta que toda la transacción se aprueba llamando al método commit().

En el caso de una transacción que utilice puntos guardados, cualquier declaración revertida con el método rollbackToSavepoint() no se aprueba cuando se confirma toda la transacción. Las declaraciones confirmadas con releaseSavepoint() o cuyos puntos guardados no se hayan liberado o revertido se confirman en la base de datos.

Parámetros

Elementos de API relacionados

Reclama todo el espacio no utilizado en la base de datos. Cuando se elimina un objeto de la base de datos (una tabla, índice o activador), deja un hueco vacío. Esto hace que el archivo de base de datos sea más grande de lo necesario, pero también acelera las operaciones INSERT. Con el tiempo, las operaciones INSERT y DELETE pueden fragmentar considerablemente la estructura del archivo de base de datos, por lo que el acceso del disco al contenido de la base de datos se ve ralentizado. Para compactar el archivo de base de datos, este método elimina páginas libres, alinea datos de tabla para que sean contiguos y limpia la estructura del archivo de base de datos.

No es posible realizar la operación compact() en un archivo de base de datos asociada; sólo se puede llevar a cabo en el archivo de base de datos principal (original) abierto por la instancia de SQLConnection. Esta operación falla si hay una transacción activa y no afecta a la base de datos en memoria.

Parámetros

Elimina toda la información estadística creada por la llamada al método analyze().

Dado que las estadísticas generadas por el método analyze() ocupan espacio en la base de datos, llamar a deanalyze() permite reclamar este espacio, por ejemplo, al eliminar varios índices o tablas.

Esta operación no está incluida en una transacción activa.

Parámetros

Elementos de API relacionados

Desasocia una base de datos adicional asociada previamente a la instancia de SQLConnection con el método attach(). Es posible tener el mismo archivo de base de datos asociado varias veces con nombres distintos. Al desasociar la conexión, el resto no se ven afectados. No se puede desasociar una base de datos si la conexión tiene una transacción abierta (si la propiedad inTransaction es true).

Parámetros

Elementos de API relacionados

Proporciona acceso al resultado de una llamada al método loadSchema(). El método getSchemaResult() se comporta como una cola en la que los primeros resultados que entran son los primeros que salen. Cada vez que finaliza una llamada al método loadSchema() (cada vez que se distribuye el evento schema en modo de ejecución asíncrono), se añade un nuevo objeto SQLSchemaResult a la cola. Cada vez que se llama al método getSchemaResult(), el resultado más antiguo (el que se añadió a la lista en primer lugar) se devuelve y se elimina de la cola. Si ya no quedan objetos en la cola, getSchemaResult() devuelve null.

Cuando se cierra la conexión de la base de datos, el método devuelve null.

Elementos de API relacionados

Carga información de esquema desde la base de datos conectada o desde las bases de datos asociadas. El esquema indica la estructura de las tablas, columnas, índices y activadores de la base de datos.

Para acceder al esquema cargado, utilice el método SQLConnection.getSchemaResult().

En modo de ejecución asíncrono, se distribuye un evento schema si la operación se realiza correctamente; si la operación falla, se distribuye un evento error.

La combinación de los valores de parámetro de type y name determina el tipo de esquema generado por el método loadSchema() y, en consecuencia, los valores de las propiedades de la instancia SQLSchemaResult que se genera. En la siguiente tabla se muestran los pares type/name y los datos de esquema que se generan como resultado:

Si la combinación de los argumentos type y name no corresponde a ninguna de las combinaciones especificadas, se distribuye un evento error en el modo de ejecución asíncrono, o se emite una excepción en el modo de ejecución sincrónico. Por ejemplo, si el argumento type es SQLViewSchema y el argumento name es el nombre de una tabla (en vez del nombre de una vista), se emite un error indicando que la base de datos no contiene ningún objeto del tipo y nombre especificados.

Si la base de datos está vacía (no contiene tablas, vistas, activadores o índices), al llamar al método loadSchema() se produce un error.

Parámetros

Elementos de API relacionados

Abre una conexión sincrónica con el archivo de base de datos en la ubicación especificada del sistema de archivos, crea y abre un nuevo archivo de base de datos en la ubicación, o bien crea y abre una base de datos en memoria. La creación y la apertura de la base de datos, así como otras operaciones realizadas con esta instancia de SQLConnection (includa la ejecución de declaraciones y otras operaciones realizadas por una instancia de SQLStatement asociada a esta instancia deSQLConnection) se llevan a cabo de forma sincrónica cuando la base de datos está abierta con este método. Para realizar operaciones de forma asíncrona, abra la conexión de la base de datos con el me´todo openAsync().

Una vez conectada la base de datos, utilice una instancia de SQLStatement para ejecutar comandos SQL. Las operaciones de base de datos, como iniciar o finalizar transacciones, cargar esquemas de información, etc., se llevan a cabo con la instancia de SQLConnection.

Se asigna automáticamente el nombre "main" a una base de datos conectada con el método open(). Este nombre se puede utilizar para calificar explícitamente nombres de tablas en declaraciones SQL con el formato [nombre-basededatos].[nombre-tabla].

Parámetros

Elementos de API relacionados

Abre una conexión asíncrona con el archivo de base de datos en la ubicación especificada del sistema de archivos, crea y abre un nuevo archivo de base de datos en la ubicación, o bien crea y abre una base de datos en memoria. La creación y la apertura de la base de datos, así como otras operaciones realizadas con esta instancia de SQLConnection (includa la ejecución de declaraciones y otras operaciones realizadas por una instancia de SQLStatement asociada a esta instancia deSQLConnection) se llevan a cabo de forma asíncrona cuando la base de datos está abierta con este método. Para realizar operaciones de forma sincrónica, abra la conexión de la base de datos con el me´todo open().

Una vez conectada la base de datos, utilice una instancia de SQLStatement para ejecutar comandos SQL. Las operaciones de base de datos, como iniciar o finalizar transacciones, cargar esquemas de información, etc., se llevan a cabo con la instancia de SQLConnection.

Se asigna automáticamente el nombre "main" a una base de datos conectada con el método openAsync(); este nombre se puede utilizar para calificar explícitamente nombres de tablas en declaraciones SQL con el formato [nombre-basededatos].[nombre-tabla].

Parámetros

Elementos de API relacionados

Cambia la clave de codificación de una base de datos codificada. Este método sólo afecta a la clave de codificación de la base de datos principal (la que se conecta utilizando el método open() u openAsync()). Sólo se puede llamar a reencrypt() en una base de datos codificada en el momento de su creación. Una vez que una base de datos se ha creado como codificada, no se puede anular su codificación. Del mismo modo, las bases de datos creadas sin codificación no se pueden codificar más adelante.

La operación de recodificación se ejecuta en su propia transacción. Si se interrumpe el proceso de recodificación, la base de datos reinicia la transacción y la clave de codificación no sufre cambios.

Parámetros

Elementos de API relacionados

Este método confirma las operaciones SQL realizadas desde el punto guardado más reciente o desde el nombre del punto guardado si se ha especificado uno.

Tenga en cuenta que hasta que no se confirma toda la transacción, los cambios no se guardan permanentemente en la base de datos. Si la operación se inicia con el método begin(), se debe llamar al método commit() para aprobar toda la transacción. Si la operación se inicia llamando a setSavepoint() mientras inTransaction es false, puede finalizar toda la transacción llamando al método commit() o a releaseSavepoint() o rollbackToSavepoint() para el primer punto guardado de la transacción.

Si el código llama al método rollback(), se eliminarán permanentemente todos los cambios de la transacción, independientemente de si se llamó a releaseSavepoint() antes de revertir la transacción.

Si se llama a este método sin ningún parámetro (o con null para el parámetro name), se confirman todos los cambios de la base de datos desde el punto guardado más reciente sin nombre (el punto guardado más reciente creado llamando a setSavepoint() sin ningún parámetro name). Por ejemplo, si se llama al método setSavepoint() tres veces, se establecen tres puntos guardados. Al llamar a releaseSavepoint() en dicho punto, se confirman las operaciones SQL realizadas desde el tercer punto guardado (el más reciente).

Si se proporciona un valor para el parámetro name, este método confirmará todas las operaciones SQL realizadas desde el punto guardado con el nombre especificado. Si se han creado otros puntos guardados más recientemente que el especificado, también se confirman las operaciones realizadas después de dichos puntos.

Una vez que se libera o se revierte un punto guardado, dicho punto y los más recientes se eliminan. Si el código ejecuta operaciones SQL adicionales después de que una llamada a releaseSavepoint() o a rollbackToSavepoint() elimine un punto guardado, dichas operaciones pasan a formar parte del punto guardado restante más reciente. (Es decir, que pertenezcan al punto guardado creado más recientemente antes del punto guardado eliminado.) Si no queda ningún punto guardado, las operaciones pertenecen a la transacción principal.

Parámetros

Elementos de API relacionados

Elimina un detector del objeto EventDispatcher. Si no hay ningún detector coincidente registrado con el objeto EventDispatcher, la llamada a este método no surtirá ningún efecto.

Parámetros

Revierte una transacción existente creada con el método begin(), lo que significa que todos los cambios realizados en cualquier declaración SQL de la transacción quedan descartados.

Los puntos guardados intermedios se pueden marcar en una transacción llamando al método setSavepoint(). Con los puntos guardados, es posible aprobar ciertas partes de una transacción llamando al método releaseSavepoint(), o bien revertir partes de una transacción llamando al método rollbackToSavepoint(). Sin embargo, si se llama al método rollback(), se descartan permanentemente todos los cambios realizados en una transacción, independientemente de si los puntos guardados se han liberado (confirmado) antes de revertir la transacción.

Parámetros

Elementos de API relacionados

Revierte cualquier operación SQL realizada desde el punto guardado más reciente o desde el nombre del punto guardado si se ha especificado uno.

Tenga en cuenta que si toda la transacción se confirma llamando al método commit(), los cambios en la transacción que no se hayan revertido con el método rollbackToSavepoint() se guardarán permanentemente en la base de datos. Además, llamar al método rollback() hace que se descarten permanentemente todos los cambios, independientemente de si se han liberado (confirmado) o revertido puntos guardados individuales antes de revertir la transacción.

Si se llama a este método sin ningún parámetro (o con null para el parámetro name), se revierte toda la base de datos desde el punto guardado más reciente sin nombre (la llamada más reciente a setSavepoint() sin ningún parámetro name).

Si se proporciona un valor para el parámetro name, este método revertirá todas las operaciones SQL realizadas desde el punto guardado con el nombre especificado. Si se han creado otros puntos guardados más recientemente que el especificado, también se revierten las operaciones realizadas desde dichos puntos.

Una vez que se libera o se revierte un punto guardado, dicho punto y los más recientes se eliminan. Si el código ejecuta operaciones SQL adicionales después de que una llamada a releaseSavepoint() o a rollbackToSavepoint() elimine un punto guardado, dichas operaciones pasan a formar parte del punto guardado restante más reciente. (Es decir, que pertenezcan al punto guardado creado más recientemente antes del punto guardado eliminado.) Si no queda ningún punto guardado, las operaciones pertenecen a la transacción principal.

Parámetros

Elementos de API relacionados

Crea un punto guardado, que es como un marcador dentro de una transacción de base de datos. Un punto guardado representa un punto dentro de una transacción. El conjunto de operaciones SQL realizadas entre puntos guardados se puede confirmar o revertir de forma independiente de otras operaciones utilizando los métodos releaseSavepoint() y rollbackToSavepoint(). De este modo, el uso de un punto guardado permite tratar un conjunto de operaciones SQL como una transacción anidada.

Cuando se llama al método setSavepoint(), si aún no se ha abierto ninguna transacción (mediante una llamada al método begin()), al llamar a este método se inicia la transacción y crea un punto guardado al comienzo de la transacción. Si una transacción ya está abierta, llamar a setSavepoint() crea un punto guardado dentro de la transacción.

Tenga en cuenta que hasta que no se confirma toda la transacción, los cambios no se guardan permanentemente en la base de datos. Si la operación se inicia con el método begin(), se debe llamar al método commit() para aprobar toda la transacción. Si la operación se inicia llamando a setSavepoint() mientras inTransaction es false, puede finalizar toda la transacción llamando al método commit(). La transacción también finaliza automáticamente cuando se llama a releaseSavepoint() o rollbackToSavepoint() para el punto guardado que inició la transacción.

Puede especificar un nombre para un punto guardado si proporciona un valor para el parámetro name. Esto permite revertir o confirmar todos los cambios realizados desde el punto guardado específico. Si no se especifica ningún nombre (opción predeterminada), se creará un punto guardado sin nombre.

Una vez que se libera o se revierte un punto guardado, dicho punto y los más recientes se eliminan. Si el código ejecuta operaciones SQL adicionales después de que una llamada a releaseSavepoint() o a rollbackToSavepoint() elimine un punto guardado, dichas operaciones pasan a formar parte del punto guardado restante más reciente. (Es decir, que pertenezcan al punto guardado creado más recientemente antes del punto guardado eliminado.) Si no queda ningún punto guardado, las operaciones pertenecen a la transacción principal.

Parámetros

Elementos de API relacionados

Se distibuye cuando la operación de llamada al método analyze() finaliza correctamente.

Elementos de API relacionados

Se distibuye cuando la operación de llamada al método attach() finaliza correctamente.

Elementos de API relacionados

Se distibuye cuando la operación de llamada al método begin() finaliza correctamente.

Elementos de API relacionados

Se distibuye cuando la operación de llamada al método cancel() finaliza correctamente.

Elementos de API relacionados

Se distibuye cuando la operación de llamada al método close() finaliza correctamente.

Elementos de API relacionados

Se distibuye cuando la operación de llamada al método commit() finaliza correctamente.

Elementos de API relacionados

Se distibuye cuando la operación de llamada al método compact() finaliza correctamente.

Elementos de API relacionados

Se distibuye cuando la operación de llamada al método deanalyze() finaliza correctamente.

Elementos de API relacionados

Se distirbuye cuando los datos de alguna tabla de las bases de datos concatenadas cambia como resultado de un comando SQL DELETE. Los cambios de los datos pueden ser el resultado directo de una declaración DELETE ejecutada mediante una instancia de SQLStatement, o bien ser el resultado indirecto de un activador disparado como respuesta a una ejecución de declaración.

Elementos de API relacionados

Se distibuye cuando la operación de llamada al método detach() finaliza correctamente.

Elementos de API relacionados

Se distribuye cuando cualquiera de los resultados de las operaciones asíncronas de SQLConnection tiene como resultado un error. La instancia de SQLErrorEvent distribuida como objeto event tiene una propiedad error que contiene información sobre la operación que intentaba realizarse en ese momento y la causa del fallo.

Se distirbuye cuando los datos de alguna tabla de las bases de datos concatenadas cambia como resultado de un comando SQL INSERT. Los cambios de los datos pueden ser el resultado directo de una declaración INSERT ejecutada mediante una instancia de SQLStatement, o bien ser el resultado indirecto de un activador disparado como respuesta a una ejecución de declaración.

Elementos de API relacionados

Se distibuye cuando la operación de llamada al método openAsync() finaliza correctamente.

Elementos de API relacionados

Se distribuye cuando la operación de llamada al método reencrypt() finaliza correctamente.

Elementos de API relacionados

Se distribuye cuando la operación de llamada al método releaseSavepoint() finaliza correctamente.

Elementos de API relacionados

Se distibuye cuando la operación de llamada al método rollback() finaliza correctamente.

Elementos de API relacionados

Se distribuye cuando la operación de llamada al método rollbackToSavepoint() finaliza correctamente.

Elementos de API relacionados

Se distribuye cuando la operación de llamada al método loadSchema() finaliza correctamente y los resultados del esquema están preparados.

Elementos de API relacionados

Se distribuye cuando la operación de llamada al método setSavepoint() finaliza correctamente.

Elementos de API relacionados

Se distirbuye cuando los datos de alguna tabla de las bases de datos concatenadas cambia como resultado de un comando SQL UPDATE. Los cambios de los datos pueden ser el resultado directo de una declaración UPDATE ejecutada mediante una instancia de SQLStatement, o bien ser el resultado indirecto de un activador disparado como respuesta a una ejecución de declaración.

El evento update tiene las siguientes propiedades:

Elementos de API relacionados