SQLConnection  - AS3

現在のデータベースが最初に作成されたときに、自動縮小が有効になっていたかどうかを示します（autoCompact パラメーターに指定されていた値で、データベースを作成した open() または openAsync() の呼び出しで指定したものです）。このプロパティが true の場合、各書き込み処理の後に、未使用領域がデータベースファイルから自動的に削除され、データベースファイルのサイズが小さく保たれます。このプロパティが false の場合、削除されたデータが占有していた領域はデータベースファイルに残り、必要に応じて再使用されます。autoCompact が false であっても、compact() メソッドを呼び出すことでデータベースに強制的に未使用領域を再要求させることができます。

connected プロパティが false の場合、このプロパティは false に設定されます。

関連する API エレメント

この接続に対するキャッシュサイズへのアクセスを提供します。これは、一度にメモリに確保される最大のデータベースディスクページ数を表します。各ページは、約 1.5 KB のメモリを使用します。この使用量は、pageSize パラメーター（データベースを作成した open() または openAsync() メソッド呼び出しで指定）で指定されている値によって異なります。デフォルトのキャッシュサイズは 2000 です。データベースの行を大量に変更する UPDATE 操作または DELETE 操作をアプリケーションで実行する場合は、キャッシュサイズを増やすことで処理速度が向上する場合があります。ただし、より多くのメモリが消費されます。

関連する API エレメント

SELECT ステートメントの結果で、列名をどのように報告するかを示します。

SQLColumnNameStyle クラスで定義されている定数は、このプロパティに対して有効な値を表します。

• SQLColumnNameStyle.LONG は、列名が [table-name]_[column-name] の形式で返されることを示します。
• SQLColumnNameStyle.SHORT は、列名が [column-name] の形式に指定されていることを示します。同じ名前を持つ複数の列が存在する場合、その名前を持つプロパティが 1 つだけが結果オブジェクトに追加されます。
• SQLColumnNameStyle.DEFAULT はデフォルト値です。この値が使用されている場合、結果の列名は、同じ列名を持つ SELECT ステートメントのテーブル数に従って形式が設定されます。SELECT ステートメントにテーブルが 1 つしか含まれない場合は、[column-name] という短い名前の形式が使用されます。また、SELECT ステートメントに複数のテーブルが結合して含まれ、同じ列名の存在により名前の競合が発生している場合は、それぞれの名前を識別できるように [table-name]_[column-name] という長い名前の形式が使用されます。

関連する API エレメント

SQLConnection インスタンスに、データベースファイルへの開いている接続があるかどうかを示します。

関連する API エレメント

この接続が、現在トランザクションに含まれているかどうかを示します。

関連する API エレメント

現在のプラットフォームで、SQLConnection クラスがサポートされているかどうかを示します。

SQL INSERT ステートメントによって最後に作成された行識別子です。行識別子は、データベース内のテーブルの行を一意に識別するために使用されます。この値は、データベースによって頻繁に生成されます。

データベースが接続されていない場合、または INSERT ステートメントが実行されていない場合、値はゼロになります。

単一の SQL INSERT ステートメントを実行した場合、挿入された行の行識別子は、lastInsertRowID プロパティ（SQLStatement オブジェクトの getResult() メソッドから返される SQLResult オブジェクトのプロパティ）を通じて取得できます（SQLStatement の result イベントが送出された後に getResult() メソッドが呼び出された場合）。

主キーと生成される行識別子の詳細については、付録「ローカルデータベースでの SQL サポート」の「CREATE TABLE」セクションおよび「式」セクションを参照してください。

関連する API エレメント

現在のデータベースが最初に作成されたときに指定された、データベースのページサイズ（バイト単位）を示します（pageSize パラメーターに指定されていた値で、データベースを作成した open() または openAsync() の呼び出しで指定します）。

connected プロパティが false の場合、このプロパティの値は 0 になります。

データベースのページサイズは、open() メソッドまたは openAsync() メソッドを使用すると、データベースに最初のテーブルが作成される前までは変更できます。

関連する API エレメント

データベースへの接続が開かれてからデータに加えられた変更数の合計が含まれます。INSERT、DELETE および UPDATE の各ステートメントによって加えられた変更の追跡に加え、この値にはトリガーによる変更も含まれます。

