SQLConnection  - AS3

Gibt an, ob bei der Erstellung der aktuellen Datenbank das automatische Verdichten aktiviert wurde (der Wert, der für den autoCompact-Parameter beim Aufrufen von open() oder openAsync(), durch den die Datenbank erstellt wurde, angegeben wurde). Weist diese Eigenschaft den Wert true auf, wird nach jedem Schreibvorgang automatisch nicht benutzter Platz aus der Datenbankdatei entfernt, um die Größe der Datei zu minimieren. Weist diese Eigenschaft den Wert false auf, verbleibt der durch entfernte Daten eingenommene Platz in der Datenbankdatei und wird bei Bedarf wiederverwendet. Selbst wenn autoCompact den Wert false aufweist, können Sie die Zurückgewinnung von nicht benutztem Platz in der Datenbank erzwingen, indem Sie die Methode compact() aufrufen.

Wenn die Eigenschaft connected den Wert false aufweist, wird diese Eigenschaft auf false gesetzt.

Verwandte API-Elemente

Bietet Zugriff auf die Cachegröße dieser Verbindung, die die Höchstzahl der jeweils auf der Festplatte gespeicherten Datenbankseiten darstellt. Pro Seite sind etwa 1,5 KB Speicher erforderlich (abhängig vom Wert des Parameters pageSize im Aufruf der Methode open() oder openAsync(), mit der die Datenbank erstellt wurde). Die standardmäßige Cache-Größe ist 2000. Wenn eine Anwendung UPDATE- oder DELETE-Vorgänge ausführt, durch die viele Zeilen der Datenbank geändert werden, können Sie durch eine Erhöhung der Cache-Größe die Geschwindigkeit auf Kosten eines erhöhten Speicherverbrauchs verbessern.

Verwandte API-Elemente

Gibt an, wie Spaltennamen im Ergebnis einer SELECT-Anweisung wiedergegeben werden.

Die in der „SQLColumnNameStyle“-Klasse definierten Konstanten repräsentieren die möglichen Werte dieser Eigenschaft:

• SQLColumnNameStyle.LONG gibt an, dass Spaltennamen im Format [tabellenname]_[spaltenname] zurückgegeben werden.
• SQLColumnNameStyle.SHORT gibt an, dass Spaltennamen im Format [spaltenname] zurückgegeben werden. Gibt es mehrere Spalten mit demselben Namen, wird nur eine Eigenschaft mit diesem Namen zum Ergebnisobjekt hinzugefügt.
• Der Standardwert ist SQLColumnNameStyle.DEFAULT. Kommt dieser Wert zur Anwendung, werden die Ergebnisspaltennamen gemäß der Anzahl Tabellen in der SELECT-Anweisung, die ähnliche Spaltennamen aufweisen, formatiert. Wenn die Anweisung SELECT nur eine Tabelle enthält, wird das kurze Namensformat [spaltenname] verwendet. Enthält die SELECT-Anweisung mehrere verbundene Tabellen und weisen zwei Spalten identische Namen auf, wird für diese das lange Namensformat [tabellenname]_[spaltenname] verwendet.

Verwandte API-Elemente

Gibt an, ob die „SQLConnection“-Instanz über eine offene Verbindung zu einer Datenbankdatei verfügt.

Verwandte API-Elemente

Gibt an, ob diese Verbindung aktuell an einer Transaktion beteiligt ist.

Verwandte API-Elemente

Gibt an, ob die SQLConnection-Klasse auf der aktuellen Plattform unterstützt wird oder nicht.

Der letzte von einer SQL INSERT-Anweisung erzeugte Zeilenbezeichner. Ein Zeilenbezeichner dient zur eindeutigen Kennzeichnung einer Zeile in einer Tabelle in der Datenbank. Der Wert wird häufig von der Datenbank erzeugt.

Der Wert lautet „zero“, wenn keine Datenbank verbunden ist oder wenn keine INSERT-Anweisung ausgeführt wurde.

Den Zeilenbezeichner für die Ausführung einer SQL INSERT-Anweisung erhalten Sie über die Eigenschaft lastInsertRowID des „SQLResult“-Objekts, das durch die Methode getResult() des „SQLStatement“-Objekts zurückgegeben wird (wenn sie aufgerufen wird, nachdem SQLStatement das result-Ereignis ausgelöst hat).

Weitere Informationen zu Primärschlüsseln und generierten Zeilenbezeichnern finden Sie in den Abschnitten „CREATE TABLE“ und „Expressions“ im Anhang „SQL-Unterstützung in lokalen Datenbanken“.

Verwandte API-Elemente

Gibt die Datenbankseitengröße (in Byte) an, die bei der Erstellung der aktuellen Datenbank angegeben wurde (der Wert, der für den Parameter pageSize beim Aufrufen von open() oder openAsync(), durch den die Datenbank erstellt wurde, angegeben wurde).

Wenn die Eigenschaft connected den Wert false aufweist, lautet der Wert dieser Eigenschaft 0.

Sie können die Seitengröße einer Datenbank ändern (mithilfe der Methoden open() oder openAsync()), solange noch keine Tabelle in der Datenbank erstellt wurde.

