Difference between revisions of "MySQL"

Latest revision as of 04:54, 17 November 2012

MySQL Setup

In order to run MySQL you will need a MySQL server to work with - you can establish a server on one of your own computers, or use a webserver with MySQL installed.

Installing MySQL

MySQL is widely supported on Windows, Linux and Mac OSX. MySQL can be downloaded from the official website or (for Linux systems) through a package manager. For Windows installations both a GUI and a command-line utility are available, which you may use if you plan on following the instructions in this guide verbatim.

Setup on a personal computer

Once MySQL is installed on your computer and the MySQL daemon is running (in Arch, /etc/rc.d/mysqld start), the next step is to establish users. If you defined a root MySQL password on setup, you can use this to establish a new user; otherwise, just hit enter at any password prompts you encounter.

In order to set up your MySQL databases, you'll first need to log into MySQL - at this point the only MySQL user will be your root user, so log in with:

<syntaxhighlight lang="bash"> mysql -p -u root </syntaxhighlight>

This will log you into MySQL as root after a password prompt. At this point, you can establish your other users with the SQL CREATE USER query. For example, if you wanted to create a user, "K_Mitnick":

<syntaxhighlight lang="SQL"> CREATE USER K_Mitnick; </syntaxhighlight>

Note the terminating semicolon - this indicates to MySQl that you wish to send your input as a query. Another method of doing this is by terminating your queries with '\g' - there is no difference between the two, it is simply a matter of personal preference.

This user will be created with absolutely no privileges: they can log into your server but do little else.

Setting Permissions

In order to allow your users to execute queries and interact with your databases, you must indicate to the server just what they are allowed to do. The most simple form of this is

<syntaxhighlight lang="SQL"> GRANT ALL ON <database name> TO <username> IDENTIFIED BY '<password>'; </syntaxhighlight>

This kind of heavy handed allowance gives the user total freedom to execute any SQL query that they wish. IT SHOULD NEVER be given to the normal user, as this will create a serious vulnerability in your database.

A more reasonable form of this would be

<syntaxhighlight lang="SQL"> GRANT SELECT ON <database name> TO <username> IDENTIFIED BY '<password>'; </syntaxhighlight>

This only gives access to the SELECT query for the user, which essentially makes their access read-only. The GRANT query can be used with any SQL query as a parameter in order to grant a user the ability to use that query.

After you have changed permissions, it is a good idea to ensure that MySQL is up-to-date with user permissions with

<syntaxhighlight lang="SQL"> FLUSH PRIVILEGES; </syntaxhighlight>

You can now log on as a user other than root.

Basic Database Operation

Display

From the main MySQL prompt you see when you first log in, you usually are not logged into a particular database. In order to see all of the databases in your server, type:

<syntaxhighlight lang="SQL"> SHOW DATABASES; </syntaxhighlight>

This will display all of the databases on a server.

There are two ways to reference a table. One is by using the format (database name).(table name) to refer to its full path. The other is to set the database you're working in as your currently active database with the USE command:

<syntaxhighlight lang="SQL"> USE <database>; </syntaxhighlight>

From this point onwards, you can simply refer to a table by name. Furthermore, you can see a list of all tables in the selected database with

<syntaxhighlight lang="SQL"> SHOW TABLES; </syntaxhighlight>

Creating and Deleting Databases

The procedure for the creation and deletion of entire databases is relatively simple.

To create:

<syntaxhighlight lang="SQL"> CREATE DATABASE <name>; </syntaxhighlight>

To delete:

<syntaxhighlight lang="SQL"> DELETE DATABASE <name>; </syntaxhighlight>

Creating and Deleting Tables

In order to create a new table, we use the CREATE query. The syntax for this query is

CREATE TABLE (<column1> <datatype>, <column2> <datatype>, etc...); </syntaxhighlight>

For example, if we were to create a table called 'user' containing usernames and hashed passwords, we might want it to have 3 sections - first of all, a number to reference the rows by, secondly a plaintext username, and finally, a hashed password. In order to generate the ID, we would use the special PRIMARY KEY feature of SQL - each table should have a primary key, which automatically updates itself for each entry and is used to refer to elements in a table. The username and password hash would be VARCHARs, which is an SQL datatype that can hold up to 65,535 characters per row. So for this table, our declaration would be as follows:

<syntaxhighlight lang="SQL"> CREATE TABLE user ( ID INT AUTO_INCREMENT PRIMARY_KEY, username VARCHAR(64), hash VARCHAR(512) ); </syntaxhighlight>

