Exploring the database

This guide will help guide you in poking around your Dreamwidth installation's database. This could help you during coding! You might also want to read the Database Table Overview for more database information, as well as locations to certain information in the database.

Signing into MySQL

Sign into your development environment with SSH.

You can find the log in credentials you need in the $LJHOME/etc/config-private.pl:

'user' => 'dh_foxfirefey',
'pass' => 'XXXXXXXXXXX',    # CHANGETHIS
'dbname' => 'dreamhack_foxfirefey',

Replace the items in brackets with the values assigned above:

mysql -u <user> -p <dbname>

For example:

mysql -u dh_foxfirefey -p dreamhack_foxfirefey

And enter the password when prompted. You will then see information like this before it gives you a prompt:

Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 12284107
<strong>Server version: 5.0.51a-3ubuntu5.4 (Ubuntu)</strong>

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

The emphasized portion lets you know what version of MySQL you are using, in case you have to look things up in the MySQL documentation.

Basic Database Navigation

Show all tables

Data in the database is stored in a collection of tables, each of which is like a spreadsheet with rows containing a certain amount of columns. To present a list of all the tables in the database, use this command:

mysql> SHOW TABLES;

Show all columns in a table

This command will show you a list of all of the columns in a table, which is all of the pieces of data a row has.

mysql> SHOW COLUMNS FROM <tablename>;

For example:

mysql> SHOW COLUMNS FROM user;

The list will have a table of information about each column (or field):

• Field -- the name of the column
• Type -- the type of data the column stores. You can read more about it at MySQL's documentation.
• Null -- whether or not NULL (the absence of a value) is allowed for this column
• Key -- A table's key determines how you can look up data in the database. PRI here means that is the tables primary key. UNI means that bit of data will be unique for that row--that is, if one row has "moo", another row cannot have the value "moo" in that table.
• Default -- the default value for the column, if none is specified
• Extra -- if auto_increment is here, that means that every new row to that table automatically gets a higher value than the last row added.

Viewing data

The most basic way of viewing is this command, but only run it if you have a few users on your system:

mysql> SELECT * FROM user;

You can show only the columns you're interested in like this:

mysql> SELECT userid,user,name FROM user;

And even limit the number of rows you get back:

mysql> SELECT userid,user,name FROM user LIMIT 5;

You can even search for a row matching specific requirements:

mysql> SELECT userid,user,name FROM user WHERE user='foxfirefey';

Changing data

See UPDATE.

mysql> SELECT status FROM user WHERE userid=1;
mysql> UPDATE user SET status='A' WHERE userid=1;
mysql> SELECT status FROM user WHERE userid=1;

mysql> SELECT userid,user,email,status FROM user;
mysql> UPDATE user SET status='A' WHERE status='N';
mysql> SELECT userid,user,email,status FROM user;

Adding data

See INSERT.