139

I have a set of data in an SQLite database. I need to view the database on a device. How do I do that?

I have checked in ddms mode. The data in file explorer is empty.

5

19 Answers 19

192

Here are step-by-step instructions (mostly taken from a combination of the other answers). This works even on devices that are not rooted.

  1. Connect your device and launch the application in debug mode.

  2. You may want to use adb -d shell "run-as com.yourpackge.name ls /data/data/com.yourpackge.name/databases/" to see what the database filename is.

Notice: com.yourpackge.name is your application package name. You can get it from the manifest file.

  1. Copy the database file from your application folder to your SD card.

    adb -d shell "run-as com.yourpackge.name cat /data/data/com.yourpackge.name/databases/filename.sqlite > /sdcard/filename.sqlite"

Notice: filename.sqlite is your database name you used when you created the database

  1. Pull the database files to your machine:

    adb pull /sdcard/filename.sqlite

This will copy the database from the SD card to the place where your ADB exist.

  1. Install Firefox SQLite Manager: https://addons.mozilla.org/en-US/firefox/addon/sqlite-manager/

  2. Open Firefox SQLite Manager (Tools->SQLite Manager) and open your database file from step 3 above.

  3. Enjoy!

20
  • 1
    It worked, but I had to replace single quotes in step 2 with double quotes. It doesn't work with single quotes, but works with double quotes (at least on Windows). Commented Mar 7, 2014 at 21:10
  • 1
    adb pull /sdcard/ will pull whole sdcard. use adb pull /sdcard/filename.sqlite Commented Dec 16, 2014 at 8:08
  • 3
    it doesn't work on all devices (for example Nexus 9). For those I recommend this solution stackoverflow.com/a/29257875/291427
    – kmalmur
    Commented Mar 25, 2015 at 14:21
  • 4
    It's also important to note that if you want to copy the DB to your SDcard, your App (the one you're "running as") needs the android.permission.WRITE_EXTERNAL_STORAGE-permission. Otherwise, it'll tell you "permission denied". Commented Jun 30, 2015 at 14:10
  • 12
    Just wanted to mention that I couldn't 'cat' the file to the sdcard and instead had to 'cp' it there, otherwise I would get an empty file in the sdcard.
    – TheIT
    Commented Mar 11, 2016 at 1:28
87

UPDATE 2020

Database Inspector (for Android Studio version 4.1). Read the Medium article

For older versions of Android Studio I recommend these 3 options:

  1. Facebook's open source [Stetho library] (http://facebook.github.io/stetho/). Taken from here

In build.gradle:

dependencies {
  // Stetho core
  compile 'com.facebook.stetho:stetho:1.5.1'        
  //If you want to add a network helper
  compile 'com.facebook.stetho:stetho-okhttp:1.5.1'
}

Initialize the library in the application object:

Stetho.initializeWithDefaults(this);

And you can view you database in Chrome from chrome://inspect

  1. Another option is this plugin (not free)
  2. And the last one is this free/open source library to see db contents in the browser https://github.com/amitshekhariitbhu/Android-Debug-Database
4
  • how to use Stetho in eclipse ? Commented Jun 12, 2016 at 10:03
  • 1
    After entering the inspect url, I wasn't easily seeing how to access the DB. This is how - after loading the url when your app is already running, there will be a url/link with text inspect on the loaded page for the App. Click that link .. then to access the DB : 1) Observe the Developer Tools window pops up from browser, 2) Click the Resources tab, 3) The databases are under Web SQL in the left-hand menu
    – Gene Bo
    Commented Nov 27, 2017 at 1:50
  • 1
    The great advantage of this solution is that you also can do SQL INSERT and DELETE (which is not possible with the solutions based on adb pull). All all changes are reflected in realtime so you don't need to copy the database each time as with adb pullbased solutions. Commented Sep 21, 2018 at 7:52
  • The Db opens no doubt however, the page formatting is not up to standards. Columns are overlapped, and sluggish crawling screen.
    – iCantC
    Commented Aug 14, 2019 at 14:44
65