Verwandte API-Elemente

Gibt die Gesamtzahl der Datenänderungen an, die vorgenommen wurden, seit die Verbindung zur Datenbank hergestellt wurde. Zusätzlich zu den Änderungen, die durch INSERT-, DELETE- und UPDATE-Anweisungen vorgenommen wurden, enthält dieser Wert auch die durch Auslöser verursachten Änderungen.

Ist die Datenbankverbindung geschlossen, wird der Wert auf „0“ zurückgesetzt. Wenn die SQLConnection-Instanz mit keiner Datenbank verbunden ist, lautet der Wert „0“.

Verwandte API-Elemente

Erstellt eine „SQLConnection“-Instanz.

Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. Sie können Ereignis-Listener bei allen Knoten in der Anzeigeliste für eine bestimmte Art von Ereignis, Phase oder Priorität registrieren.

Nachdem Sie einen Ereignis-Listener erfolgreich registriert haben, können Sie seine Priorität nicht durch weitere Aufrufe von addEventListener() ändern. Um die Priorität eines Listeners zu ändern, müssen Sie zunächst removeListener() aufrufen. Anschließend können Sie den Listener mit der neuen Prioritätsstufe erneut aufrufen.

Nach der Registrierung des Listeners haben nachfolgende Aufrufe von addEventListener() mit einem anderen type- oder useCapture-Wert eine separate Listener-Registrierung zur Folge. Wenn Sie beispielsweise zuerst einen Listener registrieren, für den useCapture auf true gesetzt ist, wird dieser nur während der Aufnahmephase aktiv sein. Wenn Sie addEventListener() für dasselbe Listener-Objekt erneut aufrufen, diesmal aber useCapture auf false gesetzt ist, werden zwei separate Listener angelegt: einer, der während der Aufnahmephase aktiv ist und ein zweiter, der während der Ziel- und Bubbling-Phase aktiv ist.

Sie können einen Ereignis-Listener nicht nur für die Ziel- oder Bubbling-Phase registrieren. Die beiden Phasen hängen während der Registrierung immer zusammen, da Bubbling nur für übergeordnete Elemente des Zielknotens gilt.

Wenn Sie einen Ereignis-Listener nicht mehr brauchen, entfernen sie ihn, indem Sie removeEventListener() aufrufen. Andernfalls könnte es zu Speicherproblemen kommen. Ereignis-Listener werden nicht automatisch aus dem Speicher entfernt, da der Garbage Collector den Listener nicht entfernt, solange das auslösende Objekt vorhanden ist (sofern der useWeakReference-Parameter auf true gesetzt ist).

Beim Kopieren einer EventDispatcher-Instanz werden zugewiesene Ereignis-Listener nicht kopiert. (Wenn ein neu angelegter Knoten einen Ereignis-Listener benötigt, müssen Sie den Listener nach dem Erstellen des Knotens zuweisen.) Wenn Sie jedoch eine EventDispatcher-Instanz verschieben, werden zugewiesene Ereignis-Listener ebenfalls verschoben.

Wenn der Ereignis-Listener bei einem Knoten registriert wird, während mit diesem Knoten ein Ereignis durchgeführt wird, so wird der Ereignis-Listener während der aktuellen Phase nicht ausgelöst, kann aber während einer späteren Phase im Ereignisablauf ausgelöst werden, etwa während der Bubbling-Phase.

Wird ein Ereignis-Listener von einem Knoten entfernt, während mit dem Knoten ein Ereignis durchgeführt wird, so wird er von den aktuellen Aktionen immer noch ausgelöst. Nachdem er entfernt worden ist, wird der Ereignis-Listener nicht wieder aufgerufen (es sei denn er wird für spätere Verarbeitungsvorgänge erneut aufgerufen).

Parameter

function(evt:Event):void

Sammelt statistische Daten über Datenbankindizes und speichert sie in der Datenbank. Diese Statistiken können dann vom Abfrageoptimierer verwendet werden (der Teil der Datenbank-Engine, der die effizienteste Ausführungsweise für jede Anweisung bestimmt). Aufgrund dieser Statistiken kann der Abfrageoptimierer eine bessere Entscheidung treffen, welche Indexpositionen bei der Ausführung einer bestimmten Abfrage angewendet werden sollen.

Wenn für eine Datenbank Indexpositionen definiert wurden, aber die Methode analyze() wurde nicht aufgerufen, werden zur Laufzeit Anweisungen mithilfe dieser Indexpositionen ausgeführt. Ohne die zusätzlichen statistischen Daten, die durch die analyze()-Methode generiert werden, wird zur Laufzeit möglicherweise nicht die effizienteste Indexposition für eine bestimmte Abfrage ausgewählt.

