SQLite ব্যবহার করে ডেটা সেভ করা

ডেটাবেসে ডেটা সেভ করা পুনরাবৃত্তি বা স্ট্রাকচার্ড ডেটার জন্য আদর্শ, যেমন যোগাযোগের তথ্য। এই পৃষ্ঠায় ধরে নেওয়া হয়েছে যে আপনি সাধারণভাবে SQL ডেটাবেস সম্পর্কে জানেন এবং Android-এ SQLite ডেটাবেস ব্যবহার শুরু করতে আপনাকে সাহায্য করে। Android-এ ডেটাবেস ব্যবহার করার জন্য প্রয়োজনীয় API android.database.sqlite প্যাকেজে উপলভ্য।

সতর্কতা: যদিও এই APIগুলি শক্তিশালী, তবে এগুলি বেশ লো-লেভেলের এবং ব্যবহার করার জন্য অনেক সময় এবং প্রচেষ্টার প্রয়োজন:

• র SQL কোয়েরির কোনও কম্পাইল-টাইম যাচাইকরণ নেই। আপনার ডেটা গ্রাফ পরিবর্তন হলে, আপনাকে প্রভাবিত SQL কোয়েরি ম্যানুয়ালি আপডেট করতে হবে। এই প্রসেসে অনেক সময় লাগতে পারে এবং ভুল হওয়ার সম্ভাবনা থাকে।
• SQL কোয়েরি ও ডেটা অবজেক্টের মধ্যে কনভার্ট করতে আপনাকে অনেক বয়লারপ্লেট কোড ব্যবহার করতে হবে।

এইসব কারণে, আপনার অ্যাপের SQLite ডেটাবেসে তথ্য অ্যাক্সেস করার জন্য অ্যাবস্ট্রাকশন লেয়ার হিসেবে রুম পারসিসটেন্স লাইব্রেরি ব্যবহার করার জন্য আমরা জোরালো সাজেশন দিই।

স্কিমা ও কন্ট্রাক্ট নির্দিষ্ট করুন

SQL ডেটাবেসের অন্যতম প্রধান নীতি হল স্কিমা: ডেটাবেস কীভাবে সাজানো হয়েছে তার একটি আনুষ্ঠানিক ঘোষণা। আপনার ডেটাবেস তৈরি করার জন্য আপনি যে SQL স্টেটমেন্ট ব্যবহার করেন, তাতে স্কিমা প্রতিফলিত হয়। আপনি একটি কম্প্যানিয়ন ক্লাস তৈরি করতে পারেন, যা কনট্র্যাক্ট ক্লাস নামে পরিচিত। এটি আপনার স্কিমার লেআউটকে পদ্ধতিগত এবং সেল্ফ-ডকুমেন্টিং উপায়ে স্পষ্টভাবে নির্দিষ্ট করে।

কনট্র্যাক্ট ক্লাস হল কনস্ট্যান্টের জন্য একটি কন্টেনার যা URI, টেবিল ও কলামের নাম নির্ধারণ করে। কনট্র্যাক্ট ক্লাস আপনাকে একই প্যাকেজের মধ্যে থাকা অন্যান্য সব ক্লাসে একই কনস্ট্যান্ট ব্যবহার করার অনুমতি দেয়। এটি আপনাকে এক জায়গায় কলামের নাম পরিবর্তন করতে এবং আপনার কোড জুড়ে এটি প্রচার করতে দেয়।

কনট্র্যাক্ট ক্লাস সাজানোর একটি ভালো উপায় হল, ক্লাসের রুট লেভেলে আপনার সম্পূর্ণ ডেটাবেসের জন্য গ্লোবাল সংজ্ঞাগুলি রাখা। তারপর প্রতিটি টেবিলের জন্য একটি ইনার ক্লাস তৈরি করুন। প্রতিটি ইনার ক্লাস সংশ্লিষ্ট টেবিলের কলামকে গণনা করে।