データベース接続が閉じられると、この値は 0 にリセットされます。SQLConnection インスタンスがデータベースに接続していない場合、値は 0 になります。

関連する API エレメント

SQLConnection インスタンスを作成します。

イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。イベントリスナーは、特定のタイプのイベント、段階、および優先度に関する表示リスト内のすべてのノードに登録できます。

イベントリスナーが正常に登録された後に、addEventListener() をさらに呼び出して優先度を変更することはできません。リスナーの優先度を変更するには、最初に removeListener() を呼び出す必要があります。その後、同じリスナーを新しい優先度レベルで再度登録できます。

リスナーが登録された後に、addEventListener()（type または useCapture に別の値を設定）を再度呼び出すと、別のリスナー登録が作成されることに注意してください。例えば、最初にリスナーを登録するときに useCapture を true に設定すると、そのリスナーはキャプチャ段階のみでリスニングします。同じリスナーオブジェクトを使用して再度 addEventListener() を呼び出すと（このとき、useCapture に false を設定）、異なる 2 つのリスナーが登録されます。1 つはキャプチャ段階でリスニングするリスナーで、もう 1 つはターゲット段階とバブリング段階でリスニングするリスナーです。

ターゲット段階またはバブリング段階のみを対象とするイベントリスナーを登録することはできません。登録時にこれらの段階が組み合わされるのは、バブリングはターゲットノードの祖先にしか適用されないためです。

イベントリスナーが不要になった場合は、removeEventListener() を呼び出して、イベントリスナーを削除します。削除しない場合、メモリの問題が発生する可能性があります。ガベージコレクションでは、オブジェクトの送出が行われている限り、リスナーを削除しないので、イベントリスナーは自動的には削除されません（useWeakReference パラメーターが true に設定されていない場合）。

EventDispatcher インスタンスをコピーしても、それに関連付けられているイベントリスナーはコピーされません。新しく作成したノードにイベントリスナーが必要な場合は、ノードを作成した後に、リスナーを関連付ける必要があります。ただし、EventDispatcher インスタンスを移動した場合は、関連付けられているイベントリスナーも一緒に移動されます。

イベントがノードで処理されるときに、イベントリスナーがそのノードに登録中であれば、イベントリスナーは現在の段階ではトリガーされません。ただし、バブリング段階など、イベントフローの後の段階でトリガーすることができます。

イベントがノードで処理されているときにイベントリスナーがノードから削除された場合でも、イベントは現在のアクションによってトリガーされます。削除された後は、その後の処理で再び登録されない限り、イベントリスナーは二度と呼び出されません。

パラメーター

function(evt:Event):void

データベースインデックスに関する統計を収集し、データベースに保存します。これらの統計情報は、クエリオプティマイザ（データベースエンジンの中で、各ステートメントを実行する最も効率的な方法を決定する部分）で使用できます。この統計情報は、特定のクエリを実行する場合に、クエリオプティマイザが最適なインデックスを選択するのに役立ちます。

データベースにインデックスが定義されていて、analyze() メソッドが呼び出されていない場合でも、ランタイムはそのインデックスを使用してステートメントを実行します。ただし、analyze() メソッドで生成された詳細な統計情報が存在しない場合は、ランタイムが特定のクエリに対して最も効率的なインデックスを選択できない場合があります。

