Amazon Relational Database Service
User Guide (API Version 2013-09-09)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

Creating a MySQL DB Instance and Connecting to a Database on a MySQL DB Instance

The easiest way to create a DB instance is to use the Amazon RDS console. Once you have created the DB instance, you can use standard MySQL utilities such as MySQL Workbench to connect to a database on the DB instance.

Important

You must complete the tasks in the Setting Up section before you can create or connect to a DB instance.

Creating a MySQL DB Instance

The basic building block of Amazon RDS is the DB instance. This is the environment in which you will run your MySQL databases.

In this example, you create a DB instance running the MySQL database engine called west2-mysql-instance1, with a db.m1.small DB instance class, 5 GB of storage, and automated backups enabled with a retention period of one day.

To create a MySQL DB instance

  1. Sign in to the AWS Management Console and open the Amazon RDS console at https://console.aws.amazon.com/rds/.

  2. In the top right corner of the Amazon RDS console, select the region in which you want to create the DB instance.

  3. In the navigation pane, click Instances.

  4. Click Launch DB Instance. The Launch DB Instance Wizard opens on the Engine Selection page.

    Engine selection

  5. On the Engine Selection page, click Select for the MySQL DB engine.

  6. On the DB Instance Details page, specify your DB instance information. The following table shows settings for an example DB instance. When the settings are as you want them, click Continue.

    For this parameter... ...Do this:

    License Model

    Select the default, General-Public-License, to use the general license agreement for MySQL. MySQL has only one license model.

    DB Engine Version

    Select the default version of MySQL. Note that Amazon RDS supports multiple versions of MySQL in some regions.

    DB Instance Class

    Select db.m1.small to select a configuration that equates to 1.7 GB memory, 1 ECU (1 virtual core with 1 ECU), 64-bit platform, and moderate I/O capacity.

    Multi-AZ Deployment

    Select No to create your DB instance in a single availability zone.

    Auto Minor Version Upgrade

    Select Yes to enable your DB instance to receive minor DB engine version upgrades automatically when they become available.

    Allocated Storage

    Type 5 to allocate 5 GB of storage for your database.

    Use Provisioned IOPS

    Leave the check box unselected. This option turns on Provisioned IOPS (I/O operations per second), a high-performance storage option in Amazon RDS that is optimized for I/O-intensive, transactional (OLTP) database workloads.

    DB Instance Identifier

    Type a name for the DB instance that is unique for your account in the region you selected. You may chose to add some intelligence to the name such as including the region and DB engine you selected, for example west2-mysql-instance1.

    Master User Name

    Type a name using alphanumeric characters that you will use as the master user name to log on to your DB instance. This will be the user name you use to logon to your database on the DB instance for the first time.

    Master User Password

    Type a password that contains from 8 to 16 printable ASCII characters (excluding /,", and @) for your master user password. This will be the password you will use when you use the user name to logon to your database.

    DB instance details

  7. On the Additional Configuration page, provide additional information that RDS needs to launch the MySQL DB instance. The table shows settings for an example DB instance. Specify your DB instance information, then click Continue.

    For this parameter... ...Do this:

    Database Name

    Type a name for your database of up to 8 alpha-numeric characters. If you do not provide a name, Amazon RDS will not automatically create a database on the DB instance you are creating.

    Database Port

    Leave the default value of 3306 unless you have a specific port you want to access the database through. MySQL installations default to port 3306.

    Important

    You cannot change the port once you create the DB instance, so it is very important that you determine the correct port to use to access the DB instance.

    Choose a VPC

    This setting depends on the platform you are on. If you are creating a DB instance on the EC2-VPC platform, select the default VPC. If you are creating a DB instance on the E2-Classic platform, select Not in VPC. For more information about VPC, see Amazon RDS and the Amazon Virtual Private Cloud Service.

    Publicly Accessible

    (Only applies if you choose a VPC) Select Yes to give the DB instance a public IP address; otherwise, select No. For more information about hiding DB instances from public access, see Hiding a DB instance in a VPC from the Internet.

    Availability Zone

    Leave the default of No Preference unless you want to specify a particular Availability Zone.

    Option Group

    Select the default value of default:mysql-5-5 since this option group is used with the MySQL version you selected on the previous page.

    Parameter Group

    Leave the default value of default.mysql5.5 unless you created your own DB parameter group. For more information about parameter groups, see Working with DB Parameter Groups.

    DB Security Groups

    Select the DB security group that you created in a previous step in the Getting Started section.

    Additional Configuration panel

  8. On the Management Options page, you can specify backup and maintenance options for your DB instance. Accept the default values, and then click Continue.

    Management Options panel
  9. On the Review page, review the options for your DB instance. If you need to make any changes, click Back to return to the appropriate page, and then make the necessary corrections. When all the settings are as you want them, click Launch DB Instance.

  10. On the final page of the wizard, click Close.

  11. On the RDS console, the new DB instance appears in the list of DB instances. The DB instance will have a status of creating until the DB instance is created and ready for use. When the state changes to available, you can connect to a database on the DB instance. Depending on the DB instance class and store allocated, it could take several minutes for the new DB instance to become available.

    My DB instances list

Connecting to a Database on a DB Instance Running the MySQL Database Engine

Once Amazon RDS provisions your DB instance, you can use any standard SQL client application to connect to a database on the DB instance. In this example, you connect to a database on a MySQL DB instance using MySQL monitor commands. One GUI-based application you can use to connect is MySQL Workbench; for more information, go to the Download MySQL Workbench page. For more information on using MySQL, go to the MySQL documentation.

To connect to a database on a DB instance using MySQL monitor

  • Type the following command at a command prompt on a client computer to connect to a database on a MySQL DB instance using the MySQL monitor. Substitute the DNS name for your DB instance for <endpoint>, the master user name you used for <mymasteruser>, and the master password you used for <password>.

    PROMPT> mysql -h <endpoint> -P 3306 -u <mymasteruser> -p <password>

    You will see output similar to the following.

    Welcome to the MySQL monitor.  Commands end with ; or \g.
    Your MySQL connection id is 350
    Server version: 5.1.32-log MySQL Community Server (GPL)
    
    Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
    
    mysql>

Deleting a DB Instance

Once you have connected to the sample DB instance that you created, you should delete the DB instance so you are no longer charged for it.

To delete a DB instance with no final DB snapshot

  1. Sign in to the AWS Management Console and open the Amazon RDS console at https://console.aws.amazon.com/rds/.

  2. In the DB Instances list, select the check box next to the DB instance you wish to delete.

  3. Click Instance Actions, and then select Delete from the dropdown menu.

  4. Select No in the Create final Snapshot? drop-down list box.

  5. Click Yes, Delete.