মনে রাখবেন: BaseColumns ইন্টারফেস প্রয়োগ করার মাধ্যমে, আপনার ইনার ক্লাস _ID নামক একটি প্রাথমিক কী ফিল্ড উত্তরাধিকার সূত্রে পেতে পারে, যা CursorAdapter-এর মতো কিছু Android ক্লাসের ক্ষেত্রে প্রত্যাশিত। এটি আবশ্যক নয়, তবে এটি আপনার ডেটাবেসকে Android ফ্রেমওয়ার্কের সাথে সামঞ্জস্যপূর্ণভাবে কাজ করতে সাহায্য করতে পারে।

যেমন, নিম্নলিখিত কন্ট্র্যাক্ট RSS ফিড দেখায় এমন একটি টেবিলের জন্য টেবিলের নাম ও কলামের নাম সংজ্ঞায়িত করে:

Kotlin

object FeedReaderContract {
    // Table contents are grouped together in an anonymous object.
    object FeedEntry : BaseColumns {
        const val TABLE_NAME = "entry"
        const val COLUMN_NAME_TITLE = "title"
        const val COLUMN_NAME_SUBTITLE = "subtitle"
    }
}

জাভা

public final class FeedReaderContract {
    // To prevent someone from accidentally instantiating the contract class,
    // make the constructor private.
    private FeedReaderContract() {}

    /* Inner class that defines the table contents */
    public static class FeedEntry implements BaseColumns {
        public static final String TABLE_NAME = "entry";
        public static final String COLUMN_NAME_TITLE = "title";
        public static final String COLUMN_NAME_SUBTITLE = "subtitle";
    }
}

SQL হেল্পার ব্যবহার করে ডেটাবেস তৈরি করা

আপনার ডেটাবেস কেমন দেখতে হবে তা নির্ধারণ করার পরে, আপনাকে এমন পদ্ধতি প্রয়োগ করতে হবে যা ডেটাবেস এবং টেবিল তৈরি ও রক্ষণাবেক্ষণ করে। এখানে কিছু সাধারণ স্টেটমেন্ট দেওয়া হল যা টেবিল তৈরি করে এবং মুছে দেয়:

Kotlin

private const val SQL_CREATE_ENTRIES =
        "CREATE TABLE ${FeedEntry.TABLE_NAME} (" +
                "${BaseColumns._ID} INTEGER PRIMARY KEY," +
                "${FeedEntry.COLUMN_NAME_TITLE} TEXT," +
                "${FeedEntry.COLUMN_NAME_SUBTITLE} TEXT)"

private const val SQL_DELETE_ENTRIES = "DROP TABLE IF EXISTS ${FeedEntry.TABLE_NAME}"

জাভা

private static final String SQL_CREATE_ENTRIES =
    "CREATE TABLE " + FeedEntry.TABLE_NAME + " (" +
    FeedEntry._ID + " INTEGER PRIMARY KEY," +
    FeedEntry.COLUMN_NAME_TITLE + " TEXT," +
    FeedEntry.COLUMN_NAME_SUBTITLE + " TEXT)";

private static final String SQL_DELETE_ENTRIES =
    "DROP TABLE IF EXISTS " + FeedEntry.TABLE_NAME;

ডিভাইসের ইন্টার্নাল স্টোরেজে আপনি যেসব ফাইল সেভ করেন, ঠিক সেভাবেই Android আপনার অ্যাপের ব্যক্তিগত ফোল্ডারে ডেটাবেস সেভ করে। আপনার ডেটা নিরাপদ, কারণ ডিফল্ট হিসেবে এই এরিয়া অন্য অ্যাপ বা ব্যবহারকারী অ্যাক্সেস করতে পারেন না।