Ändern sich die Daten einer Tabelle (aufgrund einer INSERT-, UPDATE- oder DELETE-Anweisung), werden auch die dieser Tabelle zugeordneten Indizes geändert. Die durch die Methode analyze() erzeugten statistischen Informationen werden dagegen nicht automatisch aktualisiert. Daher ist es im Allgemeinen empfehlenswert, die analyze()-Methode nach einer größeren Anzahl von Datenänderungen erneut aufzurufen. Welcher Vorteil aus einer erneuten Ausführung von analyze() gezogen werden kann, hängt jedoch von mehreren Faktoren ab: der Anzahl der für eine Tabelle definierten Indizes, dem Verhältnis zwischen der Anzahl der geänderten Zeilen und der Gesamtzahl von Zeilen in der Tabelle, wie stark die Abweichung in den indizierten Daten der Tabelle ist und wie stark sich die Daten vor und nach der Änderung unterscheiden.

Mit dem resourceName-Parameter geben Sie an, ob der Vorgang für die Indizes aller verknüpften Datenbanken, einer bestimmten Datenbank oder einer bestimmten Tabelle ausgeführt werden soll.

Durch jeden Aufruf dieser Methode werden die zuvor erstellten statistischen Daten gelöscht und für die im Parameter resourceName angegebene Datenbank oder Tabelle neu erstellt (oder alle Tabellen in allen verbundenen Datenbanken, wenn resourceName den Wert null) aufweist. Diese Methode kann jederzeit aufgerufen werden, während eine Verbindung zur Datenbank besteht. Der analyze()-Vorgang und die daraus resultierenden statistischen Daten sind nicht in einer Transaktion enthalten. Es empfiehlt sich jedoch nicht, analyze() aufzurufen, wenn in der Datenbank eine Transaktion ausgeführt wird (die inTransaction-Eigenschaft den Wert trueaufweist). Daten, ein Tabellenschema oder Indexänderungen, die zwar in der Transaktion ausgeführt aber noch nicht angewendet wurden, werden bei einem Aufruf von analyze() nicht erfasst, d. h. die aus dem Aufruf von analyze() resultierenden Daten sind veraltet, sobald die Transaktion angewendet wird.

Sie können die mit der Methode analyze() erstellten statistischen Daten mit der Methode deanalyze() entfernen.

Parameter

Verwandte API-Elemente

Fügt der „SQLConnection“-Instanz unter dem angegenenen Namen eine neue Datenbank hinzu. Nachdem eine Datenbank verknüpft wurde, können Sie sie in SQL-Anweisungen verwenden, die an dieser „SQLConnection“-Instanz ausgeführt werden.

Wenn bereits eine Datenbank mit dem angegebenen Namen verknüpft wurde, wird durch das Aufrufen von attach() ein Fehler ausgelöst. Sie können dieselbe Datenbank jedoch mehrfach mithilfe von eindeutigen Namen verknüpfen. Mit einer „SQLConnection“-Instanz können bis zu zehn Datenbanken verknüpft werden.

Jede SQL-Anweisung kann auf einer verknüpften Datenbank ausgeführt werden, und zwar mithilfe von attach(), das auf der Hauptdatenbank ausgeführt werden kann (die Datenbank, die mithilfe von open() oder openAsync() verknüpft wurde). Eine SQL-Anweisung kann auf Tabellen in allen Datenbanken zugreifen, die mit der der Anweisung zugeordneten „SQLConnection“-Instanz verknüpft sind, einschließlich dem Zugreifen auf Tabellen in mehreren Datenbanken von einer Anweisung aus. Wenn zur Laufzeit Tabellennamen in einer Anweisung aufgelöst werden, werden die Datenbanken der „SQLConnection“-Instanz in der Reihenfolge ihrer Verknüpfung durchsucht, und zwar beginnend mit der Datenbank, die mithilfe der Methode open() oder openAsync() verknüpft wurde. Geben Sie in der Anweisung den Datenbanknamen an (wie in der Methode attach() im Parameter name angegeben), um einen Tabellennamen explizit zu qualifizieren.

Eine mithilfe der Methode attach() verknüpfte Datenbank können Sie mithilfe der Methode detach() entfernen. Durch das Schließen der SQLConnection-Instanz (durch Aufrufen der Methode close()), werden die Verknüpfungen zu allen verknüpften Datenbanken aufgehoben.

Für die verknüpfte Datenbank wird der gleiche Ausführungsmodus (synchron oder asynchron) wie für die Hauptdatenbank verwendet. Ausschlaggebend ist dabei, ob die Hauptdatenbank mithilfe der Methode open() oder openAsync() verknüpft wurde.

Parameter

Verwandte API-Elemente

Startet eine Transaktion, in der alle SQL-Anweisungen, die für die Datenbanken der Verbindung ausgeführt wurden, zusammengefasst sind.

Standardmäßig wird jede SQL-Anweisung in einer separaten Transaktion ausgeführt, und die Transaktion ist beendet, wenn die Ausführung der Anweisung erfolgreich beendet wird oder fehlschlägt. Mithilfe der Methode begin() wird eine neue, manuelle Transaktion erstellt. Ab diesem Zeitpunkt erfolgt die Ausführung aller SQL-Anweisungen an der „SQLConnection“-Instanz innerhalb der Transaktion, und alle durch die Anweisung vorgenommenen Aktionen und Änderungen können als eine Gruppe übergeben (dauerhaft gemacht) oder rückgängig gemacht werden.

