Creating a MariaDB DB instance and connecting to a database on a MariaDB DB instance - Amazon Relational Database Service

Creating a MariaDB DB instance and connecting to a database on a MariaDB DB instance

The easiest way to create a MariaDB DB instance is to use the AWS Management Console. After you create the DB instance, you can use command line tools such as mysql or graphical tools such as HeidiSQL to connect to a database on the DB instance.

Important

Before you can create or connect to a DB instance, make sure to complete the tasks in Setting up for Amazon RDS.

Creating a MariaDB DB instance

The basic building block of Amazon RDS is the DB instance. This environment is where you run your MariaDB databases.

You can use Easy create to create a DB instance running MariaDB with the AWS Management Console. With Easy create, you specify only the DB engine type, DB instance size, and DB instance identifier. Easy create uses the default settings for the other configuration options. When you use Standard create instead of Easy create, you specify more configuration options when you create a database, including ones for availability, security, backups, and maintenance.

In this example, you use Easy create to create a DB instance running the MariaDB database engine with a db.t2.micro DB instance class.

Note

For information about creating DB instances with Standard create, see Creating an Amazon RDS DB instance.

To create a MariaDB DB instance with Easy create

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

  2. In the upper-right corner of the Amazon RDS console, choose the AWS Region in which you want to create the DB instance.

  3. In the navigation pane, choose Databases.

  4. Choose Create database and make sure that Easy create is chosen.

    
            						Easy create option
  5. In Configuration, choose MariaDB.

  6. For DB instance size, choose Free tier.

  7. For DB instance identifier, enter a name for the DB instance, or leave the default name.

  8. For Master username, enter a name for the master user, or leave the default name.

    The Create database page should look similar to the following image.

    
            						Create database page
  9. To use an automatically generated master password for the DB instance, make sure that the Auto generate a password box is selected.

    To enter your master password, clear the Auto generate a password box, and then enter the same password in Master password and Confirm password.

  10. (Optional) Open View default settings for Easy create.

    
            						Easy create default settings.

    You can examine the default settings used with Easy create. The Editable after database is created column shows which options you can change after database creation.

    • To change settings with No in that column, use Standard create.

    • To change settings with Yes in that column, either use Standard create, or modify the DB instance after it is created to change the settings.

    The following are important considerations for changing the default settings:

    • In some cases, you might want your DB instance to use a specific virtual private cloud (VPC) based on the Amazon VPC service. Or you might require a specific subnet group or security group. If so, use Standard create to specify these resources. You might have created these resources when you set up for Amazon RDS. For more information, see Provide access to your DB instance in your VPC by creating a security group.

    • If you want to be able to access the DB instance from a client outside of its VPC, use Standard create to set Public access to Yes.

      If the DB instance should be private, leave Public access set to No.

  11. Choose Create database.

    If you chose to use an automatically generated password, the View credential details button appears on the Databases page.

    To view the master user name and password for the DB instance, choose View credential details.

    
            						Master user credentials after automatic password generation.

    To connect to the DB instance as the master user, use the user name and password that appear.

    Important

    You can't view the master user password again. If you don't record it, you might have to change it.

    If you need to change the master user password after the DB instance is available, you can modify the DB instance to do so. For more information about modifying a DB instance, see Modifying an Amazon RDS DB instance.

  12. For Databases, choose the name of the new Maria DB instance.

    On the RDS console, the details for new DB instance appear. The DB instance has a status of Creating until the DB instance is ready to use. When the state changes to Available, you can connect to the DB instance. Depending on the DB instance class and the amount of storage, it can take up to 20 minutes before the new instance is available.

    
            						Summary during DB instance creation

Connecting to a database on a DB instance running the MariaDB database engine

After 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 Maria DB instance using the mysql command-line tool. For more information on using MariaDB, see the MariaDB documentation.

To connect to a database on a DB instance using the mysql command-line tool

  1. Install a SQL client that you can use to connect to the DB instance.

    You can connect to an Amazon RDS for MariaDB DB instance by using tools like the mysql command-line client. For more information on using the mysql command-line client, see mysql command-line client in the MariaDB documentation. One GUI-based application that you can use to connect is Heidi. For more information, see the Download HeidiSQL page. For information about installing MySQL (including the mysql command-line client), see Installing and upgrading MySQL.

  2. Make sure that your DB instance is associated with a security group that provides access to it. For more information, see Provide access to your DB instance in your VPC by creating a security group.

    If you didn't specify the appropriate security group when you created the DB instance, you can modify the DB instance to change its security group. For more information, see Modifying an Amazon RDS DB instance.

  3. Find the endpoint (DNS name) and port number for your DB instance.

    1. Open the RDS console and then choose Databases to display a list of your DB instances.

    2. Choose the Maria DB instance name to display its details.

    3. On the Connectivity & security tab, copy the endpoint. Also note the port number. You need both the endpoint and the port number to connect to the DB instance.

      
        								Connect to a Maria DB instance
  4. Enter the following command at a command prompt on a client computer to connect to a database on a Maria DB instance. Substitute the DNS name (endpoint) for your DB instance for <endpoint>. In addition, substitute the master user name that you used for <mymasteruser> and provide the master password that you used when prompted for a password.

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

    After you enter the password for the user, you should see output similar to the following.

    Welcome to the MariaDB monitor. Commands end with ; or \g. Your MariaDB connection id is 31 Server version: 10.5.8-MariaDB-log Source distribution Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. MariaDB [(none)]>

For more information about connecting to a MariaDB DB instance, see Connecting to a DB instance running the MariaDB database engine. If you can't connect to your DB instance, see Can't connect to Amazon RDS DB instance.

Deleting a DB instance

After 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 navigation pane, choose Databases.

  3. Choose the DB instance you want to delete.

  4. For Actions, choose Delete.

  5. For Create final snapshot?, choose No, and select the acknowledgment.

  6. Choose Delete.