SQLiteOpenHelper ক্লাসে আপনার ডেটাবেস ম্যানেজ করার জন্য API-এর একটি উপযোগী সেট রয়েছে। আপনার ডেটাবেসের রেফারেন্স পেতে এই ক্লাস ব্যবহার করলে, সিস্টেম ডেটাবেস তৈরি ও আপডেট করার মতো সম্ভাব্য দীর্ঘ-মেয়াদী অপারেশন শুধুমাত্র প্রয়োজন হলেই সম্পূর্ণ করে এবং অ্যাপ স্টার্টআপের সময় নয়। আপনাকে শুধু getWritableDatabase() অথবা getReadableDatabase() নম্বরে কল করতে হবে।

মনে রাখবেন: যেহেতু এগুলি অনেকক্ষণ ধরে চলতে পারে, তাই ব্যাকগ্রাউন্ড থ্রেডে getWritableDatabase() বা getReadableDatabase() কল করতে ভুলবেন না। আরও তথ্যের জন্য Android-এ থ্রেডিং দেখুন।

SQLiteOpenHelper ব্যবহার করতে, এমন একটি সাবক্লাস তৈরি করুন যা onCreate() এবং onUpgrade() কলব্যাক পদ্ধতি ওভাররাইড করে। আপনি onDowngrade() বা onOpen() পদ্ধতিও প্রয়োগ করতে চাইতে পারেন, তবে সেগুলি আবশ্যক নয়।

যেমন, এখানে SQLiteOpenHelper-এর একটি প্রয়োগ দেখানো হল যা উপরে দেখানো কিছু কমান্ড ব্যবহার করে:

Kotlin

class FeedReaderDbHelper(context: Context) : SQLiteOpenHelper(context, DATABASE_NAME, null, DATABASE_VERSION) {
    override fun onCreate(db: SQLiteDatabase) {
        db.execSQL(SQL_CREATE_ENTRIES)
    }
    override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) {
        // This database is only a cache for online data, so its upgrade policy is
        // to simply to discard the data and start over
        db.execSQL(SQL_DELETE_ENTRIES)
        onCreate(db)
    }
    override fun onDowngrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) {
        onUpgrade(db, oldVersion, newVersion)
    }
    companion object {
        // If you change the database schema, you must increment the database version.
        const val DATABASE_VERSION = 1
        const val DATABASE_NAME = "FeedReader.db"
    }
}

জাভা

public class FeedReaderDbHelper extends SQLiteOpenHelper {
    // If you change the database schema, you must increment the database version.
    public static final int DATABASE_VERSION = 1;
    public static final String DATABASE_NAME = "FeedReader.db";

    public FeedReaderDbHelper(Context context) {
        super(context, DATABASE_NAME, null, DATABASE_VERSION);
    }
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(SQL_CREATE_ENTRIES);
    }
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        // This database is only a cache for online data, so its upgrade policy is
        // to simply to discard the data and start over
        db.execSQL(SQL_DELETE_ENTRIES);
        onCreate(db);
    }
    public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        onUpgrade(db, oldVersion, newVersion);
    }
}

আপনার ডেটাবেস অ্যাক্সেস করতে, SQLiteOpenHelper-এর সাবক্লাস ইনস্ট্যান্টিয়েট করুন:

Kotlin

val dbHelper = FeedReaderDbHelper(context)

জাভা

FeedReaderDbHelper dbHelper = new FeedReaderDbHelper(getContext());

ডেটাবেসে তথ্য যোগ করা

insert() পদ্ধতিতে ContentValues অবজেক্ট পাস করে ডেটাবেসে ডেটা যোগ করুন:

Kotlin

// Gets the data repository in write mode
val db = dbHelper.writableDatabase

// Create a new map of values, where column names are the keys
val values = ContentValues().apply {
    put(FeedEntry.COLUMN_NAME_TITLE, title)
    put(FeedEntry.COLUMN_NAME_SUBTITLE, subtitle)
}

// Insert the new row, returning the primary key value of the new row
val newRowId = db?.insert(FeedEntry.TABLE_NAME, null, values)

জাভা

// Gets the data repository in write mode
SQLiteDatabase db = dbHelper.getWritableDatabase();

