实践教程之快速使用PolarDB-X

简介: PolarDB-X 为了方便用户体验,提供了免费的实验环境,您可以在实验环境里体验 PolarDB-X 的安装部署和各种内核特性。除了免费的实验,PolarDB-X 也提供免费的视频课程,手把手教你玩转 PolarDB-X 分布式数据库。


本期实验可以让您快速体验PolarDB-X,让你像使用单机MySQL一样使用分布式数据库,直观感受PolarDB-X的MySQL兼容性。

本期免费实验地址:

如何使用 PolarDB-X - 云起实验室-在线实验-上云实践-阿里云开发者社区-阿里云官方实验平台-阿里云

本期教学视频地址:

链接

1.前置准备

假设已经根据前一讲内容完成了PolarDB-X的搭建部署,可以成功链接上PolarDB-X数据库。

PolarDB-X:实践教程之如何快速安装部署PolarDB-X2 赞同 · 0 评论文章

2. 安装JDK

执行如下命令,使用yum安装JDK 1.8。

yum -y install java-1.8.0-openjdk*

执行如下命令,查看是否安装成功

java -version

返回结果如下,表示您已成功安装JDK 1.8。

3.体验Spring Boot+PolarDB-X应用开发

执行如下命令,安装Git。

yum -y install git

执行如下命令,下载Spring Boot样例工程。

git clone https://github.com/spring-guides/gs-accessing-data-mysql.git

执行如下命令,进入initial目录。

cd gs-accessing-data-mysql/initial git checkout b8408e3a1e05008811d542b706107d45160556ac

执行如下命令,查看样例工程代码。

ls

3.1 创建数据库

1 执行如下命令,登录PolarDB-X数据库。
mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456

2 执行如下SQL语句,创建数据库db_example。
create database db_example;

3 执行如下SQL语句,创建用户springuser。
create user 'springuser'@'%' identified by 'ThePassword';

4 执行如下SQL语句,给用户springuser授权。
grant all on db_example.* to 'springuser'@'%';

5 输入exit退出数据库。

3.2 配置application.properties文件,将数据库连接到Spring Boot样例工程。

1 执行如下命令,打开application.properties配置文件。
vim src/main/resources/application.properties

2 按i键进入编辑模式,找到参数spring.datasource.url,并将参数值中的端口号修改为8527。
spring.datasource.url=jdbc:mysql://${MYSQL_HOST:localhost}:8527/db_example

3 修改完成后的文件内容如下所示。按下Esc键后,输入:wq后按下Enter键保存并退出。

3.3 创建Entity Model

1 执行如下命令,创建一个User类。

vim src/main/java/com/example/accessingdatamysql/User.java

2 将如下代码复制粘贴到User类中。

package com.example.accessingdatamysql;  
import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id;  
@Entity // This tells Hibernate to make a table out of this class 
public class User {
   @Id
   @GeneratedValue(strategy=GenerationType.AUTO)
   private Integer id;
   private String name;
   private String email;
   public Integer getId() {
     return id;
   }
   public void setId(Integer id) {
     this.id = id;
   }
   public String getName() {
     return name;
   }
   public void setName(String name) {
     this.name = name;
   }
   public String getEmail() {
     return email;   }
   public void setEmail(String email) {
     this.email = email;
   }
 }

3 修改完成后的文件内容如下所示。按下Esc键后,输入:wq后按下Enter键保存并退出。

3.4 创建Repository,保存用户记录

1 执行如下命令,创建一个UserRepository类。
vim src/main/java/com/example/accessingdatamysql/UserRepository.java

2 将如下代码复制粘贴到UserRepository类中。
package com.example.accessingdatamysql;  import org.springframework.data.repository.CrudRepository;  import com.example.accessingdatamysql.User;  // This will be AUTO IMPLEMENTED by Spring into a Bean called userRepository // CRUD refers Create, Read, Update, Delete  public interface UserRepository extends CrudRepository {  }

3 修改完成后的文件内容如下所示。按下Esc键后,输入:wq后按下Enter键保存并退出。

3.5 创建一个Controller类,处理对应用程序的HTTP请求

1 执行如下命令,创建一个MainController类。

vim src/main/java/com/example/accessingdatamysql/MainController.java

2 将如下代码复制粘贴到MainController类中。