The best way I found so far is using the Android-Debug-Database tool.

Its incredibly simple to use and setup, just add the dependence and connect to the device database's interface via web. No need to root the phone or adding activities or whatsoever. Here are the steps:

STEP 1

Add the following dependency to your app's Gradle file and run the application.

debugCompile 'com.amitshekhar.android:debug-db:1.0.0'

STEP 2

Open your browser and visit your phone's IP address on port 8080. The URL should be like: http://YOUR_PHONE_IP_ADDRESS:8080. You will be presented with the following:

NOTE: You can also always get the debug address URL from your code by calling the method DebugDB.getAddressLog();

enter image description here

To get my phone's IP I currently use Ping Tools, but there are a lot of alternatives.

STEP 3

That's it!


More details in the official documentation: https://github.com/amitshekhariitbhu/Android-Debug-Database

7
  • thanks, now i can get sqlite by remote. Is this work for public address too? Commented Dec 4, 2017 at 1:53
  • If you get 0.0.0.0:8080 then use the adb forward option above
    – Jeffrey
    Commented Jul 22, 2018 at 16:43
  • it works only, if the app is installed via android studio. if you install a signed apk on the device, this method does not work for me :(
    – lidox
    Commented Dec 26, 2018 at 12:31
  • @lindox That's because you've added it as a debugImplementation dependency in your gradle file. Use implementation instead of debugImplementation in your gradle file.
    – Bob
    Commented Jan 3, 2019 at 16:39
  • It times out, and doesn't work reliably for my database which has over 6000 rows.
    – zeeshan
    Commented Jan 29, 2019 at 22:52
54

The best way to view and manage your Android app database is to use the library DatabaseManager_For_Android.

It's a single Java activity file; just add it to your source folder. You can view the tables in your app database, update, delete, insert rows to you table. Everything from inside your app.

When the development is done remove the Java file from your src folder. That's it.

You can view the 5 minute demo, Database Manager for Android SQLite Database .

4
  • Can this be used to view any database (in sqllite) or only the one created by your app?
    – Jasper
    Commented Feb 10, 2015 at 11:48
  • Only the one created by your app
    – sanath_p
    Commented Feb 10, 2015 at 23:23
  • this works with SQLiteAssetHelper as well. great tool!
    – Rm558
    Commented Jan 12, 2016 at 1:21
  • This took me about an hour, so I hope this helps someone: if you're using DBFlow, make a class called DummySQLiteOpenHelper and put the getData method inside it, and get the database like this: SQLiteDatabase sqlDB = ((AndroidDatabase)FlowManager.getWritableDatabase("Main")).getDatabase();
    – androidguy
    Commented Jan 23, 2017 at 6:48
23

You can do this:

  1. adb shell
  2. cd /go/to/databases
  3. sqlite3 database.db
  4. In the sqlite> prompt, type .tables. This will give you all the tables in the database.db file.
  5. select * from table1;
7
  • 2
    This is working. The path is /data/data/COM.YOUR_PACKAGE.NAME/databases which COM.YOUR_PACKAGE.NAME is the name of the package you want to see its databases. Number 4 did not work, though.
    – Mahsa2
    Commented Aug 14, 2016 at 23:57
  • Thanks Mahsa Mohammadkhani, updated step 4, as you mentioned in step 2, path is app data path.
    – Deepu
    Commented Aug 18, 2016 at 14:04
  • 5
    This works. Kinda. After step 1 you should do a 'run-as PACKAGE.NAME' otherwise you won't have read access.
    – Mark Gjøl
    Commented May 1, 2017 at 11:54
  • This is the correct answer. Ok, not the correct answer, but the simplest answer by far, and works as magic.
    – fiatjaf
    Commented Nov 2, 2017 at 19:24
  • In the step number 2, I introduce "cd /data/data/com.name.of.my.package/databases" but the result is "Permission denied". Do you have to have root access to the device? Thank you.
    – Alex
    Commented Mar 22, 2018 at 8:16
16

If you are using a real device, and it is not rooted, then it is not possible to see your database in FileExplorer, because, due to some security reason, that folder is locked in the Android system. And if you are using it in an emulator you will find it in FileExplorer, /data/data/your package name/databases/yourdatabse.db.

3
  • 3
    I have rooted, but data in file explorer still empty
    – John
    Commented Nov 5, 2015 at 2:09
  • what is the meaning of rooting @Abhijit ?
    – vivek
    Commented Apr 19, 2016 at 8:01
  • Root means you have superuser access..Like admin access in windows Commented Apr 20, 2016 at 10:21
7

Try AndroidDBvieweR!

  • No need for your device to be ROOTED
  • No need to import the database file of the application
  • Few configurations and you are good to go!

AndroidDBvieweR

3
  • 2
    Good app, but you need to add a dependency to the app's build.gradle file. Commented Mar 3, 2016 at 11:23
  • 1
    Which adding the dependency takes all of 5 seconds. Thanks so much Peter this is brilliant! Commented Aug 10, 2016 at 16:19
  • 2
    not everyone wants to add third party libraries to a project. Especially because this requires to change your code.
    – Alberto M
    Commented Sep 8, 2016 at 14:05
4

I have been using SQLite Database Browser to see the content SQLite DB in Android development. You have to pull the database file from the device first, then open it in SQLite DB Browser.

5
  • I need to where the database file is present.I have checked it in file explorer but data is empty.then where to get the database file.
    – user
    Commented Oct 5, 2013 at 6:14
  • Are you using emulator or real device? If on real device, then I guess DDMS won't list the internal storage (including /data). However, you can use adb pull path_to_db_file_in_device path_to_save to save it to computer.
    – Andrew T.
    Commented Oct 5, 2013 at 6:20
  • This only works on an emulator. Commented Jun 6, 2015 at 7:30
  • This won't work when pulling db from a real device as it will be encrypted. If anyone knows how to use this technique with a "real" database please let me know!
    – niczak
    Commented Jul 25, 2017 at 17:32
  • it works but pulling the /data/data/your-package-name/databases/yourdb.db is cumbersone it would be nice if it would open automatically
    – DragonFire
    Commented May 29, 2020 at 7:37
4

Although this doesn't view the database on your device directly, I've published a simple shell script for dumping databases to your local machine:

https://github.com/Pixplicity/dbdump

It performs two distinct methods described here:

  1. First, it tries to make the file accessible for other users, and attempting to pull it from the device.
  2. If that fails, it streams the contents of the file over the terminal to the local machine. It performs an additional trick to remove \r characters that some devices output to the shell.

From here you can use a variety of CLI or GUI SQLite applications, such as sqlite3 or sqlitebrowser, to browse the contents of the database.

3
  • very confused... you should explain where to put your files, and how to execute those commands... I made copy/paste in my project, open cmd and run humpty.sh -d com.mypak.name databases/MyDB.db it says Succes! ... but in dumps/com.mypak.name/databases folder is just a bat file witch says : run-as: Package 'com.mypak.name' is unknown
    – Choletski
    Commented Aug 6, 2015 at 11:46
  • @Choletski It shouldn't be outputting a batch file, that sounds like a bug. How are you executing a shell script on Windows? Through cygwin or mingw? As for extracting the database, you may want to execute the commands through adb shell yourself to see if your device supports run-as. Commented Aug 6, 2015 at 11:53
  • 1
    Works like a charm. Surprized no one upvoted this!! Thanks ! Commented Oct 8, 2015 at 14:47
3

Follow these steps

1>Download the *.jar file from here .

2>Put the *.jar file into the folder eclipse/dropins/ and Restart eclipse.

3>In the top right of eclipse, click the DDMS icon.

4>Select the proper emulator in the left panel.

5In the File Explorer tab on the main panel, go to /data/data/[YOUR.APP.NAMESPACE]/databases.

6>Underneath the DDMS icon, there should be a new blue icon of a Database light up when you select your database. Click it and you will see a Questoid Sqlite Manager tab open up to view your data.

*Note: If the database doesn't light up, it may be because your database doesn't have a *.db file extension. Be sure your database is called [DATABASE_NAME].db

*Note: if you want to use a DB without .db-Extension:

-Download this Questoid SqLiteBrowser: Download fro here.

-Unzip and put it into eclipse/dropins (not Plugins).

-Check this for more information Click here.

3

try facebook Stetho.

Stetho is a debug bridge for Android applications, enabling the powerful Chrome Developer Tools and much more.

https://github.com/facebook/stetho

3

step 1 Copy this class in your package

step 2 put the following code in your class which extends SQLiteOpenHelper.

 //-----------------for show databasae table----------------------------------------

public ArrayList<Cursor> getData(String Query)
{
    //get writable database
    SQLiteDatabase sqlDB =this.getWritableDatabase();
    String[] columns = new String[] { "mesage" };
    //an array list of cursor to save two cursors one has results from the query
    //other cursor stores error message if any errors are triggered
    ArrayList<Cursor> alc = new ArrayList<Cursor>(2);
    MatrixCursor Cursor2= new MatrixCursor(columns);
    alc.add(null);
    alc.add (null);


    try{
        String maxQuery = Query ;
        //execute the query results will be save in Cursor c
        Cursor c = sqlDB.rawQuery(maxQuery, null);

        //add value to cursor2
        Cursor2.addRow(new Object[] { "Success" });

        alc.set(1,Cursor2);
        if (null != c && c.getCount() > 0)
        {
            alc.set(0,c);
            c.moveToFirst();
            return alc ;
        }
        return alc;
    }
    catch(SQLException sqlEx)
    {
        Log.d("printing exception", sqlEx.getMessage());
        //if any exceptions are triggered save the error message to cursor an return the arraylist
        Cursor2.addRow(new Object[] { ""+sqlEx.getMessage() });
        alc.set(1,Cursor2);
        return alc;
    }
    catch(Exception ex)
    {
        Log.d("printing exception",ex.getMessage());
        //if any exceptions are triggered save the error message to cursor an return the arraylist
        Cursor2.addRow(new Object[] { ""+ex.getMessage() });
        alc.set(1,Cursor2);
        return alc;
    }
}

step 3 register in manifest

<activity
        android:name=".database.AndroidDatabaseManager"
        android:screenOrientation="portrait"
        android:theme="@style/AppTheme.NoActionBar"/>

step 4

Intent i = new Intent(this, AndroidDatabaseManager.class);
startActivity(i);
2

This works with Android 6.0 (debuggable apps at least):

adb shell "run-as your.package.name cp /data/data/your.package.name/databases/you-db-name  /sdcard/file_to_write"

Then you simply can view the DB with aSQLiteManager for instance.

2

You can try SQLiteOnWeb. It manages your SQLite database in the browser.

4
  • I can't get gradle to resolve the dependencies listed in this project's readme Commented Apr 18, 2016 at 10:45
  • Oh~, could you tell me what error you get? Commented Apr 19, 2016 at 6:27
  • Error:(48, 18) Failed to resolve: io.github.skyhacker2:sqliteonweb:1.0.1 and Error:(49, 20) Failed to resolve: io.github.skyhacker2:sqliteonweb-no-op:1.0.2. i'm using mavenCentral in repositories Commented Apr 20, 2016 at 15:06
  • please use jcenter in repositories :) Commented Apr 21, 2016 at 2:21
