KMP-এর জন্য SQLite সেট-আপ করা

androidx.sqlite লাইব্রেরিতে বেসিক ইমপ্লিমেন্টেশনের সাথে অ্যাবস্ট্রাক্ট ইন্টারফেস থাকে যা SQLite অ্যাক্সেস করে এমন আপনার নিজস্ব লাইব্রেরি তৈরি করতে ব্যবহার করা যেতে পারে। আপনি Room লাইব্রেরি ব্যবহার করার কথা বিবেচনা করতে পারেন, যা SQLite-এর উপর একটি অ্যাবস্ট্রাকশন লেয়ার প্রদান করে যাতে SQLite-এর সম্পূর্ণ ক্ষমতা ব্যবহার করার পাশাপাশি আরও শক্তিশালী ডেটাবেস অ্যাক্সেসের অনুমতি দেওয়া যায়।

ডিপেন্ডেন্সি সেট-আপ করুন

আপনার KMP প্রোজেক্টে SQLite সেট-আপ করতে, আপনার মডিউলের জন্য build.gradle.kts ফাইলে আর্টিফ্যাক্টের জন্য ডিপেন্ডেন্সি যোগ করুন:

[versions]
sqlite = "2.7.1"

[libraries]
# The SQLite Driver interfaces
androidx-sqlite = { module = "androidx.sqlite:sqlite", version.ref = "sqlite" }

# The bundled SQLite driver implementation
androidx-sqlite-bundled = { module = "androidx.sqlite:sqlite-bundled", version.ref = "sqlite" }

[plugins]
ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }

SQLite Driver API

androidx.sqlite লাইব্রেরি গ্রুপ SQLite লাইব্রেরির সাথে কমিউনিকেট করার জন্য লো-লেভেল API অফার করে। androidx.sqlite:sqlite-bundled ব্যবহার করার সময় এটি লাইব্রেরিতে অন্তর্ভুক্ত থাকে অথবা androidx.sqlite:sqlite-framework ব্যবহার করার সময় Android বা iOS-এর মতো হোস্ট প্ল্যাটফর্মে থাকে। API-গুলি SQLite C API-এর মূল কার্যকারিতা ঘনিষ্ঠভাবে অনুসরণ করে।

তিনটি প্রধান ইন্টারফেস আছে:

  • SQLiteDriver: SQLite-এর এন্ট্রি পয়েন্ট, ডেটাবেস কানেকশন খোলার জন্য ব্যবহার করা হয়।
  • SQLiteConnection: sqlite3 অবজেক্টকে বোঝায়।
  • SQLiteStatement: sqlite3_stmt অবজেক্টকে বোঝায়।

নিম্নলিখিত উদাহরণে মূল API দেখানো হয়েছে:

fun main() {
    val databaseConnection = BundledSQLiteDriver().open("todos.db")
    databaseConnection.execSQL(
        "CREATE TABLE IF NOT EXISTS Todo (id INTEGER PRIMARY KEY, content TEXT)"
    )
    databaseConnection.prepare(
        "INSERT OR IGNORE INTO Todo (id, content) VALUES (? ,?)"
    ).use { stmt ->
        stmt.bindInt(index = 1, value = 1)
        stmt.bindText(index = 2, value = "Try Room in the KMP project.")
        stmt.step()
    }
    databaseConnection.prepare("SELECT content FROM Todo").use { stmt ->
        while (stmt.step()) {
            println("Action item: ${stmt.getText(0)}")
        }
    }
    databaseConnection.close()
}

SQLite C API-এর মতো, সাধারণ ব্যবহারের প্যাটার্নে এইসব ধাপ থাকে:

  1. ইনস্ট্যানশিয়েট করা SQLiteDriver ইমপ্লিমেন্টেশন ব্যবহার করে ডেটাবেস কানেকশন খুলুন।
  2. SQLiteConnection.prepare ব্যবহার করে SQL স্টেটমেন্ট তৈরি করো।
  3. নিম্নলিখিত ধাপগুলি অনুসরণ করে SQLiteStatement এক্সিকিউট করুন:
    1. ঐচ্ছিক: bind* ফাংশন ব্যবহার করে আর্গুমেন্ট বাইন্ড করুন।
    2. step ফাংশন ব্যবহার করে ফলাফল সেটের উপর ইটারেট করুন।
    3. get* ফাংশন ব্যবহার করে ফলাফল সেট থেকে কলাম পড়ুন।

ড্রাইভার ইমপ্লিমেন্টেশন

নিম্নলিখিত সারণীতে উপলভ্য ড্রাইভার ইমপ্লিমেন্টেশনের সারসংক্ষেপ দেওয়া হয়েছে:

ক্লাসের নাম

আর্টিফ্যাক্ট

কাজ করে এমন প্ল্যাটফর্ম

AndroidSQLiteDriver androidx.sqlite:sqlite-framework

Android

