# **实验 2: 在 TiDB 集群中创建 `universe` 数据库**

## **目的**
+ 创建 `universe` 数据库，作为本课程的实验的数据基础
+ **Note**: `universe` 样例数据库来自 `universe.sql`

## **适用场景**
+ `TiDB` 集群已启动
+ 操作系统上已经安装了 [mysql client](https://cn.bing.com/search?q=MacOS+mysql+client+%E5%AE%89%E8%A3%85) (推荐) 或 [MySQL Workbench (注意选择版本: 6.3.10，页面默认为最新高版本)](https://downloads.mysql.com/archives/workbench/) (备用)

## **步骤**

****************************
#### 1. 从终端新开启一个 session 以访问 TiDB 测试数据库(本机或 TiDB Cloud):
+ a. 本地 TiDB(由实验 1a、1b 或 1c 创建): 直接登录
  ```
  $ mysql -h 127.0.0.1 -P 4000 -uroot
  ``` 
+ b. TiDB Cloud(由实验 1d 创建): 通过密码登录
  + 点击 TiDB Cloud 集群页面上的 `Connect` 
  + 在 `Connect to TiDB` 页面里的 `Standard Connection` 中，点击 `Add Your Current IP Address`
  + 复制列在 `Step 2: Connect with a SQL client` 下的命令，并执行
    ```
    mysql --connect-timeout 15 -uroot -h <tidb_cloud_server_dns_name> -P 4000 -p
    ```

****************************
#### 2. 导入示例 schema - universe:
```sql
tidb> source universe.sql
```

****************************
#### 3. 检查结果 - databases
```sql
tidb> show databases;
```

#### 4. 检查结果 - tables
```sql
tidb> show tables from universe;
```

#### 5. 检查带有 `comment` 的字段
```sql
tidb> source show-universe-comments.sql;
```

****************************
## 输出样例

****************************
#### 步骤3输出参考
```sql
tidb> show databases;
```
```
+--------------------+
| Database           |
+--------------------+
| INFORMATION_SCHEMA |
| METRICS_SCHEMA     |
| PERFORMANCE_SCHEMA |
| mysql              |
| test               |
| universe           |
+--------------------+
6 rows in set (0.00 sec)
```

*******************************
#### 步骤4输出参考
```sql
tidb> show tables from universe;
```
```
+--------------------+
| Tables_in_universe |
+--------------------+
| moons              |
| planet_categories  |
| planets            |
| stars              |
+--------------------+
4 rows in set (0.00 sec)
```

*******************************
#### 步骤5输出参考
```sql
tidb> source show-universe-comments.sql
```
```
+----------------------+----------------+
| Stars Columns        | column_comment |
+----------------------+----------------+
| mass                 | 10**24 kg      |
| density              | kg/m**3        |
| gravity              | m/s**2         |
| escape_velocity      | km/s           |
| mass_conversion_rate | 10**6 kg/s     |
+----------------------+----------------+
5 rows in set (0.01 sec)

+---------------------+----------------+
| Planets Columns     | column_comment |
+---------------------+----------------+
| mass                | 10**24 kg      |
| diameter            | km             |
| density             | kg/m**3        |
| gravity             | m/s**2         |
| escape_velocity     | km/s           |
| rotation_period     | hours          |
| length_of_day       | hours          |
| distance_from_sun   | 10**6 km       |
| perihelion          | 10**6 km       |
| aphelion            | 10**6 km       |
| orbital_period      | days           |
| orbital_velocity    | km/s           |
| orbital_inclination | degrees        |
| obliquity_to_orbit  | degrees        |
| mean_temperature    | C              |
| surface_pressure    | bars           |
+---------------------+----------------+
16 rows in set (0.02 sec)

Empty set (0.02 sec)

+---------------+----------------+
| Moons Columns | column_comment |
+---------------+----------------+
| mass          | 10**24 kg      |
| diameter      | km             |
+---------------+----------------+
2 rows in set (0.02 sec)
```