// Create a new map of values, where column names are the keys
ContentValues values = new ContentValues();
values.put(FeedEntry.COLUMN_NAME_TITLE, title);
values.put(FeedEntry.COLUMN_NAME_SUBTITLE, subtitle);

// Insert the new row, returning the primary key value of the new row
long newRowId = db.insert(FeedEntry.TABLE_NAME, null, values);

insert()-এর প্রথম আর্গুমেন্ট হল টেবিলের নাম।

দ্বিতীয় আর্গুমেন্ট ফ্রেমওয়ার্ককে বলে দেয় যে ContentValues খালি থাকলে (অর্থাৎ, আপনি কোনও ভ্যালু put করেননি) কী করতে হবে। আপনি কোনও কলামের নাম উল্লেখ করলে, ফ্রেমওয়ার্ক একটি সারি যোগ করে এবং সেই কলামের ভ্যালু ফাঁকা হিসেবে সেট করে। আপনি যদি এই কোড স্যাম্পেলের মতো null নির্দিষ্ট করেন, তাহলে কোনও ভ্যালু না থাকলে ফ্রেমওয়ার্ক কোনও সারি যোগ করে না।

insert() পদ্ধতি নতুন তৈরি করা সারির জন্য আইডি রিটার্ন করে অথবা ডেটা যোগ করার সময় কোনও সমস্যা হলে এটি -১ রিটার্ন করবে। ডেটাবেসে আগে থেকে থাকা ডেটার সাথে কোনও সমস্যা হলে এটি হতে পারে।

ডেটাবেস থেকে তথ্য পড়া

ডেটাবেস থেকে পড়তে, query() পদ্ধতি ব্যবহার করুন, এটি আপনার বেছে নেওয়ার মাপকাঠি এবং পছন্দসই কলামে পাস করুন। এই পদ্ধতিতে insert() এবং update()-এর এলিমেন্ট একত্রিত করা হয়, তবে কলামের তালিকা আপনি যে ডেটা আনতে চান ("প্রোজেকশন") তা নির্ধারণ করে, যে ডেটা যোগ করতে চান তা নয়। কোয়েরির ফলাফল আপনাকে Cursor অবজেক্টে ফেরত পাঠানো হয়।

Kotlin

val db = dbHelper.readableDatabase

// Define a projection that specifies which columns from the database
// you will actually use after this query.
val projection = arrayOf(BaseColumns._ID, FeedEntry.COLUMN_NAME_TITLE, FeedEntry.COLUMN_NAME_SUBTITLE)

// Filter results WHERE "title" = 'My Title'
val selection = "${FeedEntry.COLUMN_NAME_TITLE} = ?"
val selectionArgs = arrayOf("My Title")

// How you want the results sorted in the resulting Cursor
val sortOrder = "${FeedEntry.COLUMN_NAME_SUBTITLE} DESC"

val cursor = db.query(
        FeedEntry.TABLE_NAME,   // The table to query
        projection,             // The array of columns to return (pass null to get all)
        selection,              // The columns for the WHERE clause
        selectionArgs,          // The values for the WHERE clause
        null,                   // don't group the rows
        null,                   // don't filter by row groups
        sortOrder               // The sort order
)

জাভা

SQLiteDatabase db = dbHelper.getReadableDatabase();

// Define a projection that specifies which columns from the database
// you will actually use after this query.
String[] projection = {
    BaseColumns._ID,
    FeedEntry.COLUMN_NAME_TITLE,
    FeedEntry.COLUMN_NAME_SUBTITLE
    };

// Filter results WHERE "title" = 'My Title'
String selection = FeedEntry.COLUMN_NAME_TITLE + " = ?";
String[] selectionArgs = { "My Title" };

// How you want the results sorted in the resulting Cursor
String sortOrder =
    FeedEntry.COLUMN_NAME_SUBTITLE + " DESC";

