SQLConnection  - AS3

현재 데이터베이스를 처음에 만들 때 자동 압축을 설정했는지 여부를 나타냅니다(데이터베이스를 만든 open() 또는 openAsync() 호출에서 autoCompact 매개 변수에 지정한 값). 이 속성이 true인 경우 각 쓰기 작업 후 데이터베이스 파일에서 사용되지 않는 공간을 자동으로 제거하여 데이터베이스 파일을 작게 유지합니다. 이 속성이 false인 경우에는 제거된 데이터가 기존에 사용하던 공간이 데이터베이스 파일에서 그대로 유지되고 필요할 때 다시 사용됩니다. autoCompact가 false인 경우에도 compact() 메서드를 호출하여 데이터베이스에서 사용되지 않는 공간을 회수하도록 강제할 수 있습니다.

connected 속성이 false이면 이 속성도 false로 설정됩니다.

관련 API 요소

메모리에 한 번에 저장할 수 있는 최대 데이터베이스 디스크 페이지 수를 나타내는 이 연결의 캐시 크기에 대한 액세스를 제공합니다. 각 페이지는 약 1.5KB의 메모리를 사용하며 이 크기는 데이터베이스를 만든 open() 또는 openAsync() 메서드 호출의 pageSize 매개 변수에 지정한 값에 따라 다릅니다. 기본 캐시 크기는 2000입니다. 응용 프로그램에서 많은 데이터베이스 행을 변경하는 UPDATE 또는 DELETE 작업을 실행하는 경우 캐시 크기를 늘리면 더 많은 메모리를 사용하지만 속도를 높일 수 있습니다.

관련 API 요소

SELECT 문의 결과에서 열 이름이 보고되는 방식을 나타냅니다.

다음과 같이 SQLColumnNameStyle 클래스에 정의된 상수를 이 속성의 값으로 사용할 수 있습니다.

• SQLColumnNameStyle.LONG은 열 이름이 [table-name]_[column-name] 형식으로 반환되도록 지정합니다.
• SQLColumnNameStyle.SHORT는 열 이름이 [column-name] 형식을 갖도록 지정됩니다. 같은 이름의 열이 여럿 있는 경우 해당 이름의 속성 하나만 결과 객체에 추가됩니다.
• SQLColumnNameStyle.DEFAULT가 기본값입니다. 이 값을 사용하면 SELECT 문에서 열 이름이 유사한 테이블의 수에 따라 결과 열 이름의 형식이 지정됩니다. SELECT 문에 테이블이 한 개만 있는 경우 [column-name]과 같이 짧은 이름 형식이 사용되고 SELECT 문에 여러 테이블이 결합되어 있는 경우 두 열의 이름이 동일하여 이름 충돌이 있는 경우에는 항상 동일한 이름의 열에 대해 [table-name]_[column-name]과 같이 긴 이름 형식이 사용됩니다.

관련 API 요소

SQLConnection 인스턴스에 데이터베이스 파일에 대한 연결이 열려 있는지 여부를 나타냅니다.

관련 API 요소

이 연결이 현재 트랜잭션에 포함되어 있는지 여부를 나타냅니다.

관련 API 요소

SQLConnection 클래스가 현재 플랫폼에서 지원되는지 여부를 나타냅니다.

SQL INSERT 문에서 생성한 마지막 행 식별자입니다. 행 식별자는 데이터베이스 내의 테이블에 있는 행을 고유하게 식별하는 데 사용됩니다. 이 값은 데이터베이스에서 자주 생성됩니다.

데이터베이스가 연결되어 있지 않거나 INSERT 문을 실행하지 않은 경우 이 값은 0입니다.

단일 SQL INSERT 문 실행을 위한 행 식별자는 SQLStatement 객체의 getResult() 메서드에 의해 반환된 SQLResult 객체의 lastInsertRowID 속성을 통해 가져올 수 있습니다(SQLStatement가 해당 result 이벤트를 전달한 후에 호출한 경우).

기본 키 및 행 식별자에 대한 자세한 내용은 "CREATE TABLE" 및 "Expressions" 섹션(부록 "로컬 데이터베이스의 SQL 지원")을 참조하십시오.

관련 API 요소