package com.example.accessingdatamysql;
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.GetMapping; 
import org.springframework.web.bind.annotation.PostMapping; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestParam; 
import org.springframework.web.bind.annotation.ResponseBody;  
@Controller // This means that this class is a Controller 
@RequestMapping(path="/demo") // This means URL's start with /demo (after Application path) 
public class MainController {
   @Autowired 
   // This means to get the bean called userRepository
   // Which is auto-generated by Spring, we will use it to handle the data
   private UserRepository userRepository;
   @PostMapping(path="/add")
   // Map ONLY POST Requests
   public @ResponseBody String addNewUser (@RequestParam String name
       , @RequestParam String email) {
   // @ResponseBody means the returned String is the response, not a view name     
   // @RequestParam means it is a parameter from the GET or POST request      
     User n = new User();
     n.setName(name);
     n.setEmail(email);
     userRepository.save(n);
     return "Saved";
   }

   @GetMapping(path="/all")
   public @ResponseBody Iterable getAllUsers() {
     // This returns a JSON or XML with the users
     return userRepository.findAll();
   }
 }

3 修改完成后的文件内容如下所示。按下Esc键后,输入:wq后按下Enter键保存并退出。

3.6 创建一个Application

说明 :Spring Boot样例工程中已为您创建好AccessingDataMysqlApplication类,您可跳过此步骤。 1 执行如下命令,创建一个AccessingDataMysqlApplication类。

vim src/main/java/com/example/accessingdatamysql/AccessingDataMysqlApplication.java

2 按i键进入编辑模式,将如下代码复制粘贴到User类中。

package com.example.accessingdatamysql;  
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication;  
@SpringBootApplication
 public class AccessingDataMysqlApplication {
    public static void main(String[] args) {
     SpringApplication.run(AccessingDataMysqlApplication.class, args);
   }
  }

3 修改完成后的文件内容如下所示。按下Esc键后,输入:wq后按下Enter键保存并退出。

3.7 运行Spring Boot样例工程

执行如下命令,运行Spring Boot样例工程。

./gradlew bootRun

请您耐心等待大约两分钟,返回结果如下,表示您成功运行。

3.8 测试

在实验页面,单击右上角的

图标,创建新的终端窗口。

在新的终端窗口中,执行如下命令,增加一条记录。

curl localhost:8080/demo/add -d name=First -d email=username@example.com

返回结果如下,表示您成功增加一条记录。

执行如下命令,查询记录。

curl 'localhost:8080/demo/all' 

返回结果如下,您可以查询到刚刚增加的记录信息。

执行如下命令,登录PolarDB-X数据库。

mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456

执行如下SQL语句,使用数据库。

use db_example;

执行如下SQL语句,查询user表。

select * from user;

返回如下结果,您可以在user表查询到刚刚增加的记录。

输入exit退出数据库。

4.体验WordPress+PolarDB-X部署博客站点

本步骤将指导您如何使用Wordpress的Docker镜像和PolarDB-X搭建一个博客站点。Wordpress提供了Docker镜像,方便其快速安装,详情请参见WordPress的Docker Hub主页

4.1 安装WordPress

执行如下命令,安装WordPress。

docker run --name some-wordpress -p 9090:80 -d wordpress

创建WordPress的数据库。

1 执行如下命令,登录PolarDB-X数据库。
mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456

2 执行如下SQL语句,创建数据库wordpress。
create database wordpress MODE='AUTO';

3 输入exit退出数据库。

4.2 配置WordPress

在您的本机浏览器中,打开新页签,访问http://:9090。

在初始化页面,选择简体中文,单击继续

在准备页面,单击现在就开始

在数据库配置页面,参考说明配置数据库信息,单击提交

参数说明:

  • 数据库名:默认为wordpress。

  • 用户名:输入polardbx_root。

  • 密码:输入123456。

  • 数据库主机:输入:8527。您需要将替换为云产品资源列表中的ECS的弹性IP。

  • 表前缀:默认为wp_。

在数据库配置完成页面,单击运行安装程序

在信息配置页面,参考说明配置相关信息,单击安装WordPress

参数说明:

  • 站点标题:输入站点标题,例如myblog。

  • 用户名:输入用户名,例如admin。

  • 密码:输入密码。

  • 您的电子邮箱地址:输入邮箱地址。建议使用真实有效的邮箱地址,若没有,可以填写虚拟邮箱地址,但将无法接收信息,例如username@example.com。

在成功页面,单击登录

在登录页面,依次输入您的用户名密码,单击登录

作者介绍
目录