트랜잭션
API
하나의 트랜잭션(transaction) 내에서 여러 구문을 실행하려면 transaction 함수를 사용하세요.
val players = listOf<Player>()
database.playerQueries.transaction {
players.forEach { player ->
database.playerQueries.insert(
player_number = player.number,
full_name = player.fullName
)
}
}트랜잭션에서 값을 반환하려면 transactionWithResult 함수를 사용하세요.
val players: List<Player> = database.playerQueries.transactionWithResult {
database.playerQueries.selectAll().executeAsList()
}Rollback
트랜잭션 내부 어디서든 예외가 발생하면 트랜잭션이 롤백(roll back)됩니다. 트랜잭션 내부의 어느 지점에서든 수동으로 트랜잭션을 롤백할 수 있지만, 트랜잭션이 값을 반환하는 경우에는 반환할 값을 직접 지정해야 합니다.
database.playerQueries.transaction {
players.forEach { player ->
if (player.number == 0) rollback()
database.playerQueries.insert(
player_number = player.number,
full_name = player.fullName
)
}
}val numberInserted: Int = database.playerQueries.transactionWithResult {
players.forEach { player ->
if (player.number == 0) rollback(0)
database.playerQueries.insert(
player_number = player.number,
full_name = player.fullName
)
}
players.size
}Callbacks
트랜잭션이 완료되거나 롤백된 후에 실행될 콜백(callback)을 등록할 수 있습니다.
database.playerQueries.transaction {
afterRollback { log("No players were inserted.") }
afterCommit { log("${players.size} players were inserted.") }
players.forEach { player ->
database.playerQueries.insert(
player_number = player.number,
full_name = player.fullName
)
}
}대용량 쿼리의 일관성
AndroidSqliteDriver를 사용할 때 쿼리 결과는 제한된 크기(기본 2MB)의 CursorWindow를 통해 읽힙니다. 결과가 한 윈도우에 모두 들어가지 않으면 AndroidSqliteDriver는 다음 윈도우를 채우기 위해 구문을 다시 실행합니다. 트랜잭션 외부에서 실행된 쿼리는 윈도우 사이에 다른 스레드에서 커밋된 변경 사항을 볼 수 있어, 데이터베이스에서 일관되지 않은 행(row)을 반환할 수 있습니다.
대용량 쿼리가 일관된 단일 스냅샷을 읽도록 보장하려면 트랜잭션 내부에서 실행하세요.
val players: List<Player> = database.playerQueries.transactionWithResult {
database.playerQueries.selectAll().executeAsList()
}트랜잭션을 사용하면 트랜잭션이 종료될 때까지 다른 쓰기 작업(writer)이 대기합니다.
AndroidSqliteDriver(API 28 이상)에서 더 큰 windowSizeBytes를 설정하면 추가 윈도우 생성을 방지할 수 있습니다.
정보
결과가 한 윈도우에 들어가지 않을 수 있는 RETURNING 절이 포함된 INSERT, UPDATE 또는 DELETE 구문은 피하세요. 추가 윈도우마다 해당 구문이 다시 실행되므로 변경 사항이 두 번 이상 적용됩니다. 트랜잭션으로도 이를 방지할 수 없습니다.
