前言:

在学习和使用MySQL的过程中,难免会遇到各种问题。不知道当你遇到相关问题时会怎么做,我在工作或写文章的过程中,遇到不懂或需要求证的问题时通常会去查阅官方文档。慢慢的,阅读文档也有了一些经验,本篇文章将手把手教你阅读MySQL官方文档,希望可以给到各位一点小收获。

1.初识官方文档

如果你还没有仔细的看过MySQL官方文档,可以跟着我一步步体验下哦。首先打开参考文档首页,这里以5.7版本为例,首页地址:https://dev.mysql.com/doc/refman/5.7/en/

image.png

首页左侧边是目录,目录上方有个搜索框,首页右上角可以切换版本,比如你想看8.0版本的话可以切换到对应版本。接下来我们认识下目录内容,从侧边目录栏可以看出参考手册按照分类分为不同章节,建议大家首先阅读下第一章节General Information,该章节的主要内容如下:

  • 关于该参考手册的使用方法及适用版本。
  • 介绍MySQL的历史及数据库系统概述。
  • 列出5.7版本新增的功能。
  • 介绍5.7版本新增及不建议使用的一些参数变量。

可以看出,第一章节从整体上介绍了该版本MySQL相关的内容,读读第一章有助于我们更好的使用此文档。下面目录中比较重要的章节有安装和升级、MySQL服务管理、备份与恢复、优化、字段类型、SQL语句、InnoDB存储引擎、主从复制等。至此,我们大概认识了MySQL官方文档,下面继续看下该如何使用。

2.读活的文档

一般情况下,我们都是遇到问题或者有想知道的知识时,会去翻阅官方文档。此时我们是带着目标去阅读的,这种情况下应该速战速决。如果你对该文档目录很熟悉,那么可以很快找到相关内容,如果你对文档不熟悉,这时候要善用搜索,比如你想了解如何创建索引,在搜索框输入index,然后即可搜索出索引相关章节。

image.png

有的同学可能说了,这文档都是英文也看不太懂啊。其实我想说,参考文档中的英文大多是浅显易懂的,通读一遍能大概知道什么意思,实在看不懂可以借助谷歌翻译或其他插件进行翻译。推荐大家开两个相同的标签页,一个英文另一个借助浏览器翻译成中文,这样可以两边对照着阅读。

我们应该读“活”的文档,阅读文档要灵活运用,推荐边阅读边测试。同时也要读全面,有的参数变量在不同版本可能表现不同。不建议毫无目的的去阅读文档,推荐有计划的阅读,比如说你想了解InnoDB引擎,那么你可以根据自己的时间安排阅读InnoDB存储引擎这一章节。

3.几个小技巧

除了上面善用搜索框搜索的技巧外,下面再分享几个小技巧。不知道你有没有遇到过这种情况,就是某个语法你以前用过,但这次写着写着却发现想不起来了。此时你可以去网上搜索或翻阅官方文档,但更简便的做法是利用命令行自带的帮助文档,比如说你想了解create database参数,直接在MySQL命令行输入 ? create database 即可,命令行会自动输出相关内容并且给出文档链接,是不是方便了很多。

mysql> ? create database 
Name: \'CREATE DATABASE\'
Description:
Syntax:
CREATE {DATABASE | SCHEMA} [IF NOT EXISTS] db_name
    [create_specification] ...

create_specification:
    [DEFAULT] CHARACTER SET [=] charset_name
  | [DEFAULT] COLLATE [=] collation_name

CREATE DATABASE creates a database with the given name. To use this
statement, you need the CREATE privilege for the database. CREATE
SCHEMA is a synonym for CREATE DATABASE.

URL: http://dev.mysql.com/doc/refman/5.7/en/create-database.html

MySQL文档中有很多语句示例,其中也有些规范,比如说以上面create database语句为例,中括号[]中的内容可以省略,花括号{}中的内容是任选其一的,不同选项以竖线|分隔。了解这些有助于我们快速明白相关语句用法。

其实除了MySQL官方文档外,MySQL官方还提供了其他各种网络资源,下面简单介绍下:

社区版下载网站:
https://dev.mysql.com/downloads/

版本发行说明手册,其中有各版本新增内容:
https://dev.mysql.com/doc/relnotes/mysql/5.7/en/
https://dev.mysql.com/doc/relnotes/mysql/8.0/en/

查看与提交bug网站:
https://bugs.mysql.com/

MySQL团队博客:
https://mysqlserverteam.com/

总结:

还在学习MySQL的同学要多多翻阅官方文档,官方文档中的内容才是最全面准确的。本篇文章我将自己阅读文档的经验和技巧都分享出来了,希望对你有所帮助。写这篇文章费了笔者很大的精力,还请各位小伙伴多多支持哈!

wx_blog.png

版权声明:本文为mysqljs原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.cnblogs.com/kunjian/p/13181133.html