Cursor cursor = db.query(
    FeedEntry.TABLE_NAME,   // The table to query
    projection,             // The array of columns to return (pass null to get all)
    selection,              // The columns for the WHERE clause
    selectionArgs,          // The values for the WHERE clause
    null,                   // don't group the rows
    null,                   // don't filter by row groups
    sortOrder               // The sort order
    );

তৃতীয় ও চতুর্থ আর্গুমেন্ট (selection ও selectionArgs) একসাথে করে WHERE ক্লজ তৈরি করা হয়। যেহেতু আর্গুমেন্টগুলি নির্বাচন কোয়েরি থেকে আলাদাভাবে প্রদান করা হয়, তাই সেগুলি একত্রিত করার আগে এড়িয়ে যাওয়া হয়। এটি আপনার বেছে নেওয়া স্টেটমেন্টকে SQL ইনজেকশন থেকে সুরক্ষিত রাখে। সব আর্গুমেন্ট সম্পর্কে আরও জানতে, query() রেফারেন্স দেখুন।

কার্সরে কোনও সারি দেখতে, Cursor সরানোর পদ্ধতিগুলির মধ্যে একটি ব্যবহার করুন, যা আপনাকে অবশ্যই মান পড়া শুরু করার আগে কল করতে হবে। যেহেতু কার্সর -১ পজিশন থেকে শুরু হয়, তাই moveToNext() কল করলে "পড়ার পজিশন" ফলাফলের প্রথম এন্ট্রিতে প্লেস করা হয় এবং কার্সরটি ফলাফল সেটের শেষ এন্ট্রিটি ইতিমধ্যেই পেরিয়ে গেছে কিনা তা রিটার্ন করে। প্রতিটি সারির জন্য, আপনি Cursor গেট পদ্ধতির মধ্যে একটি কল করে কলামের ভ্যালু পড়তে পারেন, যেমন getString() বা getLong()। প্রতিটি get মেথডের জন্য, আপনাকে অবশ্যই আপনার পছন্দের কলামের ইন্ডেক্স পজিশন পাস করতে হবে, যা আপনি getColumnIndex() বা getColumnIndexOrThrow() কল করে পেতে পারেন। ফলাফল ইটারেট করা হয়ে গেলে, কার্সরে close() কল করুন যাতে এর রিসোর্স রিলিজ করা যায়। যেমন, কার্সরে স্টোর করা সব আইটেম আইডি কীভাবে পাওয়া যায় এবং সেগুলি কীভাবে একটি তালিকায় যোগ করা যায় তা নিচে দেখানো হয়েছে:

Kotlin

val itemIds = mutableListOf<Long>()
with(cursor) {
    while (moveToNext()) {
        val itemId = getLong(getColumnIndexOrThrow(BaseColumns._ID))
        itemIds.add(itemId)
    }
}
cursor.close()

জাভা

List itemIds = new ArrayList<>();
while(cursor.moveToNext()) {
  long itemId = cursor.getLong(
      cursor.getColumnIndexOrThrow(FeedEntry._ID));
  itemIds.add(itemId);
}
cursor.close();

ডেটাবেস থেকে তথ্য মুছে দেওয়া

সারণি থেকে সারি মুছতে, আপনাকে বেছে নেওয়ার মাপকাঠি প্রদান করতে হবে যা delete() পদ্ধতিতে সারি শনাক্ত করে। এই মেকানিজম query() পদ্ধতিতে সিলেকশন আর্গুমেন্টের মতোই কাজ করে। এটি বাছাইয়ের স্পেসিফিকেশনকে বাছাইয়ের ক্লজ ও বাছাইয়ের আর্গুমেন্টে ভাগ করে। The clause defines the columns to look at, and also allows you to combine column tests. আর্গুমেন্ট হল সেইসব ভ্যালু যা ক্লজের সাথে যুক্ত এবং যেগুলির উপর ভিত্তি করে পরীক্ষা করা হয়। কারণ, ফলাফলটি সাধারণ SQL স্টেটমেন্টের মতো করে ম্যানেজ করা হয় না, তাই এটি SQL ইঞ্জেকশনের ক্ষেত্রে সুরক্ষিত।