Beenden Sie eine Transaktion durch Aufrufen der commit()- oder rollback()-Methode, abhängig davon, ob die durch die Anweisungen der Transaktion vorgenommenen Änderungen dauerhaft gemacht oder verworfen werden sollen.

Verschachtelte Aufrufe von begin() werden ignoriert. Sie können Speicherpunkte erstellen, die eine Art Lesezeichen innerhalb einer Transaktion sind, indem Sie die setSavepoint()-Methode aufrufen. SQL-Anweisungen lassen sich dann anwenden oder zurücknehmen, indem Sie die releaseSavepoint()-Methode oder die rollbackToSavepoint()-Methode aufrufen. Wenn eine Transaktion jedoch durch einen Aufruf von begin() gestartet wurde, werden Änderungen erst dann dauerhaft von der Datenbank übernommen, wenn die commit()-Methode aufgerufen wird.

Wird die Datenbankverbindung geschlossen, während eine Transaktion geöffnet ist, macht AIR die Transaktion automatisch rückgängig. (Hinweis: Bei AIR 1.1 und niedrigeren Versionen werden offene Transaktionen beim Schließen einer Verbindung automatisch festgeschrieben.)

Eine Transaktion ist nicht auf Anweisungsausführungen in einer Datenbank beschränkt; sondern es können auch Anweisungen an verschiedenen verknüpften Datenbanken ausgeführt werden.

Parameter

Verwandte API-Elemente

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.
        }
    }
}

Bricht alle SQL-Anweisungen ab, die aktuell an mit der „SQLConnection“-Instanz verbundenen Datenbanken ausgeführt werden. Mithilfe dieser Methode können Sie langfristige oder außer Kontrolle geratene Abfragen stoppen.

Werden beim Aufrufen der cancel()-Methode gerade Anweisungen ausgeführt, werden diese Vorgänge abgebrochen und alle unvollständigen Aktualisierungen oder Transaktionen werden rückgängig gemacht. Wenn aktuell keine Anweisungen ausgeführt werden, geschieht mit Ausnahme der Rückgängigmachung einer offenen Transaktion nichts.

Parameter

Verwandte API-Elemente

Schließt die aktuelle Datenbankverbindung. Die Verbindung zu allen verknüpften Datenbanken werden ebenfalls unterbrochen.

Wenn es beim Aufrufen von close() eine offene Transaktion gibt, wird die Transaktion zurückgenommen. Wenn eine SQLConnection-Instanz durch einen Garbagekollektor entfernt wird, wird zur Laufzeit automatisch close() aufgerufen, auch wenn eine AIR-Anwendung geschlossen wird, während eine SQLConnection noch mit einer Datenbank verbunden ist.

Parameter

Übergibt eine vorhandene Transaktion, wodurch alle durch die Transaktionsanweisungen ausgeführten Aktionen dauerhaft auf die Datenbank angewendet werden.

Dazwischenliegende Speicherpunkte, die als eine Art Lesezeichen innerhalb einer Transaktion fungieren, lassen sich durch einen Aufruf der setSavepoint()-Methode erstellen. Durch das Verwenden von Speicherpunkten können Sie Teile einer Transaktion übernehmen, indem Sie die releaseSavepoint()-Methode aufrufen, oder Teile einer Transaktion zurücknehmen, indem Sie die rollbackToSavepoint()-Methode aufrufen. Wenn eine Transaktion jedoch mit der begin()-Methode geöffnet wurde, werden Änderungen nicht dauerhaft in der Datenbank gespeichert, bis die gesamte Transaktion durch einen Aufruf der commit()-Methode übernommen werden.

Für eine Transaktion, die Speicherpunkte verwendet, werden alle Änderungen, die mithilfe der rollbackToSavepoint()-Methode zurückgenommen werden, nicht übernommen, wenn die gesamte Transaktion übernommen wird. Anweisungen, die mit releaseSavepoint() übermittelt wurden oder deren Speicherpunkte nicht übermittelt oder zurückgenommen wurden, werden von der Datenbank übernommen.

Parameter

Verwandte API-Elemente

Gewinnt sämtlichen unbenutzten Platz in der Datenbank zurück. Wenn ein Objekt (Tabelle, Indexposition oder Auslöser) aus der Datenbank entfernt wird, bleibt ein leerer Platz zurück. Dadurch wird die Datenbank unnötig größer, aber andererseits können INSERT-Vorgänge schneller ausgeführt werden. Allmählich wird die Struktur der Datenbankdatei durch INSERT- und DELETE-Vorgänge fragmentiert, wodurch der Zugriff auf den Datenbankinhalt verlangsamt wird. Mithilfe dieser Methode wird die Datenbankdatei verdichtet, leere Seiten werden eliminiert, Tabellendaten werden ausgerichtet, sodass sie zusammenhängend sind und die Struktur der Datenbankdatei wird bereinigt.