(INSERT、UPDATE または DELETE ステートメントの実行結果として）テーブルのデータが変更された場合、そのテーブルに関連付けられているインデックスも変更されます。analyze() によって生成された統計情報は、自動的に更新されません。したがって、大量のデータを変更した場合は、再度 analyze() メソッドを呼び出すと有効です。ただし、analyze() を再び呼び出した場合の効果は、様々な要因に左右されます。例えば、テーブルに定義されているインデックスの数や、変更された行数とテーブルの全行数との比率、インデックス付けされているテーブルのデータに見られる差異の大きさ、変更後のデータと変更前のデータの変化の大きさなどに左右されます。

resourceName パラメーターは、インデックスに対する処理を、アタッチされているすべてのデータベース、特定のデータベースまたは特定のテーブルについて実行するかどうかを示します。

このメソッドが呼び出されると、そのたびに以前に作成された統計データは削除され、データベースや resourceName パラメーターで指定されたテーブル（resourceName が null の場合は接続されたすべてのデータベースの全テーブル）用に統計データが再作成されます。このメソッドは、データベース接続が開かれている状態であれば、いつでも呼び出せます。analyze() 操作とその統計データは、トランザクションに含まれません。ただし、データベースに現在処理中のトランザクションがある場合は、analyze() の呼び出しは推奨されません（inTransaction プロパティが true の場合）。これは、トランザクションで実行されたデータ、テーブルスキーマまたはインデックスの変更がコミットされていない場合、analyze() の呼び出しに反映されないので、トランザクションがコミットされると analyze() データが最新の状態でなくなることが理由です。

analyze() メソッドで作成された統計データを削除するには、deanalyze() メソッドを使用します。

パラメーター

関連する API エレメント

別のデータベースを SQLConnection インスタンスに追加し、指定された名前を新しいデータベースに付けます。データベースをアタッチすると、この SQLConnection インスタンスに対して実行される SQL ステートメントで、そのデータベースを使用できるようになります。

指定された名前を使用して、データベースが既にアタッチされている場合は、attach() を呼び出すとエラーが発生します。ただし、一意の名前を使用することで、同じデータベースを 2 回以上アタッチすることができます。単一の SQLConnection インスタンスにアタッチできるデータベースは、10 個までです。

attach() を使用して接続したデータベースに対しては、任意の SQL ステートメントを実行できます。このメソッドは、メインデータベース（open() または openAsync() を使用して接続したデータベース）に対して実行できます。SQL ステートメントは、そのステートメントの関連付けられている SQLConnection インスタンスにアタッチされているデータベースであれば、どのテーブルにでもアクセスできます。これには、単一のステートメントで複数のデータベースのテーブルにアクセスする場合も含まれます。ランタイムはステートメントのテーブル名を解決すると、SQLConnection インスタンスのデータベースを検索します。検索は open() メソッドまたは openAsync() メソッドを使用して接続されたデータベースから開始され、アタッチされた順番に行われます。ステートメントでデータベース名（attach() メソッドの name パラメーターで指定された名前）を使用して、テーブル名を明示的に修飾します。

attach() メソッドを使用してアタッチされたデータベースを削除するには、detach() メソッドを使用します。close() メソッドを呼び出して SQLConnection インスタンスを閉じると、アタッチされているデータベースは、すべてデタッチされます。

アタッチされているデータベースは、メインデータベースと同じ実行モード（同期または非同期）を使用します。これは、メインデータベースが open() メソッドまたは openAsync() メソッドのどちらを使用して接続されたかによって異なります。

パラメーター

関連する API エレメント

接続のデータベースに対して実行されるすべての SQL ステートメントがグループ化されている範囲内で、トランザクションを開始します。

デフォルトでは、各 SQL ステートメントは自身のトランザクションの範囲内で実行され、ステートメントの実行が正常に完了した場合または失敗した場合にトランザクションが終了します。begin() メソッドを使用してトランザクションを作成すると、新しいマニュアルトランザクションが作成されます。それ以降、SQLConnection インスタンスに対して実行される SQL ステートメントはすべてトランザクションの範囲内で発生し、ステートメントによって実行されるアクションまたは変更は、グループとしてコミット（永続させる）またはロールバック（元に戻す）できます。

トランザクションを終了するには、commit() メソッドまたは rollback() メソッドを呼び出します。どちらを呼び出すかは、トランザクションのステートメントによる変更を永続させるか破棄するかによって決定します。

begin() に対するネストされた呼び出しは無視されます。トランザクション内でブックマークのように機能するセーブポイントを作成するには、setSavepoint() メソッドを呼び出します。その後で releaseSavepoint() または rollbackToSavepoint() メソッドを呼び出すことにより、SQL ステートメントを部分的にコミットまたはロールバックできます。ただし、begin() を呼び出してトランザクションを開始した場合、変更をデータベースに永続的にコミットするには、commit() メソッドを呼び出す必要があります。

トランザクションが現在開いている状態でデータベース接続が閉じられると、AIR はトランザクションを自動的にロールバックします。（注意：AIR 1.1 以前のバージョンの場合、開いているトランザクションは、接続が閉じられると自動的にコミットされます）。

トランザクションでは、ステートメントの実行が単一のデータベースに限定されていません。アタッチされている別のデータベースに対して実行されるステートメントを含めることもできます。

パラメーター

関連する API エレメント

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

SQLConnection インスタンスに接続しているデータベースに対して現在実行中の SQL ステートメントをすべて中止します。このメソッドは、長時間実行されているクエリや暴走したクエリを停止するために使用できます。

cancel() メソッドを呼び出したときに実行しているステートメントが存在する場合、このメソッドによってステートメントの処理が中止され、未完了の更新またはトランザクションはロールバックされます。現在実行しているステートメントが存在しない場合、このメソッドを呼び出すと、開いているトランザクションがロールバックされます。開いているトランザクションがない場合は、何も実行されません。

パラメーター

関連する API エレメント

現在のデータベース接続を閉じます。アタッチされているデータベースもデタッチされます。

開いているトランザクションがある状態で close() を呼び出すと、そのトランザクションはロールバックされます。SQLConnection インスタンスがガベージコレクションされると、ランタイムは自動的に close() を呼び出します。これには、SQLConnection がデータベースに接続されたまま AIR アプリケーションが閉じられた場合も含まれます。

パラメーター

既存のトランザクションをコミットします。トランザクションのステートメントによって実行されたアクションは、永続的にデータベースに適用されます。

トランザクション内でブックマークのように機能する中間セーブポイントを作成するには、setSavepoint() メソッドを呼び出します。セーブポイントを使用すると、releaseSavepoint() メソッドまたは rollbackToSavepoint() メソッドを呼び出すことにより、トランザクションの一部をコミットまたはロールバックできます。ただし、begin() メソッドを呼び出してトランザクションを開始した場合、変更をデータベースに永続的に保存するには、commit() メソッドを呼び出して、トランザクション全体をコミットする必要があります。

セーブポイントを使用しているトランザクションでは、トランザクション全体をコミットする場合、rollbackToSavepoint() メソッドを使用してロールバックされたステートメントはコミットされません。releaseSavepoint() を使用してコミットされたステートメントやセーブポイントが解放またはロールバックされていないステートメントは、データベースにコミットされません。

パラメーター

関連する API エレメント

データベースの未使用領域を再要求します。オブジェクト（テーブル、インデックスまたはトリガー）がデータベースからドロップされた場合は、空のまま残されます。そのため、データベースファイルのサイズが必要以上に大きくなりますが、INSERT 操作の処理速度が向上します。時間の経過と共に、INSERT 操作および DELETE 操作によってデータベースファイルの構造に断片化が生じ、データベースコンテンツへのディスクアクセスの速度が低下します。このメソッドは、空きページを削除し、テーブルのデータが連続するように整理を行い、データベースファイルの構造をクリーンアップすることで、データベースファイルのサイズを縮小します。

compact() 操作は、アタッチされているデータベースファイルに対しては実行できません。SQLConnection インスタンスによって開かれたメイン（元の）データベースファイルにのみ実行できます。この操作は、アクティブなトランザクションがある場合は失敗します。また、メモリ内のデータベースには影響を与えません。

パラメーター

analyze() メソッドの呼び出しで作成された統計情報をすべて削除します。

analyze() メソッドで作成された統計情報はデータベースの領域を使用するので、いくつかのインデックスやテーブルをドロップした後に deanalyze() を呼び出すことで、その領域を再要求することができます。

この処理はアクティブなトランザクションには含まれていません。

パラメーター

関連する API エレメント

attach() メソッドを使用して SQLConnection インスタンスにアタッチされた追加のデータベースをデタッチします。異なる名前を使用することで、同じデータベースを 2 回以上アタッチすることができます。この場合、1 つの接続をデタッチしても、残りの接続は維持されます。接続に開いているトランザクションが存在する場合（inTransaction プロパティが true の場合）、データベースをデタッチできません。

パラメーター

関連する API エレメント

loadSchema() メソッド呼び出しの結果に対するアクセスを提供します。getSchemaResult() メソッドは、結果の先入れ先出しキューとして動作します。loadSchema() メソッドの呼び出しが完了するたびに（schema イベントが非同期実行モードで送出されるたびに）、新しい SQLSchemaResult オブジェクトがキューに追加されます。getSchemaResult() メソッドが呼び出されるたびに、最も古い結果（最初にキューに追加されたもの）が返され、キューから削除されます。キューに存在するオブジェクトがなくなると、getSchemaResult() は null を返します。

データベース接続が閉じられると、メソッドは null を返します。

関連する API エレメント

接続されているデータベースまたはアタッチされている任意のデータベースからスキーマ情報をロードします。スキーマは、データベースのテーブル、列、インデックスおよびトリガーの構造を示すものです。

ロードされているスキーマにアクセスするには、SQLConnection.getSchemaResult() メソッドを使用します。

非同期実行モードでは、処理が正しく完了すると schema イベントが送出され、処理が失敗すると error イベントが送出されます。

type および name の各パラメーター値の組み合わせによって、loadSchema() メソッドが生成するスキーマデータのタイプが決定されます。また、これにより、生成される SQLSchemaResult インスタンスの各プロパティの値も決定されます。次の表は、有効な type および name の組み合わせと、結果として生成されるスキーマデータを一覧にしたものです。

type 引数および name 引数の組み合わせが、指定されている組み合わせに対応していない場合は、error イベントが送出されるか（非同期実行モードの場合）、例外がスローされます（同期実行モードの場合）。例えば、type 引数が SQLViewSchema で、name 引数がビュー名ではなくテーブル名の場合、指定された名前を持つ指定された型のオブジェクトがデータベースに含まれていないことを示すエラーが発生します。

データベースが空の場合（データベースにテーブル、ビュー、トリガーまたはインデックスが含まれていない場合）、loadSchema() メソッドを呼び出すとエラーが発生します。

パラメーター

関連する API エレメント

ファイルシステムの指定された場所にあるデータベースファイルを同期接続で開くか、その場所に新しいデータベースファイルを作成して開くか、メモリ内データベースを作成して開きます。このメソッドを使用してデータベースを開いた場合、データベースを作成および開く処理は、この SQLConnection インスタンスを使用して実行される他の処理（この SQLConnection インスタンスに関連付けられている SQLStatement インスタンスが実行するステートメントの実行など）と同様、同期的に実行されます。非同期的に処理を実行するには、openAsync() メソッドを使用してデータベース接続を開きます。

データベースが接続されたら、SQLStatement インスタンスを使用して SQL コマンドを実行します。データベースレベルの操作（トランザクションの開始または終了、スキーマ情報のロード、その他の操作など）を実行するには、SQLConnection インスタンスを使用します。

open() メソッドを使用して接続したデータベースには、自動的に「main」というデータベース名が割り当てられます。この名前は、SQL ステートメントで明示的にテーブル名を修飾する場合に使用でき、[database-name].[table-name] という書式を使用します。

パラメーター

関連する API エレメント

ファイルシステムの指定された場所にあるデータベースファイルを非同期接続で開くか、その場所に新しいデータベースファイルを作成して開くか、メモリ内データベースを作成して開きます。このメソッドを使用してデータベースを開いた場合、データベースを作成および開く処理は、この SQLConnection インスタンスを使用して実行される他の処理（この SQLConnection インスタンスに関連付けられている SQLStatement インスタンスが実行するステートメントの実行など）と同様、非同期的に実行されます。同期的に処理を実行するには、open() メソッドを使用してデータベース接続を開きます。

データベースが接続されたら、SQLStatement インスタンスを使用して SQL コマンドを実行します。データベースレベルの操作（トランザクションの開始または終了、スキーマ情報のロード、その他の操作など）を実行するには、SQLConnection インスタンスを使用します。

openAsync() メソッドを使用して接続されたデータベースには、自動的に "main" というデータベース名が割り当てられます。この名前は、SQL ステートメントで明示的にテーブル名を修飾する場合に使用でき、[database-name].[table-name] という書式を使用します。

パラメーター

関連する API エレメント

暗号化されたデータベースの暗号化キーを変更します。このメソッドは、メインデータベース（open() メソッドまたは openAsync() メソッドを使用して接続されたデータベース）の暗号化キーのみを変更します。reencrypt() は、作成時に暗号化されたデータベースに対してのみ呼び出すことができます。いったん暗号化して作成したデータベースの暗号化を解除することはできません。同様に、暗号化しないで作成したデータベースを、後から暗号化することはできません。

再暗号化操作は、専用のトランザクションで実行します。再暗号化処理を中断した場合、データベースはトランザクションをロールバックし、暗号化キーは変更されません。

パラメーター

関連する API エレメント

このメソッドでは、直近のセーブポイントまたは名前が指定されている場合は該当する名前のセーブポイント以降に実行された SQL 操作をコミットします。

変更を永続的にデータベースに保存するには、トランザクション全体がコミットされる必要があります。begin() メソッドを使用してトランザクションを開始した場合、トランザクション全体をコミットするには、commit() メソッドを呼び出す必要があります。inTransaction が false の状態で、setSavepoint() を呼び出してトランザクションを開始した場合、トランザクション全体を終了するには、commit() メソッドを呼び出すか、トランザクションの最初のセーブポイントを対象として releaseSavepoint() または rollbackToSavepoint() を呼び出します。

コードから rollback() メソッドを呼び出すと、トランザクションがロールバックされる前に releaseSavepoint() が呼び出されたかどうかに関わらず、トランザクション内のすべての変更が完全に破棄されます。

パラメーターなしで（または name パラメーターに null を指定して）このメソッドが呼び出されると、名前のない直近のセーブポイント（name パラメーターを指定せずに setSavepoint() を呼び出して作成された直近のセーブポイント）以降に実行されたデータベースの変更がコミットされます。例えば、setSavepoint() メソッドが 3 回呼び出されたとすると、3 つのセーブポイントが設定されます。その時点で releaseSavepoint() を呼び出すと、3 番目（最新）のセーブポイント以降に実行された SQL 操作がコミットされます。

name パラメーターに値が指定されている場合、このメソッドは、指定された名前のセーブポイント以降に実行されたすべての SQL 操作をコミットします。指定されたセーブポイントよりも新しいセーブポイントが他に作成されている場合、これらのセーブポイント以降に実行された操作もコミットされます。

セーブポイントが解放またはロールバックされると、該当するセーブポイントとそれ以降に設定されたセーブポイントは削除されます。releaseSavepoint() またはrollbackToSavepoint() を呼び出してセーブポイントを削除した後に、コードから SQL 操作を実行すると、追加された操作は、残っている直近のセーブポイントに属します（つまり、これらの操作は、削除されたセーブポイントよりも前に作成された直近のセーブポイントに属します）。セーブポイントが残っていない場合、操作はメイントランザクションに属します。

パラメーター

関連する API エレメント

EventDispatcher オブジェクトからリスナーを削除します。対応するリスナーが EventDispatcher オブジェクトに登録されていない場合は、このメソッドを呼び出しても効果はありません。

パラメーター

begin() メソッドを使用して作成された既存のトランザクションをロールバックします。つまり、そのトランザクションの SQL ステートメントによる変更が、すべて破棄されます。

中間セーブポイントをトランザクション内で設定するには、setSavepoint() メソッドを呼び出します。セーブポイントを使用すると、releaseSavepoint() メソッドまたは rollbackToSavepoint() を呼び出すことにより、トランザクションの一部をコミットまたはロールバックできます。ただし、rollback() メソッドを呼び出すと、トランザクションがロールバックされる前に個々のセーブポイントが解放（コミット）されているかどうかに関わらず、トランザクション内のすべての変更が完全に破棄されます。

パラメーター

関連する API エレメント

直近のセーブポイントまたは名前が指定されている場合は該当する名前のセーブポイント以降に実行されたすべての SQL 操作をロールバックします。

commit() メソッドを呼び出してトランザクション全体をコミットすると、rollbackToSavepoint() メソッドでまだロールバックされていないトランザクション内の変更はすべて、データベースに永続的に保存されます。また、rollback() メソッドを呼び出すと、トランザクションがロールバックされる前に個々のセーブポイントが解放（コミット）されているかどうかに関わらず、すべての変更が完全に破棄されます。

パラメーターなしで（または name パラメーターに null を指定して）このメソッドが呼び出されると、名前のない直近のセーブポイント（name パラメーター値を指定せずに実行した直近の setSavepoint() 呼び出し）以降に行われたデータベースの変更がすべてロールバックされます。

name パラメーターに値が指定されている場合、このメソッドは、指定された名前のセーブポイント以降に実行されたすべての SQL 操作をロールバックします。指定されたセーブポイントよりも新しいセーブポイントが他に作成されている場合、これらのセーブポイント以降に実行された操作もロールバックされます。

セーブポイントが解放またはロールバックされると、該当するセーブポイントとそれ以降に設定されたセーブポイントは削除されます。releaseSavepoint() またはrollbackToSavepoint() を呼び出してセーブポイントを削除した後に、コードから SQL 操作を実行すると、追加された操作は、残っている直近のセーブポイントに属します（つまり、これらの操作は、削除されたセーブポイントよりも前に作成された直近のセーブポイントに属します）。セーブポイントが残っていない場合、操作はメイントランザクションに属します。

パラメーター

関連する API エレメント

データベーストランザクション内でブックマークのように機能するセーブポイントを作成します。トランザクション内のポイントを示すセーブポイントです。releaseSavepoint() や rollbackToSavepoint() メソッドを使用すると、セーブポイント間で実行された一連の SQL 操作を他の操作とは別にコミットまたはロールバックできます。この方法では、セーブポイントを使用することによって、一連の SQL 操作をネストしたトランザクションとして扱えます。

setSavepoint() メソッドの呼び出し時に、begin() メソッドを呼び出してトランザクションをまだ開いていない場合は、このメソッドを呼び出すことによってトランザクションが開始され、その際にセーブポイントが作成されます。トランザクションが既に開いている場合は、setSavepoint() を呼び出すと、トランザクション内にセーブポイントが作成されます。

変更を永続的にデータベースに保存するには、トランザクション全体がコミットされる必要があります。begin() メソッドを使用してトランザクションを開始した場合、トランザクション全体をコミットするには、commit() メソッドを呼び出す必要があります。inTransaction が false の状態で、setSavepoint() を呼び出してトランザクションを開始した場合、トランザクション全体を終了するには、commit() メソッドを呼び出します。または、トランザクションを開始したセーブポイントを対象として、releaseSavepoint() または rollbackToSavepoint() を呼び出すと、トランザクションは自動的に終了します。

セーブポイント名を指定するには、name パラメーターに値を設定します。これにより、指定のセーブポイント以降に行われたすべての変更をロールバックまたはコミットできます。名前が指定されていない場合（デフォルト）は、名前のないセーブポイントが作成されます。

セーブポイントが解放またはロールバックされると、該当するセーブポイントとそれ以降に設定されたセーブポイントは削除されます。releaseSavepoint() またはrollbackToSavepoint() を呼び出してセーブポイントを削除した後に、コードから SQL 操作を実行すると、追加された操作は、残っている直近のセーブポイントに属します（つまり、これらの操作は、削除されたセーブポイントよりも前に作成された直近のセーブポイントに属します）。セーブポイントが残っていない場合、操作はメイントランザクションに属します。

パラメーター

関連する API エレメント

analyze() の処理が正常に完了したときに送出されます。

関連する API エレメント

attach() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

begin() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

cancel() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

close() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

commit() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

compact() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

deanalyze() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

SQL DELETE コマンドを実行した結果、任意の接続済みデータベースの任意のテーブルのデータが変化した場合に送出されます。データの変化は、SQLStatement インスタンスから DELETE ステートメントを実行した直接的な結果か、ステートメントの実行に応答してトリガーが発生した間接的な結果である可能性があります。

関連する API エレメント

detach() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

任意の SQLConnection オブジェクトの非同期処理でエラーが発生した場合に送出されます。イベントオブジェクトとして送出された SQLErrorEvent インスタンスは、error プロパティを持ちます。このプロパティには、試行された処理と失敗した理由に関する情報が格納されています。

SQL INSERT コマンドを実行した結果、任意の接続済みデータベースの任意のテーブルのデータが変化した場合に送出されます。データの変化は、SQLStatement インスタンスから INSERT ステートメントを実行した直接的な結果か、ステートメントの実行に応答してトリガーが発生した間接的な結果である場合があります。

関連する API エレメント

openAsync() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

reencrypt() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

releaseSavepoint() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

rollback() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

rollbackToSavepoint() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

loadSchema() メソッド呼び出しの処理が正常に完了し、スキーマの結果の準備が完了したときに送出されます。

関連する API エレメント

setSavepoint() メソッド呼び出しの処理が正常に完了したときに送出されます。

関連する API エレメント

SQL UPDATE コマンドを実行した結果、任意の接続済みデータベースの任意のテーブルのデータが変化した場合に送出されます。データの変化は、SQLStatement インスタンスから UPDATE ステートメントを実行した直接的な結果か、ステートメントの実行に応答してトリガーが発生した間接的な結果である場合があります。

update イベントには、次のプロパティがあります。

関連する API エレメント