2

Hope this helps you

Using Terminal First point your location where andriod sdk is loacted

eg: C:\Users\AppData\Local\Android\sdk\platform-tools>

then check the list of devices attached Using

 adb devices

and then run this command to copy the file from device to your system

adb -s YOUR_DEVICE_ID shell run-as YOUR_PACKAGE_NAME chmod -R 777 /data/data/YOUR_PACKAGE_NAME/databases && adb -s YOUR_DEVICE_ID shell "mkdir -p /sdcard/tempDB" && adb -s YOUR_DEVICE_ID shell "cp -r /data/data/YOUR_PACKAGE_NAME/databases/ /sdcard/tempDB/." && adb -s YOUR_DEVICE_ID pull sdcard/tempDB/ && adb -s YOUR_DEVICE_ID shell "rm -r /sdcard/tempDB/*"

You can find the database file in this path

 Android\sdk\platform-tools\tempDB\databases
1

Using file explorer, you can locate your database file like this:

data-->data-->your.package.name-->databases--->yourdbfile.db

Then you can use any SQLite fronted to explore your database. I use the SQLite Manager Firefox addon. It's nice, small, and fast.

5
  • Is this only work for emulator?
    – Hoo
    Commented Nov 4, 2015 at 9:51
  • For rooted device also it works fine
    – r4jiv007
    Commented Nov 4, 2015 at 9:56
  • It can access data-->data-->your.package.name-->databases--->yourdbfile.db after rooted?
    – Hoo
    Commented Nov 4, 2015 at 9:58
  • Yes, it can I have tried it
    – r4jiv007
    Commented Nov 4, 2015 at 10:07
  • 3
    data in file explorer still empty even device is rooted
    – John
    Commented Nov 5, 2015 at 2:11