An einer verknüpften Datenbankdatei kann der Vorgang compact() nicht ausgeführt werden; er kann nur an der ursprünglichen oder Hauptdatenbankdatei, die mithilfe der „SQLConnection“-Instanz geöffnet wurde, ausgeführt werden. Wenn eine Transaktion aktiv ist, schlägt dieser Vorgang fehl und hat keine Auswirkung auf eine Datenbank im Speicher.

Parameter

Entfernt alle statistischen Daten, die durch einen Aufruf der Methode analyze() erstellt wurden.

Da die durch die Methode analyze() erzeugten statistischen Daten in der Datenbank Platz einnehmen, können Sie durch Aufrufen von deanalyze() Platz zurückgewinnen, der z. B. nach dem Entfernen von Indizes oder Tabellen frei geworden ist.

Dieser Vorgang ist in einer aktiven Transaktion nicht eingeschlossen.

Parameter

Verwandte API-Elemente

Unterbricht die Verknüpfung einer zusätzlichen Datenbank, die zuvor mithilfe der Methode attach() mit der „SQLConnection“-Instanz verknüpft wurde. Sie können eine Datenbank mehrfach unter verschiedenen Namen verknüpfen. Bei der Trennung einer Verbindung bleiben die anderen Verbindungen intakt. Die Verbindung zu einer Datenbank kann nicht unterbrochen werden, wenn eine offene Transaktion vorliegt (die inTransaction-Eigenschaft weist den Wert true auf).

Parameter

Verwandte API-Elemente

Bietet Zugriff auf das Ergebnis, das sich aus einem Aufruf der Methode loadSchema() ergibt. Mit der Methode getSchemaResult() werden die ältesten Ergebnisse in der Warteschlange zuerst verarbeitet. Jedes Mal, wenn das Aufrufen der loadSchema()-Methode abgeschlossen wird (jedes Mal, wenn im asynchronen Ausführungsmodus das schema-Ereignis ausgelöst wird), wird der Warteschlange ein neues SQLSchemaResult-Objekt hinzugefügt. Bei jedem Aufrufen der Methode getSchemaResult() wird das älteste Ergebnis (das Ergebnis, das der Warteschlange als erstes hinzugefügt wurde) zurückgegeben und aus der Warteschlange entfernt. Wenn die Warteschlange keine weiteren Objekte mehr enthält, gibt getSchemaResult() den Wert null zurück.

Ist die Datenbankverbindung geschlossen, gibt die Methode den Wert null zurück.

Verwandte API-Elemente

Lädt Schemainformationen von der verbundenen Datenbank oder einer verknüpften Datenbank. Das Schema gibt die Struktur der Tabellen, Spalten, Indizes und Auslöser in der Datenbank an.

Der Zugriff auf das geladene Schema erfolgt mithhilfe der Methode SQLConnection.getSchemaResult().

Im asynchronen Ausführungsmodus wird bei einem erfolgreichen Abschluss des Vorgangs ein schema-Ereignis ausgelöst. Schlägt der Vorgang fehl, wird ein error-Ereignis ausgelöst.

Mit der Kombination aus den Werten der Parameter type und name bestimmen Sie, welcher Typ von Schemadaten mithilfe der loadSchema()-Methode erzeugt wird, und folglich bestimmen Sie damit auch die Werte der Eigenschaften der erzeugten SQLSchemaResult-Instanz. Die folgende Tabelle gibt die gültigen Paare aus type und name sowie die damit erzeugten Schemadaten an:

Entspricht die Kombination aus type- und name-Argumenten keiner der angegebenen Kombinationen, wird im asynchronen Ausführungsmodus ein error-Ereignis bzw. im synchronen Ausführungsmodus eine Ausnahme ausgelöst. Beispiel: Das Argument type weist den Wert SQLViewSchema und das Argument name weist als Wert den Name einer Tabelle (nicht den Namen einer Ansicht) auf. Die daraufhin ausgelöste Fehlermeldung gibt an, dass die Datenbank kein Objekt des angegebenen Typs mit dem angegebenen Namen enthält.

Ist die Datenbank leer (enthält keine Tabellen, Ansichten, Auslöser oder Indizes), tritt beim Aufrufen der loadSchema()-Methode ein Fehler auf.

Parameter

Verwandte API-Elemente

Öffnet eine synchrone Verbindung zu der Datenbankdatei am angegebenen Speicherort im Dateisystem oder erstellt und öffnet eine neue Datenbankdatei an diesem Speicherort oder öffnet eine Datenbank aus dem Arbeitsspeicher. Wenn die Datenbank mithilfe dieser Methode geöffnet wird, werden das Erstellen und Öffnen der Datenbank sowie andere, mithilfe dieser „SQLConnection“-Instanz ausgeführte Vorgänge synchron ausgeführt. Dazu gehören auch die Anweisungsausführung und andere Vorgänge, die durch eine dieser „SQLConnection“-Instanz zugewiesene „SQLStatement“-Instanz ausgeführt werden. Um Vorgänge asynchron auszuführen, müssen Sie die Datenbankverbindung stattdessen mithilfe der Methode openAsync() öffnen.

