تا حالا اسم  Database Inspector اندروید به گوشت خورده؟ به کمک Database Inspector میتونی جزئیات دیتابیست توی پروژه رو دقیق ببینی و دیتاها رو بررسی کنی.

در این مطلب به بررسی و آموزش این قسمت میپردازیم

Database Inspector اندروید چیه و به چه دردی می‌خوره؟

اگه می‌خوای دیتابیس اپلیکیشن‌ت رو ببینی، ازش کوئری بگیری، یا حتی توی همون لحظه داده‌هاش رو عوض کنی، Database Inspector دقیقاً همون ابزاریه که دنبالش بودی. این ابزار مخصوص دیباگ کردن دیتابیسه و فقط با لایبرری‌هایی کار می‌کنه که روی SQLite ساخته شدن (مثل Room).

مطالعه بیشتر : آموزش دیتابیس Room

 چطوری Database Inspector رو باز کنیم؟

از منوی اندروید استودیو برو به:
View > Tool Windows > App Inspection

اگه اپ در حال اجرا نباشه، فقط ابزار رو می‌بینی بدون اینکه دیتابیس لود شده باشه.

پس اپت رو روی یه دستگاه با API ۲۶ یا بالاتر اجرا کن و از بخش Select Process اون رو انتخاب کن. حالا تب Database Inspector برات فعال می‌شه.

 چطوری داده‌ها رو ببینیم یا تغییر بدیم؟

• اگه از Room استفاده می‌کنی و UI هم داره دیتابیس رو observe می‌کنه، می‌تونی مستقیماً روی سلول‌ها دابل‌کلیک کنی و مقدارها رو عوض کنی.
• اگه observe نباشه، تغییرات فقط دفعهٔ بعد که داده‌ها خونده بشن اعمال می‌شن.
• تیک Live updates رو بزنی، جدول به‌صورت زنده آپدیت می‌شه، ولی دیگه نمی‌تونی دستی داده‌ها رو عوض کنی.
• برای آپدیت دستی جدول، کافیه روی Refresh table بزنی.

 اجرای کوئری سفارشی در زمان اجرا

مراحل اجرای یه کوئری:

1. روی Open New Query کلیک کن.
2. دیتابیس مورد نظر رو انتخاب کن.
3. کوئری SQL رو بنویس.
4. روی Run کلیک کن.

همچنین می‌تونی کوئری‌هایی که قبلاً نوشتی رو از Show query history انتخاب و دوباره اجرا کنی.

اجرای سریع کوئری از DAO

اگه از Room استفاده می‌کنی، یه قابلیت سریع هم داری:
از کلاس DAO روی دکمه Run SQLite statement in the Database Inspector کلیک کن.
– اگه چند دیتابیس داری، باید یکی رو انتخاب کنی.
– اگه کوئریت پارامتر داره، باید مقدار وارد کنی.

⚠️ این امکان فقط برای متدهایی با Annotation @Query فعاله. بقیه رو باید دستی بنویسی.

 مدیریت اتصال‌ها و خروجی گرفتن از دیتابیس

• دیتابیس‌هایی که باز هستن و بسته هستن، با آیکن متفاوت مشخص می‌شن.
• می‌تونی گزینه Keep database connections open رو روشن کنی تا اتصال بسته نشه.
• امکان گرفتن خروجی از دیتابیس، جدول، یا نتیجهٔ کوئری با فرمت‌های DB, SQL یا CSV هم وجود داره.

 جمع‌بندی

Database Inspector اندروید یه ابزار فوق‌العاده‌ست برای زمانی که می‌خوای دیتابیس اپ اندرویدت رو حین اجرا بررسی، ویرایش یا دیباگ کنی. مخصوصاً اگه از Room استفاده می‌کنی، می‌تونه خیلی کارت رو راه بندازه.

کد های این پروژه رو میتونید در اینجا پیدا کنید .

تا مقاله بعدی، موفق باشی 👋