현재 데이터베이스를 처음에 만들 때 지정한 데이터베이스 페이지 크기(바이트)를 나타냅니다(데이터베이스를 만든 open() 또는 openAsync() 호출에서 pageSize 매개 변수에 지정한 값).

connected 속성이 false이면 이 속성 값은 0입니다.

데이터베이스에서 첫 번째 테이블을 만들기 전까지는 데이터베이스의 페이지 크기를 open() 또는 openAsync() 메서드를 사용하여 변경할 수 있습니다.

관련 API 요소

데이터베이스에 대한 연결을 연 이후로 변경한 데이터 변경 사항의 총 수를 포함합니다. 이 값은 INSERT, DELETE 및 UPDATE 문으로 인해 변경된 내용을 추적할 뿐 아니라 트리거로 인한 변경 사항도 포함합니다.

데이터베이스 연결이 닫히면 이 값은 0으로 재설정됩니다. SQLConnection 인스턴스가 데이터베이스에 연결되어 있지 않은 경우 이 값은 0입니다.

관련 API 요소

SQLConnection 인스턴스를 만듭니다.

리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. 표시 목록의 모든 노드에서 특정 유형의 이벤트, 단계, 우선 순위에 대한 이벤트 리스너를 등록할 수 있습니다.

이벤트 리스너의 등록을 마친 뒤에는 addEventListener()를 추가로 호출하여 그 우선 순위를 변경할 수 없습니다. 리스너의 우선 순위를 변경하려면 먼저 removeListener()를 호출해야 합니다. 그런 다음 해당 리스너를 새로운 우선 순위 레벨로 다시 등록할 수 있습니다.

일단 리스너가 등록된 뒤에 type 또는 useCapture 값을 달리하여 addEventListener()를 이어서 호출하면 별도의 리스너 등록이 생성된다는 것에 유의합니다. 예를 들어 useCapture가 true로 설정된 리스너를 등록하면 이 리스너는 캡처 단계 동안에만 수신합니다. 그러나 useCapture를 false로 설정하고 동일한 리스너 객체를 사용하여 addEventListener()를 다시 호출하면 별도로 두 개의 리스너가 등록되어, 한 리스너는 캡처 단계 동안 수신하고 다른 하나는 대상 및 버블링 단계 동안 수신합니다.

대상 단계 또는 버블링 단계 전용의 이벤트 리스너를 등록할 수는 없습니다. 버블링은 대상 노드의 조상에만 적용되기 때문에 이들 단계는 등록 과정에서 하나로 통합됩니다.

사용하지 않는 이벤트 리스너는 removeEventListener()를 호출하여 제거하도록 합니다. 이렇게 하지 않으면 메모리 문제가 발생할 수 있습니다. useWeakReference 매개 변수가 true로 설정되지 않은 경우 전달하는 객체가 있는 한, 가비지 수집기는 이벤트 리스너를 제거하지 않으므로 리스너는 메모리에서 자동으로 제거되지 않습니다.

EventDispatcher 인스턴스를 복사해도 연결된 이벤트 리스너는 복사되지 않습니다. 새로 만든 노드에 이벤트 리스너가 필요한 경우, 노드를 만든 후 리스너를 연결해야 합니다. 그러나 EventDispatcher 인스턴스를 이동할 때에는 연결된 이벤트 리스너도 함께 이동됩니다.

이벤트를 처리 중인 노드에서 이벤트 리스너를 등록하는 경우, 그 이벤트 리스너는 현재 단계 동안에는 트리거되지 않지만 이벤트 흐름에서 이후 단계(예: 버블링 단계) 동안에는 트리거될 수 있습니다.

이벤트를 처리 중인 노드에서 이벤트 리스너를 제거하는 경우, 그 리스너는 현재 액션에 의해 트리거됩니다. 일단 제거된 이벤트 리스너는 이후의 처리를 위해 재등록하지 않는 한 다시는 호출되지 않습니다.

매개 변수

function(evt:Event):void