Nachdem die Verbindung zu einer Datenbank hergestellt wurde, verwenden Sie eine SQLStatement-Instanz, um SQL-Befehle auszuführen. Vorgänge auf Datenbankebene wie das Starten oder Beenden von Transaktionen, das Laden von Schemainformationen und andere Vorgänge werden unter Verwendung der SQLConnection-Instanz ausgeführt.

Eine Datenbank, zu der die Verbindung mithilfe der Methode open() hergestellt wird, erhält automatisch den Datenbanknamen „main“. Mit diesem Namen können Sie Tabellennamen explizit in SQL-Anweisungen qualifizieren, indem Sie sie im Format [datenbankname] angeben.[tabellenname] angeben.

Parameter

Verwandte API-Elemente

Öffnet eine asynchrone Verbindung zu der Datenbankdatei am angegebenen Speicherort im Dateisystem oder erstellt und öffnet eine neue Datenbankdatei an diesem Speicherort oder öffnet eine Datenbank aus dem Arbeitsspeicher. Wenn die Datenbank mithilfe dieser Methode geöffnet wird, werden das Erstellen und Öffnen der Datenbank sowie andere, mithilfe dieser „SQLConnection“-Instanz ausgeführte Vorgänge asynchron ausgeführt. Dazu gehören auch die Anweisungsausführung und andere Vorgänge, die durch eine dieser „SQLConnection“-Instanz zugewiesene „SQLStatement“-Instanz ausgeführt werden. Um Vorgänge synchron auszuführen, müssen Sie die Datenbankverbindung stattdessen mithilfe der Methode open() öffnen.

Nachdem die Verbindung zu einer Datenbank hergestellt wurde, verwenden Sie eine SQLStatement-Instanz, um SQL-Befehle auszuführen. Vorgänge auf Datenbankebene wie das Starten oder Beenden von Transaktionen, das Laden von Schemainformationen und andere Vorgänge werden unter Verwendung der SQLConnection-Instanz ausgeführt.

Eine Datenbank, zu der die Verbindung mithilfe der Methode openAsync() hergestellt wird, erhält automatisch den Datenbanknamen „main“. Mit diesem Namen können Sie Tabellennamen explizit in SQL-Anweisungen qualifizieren, indem Sie sie im Format [datenbankname].[tabellenname] angeben.

Parameter

Verwandte API-Elemente

Ändert den Verschlüsselungsschlüssel einer verschlüsselten Datenbank. Diese Methode wirkt sich nur auf den Verschlüsselungsschlüssel der Hauptdatenbank (jene Datenbank, die mithilfe der open()- oder openAsync()-Methode verbunden wurde), aus. reencrypt() kann nur für Datenbanken aufgerufen werden, die bei der Erstellung verschlüsselt wurden. Wurde eine Datenbank verschlüsselt erstellt, so kann die Verschlüsselung nicht mehr aufgehoben werden. Ebenso kann eine unverschlüsselt erstellte Datenbank später nicht verschlüsselt werden.

Der Vorgang der erneuten Verschlüsselung läuft in einer eigenen Transaktion ab. Wenn der Vorgang der erneuten Verschlüsselung unterbrochen wird, macht die Datenbank die Transaktion rückgängig und der Verschlüsselungsschlüssel bleibt unverändert.

Parameter

Verwandte API-Elemente

Mit dieser Methode werden die SQL-Vorgänge seit dem letzten Speicherpunkt bzw. seit dem angegebenen Speicherpunkt übernommen.

Beachten Sie, dass Änderungen erst dann dauerhaft in der Datenbank gespeichert werden, wenn die gesamte Transaktion übernommen wird. Wenn die Transaktion mit der begin()-Methode gestartet wurde, müssen Sie die commit()-Methode aufrufen, um die gesamte Transaktion zu übernehmen. Wenn die Transaktion durch einen Aufruf von setSavepoint() gestartet wurde, während inTransaction den Wert false hat, können Sie die gesamte Transaktion abschließen, indem Sie entweder die commit()-Methode oder releaseSavepoint() oder rollbackToSavepoint() für den ersten Speicherpunkt der Transaktion aufrufen.

Wenn der Code die rollback()-Methode aufruft, werden alle Änderungen an der Transaktion dauerhaft verworfen. Dies gilt unabhängig davon, ob vor dem Rollback der Transaktion releaseSavepoint() aufgerufen wurde.

Wenn diese Methode ohne Parameter (oder mit dem Wert null für den name-Parameter) aufgerufen wird, werden alle Datenbankänderungen seit dem letzten unbenannten Speicherpunkt übernommen. Dies ist der Speicherpunkt, der als letzter durch einen Aufruf der MethodesetSavepoint() ohne Festlegung des name-Parameters erstellt wurde). Wenn die setSavepoint()-Methode zum Beispiel dreimal aufgerufen wurde, werden drei Speicherpunkte erstellt. Durch einen Aufruf von releaseSavepoint() zu diesem Zeitpunkt werden die SQL-Vorgänge übernommen, die seit Erstellen des dritten (neuesten) Speicherpunktes ausgeführt wurden.