NativeSQLiteDriver androidx.sqlite:sqlite-framework

iOS, Mac ও Linux

BundledSQLiteDriver androidx.sqlite:sqlite-bundled

Android, iOS, Mac, Linux, এবং JVM (ডেস্কটপ)

WebWorkerSQLiteDriver androidx.sqlite:sqlite-web

জাভাস্ক্রিপ্ট ও WebAssembly (WasmJS)

androidx.sqlite:sqlite-bundled-এ উপলভ্য BundledSQLiteDriver-এর জন্য সাজেস্ট করা নিয়মগুলি ব্যবহার করুন। এতে সোর্স থেকে কম্পাইল করা SQLite লাইব্রেরি অন্তর্ভুক্ত থাকে, যা সব সমর্থিত KMP প্ল্যাটফর্ম জুড়ে সবচেয়ে আপ-টু-ডেট ভার্সন এবং ধারাবাহিকতা অফার করে।

SQLite ড্রাইভার ও Room

SQLite ডেটাবেসের সাথে লো-লেভেল ইন্টার‍্যাকশনের জন্য ড্রাইভার API উপযোগী। SQLite-এ আরও শক্তিশালী অ্যাক্সেস প্রদান করে এমন ফিচার-সমৃদ্ধ লাইব্রেরির জন্য, আমরা Room সাজেস্ট করি।

RoomDatabase ডেটাবেস অপারেশন পারফর্ম করার জন্য SQLiteDriver-এর উপর নির্ভর করে, এবং আপনাকে অবশ্যই RoomDatabase.Builder.setDriver ব্যবহার করে একটি ইমপ্লিমেন্টেশন কনফিগার করতে হবে। ম্যানেজ করা ডেটাবেস কানেকশনে আরও সরাসরি অ্যাক্সেসের জন্য রুম RoomDatabase.useReaderConnection এবং RoomDatabase.useWriterConnection প্রদান করে।

Kotlin Multiplatform-এ মাইগ্রেট করা

আপনাকে লো-লেভেল সাপোর্ট SQLite API কম্পোনেন্টের যেকোনও ব্যবহার, যেমন SupportSQLiteDatabase ইন্টারফেস, সমতুল্য SQLite ড্রাইভার কম্পোনেন্টে মাইগ্রেট করতে হবে।

Kotlin Multiplatform

নিম্ন-স্তরের SQLiteConnection ব্যবহার করে একটি ট্রানজ্যাকশন করুন

val connection: SQLiteConnection = BundledSQLiteDriver().open("todos.db")
connection.execSQL("BEGIN IMMEDIATE TRANSACTION")
try {
    // perform database operations in transaction.
    connection.execSQL("END TRANSACTION")
} catch (t: Throwable) {
    connection.execSQL("ROLLBACK TRANSACTION")
}

কোনও ফলাফল ছাড়াই কোয়েরি এক্সিকিউট করুন

val connection: SQLiteConnection = BundledSQLiteDriver().open("todos.db")
connection.execSQL("ALTER TABLE ...")

ফলাফল সহ কোয়েরি এক্সিকিউট করুন, তবে কোনও আর্গুমেন্ট নেই

val connection: SQLiteConnection = BundledSQLiteDriver().open("todos.db")
connection.prepare("SELECT * FROM Pet").use { statement ->
    while (statement.step()) {
        // read columns.
        statement.getInt(0)
        statement.getText(1)
    }
}

ফলাফল ও আর্গুমেন্ট ব্যবহার করে কোয়েরি এক্সিকিউট করুন

connection.prepare("SELECT * FROM Pet WHERE id = ?").use { statement ->
    statement.bindInt(1, id)
    if (statement.step()) {
        // row found, read columns.
    } else {
        // row not found.
    }
}

শুধুমাত্র Android-এ উপলভ্য

SupportSQLiteDatabase ব্যবহার করে ট্রানজ্যাকশন করুন

val database: SupportSQLiteDatabase = ...
database.beginTransaction()
try {
  // perform database operations in transaction
  database.setTransactionSuccessful()
} finally {
  database.endTransaction()
}

কোনও ফলাফল ছাড়াই কোয়েরি এক্সিকিউট করুন

val database: SupportSQLiteDatabase = ...
database.execSQL("ALTER TABLE ...")

ফলাফল সহ কোয়েরি এক্সিকিউট করুন, তবে কোনও আর্গুমেন্ট নেই

val database: SupportSQLiteDatabase = ...
database.query("SELECT * FROM Pet").use { cursor ->
  while (cursor.moveToNext()) {
    // read columns
    cursor.getInt(0)
    cursor.getString(1)
  }
}

ফলাফল ও আর্গুমেন্ট ব্যবহার করে কোয়েরি এক্সিকিউট করুন

database.query("SELECT * FROM Pet WHERE id = ?", id).use { cursor ->
  if (cursor.moveToNext()) {
    // row found, read columns
  } else {
    // row not found
  }
}