阿里云有奖体验：如何使用 PolarDB-X

### **体验简介** 场景将提供一台配置了CentOS 8.5操作系统的ECS实例（云服务器）。通过本教程的操作，以Spring和WordPress官方教程为例，带你体验Spring Boot+PolarDB-X和WordPress+PolarDB-X的应用开发之旅。[点击前往](https://developer.aliyun.com/adc/scenario/6e7827274b004c7b9fad58ecf5404c6c) ### 实验准备 1\. 创建实验资源 开始实验之前，您需要先创建ECS实例资源。 1.  在实验室页面，单击 **创建资源** 。      2.  （可选）在实验室页面左侧导航栏中，单击 **云产品资源** 列表，可查看本次实验资源相关信息（例如IP地址、用户信息等）。      **说明**：资源创建过程需要1~3分钟。 2\. 安装PolarDB-X 本步骤将指导您如何安装PolarDB-X。 1.  安装并启动Docekr。      1) 执行如下命令，安装Docker。 ``` curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun ``` 2) 执行如下命令，启动Docker。 ``` systemctl start docker ``` 1.  执行如下命令，安装PolarDB-X。      ``` docker run -d --name some-polardb-x -p 8527:8527 polardbx/polardb-x:2.1.0 ``` 3\. 登录PolarDB-X数据库 本步骤将指导您如何登录PolarDB-X数据库。 PolarDB-X支持通过MySQL Client命令行、第三方客户端以及符合MySQL交互协议的第三方程序代码进行连接。本实验场景主要介绍如何通过MySQL Client命令行连接到PolarDB-X数据库。 1.  执行如下命令，安装MySQL。      ``` yum install mysql -y ``` 1.  执行如下命令，查看MySQL版本号。      ``` mysql -V ``` 返回结果如下，表示您已成功安装MySQL。  1.  执行如下命令，登录PolarDB-X数据库。      **说明** -   本实验场景中的PolarDB-X数据库用户名和密码已预设，请您使用下方命令登录即可。      -   如遇到 mysql: \[Warning\] Using a password on the command line interface can be insecure. ERROR 2013 (HY000): Lost connection to MySQL server at 'reading initial communication packet', system error: 0 报错，请您稍等一分钟，重新执行登录命令即可。      ``` mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456 ``` 返回结果如下，表示您已成功登录PolarDB-X数据库。  4.输入exit退出数据库。  4\. 安装JDK 本步骤将指导您如何在云服务器ECS上安装JDK。 1.  执行如下命令，使用yum安装JDK 1.8。      ``` yum -y install java-1.8.0-openjdk* ``` 1.  执行如下命令，查看是否安装成功。      ``` java -version ``` 返回结果如下，表示您已成功安装JDK 1.8。  5\. 体验Spring Boot+PolarDB-X应用开发 本步骤将指导您如何下载并编辑Spring Boot样例工程，并连接PolarDB-X数据库。详情请参见[Spring Boot官方教程](https://spring.io/guides/gs/accessing-data-mysql/)。 1.  安装Git。      执行如下命令，安装Git。 ``` yum -y install git ``` 1.  下载Spring Boot样例工程。      2.1 执行如下命令，下载Spring Boot样例工程。 ``` git clone https://github.com/spring-guides/gs-accessing-data-mysql.git ``` 2.2 执行如下命令，进入initial目录。 ``` cd gs-accessing-data-mysql/initial git checkout b8408e3a1e05008811d542b706107d45160556ac ``` 2.3 执行如下命令，查看样例工程代码。 ``` ls ``` 1.  创建数据库。      3.1 执行如下命令，登录PolarDB-X数据库。 ``` mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456 ``` 3.2 执行如下SQL语句，创建数据库db_example。 ``` create database db_example; ``` 3.3 执行如下SQL语句，创建用户springuser。 ``` create user 'springuser'@'%' identified by 'ThePassword'; ``` 3.4 执行如下SQL语句，给用户springuser授权。 ``` grant all on db_example.* to 'springuser'@'%'; ``` 3.5 输入exit退出数据库。  1.  配置application.properties文件，将数据库连接到Spring Boot样例工程。      4.1 执行如下命令，打开application.properties配置文件。 ``` vim src/main/resources/application.properties ``` 4.2 按i键进入编辑模式，找到参数spring.datasource.url，并将参数值中的端口号修改为8527。 ``` spring.datasource.url=jdbc:mysql://${MYSQL_HOST:localhost}:8527/db_example ``` 4.3 修改完成后的文件内容如下所示。按下Esc键后，输入:wq后按下Enter键保存并退出。  1.  创建Entity Model。      5.1 执行如下命令，创建一个User类。 ``` vim src/main/java/com/example/accessingdatamysql/User.java ``` 5.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;   } } ``` 5.3 修改完成后的文件内容如下所示。按下Esc键后，输入:wq后按下Enter键保存并退出。  1.  创建Repository，保存用户记录。      6.1 执行如下命令，创建一个UserRepository类。 ``` vim src/main/java/com/example/accessingdatamysql/UserRepository.java ``` 6.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<User, Integer> { } ``` 6.3 修改完成后的文件内容如下所示。按下Esc键后，输入:wq后按下Enter键保存并退出。  1.  创建一个Controller类，处理对应用程序的HTTP请求。      7.1 执行如下命令，创建一个MainController类。 ``` vim src/main/java/com/example/accessingdatamysql/MainController.java ``` 7.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<User> getAllUsers() {     // This returns a JSON or XML with the users     return userRepository.findAll();   } } ``` 7.3 修改完成后的文件内容如下所示。按下Esc键后，输入:wq后按下Enter键保存并退出。  1.  创建一个Application。      **说明 ：**Spring Boot样例工程中已为您创建好AccessingDataMysqlApplication类，您可跳过此步骤。 8.1 执行如下命令，创建一个AccessingDataMysqlApplication类。 ``` vim src/main/java/com/example/accessingdatamysql/AccessingDataMysqlApplication.java ``` 8.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);   } } ``` 8.3 修改完成后的文件内容如下所示。按下Esc键后，输入:wq后按下Enter键保存并退出。  1.  运行Spring Boot样例工程。      执行如下命令，运行Spring Boot样例工程。 ``` ./gradlew bootRun ``` 请您耐心等待大约两分钟，返回结果如下，表示您成功运行。  1.  测试。      10.1 在实验页面，单击右上角的图标，创建新的终端窗口。  10.2 在新的终端窗口中，执行如下命令，增加一条记录。 ``` curl localhost:8080/demo/add -d name=First -d email=username@example.com ``` 返回结果如下，表示您成功增加一条记录。  10.3 执行如下命令，查询记录。 ``` curl 'localhost:8080/demo/all'  ``` 返回结果如下，您可以查询到刚刚增加的记录信息。  10.4 执行如下命令，登录PolarDB-X数据库。 ``` mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456 ``` 10.5 执行如下SQL语句，使用数据库。 ``` use db_example; ``` 10.6 执行如下SQL语句，查询user表。 ``` select * from user; ``` 返回如下结果，您可以在user表查询到刚刚增加的记录。  10.7 输入exit退出数据库。  6\. （选做）体验WordPress+PolarDB-X部 署博客站点 本步骤将指导您如何使用Wordpress的Docker镜像和PolarDB-X搭建一个博客站点。Wordpress提供了Docker镜像，方便其快速安装，详情请参见[WordPress的Docker Hub主页](https://hub.docker.com/_/wordpress)。 1.  安装WordPress。      1.1 在实验页面，切换至第一个终端窗口。按Ctrl+C键，停止运行Spring Boot样例工程。 1.2 执行如下命令，安装WordPress。 ``` docker run --name some-wordpress -p 9090:80 -d wordpress ``` 1.  创建WordPress的数据库。      2.1 执行如下命令，登录PolarDB-X数据库。 ``` mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456 ``` 2.2 执行如下SQL语句，创建数据库wordpress。 ``` create database wordpress MODE='AUTO'; ``` 2.3 输入exit退出数据库。  1.  配置WordPress。      3.1 在您的本机浏览器中，打开新页签，访问http://<ECS的弹性IP>:9090。 **说明**：您需要将<ECS的弹性IP>替换为云产品资源列表中的ECS的弹性IP。 3.2 在初始化页面，选择**简体中文**，单击**继续**。  3.3 在准备页面，单击**现在就开始**。  3.4 在数据库配置页面，参考说明配置数据库信息，单击**提交**。 参数说明： -   **数据库名** ：默认为 wordpress 。          -   **用户名** ：输入 polardbx_root 。              -   **密码** ：输入 123456 。              -   **数据库主机** ：输入 <ECS的弹性IP>:8527 。您需要将 <ECS的弹性IP> 替换为云产品资源列表中的ECS的弹性IP。              -   **表前缀** ：默认为 wp_ 。           3.5 在数据库配置完成页面，单击**运行安装程序**。  3.6 在信息配置页面，参考说明配置相关信息，单击安装WordPress。 参数说明： -   **站点标题** ：输入站点标题，例如 myblog 。          -   **用户名** ：输入用户名，例如 admin 。              -   **密码** ：输入密码。              -   **您的电子邮箱地址** ：输入邮箱地址。建议使用真实有效的邮箱地址，若没有，可以填写虚拟邮箱地址，但将无法接收信息，例如 username@example.com 。           3.7 在成功页面，单击**登录**。  3.8 在登录页面，依次输入您的**用户名**和**密码**，单击**登录**。  7\. 了解更多 -   如果您想了解更多有关分布式数据库连接池的最佳实践，详情请参见 [如何选择应用端链接池](https://doc.polardbx.com/best-practice/topics/connection-pool.html) 。      -   如果您想下载PolarDB-X源码，详情请参见 [PolarDB-X源码](https://github.com/ApsaraDB/galaxysql) 。      -   关于PolarDB-X说明文档，详情请参见 [PolarDB-X说明文档](https://doc.polardbx.com/) 。      -   如果您对PolarDB-X内部实现原理感兴趣，可关注我们的知乎官号 [PolarDB-X](https://www.zhihu.com/org/polardb-x) 。      恭喜完成