There are a great many SQL datatypes to be used to format the contents of a column. For a full list of datatypes, check The MySQL Website.

To delete a table, simply use the DROP TABLE query.

Editing Tables

Now that you have a table, you can begin to put values into it. There are three methods by which you can manipulate the data in a table: one is the INSERT query, another is the UPDATE query, and the last in the DELETE query.

In order to add a new value into a table, you use the INSERT query, the syntax for which is:

INSERT INTO [(<column name>, <column name>, etc...)] VALUES (<value 1>, <value 2>, etc...); </syntaxhighlight>

The column references are optional - if included, the VALUES will be inserted into the specified columns in order. If no column references are provided, the VALUES will simply be inserted from the first column onwards. Relating to our last example, the query we would use to add a new entry to our table would be something like:

<syntaxhighlight lang="SQL"> INSERT INTO user VALUES (null, "Selketraz", md5("lolwut")); </syntaxhighlight>

In this case, we do not insert anything into the first value - ID - as PRIMARY KEY will automatically generate its value. The next value, username, we fill with a value, and for the final value we use MySQL's native md5 function to create a hashed password.

Once we've done this, our table will look a little something like this:

ID	username	hash
1	Selketraz	05a208028929fd77cfb5b08096a837df

The output from MySQL would be like this:

  mysql> SELECT * FROM user;
  +----+-----------+----------------------------------+
  | ID | username  | hash                             |
  +----+-----------+----------------------------------+
  |  1 | Selketraz | 05a208028929fd77cfb5b08096a837df |
  +----+-----------+----------------------------------+
  1 row in set (0.00 sec)

If we wanted to change one of these values, we would use the UPDATE query instead. For example, say Selketraz forgets her password and needs to have it reset. We would simply alter her entry in the database with UPDATE to set her password to a default one.

<syntaxhighlight lang="SQL"> UPDATE user SET hash=md5("default1%") WHERE username="Selketraz"; </syntaxhighlight>

This employs the WHERE statement to select only certain rows - in effect, it says FOR every row in the entire table: IF username="Selketraz", THEN change the password hash to 'default1%'.

Finally, entry deletion. In order to delete an entry from a table, simply use the DELETE query, which is structured similarly to UPDATE:

<syntaxhighlight lang="SQL"> DELETE FROM user WHERE username="Selketraz"; </syntaxhighlight>

MySQL Commands

Full list here: http://www.pantz.org/software/mysql/mysqlcommands.html

Create a backup of a database

 <syntaxhighlight lang="bash">mysqldump <database> > <database>.sql</syntaxhighlight>

Restore an entire database

 <syntaxhighlight lang="bash">mysqldump <database> > <database>.backup.sql # Always dump the old databse if it is still there, in case we need to bring it back.
 mysql <database> < <sql-file>.sql</syntaxhighlight>

Restore a single table

 <syntaxhighlight lang="bash">mysqldump <database> > <database>.backup.sql # Backup database, just in case.
 cat <database-backup>.sql | sed -n '/-- Table structure for table `<table_name>`/,/-- Table/{ /^--.*$/d;p }' > <table_name>_table.sql
 mysql <database> < <table_name>_table.sql</syntaxhighlight>

Dump mysql user privileges

 <syntaxhighlight lang="bash">mysql -B -N -e "SELECT DISTINCT CONCAT('SHOW GRANTS FOR , user, @, host, ;') AS query FROM mysql.user" | mysql $@ |   sed 's/\(GRANT .*\)/\1;/;s/^\(Grants for .*\)/## \1 ##/;/##/{x;p;x;}'</syntaxhighlight>

Restore a single database from a full dump

 <syntaxhighlight lang="bash">mysql --one-database database_name < fulldump.sql</syntaxhighlight>

Extract sql for a single database from a full dump

<syntaxhighlight lang="bash">sed -n '/^-- Current Database: `singledb`/,/^-- Current Database: `/p' fulldump.sql > singledb.sql</syntaxhighlight>

Dumping a database in Plesk

 <syntaxhighlight lang="bash">mysqldump -u admin -p database > .sql</syntaxhighlight>

For information on troubleshooting MySQL issues, check out the MySQL Troubleshooting section.

MySQL is part of a series on administration.

syntaxhighlight lang="SQL">

DELETE FROM user WHERE username="Selketraz";