데이터베이스 인덱스에 대한 통계를 수집하여 데이터베이스에 저장합니다. 이러한 통계는 쿼리 최적화 프로그램(각 명령문을 실행하는 가장 효율적인 방법을 결정하는 데이터베이스 엔진 부분)에서 사용할 수 있습니다. 이 통계는 쿼리 최적화 프로그램에서 특정 쿼리를 실행할 때 사용할 적합한 인덱스를 선택하는 데 도움이 됩니다.

데이터베이스에 인덱스가 정의되어 있는 경우 analyze() 메서드를 호출하지 않았더라도 런타임에서 이러한 색인을 사용하여 명령문을 실행합니다. 그러나 analyze() 메서드에서 생성하는 추가 통계 정보가 없으면 런타임에서 특정 쿼리에 대해 가장 효율적인 인덱스를 선택할 수 없습니다.

INSERT, UPDATE 또는 DELETE 문의 결과로 테이블의 데이터가 변경되면 해당 테이블에 연결된 인덱스도 변경됩니다. analyze()에서 생성하는 통계 정보는 자동으로 업데이트되지 않습니다. 따라서 많은 수의 데이터 변경을 수행한 이후에는 analyze() 메서드를 다시 호출하는 것이 유익할 수 있습니다. 그러나 analyze()를 다시 호출하여 얻는 이점은 테이블에 정의된 인덱스 수, 테이블에서 변경된 행 수와 총 행 수 사이의 관계, 테이블의 인덱싱된 데이터 간의 편차 및 변경된 데이터와 사전 변경 데이터 간의 차이를 비롯한 여러 요인에 따라 달라집니다.

resourceName 매개 변수는 연결된 모든 데이터베이스, 특정 데이터베이스 또는 특정 테이블 중 어떤 것의 인덱스에 대해 작업을 수행할지를 나타냅니다.

이 메서드를 호출할 때마다 이전에 만든 통계 데이터는 제거되고 resourceName 매개 변수에서 지정한 데이터베이스 또는 테이블(또는 resourceName이 null인 경우 연결된 모든 데이터베이스의 모든 테이블)에 대해 통계 데이터가 다시 만들어집니다. 이 메서드는 데이터베이스 연결이 열려 있는 동안에 언제든 호출할 수 있습니다. analyze() 작업 및 해당 통계 데이터는 트랜잭션에 포함되지 않습니다. 그러나 데이터베이스에 현재 트랜잭션이 있는 경우(inTransaction 속성이 true인 경우)에는 analyze()를 호출하지 않는 것이 좋습니다. 이는 트랜잭션에서 실행되었지만 아직 커밋되지 않은 모든 데이터, 테이블 스키마 또는 인덱스 변경 사항이 analyze() 호출에서 고려되지 않으며 트랜잭션이 커밋되면 analyze() 데이터가 최신이 아닌 데이터가 되기 때문입니다.

analyze() 메서드로 만든 통계 데이터를 제거하려면 deanalyze() 메서드를 사용합니다.

매개 변수

관련 API 요소

새 데이터베이스에 지정된 이름을 지정하여 SQLConnection 인스턴스에 다른 데이터베이스를 추가합니다. 데이터베이스를 연결하면 이 SQLConnection 인스턴스에 대해 실행되는 SQL 문에서 해당 데이터베이스를 사용할 수 있습니다.

지정된 이름을 사용하여 데이터베이스가 이미 연결되어 있는 경우 attach()를 호출하면 오류가 발생합니다. 그러나 동일한 데이터베이스를 다른 이름을 사용하여 여러 번 연결할 수는 있습니다. 단일 SQLConnection 인스턴스에 10개의 데이터베이스만 연결할 수 있습니다.

attach()를 사용하여 연결한 데이터베이스에 대해 기본 데이터베이스(open() 또는 openAsync()를 사용하여 연결한 데이터베이스)에 대해 실행할 수 있는 모든 SQL 문을 실행할 수 있습니다. SQL 문에서는 명령문과 관련된 SQLConnection 인스턴스에 연결된 모든 데이터베이스의 테이블에 액세스할 수 있습니다. 또한 단일 명령문에서 여러 데이터베이스의 테이블에 액세스할 수도 있습니다. 런타임에서 명령문의 테이블 이름을 확인할 때는 open() 또는 openAsync() 메서드를 사용하여 연결한 데이터베이스를 시작으로 데이터베이스가 연결된 순서대로 SQLConnection 인스턴스의 데이터베이스를 검색합니다. 명령문에서 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()를 자동으로 호출합니다. 이때 AIR 응용 프로그램은 닫히지만 SQLConnection은 데이터베이스에 계속 연결되어 있습니다.

