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

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

関連項目

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

関連項目

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] という長い名前の形式が使用されます。

関連項目

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

関連項目

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

関連項目

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

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

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

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

関連項目

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

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

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

関連項目

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

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

関連項目

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

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

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

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

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

イベントリスナーが不要になった場合は、removeEventListener() を呼び出して、イベントリスナーを削除します。削除しない場合、メモリの問題が発生する可能性があります。ガベージコレクターは参照を有するオブジェクトを削除しないため、登録されているイベントリスナーに関係したオブジェクトはメモリから自動的に除去されません。

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() メソッドを使用します。

パラメータ

関連項目

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

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

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

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

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

パラメータ

関連項目

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

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

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

現在開いているトランザクションがあるときにデータベース接続を閉じると、トランザクションは自動的にロールバックされます。（メモ：AIR 1.1 および以前のバージョンでは、接続が閉じたときに開いているトランザクションは自動的にコミットされます。）

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

パラメータ

関連項目

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

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

パラメータ

関連項目

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

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

パラメータ

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

パラメータ

関連項目

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

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

パラメータ

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

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

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

パラメータ

関連項目

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

パラメータ

関連項目

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

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

関連項目

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

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

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

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

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

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

パラメータ

関連項目

ファイルシステムの指定された場所にあるデータベースファイルを開くか、その場所に新しいデータベースファイルを作成して開くか、メモリ内データベースを作成して開きます。

このメソッドを使用してデータベースを開いた場合、データベースを作成および開く処理は、この SQLConnection インスタンスを使用して実行される他の処理 (この SQLConnection インスタンスに関連付けられている SQLStatement インスタンスが実行するステートメントの実行など) と同様、同期的に実行されます。非同期的に処理を実行するには、openAsync() メソッドを使用してデータベース接続を開きます。

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

パラメータ

関連項目

ファイルシステムの指定された場所にあるデータベースファイルを開くか、その場所に新しいデータベースファイルを作成して開くか、メモリ内データベースを作成して開きます。

このメソッドを使用してデータベースを開いた場合、データベースを作成および開く処理は、この SQLConnection インスタンスを使用して実行される他の処理 (この SQLConnection インスタンスに関連付けられている SQLStatement インスタンスが実行するステートメントの実行など) と同様、非同期的に実行されます。同期的に処理を実行するには、open() メソッドを使用してデータベース接続を開きます。

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

パラメータ

関連項目

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

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

パラメータ

関連項目

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

パラメータ

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

パラメータ

関連項目

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

関連項目

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

関連項目

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

関連項目

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

関連項目

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

関連項目

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

関連項目

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

関連項目

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

関連項目

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

関連項目

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

関連項目

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

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

関連項目

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

関連項目

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

関連項目

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

関連項目

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

関連項目

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

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

関連項目