@@ Line 1: / Line 1: @@
-= MySQL Setup =
+== MySQL Setup ==
 In order to run MySQL you will need a MySQL server to work with - you can establish a server on one of your own computers, or use a webserver with MySQL installed.
-== Setup on a personal computer ==
+=== Installing MySQL ===
+MySQL is widely supported on Windows, Linux and Mac OSX. MySQL can be downloaded from [http://www.mysql.com the official website] or (for Linux systems) through a package manager. For Windows installations both a GUI and a command-line utility are available, which you may use if you plan on following the instructions in this guide verbatim.
+=== Setup on a personal computer ===
 Once MySQL is installed on your computer and the MySQL daemon is running (in Arch, /etc/rc.d/mysqld start), the next step is to establish users. If you defined a root MySQL password on setup, you can use this to establish a new user; otherwise, just hit enter at any [[password]] prompts you encounter.
-In order to set up your MySQL databases, you'll first need to log into MySQL - at this point the only MySQl user will be your root user, so log in with:
+In order to set up your MySQL databases, you'll first need to log into MySQL - at this point the only MySQL user will be your root user, so log in with:
 {| class="wikitable"
@@ Line 16: / Line 20: @@
 |}
-This will log you int MySQl as root after a password prompt. At this point, you can establish your other users with the SQL CREATE USER
+This will log you into MySQL as root after a password prompt. At this point, you can establish your other users with the SQL CREATE USER
 query. For example, if you wanted to create a user, "K_Mitnick":
@@ Line 30: / Line 34: @@
 This user will be created with absolutely no privileges: they can log into your server but do little else.
-=== Setting Permissions ===
+==== Setting Permissions ====
 In order to allow your users to execute queries and interact with your databases, you must indicate to the server just what they are allowed to do. The most simple form of this is
@@ Line 65: / Line 69: @@
 You can now log on as a user other than root.
-== Basic Database Operation ==
+=== Basic Database Operation ===
-=== Display ===
+==== Display ====
 From the main MySQL prompt you see when you first log in, you usually are not logged into a particular database. In order to see all of the databases in your server, type:
@@ Line 80: / Line 84: @@
 This will display all of the databases on a server.
-There are two ways to reference a table. One is by using the format <database>.<table> to refer to its full path. The other is to set the database you're working in as your currently active database with the USE command:
+There are two ways to reference a table. One is by using the format (database name).(table name) to refer to its full path. The other is to set the database you're working in as your currently active database with the USE command:
 {| class="wikitable"
@@ Line 89: / Line 93: @@
 |}
-From this point onwards, you can simply refer to a table by name. Whichever method of reference you choose, the syntax to display the tables in a database is simple:
+From this point onwards, you can simply refer to a table by name. Furthermore, you can see a list of all tables in the selected database with
 {| class="wikitable"
@@ Line 98: / Line 102: @@
 |}
-=== Creating and Deleting Databases and Tables ===
+==== Creating and Deleting Databases ====
+The procedure for the creation and deletion of entire databases is relatively simple.
+To create:
+{| class="wikitable"
+|
+<syntaxhighlight lang="SQL">
+CREATE DATABASE <name>;
+</syntaxhighlight>
+|}
+To delete:
+{| class="wikitable"
+|
+<syntaxhighlight lang="SQL">
+DELETE DATABASE <name>;
+</syntaxhighlight>
+|}
+==== Creating and Deleting Tables ====
 In order to create a new table, we use the CREATE query. The syntax for this query is
@@ Line 125: / Line 151: @@
 There are a great many SQL datatypes to be used to format the contents of a column. For a full list of datatypes, check [http://dev.mysql.com/doc/refman/5.0/en/data-types.html The MySQL Website].
-To delete a table, simply use the <syntaxhighlight lang="sql">DROP TABLE <table>;</syntaxhighlight> query.
+To delete a table, simply use the DROP TABLE <table> query.
+==== Editing Tables ====
+Now that you have a table, you can begin to put values into it. There are three methods by which you can manipulate the data in a table: one is the INSERT query, another is the UPDATE query, and the last in the DELETE query.
+In order to add a new value into a table, you use the INSERT query, the syntax for which is:
+{| class="wikitable"
+|
+<syntaxhighlight lang="SQL">
+INSERT INTO <table> [(<column name>, <column name>, etc...)] VALUES (<value 1>, <value 2>, etc...);
+</syntaxhighlight>
+|}
+The column references are optional - if included, the VALUES will be inserted into the specified columns in order. If no column references are provided, the VALUES will simply be inserted from the first column onwards. Relating to our last example, the query we would use to add a new entry to our table would be something like:
+{| class="wikitable"
+|
+<syntaxhighlight lang="SQL">
+INSERT INTO user VALUES (null, "Selketraz", md5("lolwut"));
+</syntaxhighlight>
+|}
+In this case, we do not insert anything into the first value - ID - as PRIMARY KEY will automatically generate its value. The next value, username, we fill with a value, and for the final value we use MySQL's native md5 function to create a hashed password.
+Once we've done this, our table will look a little something like this:
+{| class="wikitable"
+|-
+! ID
+! username
+! hash
+|-
+| 1
+| Selketraz
+| 05a208028929fd77cfb5b08096a837df
+|}
+The output from MySQL would be like this:
+<pre>
+  mysql> SELECT * FROM user;
+  +----+-----------+----------------------------------+
+  | ID | username  | hash                             |
+  +----+-----------+----------------------------------+
+  |  1 | Selketraz | 05a208028929fd77cfb5b08096a837df |
+  +----+-----------+----------------------------------+
+row in set (0.00 sec)
+</pre>
+If we wanted to change one of these values, we would use the UPDATE query instead. For example, say Selketraz forgets her password and needs to have it reset. We would simply alter her entry in the database with UPDATE to set her password to a default one.
+{| class="wikitable"
+|
+<syntaxhighlight lang="SQL">
+UPDATE user SET hash=md5("default1%") WHERE username="Selketraz";
+</syntaxhighlight>
+|}
+This employs the WHERE statement to select only certain rows - in effect, it says FOR every row in the entire table: IF username="Selketraz", THEN change the password hash to 'default1%'.
+Finally, entry deletion. In order to delete an entry from a table, simply use the DELETE query, which is structured similarly to UPDATE:
+{| class="wikitable"
+|
+<syntaxhighlight lang="SQL">
+DELETE FROM user WHERE username="Selketraz";
+</syntaxhighlight>
+|}
+== MySQL Commands ==
+*Full list here: http://www.pantz.org/software/mysql/mysqlcommands.html
+=== Create a backup of a database ===
+  <syntaxhighlight lang="bash">mysqldump '''<database>''' > '''<database>'''.sql</syntaxhighlight>
+=== Restore an entire database ===
+  <syntaxhighlight lang="bash">mysqldump '''<database>''' > '''<database>'''.backup.sql # Always dump the old databse if it is still there, in case we need to bring it back.
+  mysql '''<database>''' < '''<sql-file>'''.sql</syntaxhighlight>
+=== Restore a single table ===
+  <syntaxhighlight lang="bash">mysqldump '''<database>''' > '''<database>'''.backup.sql # Backup database, just in case.
+  cat '''<database-backup>'''.sql | sed -n '/-- Table structure for table `'''<table_name>'''`/,/-- Table/{ /^--.*$/d;p }' > '''<table_name>'''_table.sql
+  mysql '''<database>''' < '''<table_name>'''_table.sql</syntaxhighlight>
+=== Dump mysql user privileges ===
+  <syntaxhighlight lang="bash">mysql -B -N -e "SELECT DISTINCT CONCAT('SHOW GRANTS FOR ''', user, '''@''', host, ''';') AS query FROM mysql.user" | mysql $@ |   sed 's/\(GRANT .*\)/\1;/;s/^\(Grants for .*\)/## \1 ##/;/##/{x;p;x;}'</syntaxhighlight>
+=== Restore a single database from a full dump ===
+  <syntaxhighlight lang="bash">mysql --one-database database_name < fulldump.sql</syntaxhighlight>
+=== Extract sql for a single database from a full dump ===
+ <syntaxhighlight lang="bash">sed -n '/^-- Current Database: `singledb`/,/^-- Current Database: `/p' fulldump.sql > singledb.sql</syntaxhighlight>
+=== Dumping a database in Plesk ===
+  <syntaxhighlight lang="bash">mysqldump -u admin -p database > .sql</syntaxhighlight>
+For information on troubleshooting MySQL issues, check out the [[MySQL Troubleshooting]] section.
-=== Editing Databases and Tables ==-
+{{Administration}}
+syntaxhighlight lang="SQL">
+DELETE FROM user WHERE username="Selketraz";