Kotlin

// Define 'where' part of query.
val selection = "${FeedEntry.COLUMN_NAME_TITLE} LIKE ?"
// Specify arguments in placeholder order.
val selectionArgs = arrayOf("MyTitle")
// Issue SQL statement.
val deletedRows = db.delete(FeedEntry.TABLE_NAME, selection, selectionArgs)

জাভা

// Define 'where' part of query.
String selection = FeedEntry.COLUMN_NAME_TITLE + " LIKE ?";
// Specify arguments in placeholder order.
String[] selectionArgs = { "MyTitle" };
// Issue SQL statement.
int deletedRows = db.delete(FeedEntry.TABLE_NAME, selection, selectionArgs);

delete() মেথডের জন্য রিটার্ন ভ্যালু ডেটাবেস থেকে মুছে ফেলা সারির সংখ্যা দেখায়।

ডেটাবেস আপডেট করুন

আপনার ডেটাবেস ভ্যালুর সাবসেট পরিবর্তন করতে হলে, update() পদ্ধতি ব্যবহার করুন।

টেবিল আপডেট করলে, insert()-এর ContentValues সিনট্যাক্স delete()-এর WHERE সিনট্যাক্সের সাথে একত্রিত হয়।

Kotlin

val db = dbHelper.writableDatabase

// New value for one column
val title = "MyNewTitle"
val values = ContentValues().apply {
    put(FeedEntry.COLUMN_NAME_TITLE, title)
}

// Which row to update, based on the title
val selection = "${FeedEntry.COLUMN_NAME_TITLE} LIKE ?"
val selectionArgs = arrayOf("MyOldTitle")
val count = db.update(
        FeedEntry.TABLE_NAME,
        values,
        selection,
        selectionArgs)

জাভা

SQLiteDatabase db = dbHelper.getWritableDatabase();

// New value for one column
String title = "MyNewTitle";
ContentValues values = new ContentValues();
values.put(FeedEntry.COLUMN_NAME_TITLE, title);

// Which row to update, based on the title
String selection = FeedEntry.COLUMN_NAME_TITLE + " LIKE ?";
String[] selectionArgs = { "MyOldTitle" };

int count = db.update(
    FeedReaderDbHelper.FeedEntry.TABLE_NAME,
    values,
    selection,
    selectionArgs);

update() পদ্ধতির রিটার্ন ভ্যালু হল ডেটাবেসে প্রভাবিত সারির সংখ্যা।

ডেটাবেস কানেকশন বজায় রাখা হচ্ছে

যেহেতু ডেটাবেস বন্ধ থাকলে getWritableDatabase() এবং getReadableDatabase()-এ কল করা ব্যয়বহুল, তাই আপনার ডেটাবেস কানেকশন যতক্ষণ প্রয়োজন ততক্ষণ খোলা রাখা উচিত। সাধারণত, কলিং অ্যাক্টিভিটির onDestroy()-এ ডেটাবেস বন্ধ করা সবচেয়ে ভাল।

Kotlin

override fun onDestroy() {
    dbHelper.close()
    super.onDestroy()
}

জাভা

@Override
protected void onDestroy() {
    dbHelper.close();
    super.onDestroy();
}

আপনার ডেটাবেস ডিবাগ করুন

Android SDK-তে একটি sqlite3 শেল টুল অন্তর্ভুক্ত থাকে যা আপনাকে SQLite ডেটাবেসে টেবিল কন্টেন্ট ব্রাউজ করতে, SQL কমান্ড রান করতে এবং অন্যান্য উপযোগী ফাংশন পারফর্ম করতে দেয়। আরও তথ্যের জন্য, কীভাবে শেল কমান্ড ইস্যু করতে হয় তা দেখুন।