Wenn für den name-Parameter ein Wert angegeben wird, übernimmt diese Methode alle SQL-Vorgänge in die Datenbank, die seit dem Speicherpunkt mit dem angegebenen Namen ausgeführt wurden. Wurden nach dem angegebenen Speicherpunkt noch weitere Speicherpunkte erstellt, werden auch die nach diesen Speicherpunkten ausgeführten Vorgänge übernommen.

Nachdem ein Speicherpunkt übernommen oder zurückgenommen wurde, werden dieser Speicherpunkt und ggf. vorhandene neuere Speicherpunkte entfernt. Wenn der Code nach dem Aufruf von releaseSavepoint() oder rollbackToSavepoint() weitere SQL-Vorgänge ausführt, gehören diese Vorgänge zu dem neuesten verbleibenden Speicherpunkt. (Anders ausgedrückt, sie gehören zu dem Speicherpunkt, der als letztes vor dem entfernten Speicherpunkt erstellt wurde.) Wenn kein Speicherpunkt verbleibt, gehören die Vorgänge zur Haupttransaktion.

Parameter

Verwandte API-Elemente

Entfernt einen Listener aus dem EventDispatcher-Objekt. Wenn kein entsprechender Listener mit dem EventDispatcher-Objekt registriert ist, hat ein Aufruf dieser Methode keine Auswirkungen.

Parameter

Macht eine vorhandene Transaktion, die mit der Methode begin() erstellt wurde, rückgängig, d. h. alle in der Transaktion durch SQL-Anweisungen vorgenommen Änderungen werden verworfen.

Innerhalb einer Transaktion können dazwischenliegende Speicherpunkte mit einem Aufruf der setSavepoint()-Methode erstellt werden. Durch das Verwenden von Speicherpunkten können Sie Teile einer Transaktion übernehmen, indem Sie die releaseSavepoint()-Methode aufrufen, oder Teile einer Transaktion zurücknehmen, indem Sie rollbackToSavepoint() aufrufen. Mit einem Aufruf der rollback()-Methode werden jedoch alle Änderungen in einer Transaktion verworfen, unabhängig davon, ob bereits einzelne Speicherpunkte übernommen wurden, bevor die Transaktion zurückgenommen wird.

Parameter

Verwandte API-Elemente

Nimmt alle SQL-Vorgänge zurück, die seit dem letzten Speicherpunkt bzw. seit dem angegebenen Speicherpunkt ausgeführt wurden.

Beachten Sie, dass bei der Übernahme der gesamten Transaktion durch einen Aufruf der commit()-Methode alle Änderungen in der Transaktion, die nicht bereits durch einen Aufruf der rollbackToSavepoint()-Methode zurückgenommen wurden, dauerhaft in der Datenbank gespeichert werden. Durch eine Aufruf der rollback()-Methode werden alle Änderungen dauerhaft verworfen, unabhängig davon, ob vor dem Rollback der Transaktion einzelne Speicherpunkte übernommen (angewendet) oder zurückgenommen wurden.

Wenn diese Methode ohne Parameter (oder mit dem Wert null für den name-Parameter) aufgerufen wird, werden alle Datenbankänderungen seit dem letzten unbenannten Speicherpunkt zurückgenommen. Dies ist der Speicherpunkt, der als letzter durch einen Aufruf der MethodesetSavepoint() ohne Festlegung des name-Parameters erstellt wurde).

Wenn für den name-Parameter ein Wert angegeben wird, nimmt diese Methode alle SQL-Vorgänge zurück, die seit dem Speicherpunkt mit dem angegebenen Namen ausgeführt wurden. Wurden nach dem angegebenen Speicherpunkt noch weitere Speicherpunkte erstellt, werden auch die nach diesen Speicherpunkten ausgeführten Vorgänge zurückgenommen.

Nachdem ein Speicherpunkt übernommen oder zurückgenommen wurde, werden dieser Speicherpunkt und ggf. vorhandene neuere Speicherpunkte entfernt. Wenn der Code nach dem Aufruf von releaseSavepoint() oder rollbackToSavepoint() weitere SQL-Vorgänge ausführt, gehören diese Vorgänge zu dem neuesten verbleibenden Speicherpunkt. (Anders ausgedrückt, sie gehören zu dem Speicherpunkt, der als letztes vor dem entfernten Speicherpunkt erstellt wurde.) Wenn kein Speicherpunkt verbleibt, gehören die Vorgänge zur Haupttransaktion.

Parameter

Verwandte API-Elemente

Erstellt einen Speicherpunkt, der eine Art Lesezeichen innerhalb einer Datenbanktransaktion ist. Ein Speicherpunkt stellt einen Punkt innerhalb einer Transaktion dar. Die SQL-Vorgänge, die zwischen Speicherpunkten ausgeführt wurden, können separat von anderen Vorgängen übernommen oder zurückgenommen werden, indem die Methode releaseSavepoint() oder rollbackToSavepoint() aufgerufen wird. Mithilfe eines Speicherpunkts können Sie also eine Gruppe von SQL-Vorgängen als verschachtelte Transaktion behandeln.