1

There is TKlerx's Android SQLite browser for Eclipse, and it's fully functional alongside Android Studio. I'll recommend it, because it is immensely practical.

To install it on Device Monitor, just place the JAR file in [Path to Android SDK folder]/sdk/tools/lib/monitor-[...]/plugins.

0

I found very simple library stetho to browse sqlite db of app in chrome, see

0

First post (https://stackoverflow.com/a/21151598/4244605) does not working for me.

I wrote own script for get DB file from device. Without root. Working OK.

  1. Copy script to directory with adb (e.g.:~/android-sdk/platform-tools).
  2. Device have to be connected to PC.
  3. Use ./getDB.sh -p <packageName> for get name of databases.

Usage: ./getDB.sh -p <packageName> -n <name of DB> -s <store in mobile device> for get DB file to this (where script is executed) directory.

I recommend you set filename of DB as *.sqlite and open it with Firefox addon: SQLite Manager.

(It's a long time, when i have written something in Bash. You can edit this code.)

#!/bin/sh
# Get DB from Android device.
#

Hoption=false
Poption=false
Noption=false
Soption=false
Parg=""
Narg=""
Sarg=""

#-----------------------FUNCTION--------------------------:
helpFunc(){ #help
echo "Get names of DB's files in your Android app.
Usage: ./getDB -h
       ./getDB -p packageName -n nameOfDB -s storagePath
Options:
   -h                                           Show help.
   -p packageName                               List of databases for package name.
   -p packageName -n nameOfDB -s storagePath    Save DB from device to this directory."
}


#--------------------------MAIN--------------------------:
while getopts 'p:n:s:h' options; do
    case $options in

        p) Poption=true
            Parg=$OPTARG;;

        n) Noption=true
            Narg=$OPTARG;;

        s) Soption=true
            Sarg=$OPTARG;;

        h) Hoption=true;;
    esac
done

#echo "-------------------------------------------------------
#Hoption: $Hoption
#Poption: $Poption
#Noption: $Noption
#Soption: $Soption
#Parg: $Parg
#Narg: $Narg
#Sarg: $Sarg
#-------------------------------------------------------"\\n
#echo $#    #count of params

if [ $Hoption = true ];then
    helpFunc
elif [ $# -eq 2 -a $Poption = true ];then #list
    ./adb -d shell run-as $Parg ls /data/data/$Parg/databases/
    exit 0
elif [ $# -eq 6 -a $Poption = true -a $Noption = true -a $Soption = true ];then #get DB file
    #Change permissions
    ./adb shell run-as $Parg chmod 777 /data/data/$Parg/databases/
    ./adb shell run-as $Parg chmod 777 /data/data/$Parg/databases/$Narg
    #Copy
    ./adb shell cp /data/data/$Parg/databases/$Narg $Sarg
    #Pull file to this machine
    ./adb pull $Sarg/$Narg
    exit 0
else
    echo "Wrong params or arguments. Use -h for help."
    exit 1;
fi

exit 0;

Not the answer you're looking for? Browse other questions tagged or ask your own question.