매개 변수

기존 트랜잭션을 커밋하여 트랜잭션의 명령문에서 수행한 모든 작업을 데이터베이스에 영구적으로 적용합니다.

setSavepoint() 메서드를 호출하여 트랜잭션 내의 북마크 같은 중간 저장점을 만들 수 있습니다. 저장점을 사용하면 releaseSavepoint() 메서드를 호출하여 트랜잭션 일부를 커밋할 수도 있고, rollbackToSavepoint() 메서드를 호출하여 트랜잭션 일부를 롤백할 수도 있습니다. 그러나 begin() 메서드를 사용하여 트랜잭션을 연 경우 commit() 메서드를 호출하여 전체 트랜잭션을 커밋할 때까지 변경 사항이 데이터베이스에 영구적으로 저장되지 않습니다.

저장점을 사용하는 트랜잭션의 경우 rollbackToSavepoint() 메서드를 사용하여 롤백한 모든 명령문은 전체 트랜잭션이 커밋될 때 커밋되지 않습니다. releaseSavepoint()를 사용하여 커밋한 명령문이나 저장점이 릴리스 또는 롤백되지 않은 명령문은 데이터베이스에 커밋됩니다.

매개 변수

관련 API 요소

데이터베이스에서 사용되지 않는 공간을 모두 회수합니다. 데이터베이스에서 객체(테이블, 인덱스 또는 트리거)를 삭제해도 객체는 빈 공간에 남아 있습니다. 이 때문에 데이터베이스 파일이 필요한 것보다 커지지만 INSERT 작업 속도는 높아질 수 있습니다. 시간이 지남에 따라 INSERT 및 DELETE 작업으로 데이터베이스 파일 구조가 조각화되어 데이터베이스 내용에 대한 디스크 액세스가 느려질 수 있습니다. 이 메서드는 빈 페이지를 제거하고, 테이블 데이터를 연속되도록 정렬하고, 데이터베이스 파일 구조를 정리하여 데이터베이스 파일을 압축합니다.

compact() 작업은 연결된 데이터베이스 파일에 대해서는 수행할 수 없습니다. SQLConnection 인스턴스에서 연 기본(원본) 데이터베이스 파일에 대해서만 수행할 수 있습니다. 이 작업은 활성 트랜잭션이 있는 경우 실패하며 메모리 내 데이터베이스에는 영향을 주지 않습니다.

매개 변수

analyze() 메서드에 대한 호출로 만든 통계 정보를 모두 제거합니다.

analyze() 메서드에서 생성한 통계는 데이터베이스의 공간을 사용하므로 deanalyze()를 호출하면 여러 인덱스 또는 테이블을 삭제할 때와 마찬가지로 해당 공간을 회수할 수 있습니다.

이 작업은 활성 트랜잭션에 포함되지 않습니다.

매개 변수

관련 API 요소

이전에 attach() 메서드를 사용하여 SQLConnection 인스턴스에 연결한 추가 데이터베이스를 분리합니다. 같은 데이터베이스를 서로 다른 이름을 사용하여 여러 번 연결할 수 있으며 연결 하나를 분리해도 다른 연결은 그대로 유지됩니다. 연결에 열려 있는 트랜잭션이 있는 경우(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() 메서드를 세 번 호출한 경우 세 개의 저장점이 설정됩니다. 이 시점에서 releaseSavepoint()를 호출하면 세 번째(최신) 저장점 이후에 수행된 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 요소

데이터베이스 트랜잭션 내의 북마크 같은 저장점을 만듭니다. 저장점은 트랜잭션 내의 한 지점을 나타냅니다. 저장점 사이에 수행된 SQL 작업은 releaseSavepoint() 및 rollbackToSavepoint() 메서드를 사용하여 다른 작업과 별도로 커밋 또는 롤백할 수 있습니다. 이런 방식으로 저장점을 사용하여 일련의 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 요소