Wenn die setSavepoint()-Methode aufgerufen wird und noch keine Transaktion geöffnet wurde (durch einen Aufruf der begin()-Methode), wird mit dieser Methode eine Transaktion gestartet und ein Speicherpunkt am Anfang der Transaktion erstellt. Wenn bereits eine Transaktion geöffnet ist, wird mit dem Aufruf von setSavepoint() ein Speicherpunkt in dieser Transaktion erstellt.

Beachten Sie, dass Änderungen erst dann dauerhaft in der Datenbank gespeichert werden, wenn die gesamte Transaktion übernommen wird. Wenn die Transaktion mit der begin()-Methode gestartet wurde, müssen Sie die commit()-Methode aufrufen, um die gesamte Transaktion zu übernehmen. Wenn eine Transaktion durch einen Aufruf von setSavepoint() gestartet wurde, während inTransaction den Wert false hat, können Sie die gesamte Transaktion beenden, indem Sie die commit()-Methode aufrufen. Die Transaktion wird auch automatisch beendet, wenn Sie releaseSavepoint() oder rollbackToSavepoint() für den Speicherpunkt, der die Transaktion gestartet hat, aufrufen.

Sie können einen Namen für einen Speicherpunkt festlegen, indem Sie einen Wert für den name-Parameter angeben. Dies ermöglicht es Ihnen, alle Änderungen, die nach diesem Speicherpunkt vorgenommen wurden, dauerhaft anzuwenden oder zurückzunehmen. Wenn kein Name angegeben wird (Standardeinstellung), wird ein unbenannter Speicherpunkt erstellt.

Nachdem ein Speicherpunkt übernommen oder zurückgenommen wurde, werden dieser Speicherpunkt und ggf. vorhandene neuere Speicherpunkte entfernt. Wenn der Code nach dem Aufruf von releaseSavepoint() oder rollbackToSavepoint() weitere SQL-Vorgänge ausführt, gehören diese Vorgänge zu dem neuesten verbleibenden Speicherpunkt. (Anders ausgedrückt, sie gehören zu dem Speicherpunkt, der als letztes vor dem entfernten Speicherpunkt erstellt wurde.) Wenn kein Speicherpunkt verbleibt, gehören die Vorgänge zur Haupttransaktion.

Parameter

Verwandte API-Elemente

Wird ausgelöst, wenn ein analyze()-Vorgang erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn der Vorgang einer attach()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn der Vorgang einer begin()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn der Vorgang einer cancel()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn der Vorgang einer close()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn der Vorgang einer commit()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn der Vorgang einer compact()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn der Vorgang einer deanalyze()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn sich in einer der verbundenen Datenbanken in einer Tabelle Daten aufgrund eines SQL DELETE-Befehls ändern. Bei dieser Datenänderung kann es sich um ein direktes Ergebnis der Ausführung einer DELETE-Anweisung durch eine SQLStatement-Instanz handeln. Es kann sich aber auch um ein indirektes Ergebnis handeln, wenn ein Auslöser auf eine Anweisungsausführung reagiert hat.

Verwandte API-Elemente

Wird ausgelöst, wenn der Vorgang einer detach()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn ein asynchroner Vorgang des „SQLConnection“-Objekts einen Fehler ergibt. Die als Ereignisobjekt ausgelöste „SQLErrorEvent“-Instanz verfügt über eine error-Eigenschaft und darin sind Informationen zu dem versuchten Vorgang und dem Grund für das Fehlschlagen enthalten.

Wird ausgelöst, wenn sich in einer der verbundenen Datenbanken in einer Tabelle Daten aufgrund eines SQL INSERT-Befehls ändern. Bei dieser Datenänderung kann es sich um ein direktes Ergebnis der Ausführung einer INSERT-Anweisung durch eine SQLStatement-Instanz handeln, oder ein indirektes Ergebnis, wenn ein Auslöser auf eine Anweisungsausführung reagiert hat.

Verwandte API-Elemente

Wird ausgelöst, wenn der Vorgang einer openAsync()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn der Vorgang einer reencrypt()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird abgesetzt, wenn der Vorgang einer releaseSavepoint()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn der Vorgang einer rollback()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird abgesetzt, wenn der Vorgang einer rollbackToSavepoint()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn der Vorgang einer loadSchema()-Methode erfolgreich ausgeführt wurde und die Schemaergebnisse bereit sind.

Verwandte API-Elemente

Wird abgesetzt, wenn der Vorgang einer setSavepoint()-Methode erfolgreich ausgeführt wurde.

Verwandte API-Elemente

Wird ausgelöst, wenn sich in einer der verbundenen Datenbanken in einer Tabelle Daten aufgrund eines SQL UPDATE-Befehls ändern. Bei dieser Datenänderung kann es sich um ein direktes Ergebnis der Ausführung einer UPDATE-Anweisung durch eine SQLStatement-Instanz handeln. Es kann sich aber auch um ein indirektes Ergebnis handeln, wenn ein Auslöser auf eine Anweisungsausführung reagiert hat.

Das update-Ereignis hat folgende Eigenschaften:

Verwandte API-Elemente