From 248ed54017931f91a765acc7c84ea5a54ecc098c Mon Sep 17 00:00:00 2001 From: jackfrued Date: Tue, 7 Dec 2021 00:30:15 +0800 Subject: [PATCH 01/17] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E4=BA=86=E9=83=A8?= =?UTF-8?q?=E5=88=86=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 6 +- ...04\344\271\213\345\255\227\345\205\270.md" | 3 +- ...77\347\224\250\350\277\233\351\230\266.md" | 2 +- ...5\206\231Excel\346\226\207\344\273\266.md" | 194 --------- ...344\275\234PDF\346\226\207\344\273\266.md" | 4 +- ...66\345\222\214\347\237\255\344\277\241.md" | 3 +- ...07\351\233\206\346\246\202\350\277\260.md" | 200 +++++++++ ...21\347\273\234\350\265\204\346\272\220.md" | 133 ++++++ ...46\236\220HTML\351\241\265\351\235\242.md" | 149 +++++++ ...\345\217\221\347\274\226\347\250\213-1.md" | 382 ++++++++++++++++++ ...\345\217\221\347\274\226\347\250\213-2.md" | 254 ++++++++++++ ...\345\217\221\347\274\226\347\250\213-3.md" | 215 ++++++++++ ...55\347\232\204\345\272\224\347\224\250.md" | 185 +++++++++ 13 files changed, 1529 insertions(+), 201 deletions(-) delete mode 100644 "\347\254\25424\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266.md" create mode 100644 "\347\254\25431\350\257\276\357\274\232\347\275\221\347\273\234\346\225\260\346\215\256\351\207\207\351\233\206\346\246\202\350\277\260.md" create mode 100644 "\347\254\25432\350\257\276\357\274\232\347\224\250Python\350\216\267\345\217\226\347\275\221\347\273\234\350\265\204\346\272\220.md" create mode 100644 "\347\254\25433\350\257\276\357\274\232\347\224\250Python\350\247\243\346\236\220HTML\351\241\265\351\235\242.md" create mode 100644 "\347\254\25434\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-1.md" create mode 100644 "\347\254\25435\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-2.md" create mode 100644 "\347\254\25436\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-3.md" create mode 100644 "\347\254\25437\350\257\276\357\274\232\345\271\266\345\217\221\347\274\226\347\250\213\345\234\250\347\210\254\350\231\253\344\270\255\347\232\204\345\272\224\347\224\250.md" diff --git a/README.md b/README.md index 5595d12..03b08ab 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ ## Python语言基础50课 -由于之前发布的 Python 学习项目 [Python-100-Days](https://github.com/jackfrued/Python-100-Days) 对初学者来说上手还是有一定难度，所以花了点之间把原来项目中 Python 语言基础部分单独剥离出来，做成了现在这个名为“Python语言基础50课”的项目。现在这个项目用更为简单通俗的方式重写了原来“Python100天”项目中第1天到第15天的部分，**有删减也有补充**，力求**对初学者更加友好**，也欢迎大家关注这个持续更新中的项目。国内用户如果访问 GitHub 比较慢的话，也可以关注我的知乎号 [Python-Jack](https://www.zhihu.com/people/jackfrued) 上的[“从零开始学Python”]()专栏，两边同步更新。有需要的小伙伴可以关注我在知乎的专栏、文章和回答，当然，也欢迎大家评论、收藏和点赞。 +由于之前发布的 Python 学习项目 [Python-100-Days](https://github.com/jackfrued/Python-100-Days) 对初学者来说上手还是有一定难度，所以花了点之间把原来项目中 Python 语言基础部分单独剥离出来，做成了现在这个名为“Python语言基础50课”的项目。现在这个项目用更为简单通俗的方式重写了原来“Python100天”项目中第1天到第15天的部分，**有删减也有补充**，力求**对初学者更加友好**，也欢迎大家关注这个持续更新中的项目。国内用户如果访问 GitHub 比较慢的话，也可以关注我的知乎号 [Python-Jack](https://www.zhihu.com/people/jackfrued) 上的[“从零开始学Python”]()专栏，两边同步更新。有需要的小伙伴可以关注我在知乎的专栏、文章和回答，当然，也欢迎大家评论、收藏和点赞。如果需要**视频教程**，可以到“B站”上搜索[《Python零基础快速上手》](https://www.bilibili.com/video/BV1FT4y1R7sz)。 最近，国内访问 GitHub 会因为 DNS（域名解析服务）的问题出现**图片无法显示**的情况，如果你也遇到了这样的问题，可以通过**修改本机的 hosts 文件**直接对 GitHub 的资源链接进行域名解析来加以解决。使用 macOS 系统的读者可以参考[《macOS 下三种修改 hosts 文件的方法》]()一文来修改 hosts 文件；使用 Windows 系统的读者可以参考[《在 Windows 上如何管理 hosts 文件》]()一文来进行操作。我们可以把下面的内容添加到 hosts 文件的末尾，这样就可以解决 GitHub 上图片无法显示的问题。 @@ -12,4 +12,6 @@ 151.101.184.133 camo.githubusercontent.com ``` -20933D073D8CCF2D8537AD1E666330E4 +下面是我创建的学习交流群（群号：789050736），欢迎加入一起学习共同进步。 + + diff --git "a/\347\254\25412\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\345\205\270.md" "b/\347\254\25412\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\345\205\270.md" index 0abdbda..ba7780b 100644 --- "a/\347\254\25412\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\345\205\270.md" +++ "b/\347\254\25412\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\345\205\270.md" @@ -128,7 +128,8 @@ print(stu2) # {} key, value = students.popitem() print(key, value) # 1003 {'name': '武则天', 'sex': False, 'age': 20, 'place': '四川广元'} -# setdefault可以向字典中存入新的键值对或返回指定的键对应的值 +# 如果这个键在字典中存在，setdefault返回原来与这个键对应的值 +# 如果这个键在字典中不存在，向字典中添加键值对，返回第二个参数的值，默认为None result = students.setdefault(1005, {'name': '方启鹤', 'sex': True}) print(result) # {'name': '方启鹤', 'sex': True} print(students) # {1001: {...}, 1005: {...}} diff --git "a/\347\254\25415\350\257\276\357\274\232\345\207\275\346\225\260\344\275\277\347\224\250\350\277\233\351\230\266.md" "b/\347\254\25415\350\257\276\357\274\232\345\207\275\346\225\260\344\275\277\347\224\250\350\277\233\351\230\266.md" index 3c3a3da..8816ae3 100644 --- "a/\347\254\25415\350\257\276\357\274\232\345\207\275\346\225\260\344\275\277\347\224\250\350\277\233\351\230\266.md" +++ "b/\347\254\25415\350\257\276\357\274\232\345\207\275\346\225\260\344\275\277\347\224\250\350\277\233\351\230\266.md" @@ -1,4 +1,4 @@ -## 第15课：函数使用进阶 +## 第13课：函数使用进阶 前面我们讲到了关于函数的知识，我们还讲到过Python中常用的数据类型，这些类型的变量都可以作为函数的参数或返回值，用好函数还可以让我们做更多的事情。 diff --git "a/\347\254\25424\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266.md" "b/\347\254\25424\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266.md" deleted file mode 100644 index 4f862cc..0000000 --- "a/\347\254\25424\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266.md" +++ /dev/null @@ -1,194 +0,0 @@ -## 第24课：用Python读写Excel文件 - -### Excel简介 - -Excel是Microsoft（微软）为使用Windows和macOS操作系统开发的一款电子表格软件。Excel凭借其直观的界面、出色的计算功能和图表工具，再加上成功的市场营销，一直以来都是最为流行的个人计算机数据处理软件。当然，Excel也有很多竞品，例如Google Sheets、LibreOffice Calc、Numbers等，这些竞品基本上也能够兼容Excel，至少能够读写较新版本的Excel文件，当然这些不是我们讨论的重点。掌握用Python程序操作Excel文件，可以让日常办公自动化的工作更加轻松愉快，而且在很多商业项目中，导入导出Excel文件都是特别常见的功能。 - -Python操作Excel需要三方库的支持，如果要兼容Excel 2007以前的版本，也就是`xls`格式的Excel文件，可以使用三方库`xlrd`和`xlwt`，前者用于读Excel文件，后者用于写Excel文件。如果使用较新版本的Excel，即操作`xlsx`格式的Excel文件，也可以使用`openpyxl`库，当然这个库不仅仅可以操作Excel，还可以操作其他基于Office Open XML的电子表格文件。 - -下面我们以`xlwt`和`xlrd`为例讲解如何读写Excel文件，大家可以先使用下面的命令安装这两个三方库文件。 - -```Bash -pip install xlwt xlrd -i https://pypi.doubanio.com/simple -``` - -### 使用xlwt和xlrd - -#### 读Excel文件 - -例如在当前文件夹下有一个名为“阿里巴巴2017年股票数据.xlsx”的Excel文件，如果想读取并显示该文件的内容，可以通过如下所示的代码来完成。 - -```Python -import xlrd - -# 使用xlrd模块的open_workbook函数打开指定Excel文件并获得Book对象（工作簿） -wb = xlrd.open_workbook('阿里巴巴2017年股票数据.xlsx') -# 通过Book对象的sheet_names方法可以获取所有表单名称 -sheetname = wb.sheet_names()[0] -# 通过指定的表单名称获取Sheet对象（工作表） -sheet = wb.sheet_by_name(sheetname) -# 通过Sheet对象的nrows和ncols属性获取表单的行数和列数 -print(sheet.nrows, sheet.ncols) -for row in range(sheet.nrows): - for col in range(sheet.ncols): - # 通过Sheet对象的cell方法获取指定Cell对象（单元格） - # 通过Cell对象的value属性获取单元格中的值 - value = sheet.cell(row, col).value - # 对除首行外的其他行进行数据格式化处理 - if row > 0: - # 第1列的xldate类型先转成元组再格式化为“年月日”的格式 - if col == 0: - # xldate_as_tuple函数的第二个参数只有0和1两个取值 - # 其中0代表以1900-01-01为基准的日期，1代表以1904-01-01为基准的日期 - value = xlrd.xldate_as_tuple(value, 0) - value = f'{value[0]}年{value[1]:>02d}月{value[2]:>02d}日' - # 其他列的number类型处理成小数点后保留两位有效数字的浮点数 - else: - value = f'{value:.2f}' - print(value, end='\t') - print() -# 获取最后一个单元格的数据类型 -# 0 - 空值，1 - 字符串，2 - 数字，3 - 日期，4 - 布尔，5 - 错误 -last_cell_type = sheet.cell_type(sheet.nrows - 1, sheet.ncols - 1) -print(last_cell_type) -# 获取第一行的值（列表） -print(sheet.row_values(0)) -# 获取指定行指定列范围的数据（列表） -# 第一个参数代表行索引，第二个和第三个参数代表列的开始（含）和结束（不含）索引 -print(sheet.row_slice(3, 0, 5)) -``` - -相信通过上面的代码，大家已经了解到了如何读取一个Excel文件，如果想知道更多关于`xlrd`模块的知识，可以阅读它的[官方文档](https://xlrd.readthedocs.io/en/latest/)。 - -#### 写Excel文件 - -写入Excel文件可以通过`xlwt` 模块的`Workbook`类创建工作簿对象，通过工作簿对象的`add_sheet`方法可以添加工作表，通过工作表对象的`write`方法可以向指定单元格中写入数据，最后通过工作簿对象的`save`方法将工作簿写入到指定的文件或内存中。下面的代码实现了将5个学生3门课程的考试成绩写入Excel文件的操作。 - -```Python -import random - -import xlwt - -student_names = ['关羽', '张飞', '赵云', '马超', '黄忠'] -scores = [[random.randint(40, 100) for _ in range(3)] for _ in range(5)] -# 创建工作簿对象（Workbook） -wb = xlwt.Workbook() -# 创建工作表对象（Worksheet） -sheet = wb.add_sheet('一年级二班') -# 添加表头数据 -titles = ('姓名', '语文', '数学', '英语') -for index, title in enumerate(titles): - sheet.write(0, index, title) -# 将学生姓名和考试成绩写入单元格 -for row in range(len(scores)): - sheet.write(row + 1, 0, student_names[row]) - for col in range(len(scores[row])): - sheet.write(row + 1, col + 1, scores[row][col]) -# 保存Excel工作簿 -wb.save('考试成绩表.xlsx') -``` - -#### 调整单元格样式 - -在写Excel文件时，我们还可以为单元格设置样式，主要包括字体（Font）、对齐方式（Alignment）、边框（Border）和背景（Background）的设置，`xlwt`对这几项设置都封装了对应的类来支持。要设置单元格样式需要首先创建一个`XFStyle`对象，再通过该对象的属性对字体、对齐方式、边框等进行设定，例如在上面的例子中，如果希望将表头单元格的背景色修改为黄色，可以按照如下的方式进行操作。 - -```Python -header_style = xlwt.XFStyle() -pattern = xlwt.Pattern() -pattern.pattern = xlwt.Pattern.SOLID_PATTERN -# 0 - 黑色、1 - 白色、2 - 红色、3 - 绿色、4 - 蓝色、5 - 黄色、6 - 粉色、7 - 青色 -pattern.pattern_fore_colour = 5 -header_style.pattern = pattern -titles = ('姓名', '语文', '数学', '英语') -for index, title in enumerate(titles): - sheet.write(0, index, title, header_style) -``` - -如果希望为表头设置指定的字体，可以使用`Font`类并添加如下所示的代码。 - -```Python -font = xlwt.Font() -# 字体名称 -font.name = '华文楷体' -# 字体大小（20是基准单位，18表示18px） -font.height = 20 * 18 -# 是否使用粗体 -font.bold = True -# 是否使用斜体 -font.italic = False -# 字体颜色 -font.colour_index = 1 -header_style.font = font -``` - -如果希望表头垂直居中对齐，可以使用下面的代码进行设置。 - -```Python -align = xlwt.Alignment() -# 垂直方向的对齐方式 -align.vert = xlwt.Alignment.VERT_CENTER -# 水平方向的对齐方式 -align.horz = xlwt.Alignment.HORZ_CENTER -header_style.alignment = align -``` - -如果希望给表头加上黄色的虚线边框，可以使用下面的代码来设置。 - -```Python -borders = xlwt.Borders() -props = ( - ('top', 'top_colour'), ('right', 'right_colour'), - ('bottom', 'bottom_colour'), ('left', 'left_colour') -) -# 通过循环对四个方向的边框样式及颜色进行设定 -for position, color in props: - setattr(borders, position, xlwt.Borders.DASHED) - setattr(borders, color, 5) -header_style.borders = borders -``` - -如果要调整单元格的宽度（列宽）和表头的高度（行高），可以按照下面的代码进行操作。 - -```Python -# 设置行高为40px -sheet.row(0).set_style(xlwt.easyxf(f'font:height {20 * 40}')) -titles = ('姓名', '语文', '数学', '英语') -for index, title in enumerate(titles): - # 设置列宽为200px - sheet.col(index).width = 20 * 200 - # 设置单元格的数据和样式 - sheet.write(0, index, title, header_style) -``` - -#### 公式计算 - -对于前面打开的“阿里巴巴2017年股票数据.xlsx”文件，如果要统计全年收盘价（Close字段）的平均值以及全年交易量（Volume字段）的总和，可以使用Excel的公式计算即可。我们可以先使用`xlrd`读取Excel文件夹，然后通过一个名为`xlutils`的三方库提供的`copy`函数将读取到的Excel文件转成`Workbook`对象进行写操作，在调用`write`方法时，可以将一个`Formula`对象写入单元格。 - -安装`xlutils`三方库。 - -```Bash -pip install xlutils -i https://pypi.doubanio.com/simple -``` - -实现公式计算的代码如下所示。 - -```Python -import xlrd -import xlwt -from xlutils.copy import copy - -wb_for_read = xlrd.open_workbook('阿里巴巴2017年股票数据.xlsx') -sheet1 = wb_for_read.sheet_by_index(0) -nrows, ncols = sheet1.nrows, sheet1.ncols -wb_for_write = copy(wb_for_read) -sheet2 = wb_for_write.get_sheet(0) -sheet2.write(nrows, 4, xlwt.Formula(f'average(E2:E{nrows})')) -sheet2.write(nrows, 6, xlwt.Formula(f'sum(G2:G{nrows})')) -wb_for_write.save('阿里巴巴2017年股票数据-2.xlsx') -``` - -> **说明**：上面的代码有一些小瑕疵，有兴趣的读者可以自行探索如何解决。 - -### 简单的总结 - -其他操作Excel文件的三方库（如`openpyxl`）大家有兴趣可以自行了解。掌握了Python程序操作Excel的方法，可以解决日常办公中很多繁琐的处理Excel电子表格工作，最常见就是将多个数据格式相同的Excel文件合并到一个文件以及从多个Excel文件或表单中提取指定的数据。当然，如果要对表格数据进行处理，使用Python数据分析神器之一的`pandas`库可能更为方便，因为`pandas`库封装的函数以及`DataFrame`类可以完成大多数数据处理的任务。 diff --git "a/\347\254\25427\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234PDF\346\226\207\344\273\266.md" "b/\347\254\25427\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234PDF\346\226\207\344\273\266.md" index dc41e67..4177f54 100644 --- "a/\347\254\25427\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234PDF\346\226\207\344\273\266.md" +++ "b/\347\254\25427\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234PDF\346\226\207\344\273\266.md" @@ -20,7 +20,7 @@ page = reader.getPage(0) print(page.extractText()) ``` -> **提示**：上面代码中使用的PDF文件“test.pdf”以及下面的代码中需要用到的PDF文件，都可以通过后面的百度云盘地址进行获取。链接:https://pan.baidu.com/s/1rQujl5RQn9R7PadB2Z5g_g 提取码:e7b4。 +> **提示**：上面代码中使用的PDF文件“test.pdf”以及下面的代码中需要用到的PDF文件，也可以通过下面的百度云盘地址进行获取。链接:https://pan.baidu.com/s/1rQujl5RQn9R7PadB2Z5g_g 提取码:e7b4。 当然，`PyPDF2`并不是什么样的PDF文档都能提取出文字来，这个问题就我所知并没有什么特别好的解决方法，尤其是在提取中文的时候。网上也有很多讲解从PDF中提取文字的文章，推荐大家自行阅读[《三大神器助力Python提取pdf文档信息》](https://cloud.tencent.com/developer/article/1395339)一文进行了解。 @@ -151,7 +151,7 @@ pdf_canvas.save() 上面的代码如果不太理解也没有关系，等真正需要用Python创建PDF文档的时候，再好好研读一下`reportlab`的[官方文档](https://www.reportlab.com/docs/reportlab-userguide.pdf)就可以了。 -> **提示**：上面代码中用到的图片和字体，可以在后面的百度云盘链接中获取。链接:https://pan.baidu.com/s/1rQujl5RQn9R7PadB2Z5g_g 提取码:e7b4。 +> **提示**：上面代码中用到的图片和字体，也可以通过下面的百度云盘链接获取。链接:https://pan.baidu.com/s/1rQujl5RQn9R7PadB2Z5g_g 提取码:e7b4。 ### 简单的总结 diff --git "a/\347\254\25429\350\257\276\357\274\232\347\224\250Python\345\217\221\351\200\201\351\202\256\344\273\266\345\222\214\347\237\255\344\277\241.md" "b/\347\254\25429\350\257\276\357\274\232\347\224\250Python\345\217\221\351\200\201\351\202\256\344\273\266\345\222\214\347\237\255\344\277\241.md" index f1c8e85..b2ec68d 100644 --- "a/\347\254\25429\350\257\276\357\274\232\347\224\250Python\345\217\221\351\200\201\351\202\256\344\273\266\345\222\214\347\237\255\344\277\241.md" +++ "b/\347\254\25429\350\257\276\357\274\232\347\224\250Python\345\217\221\351\200\201\351\202\256\344\273\266\345\222\214\347\237\255\344\277\241.md" @@ -32,6 +32,7 @@ email['Subject'] = Header('上半年工作情况汇报', 'utf-8') content = """据德国媒体报道，当地时间9日，德国火车司机工会成员进行了投票， 定于当地时间10日起进行全国性罢工，货运交通方面的罢工已于当地时间10日19时开始。 此后，从11日凌晨2时到13日凌晨2时，德国全国范围内的客运和铁路基础设施将进行48小时的罢工。""" +email.attach(MIMEText(content, 'plain', 'utf-8')) # 创建SMTP_SSL对象（连接邮件服务器） smtp_obj = smtplib.SMTP_SSL('smtp.126.com', 465) @@ -139,7 +140,7 @@ def send_email(*, from_user, to_users, subject='', content='', filenames=[]): smtp = smtplib.SMTP_SSL(EMAIL_HOST, EMAIL_PORT) smtp.login(EMAIL_USER, EMAIL_AUTH) - smtp.sendmail(from_user, to_users, email.as_string()) + smtp.sendmail(from_user, to_users.split(';'), email.as_string()) ``` ### 发送短信 diff --git "a/\347\254\25431\350\257\276\357\274\232\347\275\221\347\273\234\346\225\260\346\215\256\351\207\207\351\233\206\346\246\202\350\277\260.md" "b/\347\254\25431\350\257\276\357\274\232\347\275\221\347\273\234\346\225\260\346\215\256\351\207\207\351\233\206\346\246\202\350\277\260.md" new file mode 100644 index 0000000..cd4b240 --- /dev/null +++ "b/\347\254\25431\350\257\276\357\274\232\347\275\221\347\273\234\346\225\260\346\215\256\351\207\207\351\233\206\346\246\202\350\277\260.md" @@ -0,0 +1,200 @@ +## 第31课：网络数据采集概述 + +爬虫（crawler）也经常被称为网络蜘蛛（spider），是按照一定的规则自动浏览网站并获取所需信息的机器人程序（自动化脚本代码），被广泛的应用于互联网搜索引擎和数据采集。使用过互联网和浏览器的人都知道，网页中除了供用户阅读的文字信息之外，还包含一些超链接，网络爬虫正是通过网页中的超链接信息，不断获得网络上其它页面的地址，然后持续的进行数据采集。正因如此，网络数据采集的过程就像一个爬虫或者蜘蛛在网络上漫游，所以才被形象的称为爬虫或者网络蜘蛛。 + +### 爬虫的应用领域 + +在理想的状态下，所有 ICP（Internet Content Provider）都应该为自己的网站提供 API 接口来共享它们允许其他程序获取的数据，在这种情况下就根本不需要爬虫程序。国内比较有名的电商平台（如淘宝、京东等）、社交平台（如微博、微信等）等都提供了自己的 API 接口，但是这类 API 接口通常会对可以抓取的数据以及抓取数据的频率进行限制。对于大多数的公司而言，及时的获取行业数据和竞对数据是企业生存的重要环节之一，然而对大部分企业来说，数据都是其与生俱来的短板。在这种情况下，合理的利用爬虫来获取数据并从中提取出有商业价值的信息对这些企业来说就显得至关重要的。 + +爬虫的应用领域其实非常广泛，下面我们列举了其中的一部分，有兴趣的读者可以自行探索相关内容。 + +1. 搜索引擎 +2. 新闻聚合 +3. 社交应用 +4. 舆情监控 +5. 行业数据 + +### 爬虫合法性探讨 + +经常听人说起“爬虫写得好，牢饭吃到饱”，那么编程爬虫程序是否违法呢？关于这个问题，我们可以从以下几个角度进行解读。 + +1. 网络爬虫这个领域目前还属于拓荒阶段，虽然互联网世界已经通过自己的游戏规则建立起了一定的道德规范，即 Robots 协议（全称是“网络爬虫排除标准”），但法律部分还在建立和完善中，也就是说，现在这个领域暂时还是灰色地带。 +2. “法不禁止即为许可”，如果爬虫就像浏览器一样获取的是前端显示的数据（网页上的公开信息）而不是网站后台的私密敏感信息，就不太担心法律法规的约束，因为目前大数据产业链的发展速度远远超过了法律的完善程度。 +3. 在爬取网站的时候，需要限制自己的爬虫遵守 Robots 协议，同时控制网络爬虫程序的抓取数据的速度；在使用数据的时候，必须要尊重网站的知识产权（从Web 2.0时代开始，虽然Web上的数据很多都是由用户提供的，但是网站平台是投入了运营成本的，当用户在注册和发布内容时，平台通常就已经获得了对数据的所有权、使用权和分发权）。如果违反了这些规定，在打官司的时候败诉几率相当高。 +4. 适当的隐匿自己的身份在编写爬虫程序时必要的，而且最好不要被对方举证你的爬虫有破坏别人动产（例如服务器）的行为。 +5. 不要在公网（如代码托管平台）上去开源或者展示你的爬虫代码，这些行为通常会给自己带来不必要的麻烦。 + +#### Robots协议 + +大多数网站都会定义`robots.txt`文件，这是一个君子协议，并不是所有爬虫都必须遵守的游戏规则。下面以淘宝的[`robots.txt`](http://www.taobao.com/robots.txt)文件为例，看看淘宝网对爬虫有哪些限制。 + +``` +User-agent: Baiduspider +Disallow: / + +User-agent: baiduspider +Disallow: / +``` + +通过上面的文件可以看出，淘宝禁止百度爬虫爬取它任何资源，因此当你在百度搜索“淘宝”的时候，搜索结果下方会出现：“由于该网站的`robots.txt`文件存在限制指令（限制搜索引擎抓取），系统无法提供该页面的内容描述”。百度作为一个搜索引擎，至少在表面上遵守了淘宝网的`robots.txt`协议，所以用户不能从百度上搜索到淘宝内部的产品信息。 + +图1. 百度搜索淘宝的结果 + +![](https://gitee.com/jackfrued/mypic/raw/master/20210824004320.png) + +下面是豆瓣网的[`robots.txt`](https://www.douban.com/robots.txt)文件，大家可以自行解读，看看它做出了什么样的限制。 + +``` +User-agent: * +Disallow: /subject_search +Disallow: /amazon_search +Disallow: /search +Disallow: /group/search +Disallow: /event/search +Disallow: /celebrities/search +Disallow: /location/drama/search +Disallow: /forum/ +Disallow: /new_subject +Disallow: /service/iframe +Disallow: /j/ +Disallow: /link2/ +Disallow: /recommend/ +Disallow: /doubanapp/card +Disallow: /update/topic/ +Disallow: /share/ +Allow: /ads.txt +Sitemap: https://www.douban.com/sitemap_index.xml +Sitemap: https://www.douban.com/sitemap_updated_index.xml +# Crawl-delay: 5 + +User-agent: Wandoujia Spider +Disallow: / + +User-agent: Mediapartners-Google +Disallow: /subject_search +Disallow: /amazon_search +Disallow: /search +Disallow: /group/search +Disallow: /event/search +Disallow: /celebrities/search +Disallow: /location/drama/search +Disallow: /j/ +``` + +### 超文本传输协议（HTTP） + +在开始讲解爬虫之前，我们稍微对超文本传输协议（HTTP）做一些回顾，因为我们在网页上看到的内容通常是浏览器执行 HTML （超文本标记语言）得到的结果，而 HTTP 就是传输 HTML 数据的协议。HTTP 和其他很多应用级协议一样是构建在 TCP（传输控制协议）之上的，它利用了 TCP 提供的可靠的传输服务实现了 Web 应用中的数据交换。按照维基百科上的介绍，设计 HTTP 最初的目的是为了提供一种发布和接收 [HTML](https://zh.wikipedia.org/wiki/HTML) 页面的方法，也就是说，这个协议是浏览器和 Web 服务器之间传输的数据的载体。关于 HTTP 的详细信息以及目前的发展状况，大家可以阅读[《HTTP 协议入门》](http://www.ruanyifeng.com/blog/2016/08/http.html)、[《互联网协议入门》](http://www.ruanyifeng.com/blog/2012/05/internet_protocol_suite_part_i.html)、[《图解 HTTPS 协议》](http://www.ruanyifeng.com/blog/2014/09/illustration-ssl.html)等文章进行了解。 + +下图是我在四川省网络通信技术重点实验室工作期间用开源协议分析工具 Ethereal（WireShark 的前身）截取的访问百度首页时的 HTTP 请求和响应的报文（协议数据），由于 Ethereal 截取的是经过网络适配器的数据，因此可以清晰的看到从物理链路层到应用层的协议数据。 + +图2. HTTP请求 + +![http-request](https://gitee.com/jackfrued/mypic/raw/master/20210824003915.png) + +HTTP 请求通常是由请求行、请求头、空行、消息体四个部分构成，如果没有数据发给服务器，消息体就不是必须的部分。请求行中包含了请求方法（GET、POST 等，如下表所示）、资源路径和协议版本；请求头由若干键值对构成，包含了浏览器、编码方式、首选语言、缓存策略等信息；请求头的后面是空行和消息体。 + + + +图3. HTTP响应 + +![http-response](https://gitee.com/jackfrued/mypic/raw/master/20210824234158.png) + +HTTP 响应通常是由响应行、响应头、空行、消息体四个部分构成，其中消息体是服务响应的数据，可能是 HTML 页面，也有可能是JSON或二进制数据等。响应行中包含了协议版本和响应状态码，响应状态码有很多种，常见的如下表所示。 + + + +#### 相关工具 + +下面我们先介绍一些开发爬虫程序的辅助工具，这些工具相信能帮助你事半功倍。 + +1. Chrome Developer Tools：谷歌浏览器内置的开发者工具。该工具最常用的几个功能模块是： + + - 元素（ELements）：用于查看或修改 HTML 元素的属性、CSS 属性、监听事件等。CSS 可以即时修改，即时显示，大大方便了开发者调试页面。 + - 控制台（Console）：用于执行一次性代码，查看 JavaScript 对象，查看调试日志信息或异常信息。控制台其实就是一个执行 JavaScript 代码的交互式环境。 + - 源代码（Sources）：用于查看页面的 HTML 文件源代码、JavaScript 源代码、CSS 源代码，此外最重要的是可以调试 JavaScript 源代码，可以给代码添加断点和单步执行。 + - 网络（Network）：用于 HTTP 请求、HTTP 响应以及与网络连接相关的信息。 + - 应用（Application）：用于查看浏览器本地存储、后台任务等内容，本地存储主要包括Cookie、Local Storage、Session Storage等。 + + ![chrome-developer-tools](https://gitee.com/jackfrued/mypic/raw/master/20210824004034.png) + +2. Postman：功能强大的网页调试与 RESTful 请求工具。Postman可以帮助我们模拟请求，非常方便的定制我们的请求以及查看服务器的响应。 + + ![postman](https://gitee.com/jackfrued/mypic/raw/master/20210824004048.png) + +3. HTTPie：命令行HTTP客户端。 + + 安装。 + + ```Bash + pip install httpie + ``` + + 使用。 + + ```Bash + http --header http --header https://movie.douban.com/ + + HTTP/1.1 200 OK + Connection: keep-alive + Content-Encoding: gzip + Content-Type: text/html; charset=utf-8 + Date: Tue, 24 Aug 2021 16:48:00 GMT + Keep-Alive: timeout=30 + Server: dae + Set-Cookie: bid=58h4BdKC9lM; Expires=Wed, 24-Aug-22 16:48:00 GMT; Domain=.douban.com; Path=/ + Strict-Transport-Security: max-age=15552000 + Transfer-Encoding: chunked + X-Content-Type-Options: nosniff + X-DOUBAN-NEWBID: 58h4BdKC9lM + ``` + +4. `builtwith`库：识别网站所用技术的工具。 + + 安装。 + + ```Bash + pip install builtwith + ``` + + 使用。 + + ```Python + import ssl + + import builtwith + + ssl._create_default_https_context = ssl._create_unverified_context + print(builtwith.parse('http://www.bootcss.com/')) + ``` + +5. `python-whois`库：查询网站所有者的工具。 + + 安装。 + + ```Bash + pip3 install python-whois + ``` + + 使用。 + + ```Python + import whois + + print(whois.whois('https://www.bootcss.com')) + ``` + +### 爬虫的基本工作流程 + +一个基本的爬虫通常分为数据采集（网页下载）、数据处理（网页解析）和数据存储（将有用的信息持久化）三个部分的内容，当然更为高级的爬虫在数据采集和处理时会使用并发编程或分布式技术，这就需要有调度器（安排线程或进程执行对应的任务）、后台管理程序（监控爬虫的工作状态以及检查数据抓取的结果）等的参与。 + +![crawler-workflow](https://gitee.com/jackfrued/mypic/raw/master/20210824004107.png) + +一般来说，爬虫的工作流程包括以下几个步骤： + +1. 设定抓取目标（种子页面/起始页面）并获取网页。 +2. 当服务器无法访问时，按照指定的重试次数尝试重新下载页面。 +3. 在需要的时候设置用户代理或隐藏真实IP，否则可能无法访问页面。 +4. 对获取的页面进行必要的解码操作然后抓取出需要的信息。 +5. 在获取的页面中通过某种方式（如正则表达式）抽取出页面中的链接信息。 +6. 对链接进行进一步的处理（获取页面并重复上面的动作）。 +7. 将有用的信息进行持久化以备后续的处理。 diff --git "a/\347\254\25432\350\257\276\357\274\232\347\224\250Python\350\216\267\345\217\226\347\275\221\347\273\234\350\265\204\346\272\220.md" "b/\347\254\25432\350\257\276\357\274\232\347\224\250Python\350\216\267\345\217\226\347\275\221\347\273\234\350\265\204\346\272\220.md" new file mode 100644 index 0000000..ab7ede2 --- /dev/null +++ "b/\347\254\25432\350\257\276\357\274\232\347\224\250Python\350\216\267\345\217\226\347\275\221\347\273\234\350\265\204\346\272\220.md" @@ -0,0 +1,133 @@ +## 第32课：用Python获取网络数据 + +网络数据采集是 Python 语言非常擅长的领域，上节课我们讲到，实现网络数据采集的程序通常称之为网络爬虫或蜘蛛程序。即便是在大数据时代，数据对于中小企业来说仍然是硬伤和短板，有些数据需要通过开放或付费的数据接口来获得，其他的行业数据和竞对数据则必须要通过网络数据采集的方式来获得。不管使用哪种方式获取网络数据资源，Python 语言都是非常好的选择，因为 Python 的标准库和三方库都对网络数据采集提供了良好的支持。 + +### requests库 + +要使用 Python 获取网络数据，我们推荐大家使用名为`requests` 的三方库，这个库我们在之前的课程中其实已经使用过了。按照官方网站的解释，`requests`是基于 Python 标准库进行了封装，简化了通过 HTTP 或 HTTPS 访问网络资源的操作。上课我们提到过，HTTP 是一个请求响应式的协议，当我们在浏览器中输入正确的 [URL](https://developer.mozilla.org/zh-CN/docs/Learn/Common_questions/What_is_a_URL)（通常也称为网址）并按下 Enter 键时，我们就向网络上的 [Web 服务器](https://developer.mozilla.org/zh-CN/docs/Learn/Common_questions/What_is_a_web_server)发送了一个 HTTP 请求，服务器在收到请求后会给我们一个 HTTP 响应。在 Chrome 浏览器中的菜单中打开“开发者工具”切换到“Network”选项卡就能够查看 HTTP 请求和响应到底是什么样子的，如下图所示。 + +![](https://gitee.com/jackfrued/mypic/raw/master/20210822093434.png) + +通过`requests`库，我们可以让 Python 程序向浏览器一样向 Web 服务器发起请求，并接收服务器返回的响应，从响应中我们就可以提取出想要的数据。浏览器呈现给我们的网页是用 [HTML](https://developer.mozilla.org/zh-CN/docs/Web/HTML) 编写的，浏览器相当于是 HTML 的解释器环境，我们看到的网页中的内容都包含在 HTML 的标签中。在获取到 HTML 代码后，就可以从标签的属性或标签体中提取内容。下面例子演示了如何获取网页 HTML 代码，我们通过`requests`库的`get`函数，获取了搜狐首页的代码。 + +```Python +import requests + +resp = requests.get('https://www.sohu.com/') +if resp.status_code == 200: + print(resp.text) +``` + +> **说明**：上面代码中的变量`resp`是一个`Response`对象（`requests`库封装的类型），通过该对象的`status_code`属性可以获取响应状态码，而该对象的`text`属性可以帮我们获取到页面的 HTML 代码。 + +由于`Response`对象的`text`是一个字符串，所以我们可以利用之前讲过的正则表达式的知识，从页面的 HTML 代码中提取新闻的标题和链接，代码如下所示。 + +```Python +import re + +import requests + +pattern = re.compile(r'') +resp = requests.get('https://www.sohu.com/') +if resp.status_code == 200: + all_matches = pattern.findall(resp.text) + for href, title in all_matches: + print(href) + print(title) +``` + +除了文本内容，我们也可以使用`requests`库通过 URL 获取二进制资源。下面的例子演示了如何获取百度 Logo 并保存到名为`baidu.png`的本地文件中。可以在百度的首页上右键点击百度Logo，并通过“复制图片地址”菜单项获取图片的 URL。 + +```Python +import requests + +resp = requests.get('https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png') +with open('baidu.png', 'wb') as file: + file.write(resp.content) +``` + +> **说明**：`Response`对象的`content`属性可以获得服务器响应的二进制数据。 + +`requests`库非常好用而且功能上也比较强大和完整，具体的内容我们在使用的过程中为大家一点点剖析。想解锁关于`requests`库更多的知识，可以阅读它的[官方文档](https://docs.python-requests.org/zh_CN/latest/)。 + +### 编写爬虫代码 + +接下来，我们以“豆瓣电影”为例，为大家讲解如何编写爬虫代码。按照上面提供的方法，我们先使用`requests`获取到网页的HTML代码，然后将整个代码看成一个长字符串，这样我们就可以使用正则表达式的捕获组从字符串提取我们需要的内容。下面的代码演示了如何从[豆瓣电影](https://movie.douban.com/)获取排前250名的电影的名称。[豆瓣电影Top250](https://movie.douban.com/top250)的页面结构和对应代码如下图所示，可以看出，每页共展示了25部电影，如果要获取到 Top250 数据，我们共需要访问10个页面，对应的地址是，这里的`xxx`如果为`0`就是第一页，如果`xxx`的值是`100`，那么我们可以访问到第五页。为了代码简单易读，我们只获取电影的标题和评分。 + +![](https://gitee.com/jackfrued/mypic/raw/master/20210822093447.png) + +```Python +import random +import re +import time + +import requests + +for page in range(1, 11): + resp = requests.get( + url=f'https://movie.douban.com/top250?start={(page - 1) * 25}', + # 如果不设置HTTP请求头中的User-Agent，豆瓣会检测出不是浏览器而阻止我们的请求。 + # 通过get函数的headers参数设置User-Agent的值，具体的值可以在浏览器的开发者工具查看到。 + # 用爬虫访问大部分网站时，将爬虫伪装成来自浏览器的请求都是非常重要的一步。 + headers={'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36'} + ) + # 通过正则表达式获取class属性为title且标签体不以&开头的span标签并用捕获组提取标签内容 + pattern1 = re.compile(r'([^&]*?)') + titles = pattern1.findall(resp.text) + # 通过正则表达式获取class属性为rating_num的span标签并用捕获组提取标签内容 + pattern2 = re.compile(r'(.*?)') + ranks = pattern2.findall(resp.text) + # 使用zip压缩两个列表，循环遍历所有的电影标题和评分 + for title, rank in zip(titles, ranks): + print(title, rank) + # 随机休眠1-5秒，避免爬取页面过于频繁 + time.sleep(random.random() * 4 + 1) +``` + +> **说明**：通过分析豆瓣网的robots协议，我们发现豆瓣网并不拒绝百度爬虫获取它的数据，因此我们也可以将爬虫伪装成百度的爬虫，将`get`函数的`headers`参数修改为：`headers={'User-Agent': 'BaiduSpider'}`。 + +### 使用 IP 代理 + +让爬虫程序隐匿自己的身份对编写爬虫程序来说是比较重要的，很多网站对爬虫都比较反感的，因为爬虫会耗费掉它们很多的网络带宽并制造很多无效的流量。要隐匿身份通常需要使用**商业 IP 代理**（如蘑菇代理、芝麻代理、快代理等），让被爬取的网站无法获取爬虫程序来源的真实 IP 地址，也就无法简单的通过 IP 地址对爬虫程序进行封禁。 + +下面以[蘑菇代理](http://www.moguproxy.com/)为例，为大家讲解商业 IP 代理的使用方法。首先需要在该网站注册一个账号，注册账号后就可以[购买](http://www.moguproxy.com/buy)相应的套餐来获得商业 IP 代理。作为商业用途，建议大家购买不限量套餐，这样可以根据实际需要获取足够多的代理 IP 地址；作为学习用途，可以购买包时套餐或根据自己的需求来决定。蘑菇代理提供了两种接入代理的方式，分别是 API 私密代理和 HTTP 隧道代理，前者是通过请求蘑菇代理的 API 接口获取代理服务器地址，后者是直接使用统一的入口（蘑菇代理提供的域名）进行接入。 + + + +下面，我们以HTTP隧道代理为例，为大家讲解接入 IP 代理的方式，大家也可以直接参考蘑菇代理官网提供的代码来为爬虫设置代理。 + +```Python +import requests + +APP_KEY = 'Wnp******************************XFx' +PROXY_HOST = 'secondtransfer.moguproxy.com:9001' + +for page in range(1, 11): + resp = requests.get( + url=f'https://movie.douban.com/top250?start={(page - 1) * 25}', + # 需要在HTTP请求头设置代理的身份认证方式 + headers={ + 'Proxy-Authorization': f'Basic {APP_KEY}', + 'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36', + 'Accept-Language': 'zh-CN,zh;q=0.8,en-US;q=0.6,en;q=0.4' + }, + # 设置代理服务器 + proxies={ + 'http': f'http://{PROXY_HOST}', + 'https': f'https://{PROXY_HOST}' + }, + verify=False + ) + pattern1 = re.compile(r'([^&]*?)') + titles = pattern1.findall(resp.text) + pattern2 = re.compile(r'(.*?)') + ranks = pattern2.findall(resp.text) + for title, rank in zip(titles, ranks): + print(title, rank) +``` + +> **说明**：上面的代码需要修改`APP_KEY`为自己创建的订单对应的`Appkey`值，这个值可以在用户中心用户订单中查看到。蘑菇代理提供了免费的 API 代理和 HTTP 隧道代理试用，但是试用的代理接通率不能保证，建议大家还是直接购买一个在自己支付能力范围内的代理服务来体验。 + +### 简单的总结 + +Python 语言能做的事情真的很多，就网络数据采集这一项而言，Python 几乎是一枝独秀的，大量的企业和个人都在使用 Python 从网络上获取自己需要的数据，这可能也是你将来日常工作的一部分。另外，用编写正则表达式的方式从网页中提取内容虽然可行，但是写出一个能够满足需求的正则表达式本身也不是件容易的事情，这一点对于新手来说尤为明显。在下一节课中，我们将会为大家介绍另外两种从页面中提取数据的方法，虽然从性能上来讲，它们可能不如正则表达式，但是却降低了编码的复杂性，相信大家会喜欢上它们的。 diff --git "a/\347\254\25433\350\257\276\357\274\232\347\224\250Python\350\247\243\346\236\220HTML\351\241\265\351\235\242.md" "b/\347\254\25433\350\257\276\357\274\232\347\224\250Python\350\247\243\346\236\220HTML\351\241\265\351\235\242.md" new file mode 100644 index 0000000..b357bcb --- /dev/null +++ "b/\347\254\25433\350\257\276\357\274\232\347\224\250Python\350\247\243\346\236\220HTML\351\241\265\351\235\242.md" @@ -0,0 +1,149 @@ +## 第33课：用Python解析HTML页面 + +在前面的课程中，我们讲到了使用`request`三方库获取网络资源，还介绍了一些前端的基础知识。接下来，我们继续探索如何解析 HTML 代码，从页面中提取出有用的信息。之前，我们尝试过用正则表达式的捕获组操作提取页面内容，但是写出一个正确的正则表达式也是一件让人头疼的事情。为了解决这个问题，我们得先深入的了解一下 HTML 页面的结构，并在此基础上研究另外的解析页面的方法。 + +### HTML 页面的结构 + +我们在浏览器中打开任意一个网站，然后通过鼠标右键菜单，选择“显示网页源代码”菜单项，就可以看到网页对应的 HTML 代码。 + +![image-20210822094218269](https://gitee.com/jackfrued/mypic/raw/master/20210822094218.png) + +代码的第`1`行是文档类型声明，第`2`行的``标签是整个页面根标签的开始标签，最后一行是根标签的结束标签``。``标签下面有两个子标签``和``，放在``标签下的内容会显示在浏览器窗口中，这部分内容是网页的主体；放在``标签下的内容不会显示在浏览器窗口中，但是却包含了页面重要的元信息，通常称之为网页的头部。HTML 页面大致的代码结构如下所示。 + +```HTML + + + + + + + + + +``` + +标签、层叠样式表（CSS）、JavaScript 是构成 HTML 页面的三要素，其中标签用来承载页面要显示的内容，CSS 负责对页面的渲染，而 JavaScript 用来控制页面的交互式行为。要实现 HTML 页面的解析，可以使用 XPath 的语法，它原本是 XML 的一种查询语法，可以根据 HTML 标签的层次结构提取标签中的内容或标签属性；此外，也可以使用 CSS 选择器来定位页面元素，就跟用 CSS 渲染页面元素是同样的道理。 + +### XPath 解析 + +XPath 是在 XML（eXtensible Markup Language）文档中查找信息的一种语法，XML 跟 HTML 类似也是一种用标签承载数据的标签语言，不同之处在于 XML 的标签是可扩展的，可以自定义的，而且 XML 对语法有更严格的要求。XPath 使用路径表达式来选取 XML 文档中的节点或者节点集，这里所说的节点包括元素、属性、文本、命名空间、处理指令、注释、根节点等。下面我们通过一个例子来说明如何使用 XPath 对页面进行解析。 + +```XML + + + + Harry Potter + 29.99 + + + Learning XML + 39.95 + + +``` + +对于上面的 XML 文件，我们可以用如下所示的 XPath 语法获取文档中的节点。 + +| 路径表达式 | 结果 | +| --------------- | ------------------------------------------------------------ | +| `/bookstore` | 选取根元素 bookstore。**注意**：假如路径起始于正斜杠( / )，则此路径始终代表到某元素的绝对路径！ | +| `//book` | 选取所有 book 子元素，而不管它们在文档中的位置。 | +| `//@lang` | 选取名为 lang 的所有属性。 | +| `/bookstore/book[1]` | 选取属于 bookstore 子元素的第一个 book 元素。 | +| `/bookstore/book[last()]` | 选取属于 bookstore 子元素的最后一个 book 元素。 | +| `/bookstore/book[last()-1]` | 选取属于 bookstore 子元素的倒数第二个 book 元素。 | +| `/bookstore/book[position()<3]` | 选取最前面的两个属于 bookstore 元素的子元素的 book 元素。 | +| `//title[@lang]` | 选取所有拥有名为 lang 的属性的 title 元素。 | +| `//title[@lang='eng']` | 选取所有 title 元素，且这些元素拥有值为 eng 的 lang 属性。 | +| `/bookstore/book[price>35.00]` | 选取 bookstore 元素的所有 book 元素，且其中的 price 元素的值须大于 35.00。 | +| `/bookstore/book[price>35.00]/title` | 选取 bookstore 元素中的 book 元素的所有 title 元素，且其中的 price 元素的值须大于 35.00。 | + +XPath还支持通配符用法，如下所示。 + +| 路径表达式 | 结果 | +| -------------- | --------------------------------- | +| `/bookstore/*` | 选取 bookstore 元素的所有子元素。 | +| `//*` | 选取文档中的所有元素。 | +| `//title[@*]` | 选取所有带有属性的 title 元素。 | + +如果要选取多个节点，可以使用如下所示的方法。 + +| 路径表达式 | 结果 | +| ---------------------------------- | ------------------------------------------------------------ | +| `//book/title \| //book/price` | 选取 book 元素的所有 title 和 price 元素。 | +| `//title \| //price` | 选取文档中的所有 title 和 price 元素。 | +| `/bookstore/book/title \| //price` | 选取属于 bookstore 元素的 book 元素的所有 title 元素，以及文档中所有的 price 元素。 | + +> **说明**：上面的例子来自于“菜鸟教程”网站上的 [XPath 教程]()，有兴趣的读者可以自行阅读原文。 + +当然，如果不理解或不熟悉 XPath 语法，可以在浏览器的开发者工具中按照如下所示的方法查看元素的 XPath 语法，下图是在 Chrome 浏览器的开发者工具中查看豆瓣网电影详情信息中影片标题的 XPath 语法。 + +![](https://gitee.com/jackfrued/mypic/raw/master/20210822093707.png) + +实现 XPath 解析需要三方库`lxml` 的支持，可以使用下面的命令安装`lxml`。 + +```Bash +pip install lxml +``` + +下面我们用 XPath 解析方式改写之前获取豆瓣电影 Top250的代码，如下所示。 + +```Python +from lxml import etree +import requests + +for page in range(1, 11): + resp = requests.get( + url=f'https://movie.douban.com/top250?start={(page - 1) * 25}', + headers={'User-Agent': 'BaiduSpider'} + ) + tree = etree.HTML(resp.text) + # 通过XPath语法从页面中提取电影标题 + title_spans = tree.xpath('//*[@id="content"]/div/div[1]/ol/li/div/div[2]/div[1]/a/span[1]') + # 通过XPath语法从页面中提取电影评分 + rank_spans = tree.xpath('//*[@id="content"]/div/div[1]/ol/li[1]/div/div[2]/div[2]/div/span[2]') + for title_span, rank_span in zip(title_spans, rank_spans): + print(title_span.text, rank_span.text) +``` + +### CSS 选择器解析 + +对于熟悉 CSS 选择器和 JavaScript 的开发者来说，通过 CSS 选择器获取页面元素可能是更为简单的选择，因为浏览器中运行的 JavaScript 本身就可以`document`对象的`querySelector()`和`querySelectorAll()`方法基于 CSS 选择器获取页面元素。在 Python 中，我们可以利用三方库`beautifulsoup4`或`pyquery`来做同样的事情。Beautiful Soup 可以用来解析 HTML 和 XML 文档，修复含有未闭合标签等错误的文档，通过为待解析的页面在内存中创建一棵树结构，实现对从页面中提取数据操作的封装。可以用下面的命令来安装 Beautiful Soup。 + +```Python +pip install beautifulsoup4 +``` + +下面是使用`bs4`改写的获取豆瓣电影Top250电影名称的代码。 + +```Python +import bs4 +import requests + +for page in range(1, 11): + resp = requests.get( + url=f'https://movie.douban.com/top250?start={(page - 1) * 25}', + headers={'User-Agent': 'BaiduSpider'} + ) + # 创建BeautifulSoup对象 + soup = bs4.BeautifulSoup(resp.text, 'lxml') + # 通过CSS选择器从页面中提取包含电影标题的span标签 + title_spans = soup.select('div.info > div.hd > a > span:nth-child(1)') + # 通过CSS选择器从页面中提取包含电影评分的span标签 + rank_spans = soup.select('div.info > div.bd > div > span.rating_num') + for title_span, rank_span in zip(title_spans, rank_spans): + print(title_span.text, rank_span.text) +``` + +关于 BeautifulSoup 更多的知识，可以参考它的[官方文档](https://www.crummy.com/software/BeautifulSoup/bs4/doc.zh/)。 + +### 简单的总结 + +下面我们对三种解析方式做一个简单比较。 + +| 解析方式 | 对应的模块 | 速度 | 使用难度 | +| -------------- | ---------------- | ------ | -------- | +| 正则表达式解析 | `re` | 快 | 困难 | +| XPath 解析 | `lxml` | 快 | 一般 | +| CSS 选择器解析 | `bs4`或`pyquery` | 不确定 | 简单 | + diff --git "a/\347\254\25434\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-1.md" "b/\347\254\25434\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-1.md" new file mode 100644 index 0000000..1183e14 --- /dev/null +++ "b/\347\254\25434\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-1.md" @@ -0,0 +1,382 @@ +## 第34课：Python中的并发编程-1 + +现如今，我们使用的计算机早已是多 CPU 或多核的计算机，而我们使用的操作系统基本都支持“多任务”，这使得我们可以同时运行多个程序，也可以将一个程序分解为若干个相对独立的子任务，让多个子任务“并行”或“并发”的执行，从而缩短程序的执行时间，同时也让用户获得更好的体验。因此当下，不管用什么编程语言进行开发，实现“并行”或“并发”编程已经成为了程序员的标配技能。为了讲述如何在 Python 程序中实现“并行”或“并发”，我们需要先了解两个重要的概念：进程和线程。 + +### 线程和进程 + +我们通过操作系统运行一个程序会创建出一个或多个进程，进程是具有一定独立功能的程序关于某个数据集合上的一次运行活动。简单的说，进程是操作系统分配存储空间的基本单位，每个进程都有自己的地址空间、数据栈以及其他用于跟踪进程执行的辅助数据；操作系统管理所有进程的执行，为它们合理的分配资源。一个进程可以通过 fork 或 spawn 的方式创建新的进程来执行其他的任务，不过新的进程也有自己独立的内存空间，因此两个进程如果要共享数据，必须通过进程间通信机制来实现，具体的方式包括管道、信号、套接字等。 + +一个进程还可以拥有多个执行线索，简单的说就是拥有多个可以获得 CPU 调度的执行单元，这就是所谓的线程。由于线程在同一个进程下，它们可以共享相同的上下文，因此相对于进程而言，线程间的信息共享和通信更加容易。当然在单核 CPU 系统中，多个线程不可能同时执行，因为在某个时刻只有一个线程能够获得 CPU，多个线程通过共享 CPU 执行时间的方式来达到并发的效果。 + +在程序中使用多线程技术通常都会带来不言而喻的好处，最主要的体现在提升程序的性能和改善用户体验，今天我们使用的软件几乎都用到了多线程技术，这一点可以利用系统自带的进程监控工具（如 macOS 中的“活动监视器”、Windows 中的“任务管理器”）来证实，如下图所示。 + + + +这里，我们还需要跟大家再次强调两个概念：**并发**（concurrency）和**并行**（parallel）。**并发**通常是指同一时刻只能有一条指令执行，但是多个线程对应的指令被快速轮换地执行。比如一个处理器，它先执行线程 A 的指令一段时间，再执行线程 B 的指令一段时间，再切回到线程 A 执行一段时间。由于处理器执行指令的速度和切换的速度极快，人们完全感知不到计算机在这个过程中有多个线程切换上下文执行的操作，这就使得宏观上看起来多个线程在同时运行，但微观上其实只有一个线程在执行。**并行**是指同一时刻，有多条指令在多个处理器上同时执行，并行必须要依赖于多个处理器，不论是从宏观上还是微观上，多个线程可以在同一时刻一起执行的。很多时候，我们并不用严格区分并发和并行两个词，所以我们有时候也把 Python 中的多线程、多进程以及异步 I/O 都视为实现并发编程的手段，但实际上前面两者也可以实现并行编程，当然这里还有一个全局解释器锁（GIL）的问题，我们稍后讨论。 + +### 多线程编程 + +Python 标准库中`threading`模块的`Thread`类可以帮助我们非常轻松的实现多线程编程。我们用一个联网下载文件的例子来对比使用多线程和不使用多线程到底有什么区别，代码如下所示。 + +不使用多线程的下载。 + +```Python +import random +import time + + +def download(*, filename): + start = time.time() + print(f'开始下载 {filename}.') + time.sleep(random.randint(3, 6)) + print(f'{filename} 下载完成.') + end = time.time() + print(f'下载耗时: {end - start:.3f}秒.') + + +def main(): + start = time.time() + download(filename='Python从入门到住院.pdf') + download(filename='MySQL从删库到跑路.avi') + download(filename='Linux从精通到放弃.mp4') + end = time.time() + print(f'总耗时: {end - start:.3f}秒.') + + +if __name__ == '__main__': + main() +``` + +> **说明**：上面的代码并没有真正实现联网下载的功能，而是通过`time.sleep()`休眠一段时间来模拟下载文件需要一些时间上的开销，跟实际下载的状况比较类似。 + +运行上面的代码，可以得到如下所示的运行结果。可以看出，当我们的程序只有一个工作线程时，每个下载任务都需要等待上一个下载任务执行结束才能开始，所以程序执行的总耗时是三个下载任务各自执行时间的总和。 + +``` +开始下载Python从入门到住院.pdf. +Python从入门到住院.pdf下载完成. +下载耗时: 3.005秒. +开始下载MySQL从删库到跑路.avi. +MySQL从删库到跑路.avi下载完成. +下载耗时: 5.006秒. +开始下载Linux从精通到放弃.mp4. +Linux从精通到放弃.mp3下载完成. +下载耗时: 6.007秒. +总耗时: 14.018秒. +``` + +事实上，上面的三个下载任务之间并没有逻辑上的因果关系，三者是可以“并发”的，下一个下载任务没有必要等待上一个下载任务结束，为此，我们可以使用多线程编程来改写上面的代码。 + +```Python +import random +import time +from threading import Thread + + +def download(*, filename): + start = time.time() + print(f'开始下载 {filename}.') + time.sleep(random.randint(3, 6)) + print(f'{filename} 下载完成.') + end = time.time() + print(f'下载耗时: {end - start:.3f}秒.') + + +def main(): + threads = [ + Thread(target=download, kwargs={'filename': 'Python从入门到住院.pdf'}), + Thread(target=download, kwargs={'filename': 'MySQL从删库到跑路.avi'}), + Thread(target=download, kwargs={'filename': 'Linux从精通到放弃.mp4'}) + ] + start = time.time() + # 启动三个线程 + for thread in threads: + thread.start() + # 等待线程结束 + for thread in threads: + thread.join() + end = time.time() + print(f'总耗时: {end - start:.3f}秒.') + + +if __name__ == '__main__': + main() +``` + +某次的运行结果如下所示。 + +``` +开始下载 Python从入门到住院.pdf. +开始下载 MySQL从删库到跑路.avi. +开始下载 Linux从精通到放弃.mp4. +MySQL从删库到跑路.avi 下载完成. +下载耗时: 3.005秒. +Python从入门到住院.pdf 下载完成. +下载耗时: 5.006秒. +Linux从精通到放弃.mp4 下载完成. +下载耗时: 6.003秒. +总耗时: 6.004秒. +``` + +通过上面的运行结果可以发现，整个程序的执行时间几乎等于耗时最长的一个下载任务的执行时间，这也就意味着，三个下载任务是并发执行的，不存在一个等待另一个的情况，这样做很显然提高了程序的执行效率。简单的说，如果程序中有非常耗时的执行单元，而这些耗时的执行单元之间又没有逻辑上的因果关系，即 B 单元的执行不依赖于 A 单元的执行结果，那么 A 和 B 两个单元就可以放到两个不同的线程中，让他们并发的执行。这样做的好处除了减少程序执行的等待时间，还可以带来更好的用户体验，因为一个单元的阻塞不会造成程序的“假死”，因为程序中还有其他的单元是可以运转的。 + +#### 使用 Thread 类创建线程对象 + +通过上面的代码可以看出，直接使用`Thread`类的构造器就可以创建线程对象，而线程对象的`start()`方法可以启动一个线程。线程启动后会执行`target`参数指定的函数，当然前提是获得 CPU 的调度；如果`target`指定的线程要执行的目标函数有参数，需要通过`args`参数为其进行指定，对于关键字参数，可以通过`kwargs`参数进行传入。`Thread`类的构造器还有很多其他的参数，我们遇到的时候再为大家进行讲解，目前需要大家掌握的，就是`target`、`args`和`kwargs`。 + +#### 继承 Thread 类自定义线程 + +除了上面的代码展示的创建线程的方式外，还可以通过继承`Thread`类并重写`run()`方法的方式来自定义线程，具体的代码如下所示。 + +```Python +import random +import time +from threading import Thread + + +class DownloadThread(Thread): + + def __init__(self, filename): + self.filename = filename + super().__init__() + + def run(self): + start = time.time() + print(f'开始下载 {self.filename}.') + time.sleep(random.randint(3, 6)) + print(f'{self.filename} 下载完成.') + end = time.time() + print(f'下载耗时: {end - start:.3f}秒.') + + +def main(): + threads = [ + DownloadThread('Python从入门到住院.pdf'), + DownloadThread('MySQL从删库到跑路.avi'), + DownloadThread('Linux从精通到放弃.mp4') + ] + start = time.time() + # 启动三个线程 + for thread in threads: + thread.start() + # 等待线程结束 + for thread in threads: + thread.join() + end = time.time() + print(f'总耗时: {end - start:.3f}秒.') + + +if __name__ == '__main__': + main() +``` + +#### 使用线程池 + +我们还可以通过线程池的方式将任务放到多个线程中去执行，通过线程池来使用线程应该是多线程编程最理想的选择。事实上，线程的创建和释放都会带来较大的开销，频繁的创建和释放线程通常都不是很好的选择。利用线程池，可以提前准备好若干个线程，在使用的过程中不需要再通过自定义的代码创建和释放线程，而是直接复用线程池中的线程。Python 内置的`concurrent.futures`模块提供了对线程池的支持，代码如下所示。 + +```Python +import random +import time +from concurrent.futures import ThreadPoolExecutor +from threading import Thread + + +def download(*, filename): + start = time.time() + print(f'开始下载 {filename}.') + time.sleep(random.randint(3, 6)) + print(f'{filename} 下载完成.') + end = time.time() + print(f'下载耗时: {end - start:.3f}秒.') + + +def main(): + with ThreadPoolExecutor(max_workers=4) as pool: + filenames = ['Python从入门到住院.pdf', 'MySQL从删库到跑路.avi', 'Linux从精通到放弃.mp4'] + start = time.time() + for filename in filenames: + pool.submit(download, filename=filename) + end = time.time() + print(f'总耗时: {end - start:.3f}秒.') + + +if __name__ == '__main__': + main() +``` + +### 守护线程 + +所谓“守护线程”就是在主线程结束的时候，不值得再保留的执行线程。这里的不值得保留指的是守护线程会在其他非守护线程全部运行结束之后被销毁，它守护的是当前进程内所有的非守护线程。简单的说，守护线程会跟随主线程一起挂掉，而主线程的生命周期就是一个进程的生命周期。如果不理解，我们可以看一段简单的代码。 + +```Python +import time +from threading import Thread + + +def display(content): + while True: + print(content, end='', flush=True) + time.sleep(0.1) + + +def main(): + Thread(target=display, args=('Ping', )).start() + Thread(target=display, args=('Pong', )).start() + + +if __name__ == '__main__': + main() +``` + +> **说明**：上面的代码中，我们将`print`函数的参数`flush`设置为`True`，这是因为`flush`参数的值如果为`False`，而`print`又没有做换行处理，就会导致每次`print`输出的内容被放到操作系统的输出缓冲区，直到缓冲区被输出的内容塞满，才会清空缓冲区产生一次输出。上述现象是操作系统为了减少 I/O 中断，提升 CPU 利用率做出的设定，为了让代码产生直观交互，我们才将`flush`参数设置为`True`，强制每次输出都清空输出缓冲区。 + +上面的代码运行起来之后是不会停止的，因为两个子线程中都有死循环，除非你手动中断代码的执行。但是，如果在创建线程对象时，将名为`daemon`的参数设置为`True`，这两个线程就会变成守护线程，那么在其他线程结束时，即便有死循环，两个守护线程也会挂掉，不会再继续执行下去，代码如下所示。 + + ```Python + import time + from threading import Thread + + + def display(content): + while True: + print(content, end='', flush=True) + time.sleep(0.1) + + + def main(): + Thread(target=display, args=('Ping', ), daemon=True).start() + Thread(target=display, args=('Pong', ), daemon=True).start() + time.sleep(5) + + + if __name__ == '__main__': + main() + ``` + +上面的代码，我们在主线程中添加了一行`time.sleep(5)`让主线程休眠5秒，在这个过程中，输出`Ping`和`Pong`的守护线程会持续运转，直到主线程在5秒后结束，这两个守护线程也被销毁，不再继续运行。 + +> **思考**：如果将上面代码第12行的`daemon=True`去掉，代码会怎样执行？有兴趣的读者可以尝试一下，并看看实际执行的结果跟你想象的是否一致。 + +### 资源竞争 + +在编写多线程代码时，不可避免的会遇到多个线程竞争同一个资源（对象）的情况。在这种情况下，如果没有合理的机制来保护被竞争的资源，那么就有可能出现非预期的状况。下面的代码创建了`100`个线程向同一个银行账户（初始余额为`0`元）转账，每个线程转账金额为`1`元。在正常的情况下，我们的银行账户最终的余额应该是`100`元，但是运行下面的代码我们并不能得到`100`元这个结果。 + +```Python +import time + +from concurrent.futures import ThreadPoolExecutor + + +class Account(object): + """银行账户""" + + def __init__(self): + self.balance = 0.0 + + def deposit(self, money): + """存钱""" + new_balance = self.balance + money + time.sleep(0.01) + self.balance = new_balance + + +def main(): + """主函数""" + account = Account() + with ThreadPoolExecutor(max_workers=16) as pool: + for _ in range(100): + pool.submit(account.deposit, 1) + print(account.balance) + + +if __name__ == '__main__': + main() +``` + +上面代码中的`Account`类代表了银行账户，它的`deposit`方法代表存款行为，参数`money`代表存入的金额，该方法通过`time.sleep`函数模拟受理存款需要一段时间。我们通过线程池的方式启动了`100`个线程向一个账户转账，但是上面的代码并不能运行出`100`这个我们期望的结果，这就是在多个线程竞争一个资源的时候，可能会遇到的数据不一致的问题。注意上面代码的第`14`行，当多个线程都执行到这行代码时，它们会在相同的余额上执行加上存入金额的操作，这就会造成“丢失更新”现象，即之前修改数据的成果被后续的修改给覆盖掉了，所以才得不到正确的结果。 + +要解决上面的问题，可以使用锁机制，通过锁对操作数据的关键代码加以保护。Python 标准库的`threading`模块提供了`Lock`和`RLock`类来支持锁机制，这里我们不去深究二者的区别，建议大家直接使用`RLock`。接下来，我们给银行账户添加一个锁对象，通过锁对象来解决刚才存款时发生“丢失更新”的问题，代码如下所示。 + +```Python +import time + +from concurrent.futures import ThreadPoolExecutor +from threading import RLock + + +class Account(object): + """银行账户""" + + def __init__(self): + self.balance = 0.0 + self.lock = RLock() + + def deposit(self, money): + # 获得锁 + self.lock.acquire() + try: + new_balance = self.balance + money + time.sleep(0.01) + self.balance = new_balance + finally: + # 释放锁 + self.lock.release() + + +def main(): + """主函数""" + account = Account() + with ThreadPoolExecutor(max_workers=16) as pool: + for _ in range(100): + pool.submit(account.deposit, 1) + print(account.balance) + + +if __name__ == '__main__': + main() +``` + +上面代码中，获得锁和释放锁的操作也可以通过上下文语法来实现，使用上下文语法会让代码更加简单优雅，这也是我们推荐大家使用的方式。 + +```Python +import time + +from concurrent.futures import ThreadPoolExecutor +from threading import RLock + + +class Account(object): + """银行账户""" + + def __init__(self): + self.balance = 0.0 + self.lock = RLock() + + def deposit(self, money): + # 通过上下文语法获得锁和释放锁 + with self.lock: + new_balance = self.balance + money + time.sleep(0.01) + self.balance = new_balance + + +def main(): + """主函数""" + account = Account() + with ThreadPoolExecutor(max_workers=16) as pool: + for _ in range(100): + pool.submit(account.deposit, 1) + print(account.balance) + + +if __name__ == '__main__': + main() +``` + +> **思考**：将上面的代码修改为5个线程向银行账户存钱，5个线程从银行账户取钱，取钱的线程在银行账户余额不足时，需要停下来等待存钱的线程将钱存入后再尝试取钱。这里需要用到线程调度的知识，大家可以自行研究下`threading`模块中的`Condition`类，看看是否能够完成这个任务。 + +### GIL问题 + +如果使用官方的 Python 解释器（通常称之为 CPython）运行 Python 程序，我们并不能通过使用多线程的方式将 CPU 的利用率提升到逼近400%（对于4核 CPU）或逼近800%（对于8核 CPU）这样的水平，因为 CPython 在执行代码时，会受到 GIL（全局解释器锁）的限制。具体的说，CPython 在执行任何代码时，都需要对应的线程先获得 GIL，然后每执行100条（字节码）指令，CPython 就会让获得 GIL 的线程主动释放 GIL，这样别的线程才有机会执行。因为 GIL 的存在，无论你的 CPU 有多少个核，我们编写的 Python 代码也没有机会真正并行的执行。 + +GIL 是官方 Python 解释器在设计上的历史遗留问题，要解决这个问题，让多线程能够发挥 CPU 的多核优势，需要重新实现一个不带 GIL 的 Python 解释器。这个问题按照官方的说法，在 Python 发布4.0版本时会得到解决，就让我们拭目以待吧。当下，对于 CPython 而言，如果希望充分发挥 CPU 的多核优势，可以考虑使用多进程，因为每个进程都对应一个 Python 解释器，因此每个进程都有自己独立的 GIL，这样就可以突破 GIL 的限制。在下一个章节中，我们会为大家介绍关于多进程的相关知识，并对多线程和多进程的代码及其执行效果进行比较。 + diff --git "a/\347\254\25435\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-2.md" "b/\347\254\25435\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-2.md" new file mode 100644 index 0000000..439a9bc --- /dev/null +++ "b/\347\254\25435\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-2.md" @@ -0,0 +1,254 @@ +## 第35课：Python中的并发编程-2 + +在上一课中我们说过，由于 GIL 的存在，CPython 中的多线程并不能发挥 CPU 的多核优势，如果希望突破 GIL 的限制，可以考虑使用多进程。对于多进程的程序，每个进程都有一个属于自己的 GIL，所以多进程不会受到 GIL 的影响。那么，我们应该如何在 Python 程序中创建和使用多进程呢？ + +###创建进程 + +在 Python 中可以基于`Process`类来创建进程，虽然进程和线程有着本质的差别，但是`Process`类和`Thread`类的用法却非常类似。在使用`Process`类的构造器创建对象时，也是通过`target`参数传入一个函数来指定进程要执行的代码，而`args`和`kwargs`参数可以指定该函数使用的参数值。 + +```Python +from multiprocessing import Process, current_process +from time import sleep + + +def sub_task(content, nums): + # 通过current_process函数获取当前进程对象 + # 通过进程对象的pid和name属性获取进程的ID号和名字 + print(f'PID: {current_process().pid}') + print(f'Name: {current_process().name}') + # 通过下面的输出不难发现，每个进程都有自己的nums列表，进程之间本就不共享内存 + # 在创建子进程时复制了父进程的数据结构，三个进程从列表中pop(0)得到的值都是20 + counter, total = 0, nums.pop(0) + print(f'Loop count: {total}') + sleep(0.5) + while counter < total: + counter += 1 + print(f'{counter}: {content}') + sleep(0.01) + + +def main(): + nums = [20, 30, 40] + # 创建并启动进程来执行指定的函数 + Process(target=sub_task, args=('Ping', nums)).start() + Process(target=sub_task, args=('Pong', nums)).start() + # 在主进程中执行sub_task函数 + sub_task('Good', nums) + + +if __name__ == '__main__': + main() +``` + +> **说明**：上面的代码通过`current_process`函数获取当前进程对象，再通过进程对象的`pid`属性获取进程ID。在 Python 中，使用`os`模块的`getpid`函数也可以达到同样的效果。 + +如果愿意，也可以使用`os`模块的`fork`函数来创建进程，调用该函数时，操作系统自动把当前进程（父进程）复制一份（子进程），父进程的`fork`函数会返回子进程的ID，而子进程中的`fork`函数会返回`0`，也就是说这个函数调用一次会在父进程和子进程中得到两个不同的返回值。需要注意的是，Windows 系统并不支持`fork`函数，如果你使用的是 Linux 或 macOS 系统，可以试试下面的代码。 + +```Python +import os + +print(f'PID: {os.getpid()}') +pid = os.fork() +if pid == 0: + print(f'子进程 - PID: {os.getpid()}') + print('Todo: 在子进程中执行的代码') +else: + print(f'父进程 - PID: {os.getpid()}') + print('Todo: 在父进程中执行的代码') +``` + +简而言之，我们还是推荐大家通过直接使用`Process`类、继承`Process`类和使用进程池（`ProcessPoolExecutor`）这三种方式来创建和使用多进程，这三种方式不同于上面的`fork`函数，能够保证代码的兼容性和可移植性。具体的做法跟之前讲过的创建和使用多线程的方式比较接近，此处不再进行赘述。 + +### 多进程和多线程的比较 + +对于爬虫这类 I/O 密集型任务来说，使用多进程并没有什么优势；但是对于计算密集型任务来说，多进程相比多线程，在效率上会有显著的提升，我们可以通过下面的代码来加以证明。下面的代码会通过多线程和多进程两种方式来判断一组大整数是不是质数，很显然这是一个计算密集型任务，我们将任务分别放到多个线程和多个进程中来加速代码的执行，让我们看看多线程和多进程的代码具体表现有何不同。 + +我们先实现一个多线程的版本，代码如下所示。 + +```Python +import concurrent.futures + +PRIMES = [ + 1116281, + 1297337, + 104395303, + 472882027, + 533000389, + 817504243, + 982451653, + 112272535095293, + 112582705942171, + 112272535095293, + 115280095190773, + 115797848077099, + 1099726899285419 +] * 5 + + +def is_prime(n): + """判断素数""" + for i in range(2, int(n ** 0.5) + 1): + if n % i == 0: + return False + return n != 1 + + +def main(): + """主函数""" + with concurrent.futures.ThreadPoolExecutor(max_workers=16) as executor: + for number, prime in zip(PRIMES, executor.map(is_prime, PRIMES)): + print('%d is prime: %s' % (number, prime)) + + +if __name__ == '__main__': + main() +``` + +假设上面的代码保存在名为`example.py`的文件中，在 Linux 或 macOS 系统上，可以使用`time python example.py`命令执行程序并获得操作系统关于执行时间的统计，在我的 macOS 上，某次的运行结果的最后一行输出如下所示。 + +``` +python example09.py 38.69s user 1.01s system 101% cpu 39.213 total +``` + +从运行结果可以看出，多线程的代码只能让 CPU 利用率达到100%，这其实已经证明了多线程的代码无法利用 CPU 多核特性来加速代码的执行，我们再看看多进程的版本，我们将上面代码中的线程池（`ThreadPoolExecutor`）更换为进程池（`ProcessPoolExecutor`）。 + +多进程的版本。 + +```Python +import concurrent.futures + +PRIMES = [ + 1116281, + 1297337, + 104395303, + 472882027, + 533000389, + 817504243, + 982451653, + 112272535095293, + 112582705942171, + 112272535095293, + 115280095190773, + 115797848077099, + 1099726899285419 +] * 5 + + +def is_prime(n): + """判断素数""" + for i in range(2, int(n ** 0.5) + 1): + if n % i == 0: + return False + return n != 1 + + +def main(): + """主函数""" + with concurrent.futures.ProcessPoolExecutor(max_workers=16) as executor: + for number, prime in zip(PRIMES, executor.map(is_prime, PRIMES)): + print('%d is prime: %s' % (number, prime)) + + +if __name__ == '__main__': + main() +``` + +> **提示**：运行上面的代码时，可以通过操作系统的任务管理器（资源监视器）来查看是否启动了多个 Python 解释器进程。 + +我们仍然通过`time python example.py`的方式来执行上述代码，运行结果的最后一行如下所示。 + +``` +python example09.py 106.63s user 0.57s system 389% cpu 27.497 total +``` + +可以看出，多进程的版本在我使用的这台电脑上，让 CPU 的利用率达到了将近400%，而运行代码时用户态耗费的 CPU 的时间（106.63秒）几乎是代码运行总时间（27.497秒）的4倍，从这两点都可以看出，我的电脑使用了一款4核的 CPU。当然，要知道自己的电脑有几个 CPU 或几个核，可以直接使用下面的代码。 + +```Python +import os + +print(os.cpu_count()) +``` + +综上所述，多进程可以突破 GIL 的限制，充分利用 CPU 多核特性，对于计算密集型任务，这一点是相当重要的。常见的计算密集型任务包括科学计算、图像处理、音视频编解码等，如果这些计算密集型任务本身是可以并行的，那么使用多进程应该是更好的选择。 + +### 进程间通信 + +在讲解进程间通信之前，先给大家一个任务：启动两个进程，一个输出“Ping”，一个输出“Pong”，两个进程输出的“Ping”和“Pong”加起来一共有50个时，就结束程序。听起来是不是非常简单，但是实际编写代码时，由于多个进程之间不能够像多个线程之间直接通过共享内存的方式交换数据，所以下面的代码是达不到我们想要的结果的。 + +```Python +from multiprocessing import Process +from time import sleep + +counter = 0 + + +def sub_task(string): + global counter + while counter < 50: + print(string, end='', flush=True) + counter += 1 + sleep(0.01) + + +def main(): + Process(target=sub_task, args=('Ping', )).start() + Process(target=sub_task, args=('Pong', )).start() + + +if __name__ == '__main__': + main() +``` + +上面的代码看起来没毛病，但是最后的结果是“Ping”和“Pong”各输出了50个。再次提醒大家，当我们在程序中创建进程的时候，子进程会复制父进程及其所有的数据结构，每个子进程有自己独立的内存空间，这也就意味着两个子进程中各有一个`counter`变量，它们都会从`0`加到`50`，所以结果就可想而知了。要解决这个问题比较简单的办法是使用`multiprocessing`模块中的`Queue`类，它是可以被多个进程共享的队列，底层是通过操作系统底层的管道和信号量（semaphore）机制来实现的，代码如下所示。 + +```Python +import time +from multiprocessing import Process, Queue + + +def sub_task(content, queue): + counter = queue.get() + while counter < 50: + print(content, end='', flush=True) + counter += 1 + queue.put(counter) + time.sleep(0.01) + counter = queue.get() + + +def main(): + queue = Queue() + queue.put(0) + p1 = Process(target=sub_task, args=('Ping', queue)) + p1.start() + p2 = Process(target=sub_task, args=('Pong', queue)) + p2.start() + while p1.is_alive() and p2.is_alive(): + pass + queue.put(50) + + +if __name__ == '__main__': + main() +``` + +> **提示**：`multiprocessing.Queue`对象的`get`方法默认在队列为空时是会阻塞的，直到获取到数据才会返回。如果不希望该方法阻塞以及需要指定阻塞的超时时间，可以通过指定`block`和`timeout`参数进行设定。 + +上面的代码通过`Queue`类的`get`和`put`方法让三个进程（`p1`、`p2`和主进程）实现了数据的共享，这就是所谓的进程间的通信，通过这种方式，当`Queue`中取出的值已经大于等于`50`时，`p1`和`p2`就会跳出`while`循环，从而终止进程的执行。代码第22行的循环是为了等待`p1`和`p2`两个进程中的一个结束，这时候主进程还需要向`Queue`中放置一个大于等于`50`的值，这样另一个尚未结束的进程也会因为读到这个大于等于`50`的值而终止。 + +进程间通信的方式还有很多，比如使用套接字也可以实现两个进程的通信，甚至于这两个进程并不在同一台主机上，有兴趣的读者可以自行了解。 + +### 简单的总结 + +在 Python 中，我们还可以通过`subprocess`模块的`call`函数执行其他的命令来创建子进程，相当于就是在我们的程序中调用其他程序，这里我们暂不探讨这些知识，有兴趣的读者可以自行研究。 + +对于Python开发者来说，以下情况需要考虑使用多线程： + +1. 程序需要维护许多共享的状态（尤其是可变状态），Python 中的列表、字典、集合都是线程安全的（多个线程同时操作同一个列表、字典或集合，不会引发错误和数据问题），所以使用线程而不是进程维护共享状态的代价相对较小。 +2. 程序会花费大量时间在 I/O 操作上，没有太多并行计算的需求且不需占用太多的内存。 + +那么在遇到下列情况时，应该考虑使用多进程： + +1. 程序执行计算密集型任务（如：音视频编解码、数据压缩、科学计算等）。 +2. 程序的输入可以并行的分成块，并且可以将运算结果合并。 +3. 程序在内存使用方面没有任何限制且不强依赖于 I/O 操作（如读写文件、套接字等）。 diff --git "a/\347\254\25436\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-3.md" "b/\347\254\25436\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-3.md" new file mode 100644 index 0000000..f7fcfe2 --- /dev/null +++ "b/\347\254\25436\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-3.md" @@ -0,0 +1,215 @@ +## 第36课：Python中的并发编程-3 + +爬虫是典型的 I/O 密集型任务，I/O 密集型任务的特点就是程序会经常性的因为 I/O 操作而进入阻塞状态，比如我们之前使用`requests`获取页面代码或二进制内容，发出一个请求之后，程序必须要等待网站返回响应之后才能继续运行，如果目标网站不是很给力或者网络状况不是很理想，那么等待响应的时间可能会很久，而在这个过程中整个程序是一直阻塞在那里，没有做任何的事情。通过前面的课程，我们已经知道了可以通过多线程的方式为爬虫提速，使用多线程的本质就是，当一个线程阻塞的时候，程序还有其他的线程可以继续运转，因此整个程序就不会在阻塞和等待中浪费了大量的时间。 + +事实上，还有一种非常适合 I/O 密集型任务的并发编程方式，我们称之为异步编程，你也可以将它称为异步 I/O。这种方式并不需要启动多个线程或多个进程来实现并发，它是通过多个子程序相互协作的方式来提升 CPU 的利用率，解决了 I/O 密集型任务 CPU 利用率很低的问题，我一般将这种方式称为“协作式并发”。这里，我不打算探讨操作系统的各种 I/O 模式，因为这对很多读者来说都太过抽象；但是我们得先抛出两组概念给大家，一组叫做“阻塞”和“非阻塞”，一组叫做“同步”和“异步”。 + +### 基本概念 + +#### 阻塞 + +阻塞状态指程序未得到所需计算资源时被挂起的状态。程序在等待某个操作完成期间，自身无法继续处理其他的事情，则称该程序在该操作上是阻塞的。阻塞随时都可能发生，最典型的就是 I/O 中断（包括网络 I/O 、磁盘 I/O 、用户输入等）、休眠操作、等待某个线程执行结束，甚至包括在 CPU 切换上下文时，程序都无法真正的执行，这就是所谓的阻塞。 + +#### 非阻塞 + +程序在等待某操作过程中，自身不被阻塞，可以继续处理其他的事情，则称该程序在该操作上是非阻塞的。非阻塞并不是在任何程序级别、任何情况下都可以存在的。仅当程序封装的级别可以囊括独立的子程序单元时，它才可能存在非阻塞状态。显然，某个操作的阻塞可能会导程序耗时以及效率低下，所以我们会希望把它变成非阻塞的。 + +#### 同步 + +不同程序单元为了完成某个任务，在执行过程中需靠某种通信方式以协调一致，我们称这些程序单元是同步执行的。例如前面讲过的给银行账户存钱的操作，我们在代码中使用了“锁”作为通信信号，让多个存钱操作强制排队顺序执行，这就是所谓的同步。 + +#### 异步 + +不同程序单元在执行过程中无需通信协调，也能够完成一个任务，这种方式我们就称之为异步。例如，使用爬虫下载页面时，调度程序调用下载程序后，即可调度其他任务，而无需与该下载任务保持通信以协调行为。不同网页的下载、保存等操作都是不相关的，也无需相互通知协调。很显然，异步操作的完成时刻和先后顺序并不能确定。 + +很多人都不太能准确的把握这几个概念，这里我们简单的总结一下，同步与异步的关注点是**消息通信机制**，最终表现出来的是“有序”和“无序”的区别；阻塞和非阻塞的关注点是**程序在等待消息时状态**，最终表现出来的是程序在等待时能不能做点别的。如果想深入理解这些内容，推荐大家阅读经典著作[《UNIX网络编程》](https://item.jd.com/11880047.html)，这本书非常的赞。 + +### 生成器和协程 + +前面我们说过，异步编程是一种“协作式并发”，即通过多个子程序相互协作的方式提升 CPU 的利用率，从而减少程序在阻塞和等待中浪费的时间，最终达到并发的效果。我们可以将多个相互协作的子程序称为“协程”，它是实现异步编程的关键。在介绍协程之前，我们先通过下面的代码，看看什么是生成器。 + +```Python +def fib(max_count): + a, b = 0, 1 + for _ in range(max_count): + a, b = b, a + b + yield a +``` + +上面我们编写了一个生成斐波那契数列的生成器，调用上面的`fib`函数并不是执行该函数获得返回值，因为`fib`函数中有一个特殊的关键字`yield`。这个关键字使得`fib`函数跟普通的函数有些区别，调用该函数会得到一个生成器对象，我们可以通过下面的代码来验证这一点。 + +```Python +gen_obj = fib(20) +print(gen_obj) +``` + +输出： + +``` + +``` + +我们可以使用内置函数`next`从生成器对象中获取斐波那契数列的值，也可以通过`for-in`循环对生成器能够提供的值进行遍历，代码如下所示。 + +```Python +for value in gen_obj: + print(value) +``` + +生成器经过预激活，就是一个协程，它可以跟其他子程序协作。 + +```Python +def calc_average(): + total, counter = 0, 0 + avg_value = None + while True: + curr_value = yield avg_value + total += curr_value + counter += 1 + avg_value = total / counter + + +def main(): + obj = calc_average() + # 生成器预激活 + obj.send(None) + for _ in range(5): + print(obj.send(float(input()))) + + +if __name__ == '__main__': + main() +``` + +上面的`main`函数首先通过生成器对象的`send`方法发送一个`None`值来将其激活为协程，也可以通过`next(obj)`达到同样的效果。接下来，协程对象会接收`main`函数发送的数据并产出（`yield`）数据的平均值。通过上面的例子，不知道大家是否看出两段子程序是怎么“协作”的。 + +### 异步函数 + +Python 3.5版本中，引入了两个非常有意思的元素，一个叫`async`，一个叫`await`，它们在Python 3.7版本中成为了正式的关键字。通过这两个关键字，可以简化协程代码的编写，可以用更为简单的方式让多个子程序很好的协作起来。我们通过一个例子来加以说明，请大家先看看下面的代码。 + +```Python +import time + + +def display(num): + time.sleep(1) + print(num) + + +def main(): + start = time.time() + for i in range(1, 10): + display(i) + end = time.time() + print(f'{end - start:.3f}秒') + + +if __name__ == '__main__': + main() +``` + +上面的代码每次执行都会依次输出`1`到`9`的数字，每个间隔`1`秒钟，整个代码需要执行大概需要`9`秒多的时间，这一点我相信大家都能看懂。不知道大家是否意识到，这段代码就是以同步和阻塞的方式执行的，同步可以从代码的输出看出来，而阻塞是指在调用`display`函数发生休眠时，整个代码的其他部分都不能继续执行，必须等待休眠结束。 + +接下来，我们尝试用异步的方式改写上面的代码，让`display`函数以异步的方式运转。 + +```Python +import asyncio +import time + + +async def display(num): + await asyncio.sleep(1) + print(num) + + +def main(): + start = time.time() + objs = [display(i) for i in range(1, 10)] + loop = asyncio.get_event_loop() + loop.run_until_complete(asyncio.wait(objs)) + loop.close() + end = time.time() + print(f'{end - start:.3f}秒') + + +if __name__ == '__main__': + main() +``` + +Python 中的`asyncio`模块提供了对异步 I/O 的支持。上面的代码中，我们首先在`display`函数前面加上了`async`关键字使其变成一个异步函数，调用异步函数不会执行函数体而是获得一个协程对象。我们将`display`函数中的`time.sleep(1)`修改为`await asyncio.sleep(1)`，二者的区别在于，后者不会让整个代码陷入阻塞，因为`await`操作会让其他协作的子程序有获得 CPU 资源而得以运转的机会。为了让这些子程序可以协作起来，我们需要将他们放到一个事件循环（实现消息分派传递的系统）上，因为**当协程遭遇 I/O 操作阻塞时，就会到事件循环中监听 I/O 操作是否完成，并注册自身的上下文以及自身的唤醒函数（以便恢复执行），之后该协程就变为阻塞状态**。上面的第12行代码创建了`9`个协程对象并放到一个列表中，第13行代码通过`asyncio`模块的`get_event_loop`函数获得了系统的事件循环，第14行通过`asyncio`模块的`run_until_complete`函数将协程对象挂载到事件循环上。执行上面的代码会发现，`9`个分别会阻塞`1`秒钟的协程总共只阻塞了约`1`秒种的时间，因为**阻塞的协程对象会放弃对 CPU 的占有而不是让 CPU 处于闲置状态，这种方式大大的提升了 CPU 的利用率**。而且我们还会注意到，数字并不是按照从`1`到`9`的顺序打印输出的，这正是我们想要的结果，说明它们是**异步执行**的。对于爬虫这样的 I/O 密集型任务来说，这种协作式并发在很多场景下是比使用多线程更好的选择，因为这种做法减少了管理和维护多个线程以及多个线程切换所带来的开销。 + +### aiohttp库 + +我们之前使用的`requests`三方库并不支持异步 I/O，如果希望使用异步 I/O 的方式来加速爬虫代码的执行，我们可以安装和使用名为`aiohttp`的三方库。 + +安装`aiohttp`。 + +```Bash +pip install aiohttp +``` + +下面的代码使用`aiohttp`抓取了`10`个网站的首页并解析出它们的标题。 + +```Python +import asyncio +import re + +import aiohttp +from aiohttp import ClientSession + +TITLE_PATTERN = re.compile(r'(.*?)', re.DOTALL) + + +async def fetch_page_title(url): + async with aiohttp.ClientSession(headers={ + 'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.69 Safari/537.36', + }) as session: # type: ClientSession + async with session.get(url, ssl=False) as resp: + if resp.status == 200: + html_code = await resp.text() + matcher = TITLE_PATTERN.search(html_code) + title = matcher.group(1).strip() + print(title) + + +def main(): + urls = [ + 'https://www.python.org/', + 'https://www.jd.com/', + 'https://www.baidu.com/', + 'https://www.taobao.com/', + 'https://git-scm.com/', + 'https://www.sohu.com/', + 'https://gitee.com/', + 'https://www.amazon.com/', + 'https://www.usa.gov/', + 'https://www.nasa.gov/' + ] + objs = [fetch_page_title(url) for url in urls] + loop = asyncio.get_event_loop() + loop.run_until_complete(asyncio.wait(objs)) + loop.close() + + +if __name__ == '__main__': + main() +``` + +输出： + +``` +京东(JD.COM)-正品低价、品质保障、配送及时、轻松购物！ +搜狐 +淘宝网 - 淘！我喜欢 +百度一下，你就知道 +Gitee - 基于 Git 的代码托管和研发协作平台 +Git +NASA +Official Guide to Government Information and Services | USAGov +Amazon.com. Spend less. Smile more. +Welcome to Python.org +``` + +从上面的输出可以看出，网站首页标题的输出顺序跟它们的 URL 在列表中的顺序没有关系。代码的第11行到第13行创建了`ClientSession`对象，通过它的`get`方法可以向指定的 URL 发起请求，如第14行所示，跟`requests`中的`Session`对象并没有本质区别，唯一的区别是这里使用了异步上下文。代码第16行的`await`会让因为 I/O 操作阻塞的子程序放弃对 CPU 的占用，这使得其他的子程序可以运转起来去抓取页面。代码的第17行和第18行使用了正则表达式捕获组操作解析网页标题。`fetch_page_title`是一个被`async`关键字修饰的异步函数，调用该函数会获得协程对象，如代码第35行所示。后面的代码跟之前的例子没有什么区别，相信大家能够理解。 + +大家可以尝试将`aiohttp`换回到`requests`，看看不使用异步 I/O 也不使用多线程，到底和上面的代码有什么区别，相信通过这样的对比，大家能够更深刻的理解我们之前强调的几个概念：同步和异步，阻塞和非阻塞。 diff --git "a/\347\254\25437\350\257\276\357\274\232\345\271\266\345\217\221\347\274\226\347\250\213\345\234\250\347\210\254\350\231\253\344\270\255\347\232\204\345\272\224\347\224\250.md" "b/\347\254\25437\350\257\276\357\274\232\345\271\266\345\217\221\347\274\226\347\250\213\345\234\250\347\210\254\350\231\253\344\270\255\347\232\204\345\272\224\347\224\250.md" new file mode 100644 index 0000000..6662c24 --- /dev/null +++ "b/\347\254\25437\350\257\276\357\274\232\345\271\266\345\217\221\347\274\226\347\250\213\345\234\250\347\210\254\350\231\253\344\270\255\347\232\204\345\272\224\347\224\250.md" @@ -0,0 +1,185 @@ +## 第37课：并发编程在爬虫中的应用 + +之前的课程，我们已经为大家介绍了 Python 中的多线程、多进程和异步编程，通过这三种手段，我们可以实现并发或并行编程，这一方面可以加速代码的执行，另一方面也可以带来更好的用户体验。爬虫程序是典型的 I/O 密集型任务，对于 I/O 密集型任务来说，多线程和异步 I/O 都是很好的选择，因为当程序的某个部分因 I/O 操作阻塞时，程序的其他部分仍然可以运转，这样我们不用在等待和阻塞中浪费大量的时间。下面我们以爬取“[360图片](https://image.so.com/)”网站的图片并保存到本地为例，为大家分别展示使用单线程、多线程和异步 I/O 编程的爬虫程序有什么区别，同时也对它们的执行效率进行简单的对比。 + +“360图片”网站的页面使用了 [Ajax](https://developer.mozilla.org/zh-CN/docs/Web/Guide/AJAX) 技术，这是很多网站都会使用的一种异步加载数据和局部刷新页面的技术。简单的说，页面上的图片都是通过 JavaScript 代码异步获取 JSON 数据并动态渲染生成的，而且整个页面还使用了瀑布式加载（一边向下滚动，一边加载更多的图片）。我们在浏览器的“开发者工具”中可以找到提供动态内容的数据接口，如下图所示，我们需要的图片信息就在服务器返回的 JSON 数据中。 + + + +例如，要获取“美女”频道的图片，我们可以请求如下所示的URL，其中参数`ch`表示请求的频道，`=`后面的参数值`beauty`就代表了“美女”频道，参数`sn`相当于是页码，`0`表示第一页（共`30`张图片），`30`表示第二页，`60`表示第三页，以此类推。 + +``` +https://image.so.com/zjl?ch=beauty&sn=0 +``` + +### 单线程版本 + +通过上面的 URL 下载“美女”频道共`90`张图片。 + +```Python +""" +example04.py - 单线程版本爬虫 +""" +import os + +import requests + + +def download_picture(url): + filename = url[url.rfind('/') + 1:] + resp = requests.get(url) + if resp.status_code == 200: + with open(f'images/beauty/{filename}', 'wb') as file: + file.write(resp.content) + + +def main(): + if not os.path.exists('images/beauty'): + os.makedirs('images/beauty') + for page in range(3): + resp = requests.get(f'https://image.so.com/zjl?ch=beauty&sn={page * 30}') + if resp.status_code == 200: + pic_dict_list = resp.json()['list'] + for pic_dict in pic_dict_list: + download_picture(pic_dict['qhimg_url']) + +if __name__ == '__main__': + main() +``` + +在 macOS 或 Linux 系统上，我们可以使用`time`命令来了解上面代码的执行时间以及 CPU 的利用率，如下所示。 + +```Bash +time python3 example04.py +``` + +下面是单线程爬虫代码在我的电脑上执行的结果。 + +``` +python3 example04.py 2.36s user 0.39s system 12% cpu 21.578 total +``` + +这里我们只需要关注代码的总耗时为`21.578`秒，CPU 利用率为`12%`。 + +### 多线程版本 + +我们使用之前讲到过的线程池技术，将上面的代码修改为多线程版本。 + +```Python +""" +example05.py - 多线程版本爬虫 +""" +import os +from concurrent.futures import ThreadPoolExecutor + +import requests + + +def download_picture(url): + filename = url[url.rfind('/') + 1:] + resp = requests.get(url) + if resp.status_code == 200: + with open(f'images/beauty/{filename}', 'wb') as file: + file.write(resp.content) + + +def main(): + if not os.path.exists('images/beauty'): + os.makedirs('images/beauty') + with ThreadPoolExecutor(max_workers=16) as pool: + for page in range(3): + resp = requests.get(f'https://image.so.com/zjl?ch=beauty&sn={page * 30}') + if resp.status_code == 200: + pic_dict_list = resp.json()['list'] + for pic_dict in pic_dict_list: + pool.submit(download_picture, pic_dict['qhimg_url']) + + +if __name__ == '__main__': + main() +``` + +执行如下所示的命令。 + +```Bash +time python3 example05.py +``` + +代码的执行结果如下所示： + +``` +python3 example05.py 2.65s user 0.40s system 95% cpu 3.193 total +``` + +### 异步I/O版本 + +我们使用`aiohttp`将上面的代码修改为异步 I/O 的版本。为了以异步 I/O 的方式实现网络资源的获取和写文件操作，我们首先得安装三方库`aiohttp`和`aiofile`，命令如下所示。 + +```Bash +pip install aiohttp aiofile +``` + +`aiohttp` 的用法在之前的课程中已经做过简要介绍，`aiofile`模块中的`async_open`函数跟 Python 内置函数`open`的用法大致相同，只不过它支持异步操作。下面是异步 I/O 版本的爬虫代码。 + +```Python +""" +example06.py - 异步I/O版本爬虫 +""" +import asyncio +import json +import os + +import aiofile +import aiohttp + + +async def download_picture(session, url): + filename = url[url.rfind('/') + 1:] + async with session.get(url, ssl=False) as resp: + if resp.status == 200: + data = await resp.read() + async with aiofile.async_open(f'images/beauty/{filename}', 'wb') as file: + await file.write(data) + + +async def fetch_json(): + async with aiohttp.ClientSession() as session: + for page in range(3): + async with session.get( + url=f'https://image.so.com/zjl?ch=beauty&sn={page * 30}', + ssl=False + ) as resp: + if resp.status == 200: + json_str = await resp.text() + result = json.loads(json_str) + for pic_dict in result['list']: + await download_picture(session, pic_dict['qhimg_url']) + + +def main(): + if not os.path.exists('images/beauty'): + os.makedirs('images/beauty') + loop = asyncio.get_event_loop() + loop.run_until_complete(fetch_json()) + loop.close() + + +if __name__ == '__main__': + main() +``` + +执行如下所示的命令。 + +```Bash +time python3 example06.py +``` + +代码的执行结果如下所示： + +``` +python3 example06.py 0.82s user 0.21s system 27% cpu 3.782 total +``` + +### 总结 + +通过上面三段代码执行结果的比较，我们可以得出一个结论，使用多线程和异步 I/O 都可以改善爬虫程序的性能，因为我们不用将时间浪费在因 I/O 操作造成的等待和阻塞上，而`time`命令的执行结果也告诉我们，单线程的代码 CPU 利用率仅仅只有`12%`，而多线程版本的 CPU 利用率则高达`95%`；单线程版本的爬虫执行时间约`21`秒，而多线程和异步 I/O 的版本仅执行了`3`秒钟。另外，在运行时间差别不大的情况下，多线程的代码比异步 I/O 的代码耗费了更多的 CPU 资源，这是因为多线程的调度和切换也需要花费 CPU 时间。至此，三种方式在 I/O 密集型任务上的优劣已经一目了然，当然这只是在我的电脑上跑出来的结果。如果网络状况不是很理想或者目标网站响应很慢，那么使用多线程和异步 I/O 的优势将更为明显，有兴趣的读者可以自行试验。 From 99a27a8fdca514d8ed0a6c627e7000a3eb3ba544 Mon Sep 17 00:00:00 2001 From: jackfrued Date: Fri, 11 Mar 2022 01:08:16 +0800 Subject: [PATCH 02/17] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E4=BA=86=E7=AC=AC38?= =?UTF-8?q?=E8=AF=BE=E5=88=B0=E7=AC=AC43=E8=AF=BE=E7=9A=84=E5=86=85?= =?UTF-8?q?=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...50\346\200\201\345\206\205\345\256\271.md" | 281 ++++++ ...\236\266Scrapy\347\256\200\344\273\213.md" | 250 ++++++ ...5\222\214MySQL\346\246\202\350\277\260.md" | 388 +++++++++ ...357\274\232SQL\350\257\246\350\247\243.md" | 804 ++++++++++++++++++ ...7\274\232\346\267\261\345\205\245MySQL.md" | 661 ++++++++++++++ ...QL\346\225\260\346\215\256\345\272\223.md" | 295 +++++++ 6 files changed, 2679 insertions(+) create mode 100644 "\347\254\25438\350\257\276\357\274\232\346\212\223\345\217\226\347\275\221\351\241\265\345\212\250\346\200\201\345\206\205\345\256\271.md" create mode 100644 "\347\254\25439\350\257\276\357\274\232\347\210\254\350\231\253\346\241\206\346\236\266Scrapy\347\256\200\344\273\213.md" create mode 100644 "\347\254\25440\350\257\276\357\274\232\345\205\263\347\263\273\345\236\213\346\225\260\346\215\256\345\272\223\345\222\214MySQL\346\246\202\350\277\260.md" create mode 100644 "\347\254\25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" create mode 100644 "\347\254\25442\350\257\276\357\274\232\346\267\261\345\205\245MySQL.md" create mode 100644 "\347\254\25443\350\257\276\357\274\232Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" diff --git "a/\347\254\25438\350\257\276\357\274\232\346\212\223\345\217\226\347\275\221\351\241\265\345\212\250\346\200\201\345\206\205\345\256\271.md" "b/\347\254\25438\350\257\276\357\274\232\346\212\223\345\217\226\347\275\221\351\241\265\345\212\250\346\200\201\345\206\205\345\256\271.md" new file mode 100644 index 0000000..f04b86f --- /dev/null +++ "b/\347\254\25438\350\257\276\357\274\232\346\212\223\345\217\226\347\275\221\351\241\265\345\212\250\346\200\201\345\206\205\345\256\271.md" @@ -0,0 +1,281 @@ +## 第38课：抓取网页动态内容 + +根据权威机构发布的全球互联网可访问性审计报告，全球约有四分之三的网站其内容或部分内容是通过JavaScript动态生成的，这就意味着在浏览器窗口中“查看网页源代码”时无法在HTML代码中找到这些内容，也就是说我们之前用的抓取数据的方式无法正常运转了。解决这样的问题基本上有两种方案，一是获取提供动态内容的数据接口，这种方式也适用于抓取手机 App 的数据；另一种是通过自动化测试工具 Selenium 运行浏览器获取渲染后的动态内容。对于第一种方案，我们可以使用浏览器的“开发者工具”或者更为专业的抓包工具（如：Charles、Fiddler、Wireshark等）来获取到数据接口，后续的操作跟上一个章节中讲解的获取“360图片”网站的数据是一样的，这里我们不再进行赘述。这一章我们重点讲解如何使用自动化测试工具 Selenium 来获取网站的动态内容。 + +### Selenium 介绍 + +Selenium 是一个自动化测试工具，利用它可以驱动浏览器执行特定的行为，最终帮助爬虫开发者获取到网页的动态内容。简单的说，只要我们在浏览器窗口中能够看到的内容，都可以使用 Selenium 获取到，对于那些使用了 JavaScript 动态渲染技术的网站，Selenium 会是一个重要的选择。下面，我们还是以 Chrome 浏览器为例，来讲解 Selenium 的用法，大家需要先安装 Chrome 浏览器并下载它的驱动。Chrome 浏览器的驱动程序可以在[ChromeDriver官网](https://chromedriver.chromium.org/downloads)进行下载，驱动的版本要跟浏览器的版本对应，如果没有完全对应的版本，就选择版本代号最为接近的版本。 + + + +### 使用Selenium + +我们可以先通过`pip`来安装 Selenium，命令如下所示。 + +```Shell +pip install selenium +``` + +#### 加载页面 + +接下来，我们通过下面的代码驱动 Chrome 浏览器打开百度。 + +```Python +from selenium import webdriver + +# 创建Chrome浏览器对象 +browser = webdriver.Chrome() +# 加载指定的页面 +browser.get('https://www.baidu.com/') +``` + +如果不愿意使用 Chrome 浏览器，也可以修改上面的代码操控其他浏览器，只需创建对应的浏览器对象（如 Firefox、Safari 等）即可。运行上面的程序，如果看到如下所示的错误提示，那是说明我们还没有将 Chrome 浏览器的驱动添加到 PATH 环境变量中，也没有在程序中指定 Chrome 浏览器驱动所在的位置。 + +```Shell +selenium.common.exceptions.WebDriverException: Message: 'chromedriver' executable needs to be in PATH. Please see https://sites.google.com/a/chromium.org/chromedriver/home +``` + +解决这个问题的办法有三种： + +1. 将下载的 ChromeDriver 放到已有的 PATH 环境变量下，建议直接跟 Python 解释器放在同一个目录，因为之前安装 Python 的时候我们已经将 Python 解释器的路径放到 PATH 环境变量中了。 + +2. 将 ChromeDriver 放到项目虚拟环境下的 `bin` 文件夹中（Windows 系统对应的目录是 `Scripts`），这样 ChromeDriver 就跟虚拟环境下的 Python 解释器在同一个位置，肯定是能够找到的。 + +3. 修改上面的代码，在创建 Chrome 对象时，通过`service`参数配置`Service`对象，并通过创建`Service`对象的`executable_path`参数指定 ChromeDriver 所在的位置，如下所示： + + ```Python + from selenium import webdriver + from selenium.webdriver.chrome.service import Service + + browser = webdriver.Chrome(service=Service(executable_path='venv/bin/chromedriver')) + browser.get('https://www.baidu.com/') + ``` + +#### 查找元素和模拟用户行为 + +接下来，我们可以尝试模拟用户在百度首页的文本框输入搜索关键字并点击“百度一下”按钮。在完成页面加载后，可以通过`Chrome`对象的`find_element`和`find_elements`方法来获取页面元素，Selenium 支持多种获取元素的方式，包括：CSS 选择器、XPath、元素名字（标签名）、元素 ID、类名等，前者可以获取单个页面元素（`WebElement`对象），后者可以获取多个页面元素构成的列表。获取到`WebElement`对象以后，可以通过`send_keys`来模拟用户输入行为，可以通过`click`来模拟用户点击操作，代码如下所示。 + +```Python +from selenium import webdriver +from selenium.webdriver.common.by import By + +browser = webdriver.Chrome() +browser.get('https://www.baidu.com/') +# 通过元素ID获取元素 +kw_input = browser.find_element(By.ID, 'kw') +# 模拟用户输入行为 +kw_input.send_keys('Python') +# 通过CSS选择器获取元素 +su_button = browser.find_element(By.CSS_SELECTOR, '#su') +# 模拟用户点击行为 +su_button.click() +``` + +如果要执行一个系列动作，例如模拟拖拽操作，可以创建`ActionChains`对象，有兴趣的读者可以自行研究。 + +#### 隐式等待和显式等待 + +这里还有一个细节需要大家知道，网页上的元素可能是动态生成的，在我们使用`find_element`或`find_elements`方法获取的时候，可能还没有完成渲染，这时会引发`NoSuchElementException`错误。为了解决这个问题，我们可以使用隐式等待的方式，通过设置等待时间让浏览器完成对页面元素的渲染。除此之外，我们还可以使用显示等待，通过创建`WebDriverWait`对象，并设置等待时间和条件，当条件没有满足时，我们可以先等待再尝试进行后续的操作，具体的代码如下所示。 + +```Python +from selenium import webdriver +from selenium.webdriver.common.by import By +from selenium.webdriver.support import expected_conditions +from selenium.webdriver.support.wait import WebDriverWait + +browser = webdriver.Chrome() +# 设置浏览器窗口大小 +browser.set_window_size(1200, 800) +browser.get('https://www.baidu.com/') +# 设置隐式等待时间为10秒 +browser.implicitly_wait(10) +kw_input = browser.find_element(By.ID, 'kw') +kw_input.send_keys('Python') +su_button = browser.find_element(By.CSS_SELECTOR, '#su') +su_button.click() +# 创建显示等待对象 +wait_obj = WebDriverWait(browser, 10) +# 设置等待条件（等搜索结果的div出现） +wait_obj.until( + expected_conditions.presence_of_element_located( + (By.CSS_SELECTOR, '#content_left') + ) +) +# 截屏 +browser.get_screenshot_as_file('python_result.png') +``` + +上面设置的等待条件`presence_of_element_located`表示等待指定元素出现，下面的表格列出了常用的等待条件及其含义。 + +| 等待条件 | 具体含义 | +| ---------------------------------------- | ------------------------------------- | +| `title_is / title_contains` | 标题是指定的内容 / 标题包含指定的内容 | +| `visibility_of` | 元素可见 | +| `presence_of_element_located` | 定位的元素加载完成 | +| `visibility_of_element_located` | 定位的元素变得可见 | +| `invisibility_of_element_located` | 定位的元素变得不可见 | +| `presence_of_all_elements_located` | 定位的所有元素加载完成 | +| `text_to_be_present_in_element` | 元素包含指定的内容 | +| `text_to_be_present_in_element_value` | 元素的`value`属性包含指定的内容 | +| `frame_to_be_available_and_switch_to_it` | 载入并切换到指定的内部窗口 | +| `element_to_be_clickable` | 元素可点击 | +| `element_to_be_selected` | 元素被选中 | +| `element_located_to_be_selected` | 定位的元素被选中 | +| `alert_is_present` | 出现 Alert 弹窗 | + +#### 执行JavaScript代码 + +对于使用瀑布式加载的页面，如果希望在浏览器窗口中加载更多的内容，可以通过浏览器对象的`execute_scripts`方法执行 JavaScript 代码来实现。对于一些高级的爬取操作，也很有可能会用到类似的操作，如果你的爬虫代码需要 JavaScript 的支持，建议先对 JavaScript 进行适当的了解，尤其是 JavaScript 中的 BOM 和 DOM 操作。我们在上面的代码中截屏之前加入下面的代码，这样就可以利用 JavaScript 将网页滚到最下方。 + +```Python +# 执行JavaScript代码 +browser.execute_script('document.documentElement.scrollTop = document.documentElement.scrollHeight') +``` + +#### Selenium反爬的破解 + +有一些网站专门针对 Selenium 设置了反爬措施，因为使用 Selenium 驱动的浏览器，在控制台中可以看到如下所示的`webdriver`属性值为`true`，如果要绕过这项检查，可以在加载页面之前，先通过执行 JavaScript 代码将其修改为`undefined`。 + + + +另一方面，我们还可以将浏览器窗口上的“Chrome正受到自动测试软件的控制”隐藏掉，完整的代码如下所示。 + +```Python +# 创建Chrome参数对象 +options = webdriver.ChromeOptions() +# 添加试验性参数 +options.add_experimental_option('excludeSwitches', ['enable-automation']) +options.add_experimental_option('useAutomationExtension', False) +# 创建Chrome浏览器对象并传入参数 +browser = webdriver.Chrome(options=options) +# 执行Chrome开发者协议命令（在加载页面时执行指定的JavaScript代码） +browser.execute_cdp_cmd( + 'Page.addScriptToEvaluateOnNewDocument', + {'source': 'Object.defineProperty(navigator, "webdriver", {get: () => undefined})'} +) +browser.set_window_size(1200, 800) +browser.get('https://www.baidu.com/') +``` + +#### 无头浏览器 + +很多时候，我们在爬取数据时并不需要看到浏览器窗口，只要有 Chrome 浏览器以及对应的驱动程序，我们的爬虫就能够运转起来。如果不想看到浏览器窗口，我们可以通过下面的方式设置使用无头浏览器。 + +```Python +options = webdriver.ChromeOptions() +options.add_argument('--headless') +browser = webdriver.Chrome(options=options) +``` + +### API参考 + +Selenium 相关的知识还有很多，我们在此就不一一赘述了，下面为大家罗列一些浏览器对象和`WebElement`对象常用的属性和方法。具体的内容大家还可以参考 Selenium [官方文档的中文翻译](https://selenium-python-zh.readthedocs.io/en/latest/index.html)。 + +#### 浏览器对象 + +表1. 常用属性 + +| 属性名 | 描述 | +| ----------------------- | -------------------------------- | +| `current_url` | 当前页面的URL | +| `current_window_handle` | 当前窗口的句柄（引用） | +| `name` | 浏览器的名称 | +| `orientation` | 当前设备的方向（横屏、竖屏） | +| `page_source` | 当前页面的源代码（包括动态内容） | +| `title` | 当前页面的标题 | +| `window_handles` | 浏览器打开的所有窗口的句柄 | + +表2. 常用方法 + +| 方法名 | 描述 | +| -------------------------------------- | ----------------------------------- | +| `back` / `forward` | 在浏览历史记录中后退/前进 | +| `close` / `quit` | 关闭当前浏览器窗口 / 退出浏览器实例 | +| `get` | 加载指定 URL 的页面到浏览器中 | +| `maximize_window` | 将浏览器窗口最大化 | +| `refresh` | 刷新当前页面 | +| `set_page_load_timeout` | 设置页面加载超时时间 | +| `set_script_timeout` | 设置 JavaScript 执行超时时间 | +| `implicit_wait` | 设置等待元素被找到或目标指令完成 | +| `get_cookie` / `get_cookies` | 获取指定的Cookie / 获取所有Cookie | +| `add_cookie` | 添加 Cookie 信息 | +| `delete_cookie` / `delete_all_cookies` | 删除指定的 Cookie / 删除所有 Cookie | +| `find_element` / `find_elements` | 查找单个元素 / 查找一系列元素 | + +#### WebElement对象 + +表1. WebElement常用属性 + +| 属性名 | 描述 | +| ---------- | -------------- | +| `location` | 元素的位置 | +| `size` | 元素的尺寸 | +| `text` | 元素的文本内容 | +| `id` | 元素的 ID | +| `tag_name` | 元素的标签名 | + +表2. 常用方法 + +| 方法名 | 描述 | +| -------------------------------- | ------------------------------------ | +| `clear` | 清空文本框或文本域中的内容 | +| `click` | 点击元素 | +| `get_attribute` | 获取元素的属性值 | +| `is_displayed` | 判断元素对于用户是否可见 | +| `is_enabled` | 判断元素是否处于可用状态 | +| `is_selected` | 判断元素（单选框和复选框）是否被选中 | +| `send_keys` | 模拟输入文本 | +| `submit` | 提交表单 | +| `value_of_css_property` | 获取指定的CSS属性值 | +| `find_element` / `find_elements` | 获取单个子元素 / 获取一系列子元素 | +| `screenshot` | 为元素生成快照 | + +### 简单案例 + +下面的例子演示了如何使用 Selenium 从“360图片”网站搜索和下载图片。 + +```Python +import os +import time +from concurrent.futures import ThreadPoolExecutor + +import requests +from selenium import webdriver +from selenium.webdriver.common.by import By +from selenium.webdriver.common.keys import Keys + +DOWNLOAD_PATH = 'images/' + + +def download_picture(picture_url: str): + """ + 下载保存图片 + :param picture_url: 图片的URL + """ + filename = picture_url[picture_url.rfind('/') + 1:] + resp = requests.get(picture_url) + with open(os.path.join(DOWNLOAD_PATH, filename), 'wb') as file: + file.write(resp.content) + + +if not os.path.exists(DOWNLOAD_PATH): + os.makedirs(DOWNLOAD_PATH) +browser = webdriver.Chrome() +browser.get('https://image.so.com/z?ch=beauty') +browser.implicitly_wait(10) +kw_input = browser.find_element(By.CSS_SELECTOR, 'input[name=q]') +kw_input.send_keys('苍老师') +kw_input.send_keys(Keys.ENTER) +for _ in range(10): + browser.execute_script( + 'document.documentElement.scrollTop = document.documentElement.scrollHeight' + ) + time.sleep(1) +imgs = browser.find_elements(By.CSS_SELECTOR, 'div.waterfall img') +with ThreadPoolExecutor(max_workers=32) as pool: + for img in imgs: + pic_url = img.get_attribute('src') + pool.submit(download_picture, pic_url) +``` + +运行上面的代码，检查指定的目录下是否下载了根据关键词搜索到的图片。 diff --git "a/\347\254\25439\350\257\276\357\274\232\347\210\254\350\231\253\346\241\206\346\236\266Scrapy\347\256\200\344\273\213.md" "b/\347\254\25439\350\257\276\357\274\232\347\210\254\350\231\253\346\241\206\346\236\266Scrapy\347\256\200\344\273\213.md" new file mode 100644 index 0000000..5b2ca62 --- /dev/null +++ "b/\347\254\25439\350\257\276\357\274\232\347\210\254\350\231\253\346\241\206\346\236\266Scrapy\347\256\200\344\273\213.md" @@ -0,0 +1,250 @@ +## 第39课：爬虫框架Scrapy简介 + +当你写了很多个爬虫程序之后，你会发现每次写爬虫程序时，都需要将页面获取、页面解析、爬虫调度、异常处理、反爬应对这些代码从头至尾实现一遍，这里面有很多工作其实都是简单乏味的重复劳动。那么，有没有什么办法可以提升我们编写爬虫代码的效率呢？答案是肯定的，那就是利用爬虫框架，而在所有的爬虫框架中，Scrapy 应该是最流行、最强大的框架。 + +### Scrapy 概述 + +Scrapy 是基于 Python 的一个非常流行的网络爬虫框架，可以用来抓取 Web 站点并从页面中提取结构化的数据。下图展示了 Scrapy 的基本架构，其中包含了主要组件和系统的数据处理流程（图中带数字的红色箭头）。 + +![](https://gitee.com/jackfrued/mypic/raw/master/20210824003638.png) + +#### Scrapy的组件 + +我们先来说说 Scrapy 中的组件。 + +1. Scrapy 引擎（Engine）：用来控制整个系统的数据处理流程。 +2. 调度器（Scheduler）：调度器从引擎接受请求并排序列入队列，并在引擎发出请求后返还给它们。 +3. 下载器（Downloader）：下载器的主要职责是抓取网页并将网页内容返还给蜘蛛（Spiders）。 +4. 蜘蛛程序（Spiders）：蜘蛛是用户自定义的用来解析网页并抓取特定URL的类，每个蜘蛛都能处理一个域名或一组域名，简单的说就是用来定义特定网站的抓取和解析规则的模块。 +5. 数据管道（Item Pipeline）：管道的主要责任是负责处理有蜘蛛从网页中抽取的数据条目，它的主要任务是清理、验证和存储数据。当页面被蜘蛛解析后，将被发送到数据管道，并经过几个特定的次序处理数据。每个数据管道组件都是一个 Python 类，它们获取了数据条目并执行对数据条目进行处理的方法，同时还需要确定是否需要在数据管道中继续执行下一步或是直接丢弃掉不处理。数据管道通常执行的任务有：清理 HTML 数据、验证解析到的数据（检查条目是否包含必要的字段）、检查是不是重复数据（如果重复就丢弃）、将解析到的数据存储到数据库（关系型数据库或 NoSQL 数据库）中。 +6. 中间件（Middlewares）：中间件是介于引擎和其他组件之间的一个钩子框架，主要是为了提供自定义的代码来拓展 Scrapy 的功能，包括下载器中间件和蜘蛛中间件。 + +#### 数据处理流程 + +Scrapy 的整个数据处理流程由引擎进行控制，通常的运转流程包括以下的步骤： + +1. 引擎询问蜘蛛需要处理哪个网站，并让蜘蛛将第一个需要处理的 URL 交给它。 + +2. 引擎让调度器将需要处理的 URL 放在队列中。 + +3. 引擎从调度那获取接下来进行爬取的页面。 + +4. 调度将下一个爬取的 URL 返回给引擎，引擎将它通过下载中间件发送到下载器。 + +5. 当网页被下载器下载完成以后，响应内容通过下载中间件被发送到引擎；如果下载失败了，引擎会通知调度器记录这个 URL，待会再重新下载。 + +6. 引擎收到下载器的响应并将它通过蜘蛛中间件发送到蜘蛛进行处理。 + +7. 蜘蛛处理响应并返回爬取到的数据条目，此外还要将需要跟进的新的 URL 发送给引擎。 + +8. 引擎将抓取到的数据条目送入数据管道，把新的 URL 发送给调度器放入队列中。 + +上述操作中的第2步到第8步会一直重复直到调度器中没有需要请求的 URL，爬虫就停止工作。 + +### 安装和使用Scrapy + +可以使用 Python 的包管理工具`pip`来安装 Scrapy。 + +```Shell +pip install scrapy +``` + +在命令行中使用`scrapy`命令创建名为`demo`的项目。 + +```Bash +scrapy startproject demo +``` + +项目的目录结构如下图所示。 + +```Shell +demo +|____ demo +|________ spiders +|____________ __init__.py +|________ __init__.py +|________ items.py +|________ middlewares.py +|________ pipelines.py +|________ settings.py +|____ scrapy.cfg +``` + +切换到`demo` 目录，用下面的命令创建名为`douban`的蜘蛛程序。 + +```Bash +scrapy genspider douban movie.douban.com +``` + +#### 一个简单的例子 + +接下来，我们实现一个爬取豆瓣电影 Top250 电影标题、评分和金句的爬虫。 + +1. 在`items.py`的`Item`类中定义字段，这些字段用来保存数据，方便后续的操作。 + + ```Python + import scrapy + + + class DoubanItem(scrapy.Item): + title = scrapy.Field() + score = scrapy.Field() + motto = scrapy.Field() + ``` + +2. 修改`spiders`文件夹中名为`douban.py` 的文件，它是蜘蛛程序的核心，需要我们添加解析页面的代码。在这里，我们可以通过对`Response`对象的解析，获取电影的信息，代码如下所示。 + + ```Python + import scrapy + from scrapy import Selector, Request + from scrapy.http import HtmlResponse + + from demo.items import MovieItem + + + class DoubanSpider(scrapy.Spider): + name = 'douban' + allowed_domains = ['movie.douban.com'] + start_urls = ['https://movie.douban.com/top250?start=0&filter='] + + def parse(self, response: HtmlResponse): + sel = Selector(response) + movie_items = sel.css('#content > div > div.article > ol > li') + for movie_sel in movie_items: + item = MovieItem() + item['title'] = movie_sel.css('.title::text').extract_first() + item['score'] = movie_sel.css('.rating_num::text').extract_first() + item['motto'] = movie_sel.css('.inq::text').extract_first() + yield item + ``` + 通过上面的代码不难看出，我们可以使用 CSS 选择器进行页面解析。当然，如果你愿意也可以使用 XPath 或正则表达式进行页面解析，对应的方法分别是`xpath`和`re`。 + + 如果还要生成后续爬取的请求，我们可以用`yield`产出`Request`对象。`Request`对象有两个非常重要的属性，一个是`url`，它代表了要请求的地址；一个是`callback`，它代表了获得响应之后要执行的回调函数。我们可以将上面的代码稍作修改。 + + ```Python + import scrapy + from scrapy import Selector, Request + from scrapy.http import HtmlResponse + + from demo.items import MovieItem + + + class DoubanSpider(scrapy.Spider): + name = 'douban' + allowed_domains = ['movie.douban.com'] + start_urls = ['https://movie.douban.com/top250?start=0&filter='] + + def parse(self, response: HtmlResponse): + sel = Selector(response) + movie_items = sel.css('#content > div > div.article > ol > li') + for movie_sel in movie_items: + item = MovieItem() + item['title'] = movie_sel.css('.title::text').extract_first() + item['score'] = movie_sel.css('.rating_num::text').extract_first() + item['motto'] = movie_sel.css('.inq::text').extract_first() + yield item + + hrefs = sel.css('#content > div > div.article > div.paginator > a::attr("href")') + for href in hrefs: + full_url = response.urljoin(href.extract()) + yield Request(url=full_url) + ``` + + 到这里，我们已经可以通过下面的命令让爬虫运转起来。 + + ```Shell + scrapy crawl movie + ``` + + 可以在控制台看到爬取到的数据，如果想将这些数据保存到文件中，可以通过`-o`参数来指定文件名，Scrapy 支持我们将爬取到的数据导出成 JSON、CSV、XML 等格式。 + + ```Shell + scrapy crawl moive -o result.json + ``` + + 不知大家是否注意到，通过运行爬虫获得的 JSON 文件中有`275`条数据，那是因为首页被重复爬取了。要解决这个问题，可以对上面的代码稍作调整，不在`parse`方法中解析获取新页面的 URL，而是通过`start_requests`方法提前准备好待爬取页面的 URL，调整后的代码如下所示。 + + ```Python + import scrapy + from scrapy import Selector, Request + from scrapy.http import HtmlResponse + + from demo.items import MovieItem + + + class DoubanSpider(scrapy.Spider): + name = 'douban' + allowed_domains = ['movie.douban.com'] + + def start_requests(self): + for page in range(10): + yield Request(url=f'https://movie.douban.com/top250?start={page * 25}') + + def parse(self, response: HtmlResponse): + sel = Selector(response) + movie_items = sel.css('#content > div > div.article > ol > li') + for movie_sel in movie_items: + item = MovieItem() + item['title'] = movie_sel.css('.title::text').extract_first() + item['score'] = movie_sel.css('.rating_num::text').extract_first() + item['motto'] = movie_sel.css('.inq::text').extract_first() + yield item + ``` + +3. 如果希望完成爬虫数据的持久化，可以在数据管道中处理蜘蛛程序产生的`Item`对象。例如，我们可以通过前面讲到的`openpyxl`操作 Excel 文件，将数据写入 Excel 文件中，代码如下所示。 + + ```Python + import openpyxl + + from demo.items import MovieItem + + + class MovieItemPipeline: + + def __init__(self): + self.wb = openpyxl.Workbook() + self.sheet = self.wb.active + self.sheet.title = 'Top250' + self.sheet.append(('名称', '评分', '名言')) + + def process_item(self, item: MovieItem, spider): + self.sheet.append((item['title'], item['score'], item['motto'])) + return item + + def close_spider(self, spider): + self.wb.save('豆瓣电影数据.xlsx') + ``` + + 上面的`process_item`和`close_spider`都是回调方法（钩子函数）， 简单的说就是 Scrapy 框架会自动去调用的方法。当蜘蛛程序产生一个`Item`对象交给引擎时，引擎会将该`Item`对象交给数据管道，这时我们配置好的数据管道的`parse_item`方法就会被执行，所以我们可以在该方法中获取数据并完成数据的持久化操作。另一个方法`close_spider`是在爬虫结束运行前会自动执行的方法，在上面的代码中，我们在这个地方进行了保存 Excel 文件的操作，相信这段代码大家是很容易读懂的。 + + 总而言之，数据管道可以帮助我们完成以下操作： + + - 清理 HTML 数据，验证爬取的数据。 + - 丢弃重复的不必要的内容。 + - 将爬取的结果进行持久化操作。 + +4. 修改`settings.py`文件对项目进行配置，主要需要修改以下几个配置。 + + ```Python + # 用户浏览器 + USER_AGENT = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36' + + # 并发请求数量 + CONCURRENT_REQUESTS = 4 + + # 下载延迟 + DOWNLOAD_DELAY = 3 + # 随机化下载延迟 + RANDOMIZE_DOWNLOAD_DELAY = True + + # 是否遵守爬虫协议 + ROBOTSTXT_OBEY = True + + # 配置数据管道 + ITEM_PIPELINES = { + 'demo.pipelines.MovieItemPipeline': 300, + } + ``` + + > **说明**：上面配置文件中的`ITEM_PIPELINES`选项是一个字典，可以配置多个处理数据的管道，后面的数字代表了执行的优先级，数字小的先执行。 + diff --git "a/\347\254\25440\350\257\276\357\274\232\345\205\263\347\263\273\345\236\213\346\225\260\346\215\256\345\272\223\345\222\214MySQL\346\246\202\350\277\260.md" "b/\347\254\25440\350\257\276\357\274\232\345\205\263\347\263\273\345\236\213\346\225\260\346\215\256\345\272\223\345\222\214MySQL\346\246\202\350\277\260.md" new file mode 100644 index 0000000..63dc6cf --- /dev/null +++ "b/\347\254\25440\350\257\276\357\274\232\345\205\263\347\263\273\345\236\213\346\225\260\346\215\256\345\272\223\345\222\214MySQL\346\246\202\350\277\260.md" @@ -0,0 +1,388 @@ +## 第40课：关系型数据库和MySQL概述 + +### 关系型数据库概述 + +1. 数据持久化 - 将数据保存到能够长久保存数据的存储介质中，在掉电的情况下数据也不会丢失。 + +2. 数据库发展史 - 网状数据库、层次数据库、关系数据库、NoSQL 数据库、NewSQL 数据库。 + + > 1970年，IBM的研究员E.F.Codd在*Communication of the ACM*上发表了名为*A Relational Model of Data for Large Shared Data Banks*的论文，提出了**关系模型**的概念，奠定了关系模型的理论基础。后来Codd又陆续发表多篇文章，论述了范式理论和衡量关系系统的12条标准，用数学理论奠定了关系数据库的基础。 + +3. 关系数据库特点。 + + - 理论基础：**关系代数**（关系运算、集合论、一阶谓词逻辑）。 + + - 具体表象：用**二维表**（有行和列）组织数据。 + + - 编程语言：**结构化查询语言**（SQL）。 + +4. ER模型（实体关系模型）和概念模型图。 + + **ER模型**，全称为**实体关系模型**（Entity-Relationship Model），由美籍华裔计算机科学家陈品山先生提出，是概念数据模型的高层描述方式，如下图所示。 + + + + - 实体 - 矩形框 + - 属性 - 椭圆框 + - 关系 - 菱形框 + - 重数 - 1:1（一对一） / 1:N（一对多） / M:N（多对多） + + 实际项目开发中，我们可以利用数据库建模工具（如：PowerDesigner）来绘制概念数据模型（其本质就是 ER 模型），然后再设置好目标数据库系统，将概念模型转换成物理模型，最终生成创建二维表的 SQL（很多工具都可以根据我们设计的物理模型图以及设定的目标数据库来导出 SQL 或直接生成数据表）。 + + ![](https://gitee.com/jackfrued/mypic/raw/master/20210826003212.png) + +5. 关系数据库产品。 + - [Oracle](https://www.oracle.com/index.html) - 目前世界上使用最为广泛的数据库管理系统，作为一个通用的数据库系统，它具有完整的数据管理功能；作为一个关系数据库，它是一个完备关系的产品；作为分布式数据库，它实现了分布式处理的功能。在 Oracle 最新的 12c 版本中，还引入了多承租方架构，使用该架构可轻松部署和管理数据库云。 + - [DB2](https://www.ibm.com/analytics/us/en/db2/) - IBM 公司开发的、主要运行于 Unix（包括 IBM 自家的 [AIX](https://zh.wikipedia.org/wiki/AIX)）、Linux、以及 Windows 服务器版等系统的关系数据库产品。DB2 历史悠久且被认为是最早使用 SQL 的数据库产品，它拥有较为强大的商业智能功能。 + - [SQL Server](https://www.microsoft.com/en-us/sql-server/) - 由 Microsoft 开发和推广的关系型数据库产品，最初适用于中小企业的数据管理，但是近年来它的应用范围有所扩展，部分大企业甚至是跨国公司也开始基于它来构建自己的数据管理系统。 + - [MySQL](https://www.mysql.com/) - MySQL 是开放源代码的，任何人都可以在 GPL（General Public License）的许可下下载并根据个性化的需要对其进行修改。MySQL 因为其速度、可靠性和适应性而备受关注。 + - [PostgreSQL]() - 在 BSD 许可证下发行的开放源代码的关系数据库产品。 + +### MySQL 简介 + +MySQL 最早是由瑞典的 MySQL AB 公司开发的一个开放源码的关系数据库管理系统，该公司于2008年被昇阳微系统公司（Sun Microsystems）收购。在2009年，甲骨文公司（Oracle）收购昇阳微系统公司，因此 MySQL 目前也是 Oracle 旗下产品。 + +MySQL 在过去由于性能高、成本低、可靠性好，已经成为最流行的开源数据库，因此被广泛地应用于中小型网站开发。随着 MySQL 的不断成熟，它也逐渐被应用于更多大规模网站和应用，比如维基百科、谷歌（Google）、脸书（Facebook）、淘宝网等网站都使用了 MySQL 来提供数据持久化服务。 + +甲骨文公司收购后昇阳微系统公司，大幅调涨 MySQL 商业版的售价，且甲骨文公司不再支持另一个自由软件项目 [OpenSolaris ](https://zh.wikipedia.org/wiki/OpenSolaris) 的发展，因此导致自由软件社区对于 Oracle 是否还会持续支持 MySQL 社区版（MySQL 的各个发行版本中唯一免费的版本）有所担忧，MySQL 的创始人麦克尔·维德纽斯以 MySQL 为基础，创建了 [MariaDB](https://zh.wikipedia.org/wiki/MariaDB)（以他女儿的名字命名的数据库）分支。有许多原来使用 MySQL 数据库的公司（例如：维基百科）已经陆续完成了从 MySQL 数据库到 MariaDB 数据库的迁移。 + +### 安装 MySQL + +#### Windows 环境 + +1. 通过[官方网站](https://www.mysql.com/)提供的[下载链接](https://dev.mysql.com/downloads/windows/installer/8.0.html)下载“MySQL社区版服务器”安装程序，如下图所示，建议大家下载离线安装版的MySQL Installer。 + + + +2. 运行 Installer，按照下面的步骤进行安装。 + + - 选择自定义安装。 + + + + - 选择需要安装的组件。 + + + + - 如果缺少依赖项，需要先安装依赖项。 + + + + - 准备开始安装。 + + + + - 安装完成。 + + + + - 准备执行配置向导。 + + + +3. 执行安装后的配置向导。 + + - 配置服务器类型和网络。 + + + + - 配置认证方法（保护密码的方式）。 + + + + - 配置用户和角色。 + + + + - 配置Windows服务名以及是否开机自启。 + + + + - 配置日志。 + + + + - 配置高级选项。 + + ACAC15B8633133B65476286A49BFBD7E + + - 应用配置。 + + + +4. 可以在 Windows 系统的“服务”窗口中启动或停止 MySQL。 + + + +5. 配置 PATH 环境变量，以便在命令行提示符窗口使用 MySQL 客户端工具。 + + - 打开 Windows 的“系统”窗口并点击“高级系统设置”。 + + + + - 在“系统属性”的“高级”窗口，点击“环境变量”按钮。 + + + + - 修改PATH环境变量，将MySQL安装路径下的`bin`文件夹的路径配置到PATH环境变量中。 + + + + - 配置完成后，可以尝试在“命令提示符”下使用 MySQL 的命令行工具。 + + + +#### Linux 环境 + +下面以 CentOS 7.x 环境为例，演示如何安装 MySQL 5.7.x，如果需要在其他 Linux 系统下安装其他版本的 MySQL，请读者自行在网络上查找对应的安装教程。 + +1. 安装 MySQL。 + + 可以在 [MySQL 官方网站]()下载安装文件。首先在下载页面中选择平台和版本，然后找到对应的下载链接，直接下载包含所有安装文件的归档文件，解归档之后通过包管理工具进行安装。 + + ```Shell + wget https://dev.mysql.com/get/Downloads/MySQL-5.7/mysql-5.7.26-1.el7.x86_64.rpm-bundle.tar + tar -xvf mysql-5.7.26-1.el7.x86_64.rpm-bundle.tar + ``` + + 如果系统上有 MariaDB 相关的文件，需要先移除 MariaDB 相关的文件。 + + ```Shell + yum list installed | grep mariadb | awk '{print $1}' | xargs yum erase -y + ``` + + 更新和安装可能用到的底层依赖库。 + + ```Bash + yum update + yum install -y libaio libaio-devel + ``` + + 接下来可以按照如下所示的顺序用 RPM（Redhat Package Manager）工具安装 MySQL。 + + ```Shell + rpm -ivh mysql-community-common-5.7.26-1.el7.x86_64.rpm + rpm -ivh mysql-community-libs-5.7.26-1.el7.x86_64.rpm + rpm -ivh mysql-community-libs-compat-5.7.26-1.el7.x86_64.rpm + rpm -ivh mysql-community-devel-5.7.26-1.el7.x86_64.rpm + rpm -ivh mysql-community-client-5.7.26-1.el7.x86_64.rpm + rpm -ivh mysql-community-server-5.7.26-1.el7.x86_64.rpm + ``` + + 可以使用下面的命令查看已经安装的 MySQL 相关的包。 + + ```Shell + rpm -qa | grep mysql + ``` + +2. 配置 MySQL。 + + MySQL 的配置文件在`/etc`目录下，名为`my.cnf`，默认的配置文件内容如下所示。 + + ```Shell + cat /etc/my.cnf + ``` + + ```INI + # For advice on how to change settings please see + # http://dev.mysql.com/doc/refman/5.7/en/server-configuration-defaults.html + + [mysqld] + # + # Remove leading # and set to the amount of RAM for the most important data + # cache in MySQL. Start at 70% of total RAM for dedicated server, else 10%. + # innodb_buffer_pool_size = 128M + # + # Remove leading # to turn on a very important data integrity option: logging + # changes to the binary log between backups. + # log_bin + # + # Remove leading # to set options mainly useful for reporting servers. + # The server defaults are faster for transactions and fast SELECTs. + # Adjust sizes as needed, experiment to find the optimal values. + # join_buffer_size = 128M + # sort_buffer_size = 2M + # read_rnd_buffer_size = 2M + datadir=/var/lib/mysql + socket=/var/lib/mysql/mysql.sock + + # Disabling symbolic-links is recommended to prevent assorted security risks + symbolic-links=0 + + log-error=/var/log/mysqld.log + pid-file=/var/run/mysqld/mysqld.pid + ``` + + 通过配置文件，我们可以修改 MySQL 服务使用的端口、字符集、最大连接数、套接字队列大小、最大数据包大小、日志文件的位置、日志过期时间等配置。当然，我们还可以通过修改配置文件来对 MySQL 服务器进行性能调优和安全管控。 + +3. 启动 MySQL 服务。 + + 可以使用下面的命令来启动 MySQL。 + + ```Shell + service mysqld start + ``` + + 在 CentOS 7 中，更推荐使用下面的命令来启动 MySQL。 + + ```Shell + systemctl start mysqld + ``` + + 启动 MySQL 成功后，可以通过下面的命令来检查网络端口使用情况，MySQL 默认使用`3306`端口。 + + ```Shell + netstat -ntlp | grep mysql + ``` + + 也可以使用下面的命令查找是否有名为`mysqld`的进程。 + + ```Shell + pgrep mysqld + ``` + +4. 使用 MySQL 客户端工具连接服务器。 + + 命令行工具： + + ```Shell + mysql -u root -p + ``` + + > 说明：启动客户端时，`-u`参数用来指定用户名，MySQL 默认的超级管理账号为`root`；`-p`表示要输入密码（用户口令）；如果连接的是其他主机而非本机，可以用`-h`来指定连接主机的主机名或IP地址。 + + 如果是首次安装 MySQL，可以使用下面的命令来找到默认的初始密码。 + + ```Shell + cat /var/log/mysqld.log | grep password + ``` + + 上面的命令会查看 MySQL 的日志带有`password`的行，在显示的结果中`root@localhost:`后面的部分就是默认设置的初始密码。 + + 进入客户端工具后，可以通过下面的指令来修改超级管理员（root）的访问口令为`123456`。 + + ```SQL + set global validate_password_policy=0; + set global validate_password_length=6; + alter user 'root'@'localhost' identified by '123456'; + ``` + + > **说明**：MySQL 较新的版本默认不允许使用弱口令作为用户口令，所以上面的代码修改了验证用户口令的策略和口令的长度。事实上我们不应该使用弱口令，因为存在用户口令被暴力破解的风险。近年来，**攻击数据库窃取数据和劫持数据库勒索比特币**的事件屡见不鲜，要避免这些潜在的风险，最为重要的一点是**不要让数据库服务器暴露在公网上**（最好的做法是将数据库置于内网，至少要做到不向公网开放数据库服务器的访问端口），另外要保管好`root`账号的口令，应用系统需要访问数据库时，通常不使用`root`账号进行访问，而是**创建其他拥有适当权限的账号来访问**。 + + 再次使用客户端工具连接 MySQL 服务器时，就可以使用新设置的口令了。在实际开发中，为了方便用户操作，可以选择图形化的客户端工具来连接 MySQL 服务器，包括： + + - MySQL Workbench（官方工具） + + + + - Navicat for MySQL（界面简单友好） + + + + +#### macOS环境 + +macOS 系统安装 MySQL 是比较简单的，只需要从刚才说到的官方网站下载 DMG 安装文件并运行就可以了，下载的时候需要根据自己使用的是 Intel 的芯片还是苹果的 M1 芯片选择下载链接，如下图所示。 + + + +安装成功后，可以在“系统偏好设置”中找到“MySQL”，在如下所示的画面中，可以启动和停止 MySQL 服务器，也可以对 MySQL 核心文件的路径进行配置。 + + + +### MySQL 基本命令 + +#### 查看命令 + +1. 查看所有数据库 + +```SQL +show databases; +``` + +2. 查看所有字符集 + +```SQL +show character set; +``` + +3. 查看所有的排序规则 + +```SQL +show collation; +``` + +4. 查看所有的引擎 + +```SQL +show engines; +``` + +5. 查看所有日志文件 + +```SQL +show binary logs; +``` + +6. 查看数据库下所有表 + +```SQL +show tables; +``` + +#### 获取帮助 + +在 MySQL 命令行工具中，可以使用`help`命令或`?`来获取帮助，如下所示。 + +1. 查看`show`命令的帮助。 + + ```MySQL + ? show + ``` + +2. 查看有哪些帮助内容。 + + ```MySQL + ? contents + ``` + +3. 获取函数的帮助。 + + ```MySQL + ? functions + ``` + +4. 获取数据类型的帮助。 + + ```MySQL + ? data types + ``` + +#### 其他命令 + +1. 新建/重建服务器连接 - `connect` / `resetconnection`。 + +2. 清空当前输入 - `\c`。在输入错误时，可以及时使用`\c`清空当前输入并重新开始。 + +3. 修改终止符（定界符）- `delimiter`。默认的终止符是`;`，可以使用该命令修改成其他的字符，例如修改为`$`符号，可以用`delimiter $`命令。 + +4. 打开系统默认编辑器 - `edit`。编辑完成保存关闭之后，命令行会自动执行编辑的内容。 + +5. 查看服务器状态 - `status`。 + +6. 修改默认提示符 - `prompt`。 + +7. 执行系统命令 - `system`。可以将系统命令跟在`system`命令的后面执行，`system`命令也可以缩写为`\!`。 + +8. 执行 SQL 文件 - `source`。`source`命令后面跟 SQL 文件路径。 + +9. 重定向输出 - `tee` / `notee`。可以将命令的输出重定向到指定的文件中。 + +10. 切换数据库 - `use`。 + +11. 显示警告信息 - `warnings`。 + +12. 退出命令行 - `quit`或`exit`。 + + + diff --git "a/\347\254\25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" "b/\347\254\25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" new file mode 100644 index 0000000..9559e32 --- /dev/null +++ "b/\347\254\25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" @@ -0,0 +1,804 @@ +## 第41课：SQL详解 + +我们通常可以将 SQL 分为四类，分别是 DDL（数据定义语言）、DML（数据操作语言）、DQL（数据查询语言）和 DCL（数据控制语言）。DDL 主要用于创建、删除、修改数据库中的对象，比如创建、删除和修改二维表，核心的关键字包括`create`、`drop`和`alter`；DML 主要负责数据的插入、删除和更新，关键词包括`insert`、`delete`和`update`；DQL 负责数据查询，最重要的一个关键词是`select`；DCL 通常用于授予和召回权限，核心关键词是`grant`和`revoke`。 + +> **说明**：SQL 是不区分大小写的语言，为了书写和识别方便，下面的 SQL 都使用了小写字母来书写。 + +### DDL（数据定义语言） + +下面我们来实现一个选课系统的数据库，如下所示的 SQL 创建了名为`school`的数据库和五张表，分别是学院表（`tb_college`）、学生表（`tb_student`）、教师表（`tb_teacher`）、课程表（`tb_course`）和选课记录表（`tb_record`），其中学生和教师跟学院之间是多对一关系，课程跟老师之间也是多对一关系，学生和课程是多对多关系，选课记录表就是维持学生跟课程多对多关系的中间表。 + +```SQL +-- 如果存在名为school的数据库就删除它 +drop database if exists `school`; + +-- 创建名为school的数据库并设置默认的字符集和排序方式 +create database `school` default character set utf8mb4 collate utf8mb4_general_ci; + +-- 切换到school数据库上下文环境 +use `school`; + +-- 创建学院表 +create table `tb_college` +( +`col_id` int unsigned auto_increment comment '编号', +`col_name` varchar(50) not null comment '名称', +`col_intro` varchar(500) default '' comment '介绍', +primary key (`col_id`) +) engine=innodb auto_increment=1 comment '学院表'; + +-- 创建学生表 +create table `tb_student` +( +`stu_id` int unsigned not null comment '学号', +`stu_name` varchar(20) not null comment '姓名', +`stu_sex` boolean default 1 not null comment '性别', +`stu_birth` date not null comment '出生日期', +`stu_addr` varchar(255) default '' comment '籍贯', +`col_id` int unsigned not null comment '所属学院', +primary key (`stu_id`), +constraint `fk_student_col_id` foreign key (`col_id`) references `tb_college` (`col_id`) +) engine=innodb comment '学生表'; + +-- 创建教师表 +create table `tb_teacher` +( +`tea_id` int unsigned not null comment '工号', +`tea_name` varchar(20) not null comment '姓名', +`tea_title` varchar(10) default '助教' comment '职称', +`col_id` int unsigned not null comment '所属学院', +primary key (`tea_id`), +constraint `fk_teacher_col_id` foreign key (`col_id`) references `tb_college` (`col_id`) +) engine=innodb comment '老师表'; + +-- 创建课程表 +create table `tb_course` +( +`cou_id` int unsigned not null comment '编号', +`cou_name` varchar(50) not null comment '名称', +`cou_credit` int not null comment '学分', +`tea_id` int unsigned not null comment '授课老师', +primary key (`cou_id`), +constraint `fk_course_tea_id` foreign key (`tea_id`) references `tb_teacher` (`tea_id`) +) engine=innodb comment '课程表'; + +-- 创建选课记录表 +create table `tb_record` +( +`rec_id` bigint unsigned auto_increment comment '选课记录号', +`stu_id` int unsigned not null comment '学号', +`cou_id` int unsigned not null comment '课程编号', +`sel_date` date not null comment '选课日期', +`score` decimal(4,1) comment '考试成绩', +primary key (`rec_id`), +constraint `fk_record_stu_id` foreign key (`stu_id`) references `tb_student` (`stu_id`), +constraint `fk_record_cou_id` foreign key (`cou_id`) references `tb_course` (`cou_id`), +constraint `uk_record_stu_cou` unique (`stu_id`, `cou_id`) +) engine=innodb comment '选课记录表'; +``` + +上面的DDL有几个地方需要强调一下： + +- 创建数据库时，我们通过`default character set utf8mb4`指定了数据库默认使用的字符集为`utf8mb4`（最大`4`字节的`utf-8`编码），我们推荐使用该字符集，它也是 MySQL 8.x 默认使用的字符集，因为它能够支持国际化编码，还可以存储 Emoji 字符。可以通过下面的命令查看 MySQL 支持的字符集以及默认的排序规则。 + + ```SQL + show character set; + ``` + + ``` + +----------+---------------------------------+---------------------+--------+ + | Charset | Description | Default collation | Maxlen | + +----------+---------------------------------+---------------------+--------+ + | big5 | Big5 Traditional Chinese | big5_chinese_ci | 2 | + | dec8 | DEC West European | dec8_swedish_ci | 1 | + | cp850 | DOS West European | cp850_general_ci | 1 | + | hp8 | HP West European | hp8_english_ci | 1 | + | koi8r | KOI8-R Relcom Russian | koi8r_general_ci | 1 | + | latin1 | cp1252 West European | latin1_swedish_ci | 1 | + | latin2 | ISO 8859-2 Central European | latin2_general_ci | 1 | + | swe7 | 7bit Swedish | swe7_swedish_ci | 1 | + | ascii | US ASCII | ascii_general_ci | 1 | + | ujis | EUC-JP Japanese | ujis_japanese_ci | 3 | + | sjis | Shift-JIS Japanese | sjis_japanese_ci | 2 | + | hebrew | ISO 8859-8 Hebrew | hebrew_general_ci | 1 | + | tis620 | TIS620 Thai | tis620_thai_ci | 1 | + | euckr | EUC-KR Korean | euckr_korean_ci | 2 | + | koi8u | KOI8-U Ukrainian | koi8u_general_ci | 1 | + | gb2312 | GB2312 Simplified Chinese | gb2312_chinese_ci | 2 | + | greek | ISO 8859-7 Greek | greek_general_ci | 1 | + | cp1250 | Windows Central European | cp1250_general_ci | 1 | + | gbk | GBK Simplified Chinese | gbk_chinese_ci | 2 | + | latin5 | ISO 8859-9 Turkish | latin5_turkish_ci | 1 | + | armscii8 | ARMSCII-8 Armenian | armscii8_general_ci | 1 | + | utf8 | UTF-8 Unicode | utf8_general_ci | 3 | + | ucs2 | UCS-2 Unicode | ucs2_general_ci | 2 | + | cp866 | DOS Russian | cp866_general_ci | 1 | + | keybcs2 | DOS Kamenicky Czech-Slovak | keybcs2_general_ci | 1 | + | macce | Mac Central European | macce_general_ci | 1 | + | macroman | Mac West European | macroman_general_ci | 1 | + | cp852 | DOS Central European | cp852_general_ci | 1 | + | latin7 | ISO 8859-13 Baltic | latin7_general_ci | 1 | + | utf8mb4 | UTF-8 Unicode | utf8mb4_general_ci | 4 | + | cp1251 | Windows Cyrillic | cp1251_general_ci | 1 | + | utf16 | UTF-16 Unicode | utf16_general_ci | 4 | + | utf16le | UTF-16LE Unicode | utf16le_general_ci | 4 | + | cp1256 | Windows Arabic | cp1256_general_ci | 1 | + | cp1257 | Windows Baltic | cp1257_general_ci | 1 | + | utf32 | UTF-32 Unicode | utf32_general_ci | 4 | + | binary | Binary pseudo charset | binary | 1 | + | geostd8 | GEOSTD8 Georgian | geostd8_general_ci | 1 | + | cp932 | SJIS for Windows Japanese | cp932_japanese_ci | 2 | + | eucjpms | UJIS for Windows Japanese | eucjpms_japanese_ci | 3 | + | gb18030 | China National Standard GB18030 | gb18030_chinese_ci | 4 | + +----------+---------------------------------+---------------------+--------+ + 41 rows in set (0.00 sec) + ``` + + 如果要设置 MySQL 服务启动时默认使用的字符集，可以修改MySQL的配置并添加以下内容。 + + ```INI + [mysqld] + character-set-server=utf8 + ``` + +- 在创建表的时候，可以自行选择底层的存储引擎。MySQL 支持多种存储引擎，可以通过`show engines`命令进行查看。MySQL 5.5 以后的版本默认使用的存储引擎是 InnoDB，它是我们推荐大家使用的存储引擎（因为更适合当下互联网应用对高并发、性能以及事务支持等方面的需求），为了 SQL 语句的向下兼容性，我们可以在建表语句结束处右圆括号的后面通过`engine=innodb`来指定使用 InnoDB 存储引擎。 + + ```SQL + show engines\G + ``` + + ``` + *************************** 1. row *************************** + Engine: InnoDB + Support: DEFAULT + Comment: Supports transactions, row-level locking, and foreign keys + Transactions: YES + XA: YES + Savepoints: YES + *************************** 2. row *************************** + Engine: MRG_MYISAM + Support: YES + Comment: Collection of identical MyISAM tables + Transactions: NO + XA: NO + Savepoints: NO + *************************** 3. row *************************** + Engine: MEMORY + Support: YES + Comment: Hash based, stored in memory, useful for temporary tables + Transactions: NO + XA: NO + Savepoints: NO + *************************** 4. row *************************** + Engine: BLACKHOLE + Support: YES + Comment: /dev/null storage engine (anything you write to it disappears) + Transactions: NO + XA: NO + Savepoints: NO + *************************** 5. row *************************** + Engine: MyISAM + Support: YES + Comment: MyISAM storage engine + Transactions: NO + XA: NO + Savepoints: NO + *************************** 6. row *************************** + Engine: CSV + Support: YES + Comment: CSV storage engine + Transactions: NO + XA: NO + Savepoints: NO + *************************** 7. row *************************** + Engine: ARCHIVE + Support: YES + Comment: Archive storage engine + Transactions: NO + XA: NO + Savepoints: NO + *************************** 8. row *************************** + Engine: PERFORMANCE_SCHEMA + Support: YES + Comment: Performance Schema + Transactions: NO + XA: NO + Savepoints: NO + *************************** 9. row *************************** + Engine: FEDERATED + Support: NO + Comment: Federated MySQL storage engine + Transactions: NULL + XA: NULL + Savepoints: NULL + 9 rows in set (0.00 sec) + ``` + + 下面的表格对MySQL几种常用的数据引擎进行了简单的对比。 + + | 特性 | InnoDB | MRG_MYISAM | MEMORY | MyISAM | + | ------------ | ------------ | ---------- | ------ | ------ | + | 存储限制 | 有 | 没有 | 有 | 有 | + | 事务 | 支持 | | | | + | 锁机制 | 行锁 | 表锁 | 表锁 | 表锁 | + | B树索引 | 支持 | 支持 | 支持 | 支持 | + | 哈希索引 | | | 支持 | | + | 全文检索 | 支持（5.6+） | | | 支持 | + | 集群索引 | 支持 | | | | + | 数据缓存 | 支持 | | 支持 | | + | 索引缓存 | 支持 | 支持 | 支持 | 支持 | + | 数据可压缩 | | | | 支持 | + | 内存使用 | 高 | 低 | 中 | 低 | + | 存储空间使用 | 高 | 低 | | 低 | + | 批量插入性能 | 低 | 高 | 高 | 高 | + | 是否支持外键 | 支持 | | | | + + 通过上面的比较我们可以了解到，InnoDB 是唯一能够支持外键、事务以及行锁的存储引擎，所以我们之前说它更适合互联网应用，而且在较新版本的 MySQL 中，它也是默认使用的存储引擎。 + +- 在定义表结构为每个字段选择数据类型时，如果不清楚哪个数据类型更合适，可以通过 MySQL 的帮助系统来了解每种数据类型的特性、数据的长度和精度等相关信息。 + + ```SQL + ? data types + ``` + + ``` + You asked for help about help category: "Data Types" + For more information, type 'help ', where is one of the following + topics: + AUTO_INCREMENT + BIGINT + BINARY + BIT + BLOB + BLOB DATA TYPE + BOOLEAN + CHAR + CHAR BYTE + DATE + DATETIME + DEC + DECIMAL + DOUBLE + DOUBLE PRECISION + ENUM + FLOAT + INT + INTEGER + LONGBLOB + LONGTEXT + MEDIUMBLOB + MEDIUMINT + MEDIUMTEXT + SET DATA TYPE + SMALLINT + TEXT + TIME + TIMESTAMP + TINYBLOB + TINYINT + TINYTEXT + VARBINARY + VARCHAR + YEAR DATA TYPE + ``` + + ```SQL + ? varchar + ``` + + ``` + Name: 'VARCHAR' + Description: + [NATIONAL] VARCHAR(M) [CHARACTER SET charset_name] [COLLATE + collation_name] + + A variable-length string. M represents the maximum column length in + characters. The range of M is 0 to 65,535. The effective maximum length + of a VARCHAR is subject to the maximum row size (65,535 bytes, which is + shared among all columns) and the character set used. For example, utf8 + characters can require up to three bytes per character, so a VARCHAR + column that uses the utf8 character set can be declared to be a maximum + of 21,844 characters. See + http://dev.mysql.com/doc/refman/5.7/en/column-count-limit.html. + + MySQL stores VARCHAR values as a 1-byte or 2-byte length prefix plus + data. The length prefix indicates the number of bytes in the value. A + VARCHAR column uses one length byte if values require no more than 255 + bytes, two length bytes if values may require more than 255 bytes. + + *Note*: + + MySQL follows the standard SQL specification, and does not remove + trailing spaces from VARCHAR values. + + VARCHAR is shorthand for CHARACTER VARYING. NATIONAL VARCHAR is the + standard SQL way to define that a VARCHAR column should use some + predefined character set. MySQL uses utf8 as this predefined character + set. http://dev.mysql.com/doc/refman/5.7/en/charset-national.html. + NVARCHAR is shorthand for NATIONAL VARCHAR. + + URL: http://dev.mysql.com/doc/refman/5.7/en/string-type-overview.html + ``` + + 在数据类型的选择上，保存字符串数据通常都使用`VARCHAR`和`CHAR`两种类型，前者通常称为变长字符串，而后者通常称为定长字符串；对于 InnoDB 存储引擎，行存储格式没有区分固定长度和可变长度列，因此`VARCHAR`类型和`CHAR`类型没有本质区别，后者不一定比前者性能更好。如果要保存的很大字符串，可以使用`TEXT`类型；如果要保存很大的字节串，可以使用`BLOB`（二进制大对象）类型。在 MySQL 中，`TEXT`和`BLOB`又分别包括`TEXT`、`MEDIUMTEXT`、`LONGTEXT`和`BLOB`、`MEDIUMBLOB`、`LONGBLOB`三种不同的类型，它们主要的区别在于存储数据的最大大小不同。保存浮点数可以用`FLOAT`或`DOUBLE`类型，`FLOAT`已经不推荐使用了，而且在 MySQL 后续的版本中可能会被移除掉。而保存定点数应该使用`DECIMAL`类型。如果要保存时间日期，`DATETIME`类型优于`TIMESTAMP`类型，因为前者能表示的时间日期范围更大。 + +### DML（数据操作语言） + +我们通过如下所示的 SQL 给上面创建的表添加数据。 + +```SQL +use school; + +-- 插入学院数据 +insert into `tb_college` + (`col_name`, `col_intro`) +values + ('计算机学院', '计算机学院1958年设立计算机专业，1981年建立计算机科学系，1998年设立计算机学院，2005年5月，为了进一步整合教学和科研资源，学校决定，计算机学院和软件学院行政班子合并统一运作、实行教学和学生管理独立运行的模式。 学院下设三个系：计算机科学与技术系、物联网工程系、计算金融系；两个研究所：图象图形研究所、网络空间安全研究院（2015年成立）；三个教学实验中心：计算机基础教学实验中心、IBM技术中心和计算机专业实验中心。'), + ('外国语学院', '外国语学院设有7个教学单位，6个文理兼收的本科专业；拥有1个一级学科博士授予点，3个二级学科博士授予点，5个一级学科硕士学位授权点，5个二级学科硕士学位授权点，5个硕士专业授权领域，同时还有2个硕士专业学位（MTI）专业；有教职员工210余人，其中教授、副教授80余人，教师中获得中国国内外名校博士学位和正在职攻读博士学位的教师比例占专任教师的60%以上。'), + ('经济管理学院', '经济学院前身是创办于1905年的经济科；已故经济学家彭迪先、张与九、蒋学模、胡寄窗、陶大镛、胡代光，以及当代学者刘诗白等曾先后在此任教或学习。'); + +-- 插入学生数据 +insert into `tb_student` + (`stu_id`, `stu_name`, `stu_sex`, `stu_birth`, `stu_addr`, `col_id`) +values + (1001, '杨过', 1, '1990-3-4', '湖南长沙', 1), + (1002, '任我行', 1, '1992-2-2', '湖南长沙', 1), + (1033, '王语嫣', 0, '1989-12-3', '四川成都', 1), + (1572, '岳不群', 1, '1993-7-19', '陕西咸阳', 1), + (1378, '纪嫣然', 0, '1995-8-12', '四川绵阳', 1), + (1954, '林平之', 1, '1994-9-20', '福建莆田', 1), + (2035, '东方不败', 1, '1988-6-30', null, 2), + (3011, '林震南', 1, '1985-12-12', '福建莆田', 3), + (3755, '项少龙', 1, '1993-1-25', '四川成都', 3), + (3923, '杨不悔', 0, '1985-4-17', '四川成都', 3); + +-- 插入老师数据 +insert into `tb_teacher` + (`tea_id`, `tea_name`, `tea_title`, `col_id`) +values + (1122, '张三丰', '教授', 1), + (1133, '宋远桥', '副教授', 1), + (1144, '杨逍', '副教授', 1), + (2255, '范遥', '副教授', 2), + (3366, '韦一笑', default, 3); + +-- 插入课程数据 +insert into `tb_course` + (`cou_id`, `cou_name`, `cou_credit`, `tea_id`) +values + (1111, 'Python程序设计', 3, 1122), + (2222, 'Web前端开发', 2, 1122), + (3333, '操作系统', 4, 1122), + (4444, '计算机网络', 2, 1133), + (5555, '编译原理', 4, 1144), + (6666, '算法和数据结构', 3, 1144), + (7777, '经贸法语', 3, 2255), + (8888, '成本会计', 2, 3366), + (9999, '审计学', 3, 3366); + +-- 插入选课数据 +insert into `tb_record` + (`stu_id`, `cou_id`, `sel_date`, `score`) +values + (1001, 1111, '2017-09-01', 95), + (1001, 2222, '2017-09-01', 87.5), + (1001, 3333, '2017-09-01', 100), + (1001, 4444, '2018-09-03', null), + (1001, 6666, '2017-09-02', 100), + (1002, 1111, '2017-09-03', 65), + (1002, 5555, '2017-09-01', 42), + (1033, 1111, '2017-09-03', 92.5), + (1033, 4444, '2017-09-01', 78), + (1033, 5555, '2017-09-01', 82.5), + (1572, 1111, '2017-09-02', 78), + (1378, 1111, '2017-09-05', 82), + (1378, 7777, '2017-09-02', 65.5), + (2035, 7777, '2018-09-03', 88), + (2035, 9999, '2019-09-02', null), + (3755, 1111, '2019-09-02', null), + (3755, 8888, '2019-09-02', null), + (3755, 9999, '2017-09-01', 92); +``` + +> **注意**：上面的`insert`语句使用了批处理的方式来插入数据，这种做法插入数据的效率比较高。 + +### DQL（数据查询语言） + +接下来，我们完成如下所示的查询。 + +```SQL +-- 查询所有学生的所有信息 +select * from `tb_student`; + +-- 查询学生的学号、姓名和籍贯(投影) +select `stu_id`, `stu_name`, `stu_addr` from `tb_student`; + +-- 查询所有课程的名称及学分(投影和别名) +select `cou_name` as 课程名称, `cou_credit` as 学分 from `tb_course`; + +-- 查询所有女学生的姓名和出生日期(筛选) +select `stu_name`, `stu_birth` from `tb_student` where `stu_sex`=0; + +-- 查询籍贯为“四川成都”的女学生的姓名和出生日期(筛选) +select `stu_name`, `stu_birth` from `tb_student` where `stu_sex`=0 and `stu_addr`='四川成都'; + +-- 查询籍贯为“四川成都”或者性别为“女生”的学生 +select `stu_name`, `stu_birth` from `tb_student` where `stu_sex`=0 or `stu_addr`='四川成都'; + +-- 查询所有80后学生的姓名、性别和出生日期(筛选) +select `stu_name`, `stu_sex`, `stu_birth` from `tb_student` +where `stu_birth`>='1980-1-1' and `stu_birth`<='1989-12-31'; + +select `stu_name`, `stu_sex`, `stu_birth` from `tb_student` +where `stu_birth` between '1980-1-1' and '1989-12-31'; + +-- 补充：将表示性别的 1 和 0 处理成 “男” 和 “女” +select + `stu_name` as 姓名, + if(`stu_sex`, '男', '女') as 性别, + `stu_birth` as 出生日期 +from `tb_student` +where `stu_birth` between '1980-1-1' and '1989-12-31'; + +select + `stu_name` as 姓名, + case `stu_sex` when 1 then '男' else '女' end as 性别, + `stu_birth` as 出生日期 +from `tb_student` +where `stu_birth` between '1980-1-1' and '1989-12-31'; + +-- 查询学分大于2的课程的名称和学分(筛选) +select `cou_name`, `cou_credit` from `tb_course` where `cou_credit`>2; + +-- 查询学分是奇数的课程的名称和学分(筛选) +select `cou_name`, `cou_credit` from `tb_course` where `cou_credit`%2<>0; + +select `cou_name`, `cou_credit` from `tb_course` where `cou_credit` mod 2<>0; + +-- 查询选择选了1111的课程考试成绩在90分以上的学生学号(筛选) +select `stu_id` from `tb_record` where `cou_id`=1111 and `score`>90; + +-- 查询名字叫“杨过”的学生的姓名和性别 +select `stu_name`, `stu_sex` from `tb_student` where `stu_name`='杨过'; + +-- 查询姓“杨”的学生姓名和性别(模糊) +-- % - 通配符（wildcard），它可以匹配0个或任意多个字符 +select `stu_name`, `stu_sex` from `tb_student` where `stu_name` like '杨%'; + +-- 查询姓“杨”名字两个字的学生姓名和性别(模糊) +-- _ - 通配符（wildcard），它可以精确匹配一个字符 +select `stu_name`, `stu_sex` from `tb_student` where `stu_name` like '杨_'; + +-- 查询姓“杨”名字三个字的学生姓名和性别(模糊) +select `stu_name`, `stu_sex` from `tb_student` where `stu_name` like '杨__'; + +-- 查询名字中有“不”字或“嫣”字的学生的姓名(模糊) +select `stu_name` from `tb_student` where `stu_name` like '%不%' or `stu_name` like '%嫣%'; + +-- 将“岳不群”改名为“岳不嫣”，比较下面两个查询的区别 +update `tb_student` set `stu_name`='岳不嫣' where `stu_id`=1572; + +select `stu_name` from `tb_student` where `stu_name` like '%不%' +union +select `stu_name` from `tb_student` where `stu_name` like '%嫣%'; + +select `stu_name` from `tb_student` where `stu_name` like '%不%' +union all +select `stu_name` from `tb_student` where `stu_name` like '%嫣%'; + +-- 查询姓“杨”或姓“林”名字三个字的学生的姓名(正则表达式模糊查询) +select `stu_name` from `tb_student` where `stu_name` regexp '[杨林].{2}'; + +-- 查询没有录入籍贯的学生姓名(空值处理) +select `stu_name` from `tb_student` where `stu_addr` is null; + +select `stu_name` from `tb_student` where `stu_addr` <=> null; + +-- 查询录入了籍贯的学生姓名(空值处理) +select `stu_name` from `tb_student` where `stu_addr` is not null; + +-- 下面的查询什么也查不到，三值逻辑 --> true / false / unknown +select `stu_name` from `tb_student` where `stu_addr`=null or `stu_addr`<>null; + +-- 查询学生选课的所有日期(去重) +select distinct `sel_date` from `tb_record`; + +-- 查询学生的籍贯(去重) +select distinct `stu_addr` from `tb_student` where `stu_addr` is not null; + +-- 查询男学生的姓名和生日按年龄从大到小排列(排序) +-- 升序：从小到大 - asc，降序：从大到小 - desc +select `stu_id`, `stu_name`, `stu_birth` from `tb_student` +where `stu_sex`=1 order by `stu_birth` asc, `stu_id` desc; + +-- 补充：将上面的生日换算成年龄(日期函数、数值函数) +select + `stu_id` as 学号, + `stu_name` as 姓名, + floor(datediff(curdate(), `stu_birth`)/365) as 年龄 +from `tb_student` +where `stu_sex`=1 order by 年龄 desc, `stu_id` desc; + +-- 查询年龄最大的学生的出生日期(聚合函数) +select min(`stu_birth`) from `tb_student`; + +-- 查询年龄最小的学生的出生日期(聚合函数) +select max(`stu_birth`) from `tb_student`; + +-- 查询编号为1111的课程考试成绩的最高分(聚合函数) +select max(`score`) from `tb_record` where `cou_id`=1111; + +-- 查询学号为1001的学生考试成绩的最低分(聚合函数) +select min(`score`) from `tb_record` where `stu_id`=1001; + +-- 查询学号为1001的学生考试成绩的平均分(聚合函数) +select avg(`score`) from `tb_record` where `stu_id`=1001; + +select sum(`score`) / count(`score`) from `tb_record` where `stu_id`=1001; + +-- 查询学号为1001的学生考试成绩的平均分，如果有null值，null值算0分(聚合函数) +select sum(`score`) / count(*) from `tb_record` where `stu_id`=1001; + +select avg(ifnull(`score`, 0)) from `tb_record` where `stu_id`=1001; + +-- 查询学号为1001的学生考试成绩的标准差(聚合函数) +select std(`score`), variance(`score`) from `tb_record` where `stu_id`=1001; + +-- 查询男女学生的人数(分组和聚合函数) +select + case `stu_sex` when 1 then '男' else '女' end as 性别, + count(*) as 人数 +from `tb_student` group by `stu_sex`; + +-- 查询每个学院学生人数(分组和聚合函数) +select + `col_id` as 学院, + count(*) as 人数 +from `tb_student` group by `col_id` with rollup; + +-- 查询每个学院男女学生人数(分组和聚合函数) +select + `col_id` as 学院, + if(`stu_sex`, '男', '女') as 性别, + count(*) as 人数 +from `tb_student` group by `col_id`, `stu_sex`; + +-- 查询每个学生的学号和平均成绩(分组和聚合函数) +select + `stu_id`, + round(avg(`score`), 1) as avg_score +from `tb_record` group by `stu_id`; + +-- 查询平均成绩大于等于90分的学生的学号和平均成绩 +-- 分组以前的筛选使用where子句，分组以后的筛选使用having子句 +select + `stu_id`, + round(avg(`score`), 1) as avg_score +from `tb_record` +group by `stu_id` having avg_score>=90; + +-- 查询1111、2222、3333三门课程平均成绩大于等于90分的学生的学号和平均成绩 +select + `stu_id`, + round(avg(`score`), 1) as avg_score +from `tb_record` where `cou_id` in (1111, 2222, 3333) +group by `stu_id` having avg_score>=90; + +-- 查询年龄最大的学生的姓名(子查询/嵌套查询) +-- 嵌套查询：把一个select的结果作为另一个select的一部分来使用 +select `stu_name` from `tb_student` +where `stu_birth`=( + select min(`stu_birth`) from `tb_student` +); + +-- 查询选了两门以上的课程的学生姓名(子查询/分组条件/集合运算) +select `stu_name` from `tb_student` +where `stu_id` in ( + select `stu_id` from `tb_record` + group by `stu_id` having count(*)>2 +); + +-- 查询学生的姓名、生日和所在学院名称 +select `stu_name`, `stu_birth`, `col_name` +from `tb_student`, `tb_college` +where `tb_student`.`col_id`=`tb_college`.`col_id`; + +select `stu_name`, `stu_birth`, `col_name` +from `tb_student` inner join `tb_college` +on `tb_student`.`col_id`=`tb_college`.`col_id`; + +select `stu_name`, `stu_birth`, `col_name` +from `tb_student` natural join `tb_college`; + +-- 查询学生姓名、课程名称以及成绩(连接查询/联结查询) +select `stu_name`, `cou_name`, `score` +from `tb_student`, `tb_course`, `tb_record` +where `tb_student`.`stu_id`=`tb_record`.`stu_id` +and `tb_course`.`cou_id`=`tb_record`.`cou_id` +and `score` is not null; + +select `stu_name`, `cou_name`, `score` from `tb_student` +inner join `tb_record` on `tb_student`.`stu_id`=`tb_record`.`stu_id` +inner join `tb_course` on `tb_course`.`cou_id`=`tb_record`.`cou_id` +where `score` is not null; + +select `stu_name`, `cou_name`, `score` from `tb_student` +natural join `tb_record` +natural join `tb_course` +where `score` is not null; + +-- 补充：上面的查询结果取前5条数据(分页查询) +select `stu_name`, `cou_name`, `score` +from `tb_student`, `tb_course`, `tb_record` +where `tb_student`.`stu_id`=`tb_record`.`stu_id` +and `tb_course`.`cou_id`=`tb_record`.`cou_id` +and `score` is not null +order by `score` desc +limit 0,5; + +-- 补充：上面的查询结果取第6-10条数据(分页查询) +select `stu_name`, `cou_name`, `score` +from `tb_student`, `tb_course`, `tb_record` +where `tb_student`.`stu_id`=`tb_record`.`stu_id` +and `tb_course`.`cou_id`=`tb_record`.`cou_id` +and `score` is not null +order by `score` desc +limit 5 offset 5; + +-- 补充：上面的查询结果取第11-15条数据(分页查询) +select `stu_name`, `cou_name`, `score` +from `tb_student`, `tb_course`, `tb_record` +where `tb_student`.`stu_id`=`tb_record`.`stu_id` +and `tb_course`.`cou_id`=`tb_record`.`cou_id` +and `score` is not null +order by `score` desc +limit 5 offset 10; + +-- 查询选课学生的姓名和平均成绩(子查询和连接查询) +select `stu_name`, `avg_score` +from `tb_student` inner join ( + select `stu_id` as `sid`, round(avg(`score`), 1) as avg_score + from `tb_record` group by `stu_id` +) as `t2` on `stu_id`=`sid`; + +-- 查询学生的姓名和选课的数量 +select `stu_name`, `total` from `tb_student` as `t1` +inner join ( + select `stu_id`, count(*) as `total` + from `tb_record` group by `stu_id` +) as `t2` on `t1`.`stu_id`=`t2`.`stu_id`; + +-- 查询每个学生的姓名和选课数量(左外连接和子查询) +-- 左外连接：左表（写在join左边的表）的每条记录都可以查出来，不满足连表条件的地方填充null。 +select `stu_name`, coalesce(`total`, 0) as `total` +from `tb_student` as `t1` +left outer join ( + select `stu_id`, count(*) as `total` + from `tb_record` group by `stu_id` +) as `t2` on `t1`.`stu_id`=`t2`.`stu_id`; + +-- 修改选课记录表，去掉 stu_id 列的外键约束 +alter table `tb_record` drop foreign key `fk_record_stu_id`; + +-- 插入两条新纪录（注意：没有学号为 5566 的学生） +insert into `tb_record` +values + (default, 5566, 1111, '2019-09-02', 80), + (default, 5566, 2222, '2019-09-02', 70); + +-- 右外连接：右表（写在join右边的表）的每条记录都可以查出来，不满足连表条件的地方填充null。 +select `stu_name`, `total` from `tb_student` as `t1` +right outer join ( + select `stu_id`, count(*) as `total` + from `tb_record` group by `stu_id` +) as `t2` on `t1`.`stu_id`=`t2`.`stu_id`; + +-- 全外连接：左表和右表的每条记录都可以查出来，不满足连表条件的地方填充null。 +-- 说明：MySQL不支持全外连接，所以用左外连接和右外连接的并集来表示。 +select `stu_name`, `total` +from `tb_student` as `t1` +left outer join ( + select `stu_id`, count(*) as `total` + from `tb_record` group by `stu_id` +) as `t2` on `t1`.`stu_id`=`t2`.`stu_id` +union +select `stu_name`, `total` from `tb_student` as `t1` +right outer join ( + select `stu_id`, count(*) as `total` + from `tb_record` group by `stu_id` +) as `t2` on `t1`.`stu_id`=`t2`.`stu_id`; +``` + +上面的DML有几个地方需要加以说明： + +1. MySQL目前的版本不支持全外连接，上面我们通过`union`操作，将左外连接和右外连接的结果求并集实现全外连接的效果。大家可以通过下面的图来加深对连表操作的认识。 + + + +2. MySQL 中支持多种类型的运算符，包括：算术运算符（`+`、`-`、`*`、`/`、`%`）、比较运算符（`=`、`<>`、`<=>`、`<`、`<=`、`>`、`>=`、`BETWEEN...AND..`.、`IN`、`IS NULL`、`IS NOT NULL`、`LIKE`、`RLIKE`、`REGEXP`）、逻辑运算符（`NOT`、`AND`、`OR`、`XOR`）和位运算符（`&`、`|`、`^`、`~`、`>>`、`<<`），我们可以在 DML 中使用这些运算符处理数据。 + +3. 在查询数据时，可以在`SELECT`语句及其子句（如`WHERE`子句、`ORDER BY`子句、`HAVING`子句等）中使用函数，这些函数包括字符串函数、数值函数、时间日期函数、流程函数等，如下面的表格所示。 + + 常用字符串函数。 + + | 函数 | 功能 | + | --------------------------- | ----------------------------------------------------- | + | `CONCAT` | 将多个字符串连接成一个字符串 | + | `FORMAT` | 将数值格式化成字符串并指定保留几位小数 | + | `FROM_BASE64` / `TO_BASE64` | BASE64解码/编码 | + | `BIN` / `OCT` / `HEX` | 将数值转换成二进制/八进制/十六进制字符串 | + | `LOCATE` | 在字符串中查找一个子串的位置 | + | `LEFT` / `RIGHT` | 返回一个字符串左边/右边指定长度的字符 | + | `LENGTH` / `CHAR_LENGTH` | 返回字符串的长度以字节/字符为单位 | + | `LOWER` / `UPPER` | 返回字符串的小写/大写形式 | + | `LPAD` / `RPAD` | 如果字符串的长度不足，在字符串左边/右边填充指定的字符 | + | `LTRIM` / `RTRIM` | 去掉字符串前面/后面的空格 | + | `ORD` / `CHAR` | 返回字符对应的编码/返回编码对应的字符 | + | `STRCMP` | 比较字符串，返回-1、0、1分别表示小于、等于、大于 | + | `SUBSTRING` | 返回字符串指定范围的子串 | + + 常用数值函数。 + + | 函数 | 功能 | + | -------------------------------------------------------- | ---------------------------------- | + | `ABS` | 返回一个数的绝度值 | + | `CEILING` / `FLOOR` | 返回一个数上取整/下取整的结果 | + | `CONV` | 将一个数从一种进制转换成另一种进制 | + | `CRC32` | 计算循环冗余校验码 | + | `EXP` / `LOG` / `LOG2` / `LOG10` | 计算指数/对数 | + | `POW` | 求幂 | + | `RAND` | 返回[0,1)范围的随机数 | + | `ROUND` | 返回一个数四舍五入后的结果 | + | `SQRT` | 返回一个数的平方根 | + | `TRUNCATE` | 截断一个数到指定的精度 | + | `SIN` / `COS` / `TAN` / `COT` / `ASIN` / `ACOS` / `ATAN` | 三角函数 | + + 常用时间日期函数。 + + | 函数 | 功能 | + | ----------------------------- | ------------------------------------- | + | `CURDATE` / `CURTIME` / `NOW` | 获取当前日期/时间/日期和时间 | + | `ADDDATE` / `SUBDATE` | 将两个日期表达式相加/相减并返回结果 | + | `DATE` / `TIME` | 从字符串中获取日期/时间 | + | `YEAR` / `MONTH` / `DAY` | 从日期中获取年/月/日 | + | `HOUR` / `MINUTE` / `SECOND` | 从时间中获取时/分/秒 | + | `DATEDIFF` / `TIMEDIFF` | 返回两个时间日期表达式相差多少天/小时 | + | `MAKEDATE` / `MAKETIME` | 制造一个日期/时间 | + + 常用流程函数。 + + | 函数 | 功能 | + | -------- | ------------------------------------------------ | + | `IF` | 根据条件是否成立返回不同的值 | + | `IFNULL` | 如果为NULL则返回指定的值否则就返回本身 | + | `NULLIF` | 两个表达式相等就返回NULL否则返回第一个表达式的值 | + + 其他常用函数。 + + | 函数 | 功能 | + | -------------------------- | ----------------------------- | + | `MD5` / `SHA1` / `SHA2` | 返回字符串对应的哈希摘要 | + | `CHARSET` / `COLLATION` | 返回字符集/校对规则 | + | `USER` / `CURRENT_USER` | 返回当前用户 | + | `DATABASE` | 返回当前数据库名 | + | `VERSION` | 返回当前数据库版本 | + | `FOUND_ROWS` / `ROW_COUNT` | 返回查询到的行数/受影响的行数 | + | `LAST_INSERT_ID` | 返回最后一个自增主键的值 | + | `UUID` / `UUID_SHORT` | 返回全局唯一标识符 | + +### DCL（数据控制语言） + +数据控制语言用于给指定的用户授权或者从召回指定用户的指定权限，这组操作对数据库管理员来说比较重要，将一个用户的权限最小化（刚好够用）是非常重要的，对数据库的安全至关重要。 + +```SQL +-- 创建名为 wangdachui 的账号并为其指定口令，允许该账号从任意主机访问 +create user 'wangdachui'@'%' identified by '123456'; + +-- 授权 wangdachui 可以对名为school的数据库执行 select 和 insert 操作 +grant select, insert on `school`.* to 'wangdachui'@'%'; + +-- 召回 wangdachui 对school数据库的 insert 权限 +revoke insert on `school`.* from 'wangdachui'@'%'; +``` + +> **说明**：创建一个可以允许任意主机登录并且具有超级管理员权限的用户在现实中并不是一个明智的决定，因为一旦该账号的口令泄露或者被破解，数据库将会面临灾难级的风险。 diff --git "a/\347\254\25442\350\257\276\357\274\232\346\267\261\345\205\245MySQL.md" "b/\347\254\25442\350\257\276\357\274\232\346\267\261\345\205\245MySQL.md" new file mode 100644 index 0000000..27b941a --- /dev/null +++ "b/\347\254\25442\350\257\276\357\274\232\346\267\261\345\205\245MySQL.md" @@ -0,0 +1,661 @@ +## 第42课：深入MySQL + +### 索引 + +索引是关系型数据库中用来提升查询性能最为重要的手段。关系型数据库中的索引就像一本书的目录，我们可以想象一下，如果要从一本书中找出某个知识点，但是这本书没有目录，这将是意见多么可怕的事情！我们估计得一篇一篇的翻下去，才能确定这个知识点到底在什么位置。创建索引虽然会带来存储空间上的开销，就像一本书的目录会占用一部分篇幅一样，但是在牺牲空间后换来的查询时间的减少也是非常显著的。 + +MySQL 数据库中所有数据类型的列都可以被索引。对于MySQL 8.0 版本的 InnoDB 存储引擎来说，它支持三种类型的索引，分别是 B+ 树索引、全文索引和 R 树索引。这里，我们只介绍使用得最为广泛的 B+ 树索引。使用 B+ 树的原因非常简单，因为它是目前在基于磁盘进行海量数据存储和排序上最有效率的数据结构。B+ 树是一棵[平衡树](https://zh.wikipedia.org/zh-cn/%E5%B9%B3%E8%A1%A1%E6%A0%91)，树的高度通常为3或4，但是却可以保存从百万级到十亿级的数据，而从这些数据里面查询一条数据，只需要3次或4次 I/O 操作。 + +B+ 树由根节点、中间节点和叶子节点构成，其中叶子节点用来保存排序后的数据。由于记录在索引上是排序过的，因此在一个叶子节点内查找数据时可以使用二分查找，这种查找方式效率非常的高。当数据很少的时候，B+ 树只有一个根节点，数据也就保存在根节点上。随着记录越来越多，B+ 树会发生分裂，根节点不再保存数据，而是提供了访问下一层节点的指针，帮助快速确定数据在哪个叶子节点上。 + +在创建二维表时，我们通常都会为表指定主键列，主键列上默认会创建索引，而对于 MySQL InnoDB 存储引擎来说，因为它使用的是索引组织表这种数据存储结构，所以主键上的索引就是整张表的数据，而这种索引我们也将其称之为**聚集索引**（clustered index）。很显然，一张表只能有一个聚集索引，否则表的数据岂不是要保存多次。我们自己创建的索引都是二级索引（secondary index），更常见的叫法是**非聚集索引**（non-clustered index）。通过我们自定义的非聚集索引只能定位记录的主键，在获取数据时可能需要再通过主键上的聚集索引进行查询，这种现象称为“回表”，因此通过非聚集索引检索数据通常比使用聚集索引检索数据要慢。 + +接下来我们通过一个简单的例子来说明索引的意义，比如我们要根据学生的姓名来查找学生，这个场景在实际开发中应该经常遇到，就跟通过商品名称查找商品是一个道理。我们可以使用 MySQL 的`explain`关键字来查看 SQL 的执行计划（数据库执行 SQL 语句的具体步骤）。 + +```SQL +explain select * from tb_student where stuname='林震南'\G +``` + +``` +*************************** 1. row *************************** + id: 1 + select_type: SIMPLE + table: tb_student + partitions: NULL + type: ALL +possible_keys: NULL + key: NULL + key_len: NULL + ref: NULL + rows: 11 + filtered: 10.00 + Extra: Using where +1 row in set, 1 warning (0.00 sec) +``` + +在上面的 SQL 执行计划中，有几项值得我们关注： + +1. `select_type`：查询的类型。 + - `SIMPLE`：简单 SELECT，不需要使用 UNION 操作或子查询。 + - `PRIMARY`：如果查询包含子查询，最外层的 SELECT 被标记为 PRIMARY。 + - `UNION`：UNION 操作中第二个或后面的 SELECT 语句。 + - `SUBQUERY`：子查询中的第一个 SELECT。 + - `DERIVED`：派生表的 SELECT 子查询。 +2. `table`：查询对应的表。 +3. `type`：MySQL 在表中找到满足条件的行的方式，也称为访问类型，包括：`ALL`（全表扫描）、`index`（索引全扫描，只遍历索引树）、`range`（索引范围扫描）、`ref`（非唯一索引扫描）、`eq_ref`（唯一索引扫描）、`const` / `system`（常量级查询）、`NULL`（不需要访问表或索引）。在所有的访问类型中，很显然 ALL 是性能最差的，它代表的全表扫描是指要扫描表中的每一行才能找到匹配的行。 +4. `possible_keys`：MySQL 可以选择的索引，但是**有可能不会使用**。 +5. `key`：MySQL 真正使用的索引，如果为`NULL`就表示没有使用索引。 +6. `key_len`：使用的索引的长度，在不影响查询的情况下肯定是长度越短越好。 +7. `rows`：执行查询需要扫描的行数，这是一个**预估值**。 +8. `extra`：关于查询额外的信息。 + - `Using filesort`：MySQL 无法利用索引完成排序操作。 + - `Using index`：只使用索引的信息而不需要进一步查表来获取更多的信息。 + - `Using temporary`：MySQL 需要使用临时表来存储结果集，常用于分组和排序。 + - `Impossible where`：`where`子句会导致没有符合条件的行。 + - `Distinct`：MySQL 发现第一个匹配行后，停止为当前的行组合搜索更多的行。 + - `Using where`：查询的列未被索引覆盖，筛选条件并不是索引的前导列。 + +从上面的执行计划可以看出，当我们通过学生名字查询学生时实际上是进行了全表扫描，不言而喻这个查询性能肯定是非常糟糕的，尤其是在表中的行很多的时候。如果我们需要经常通过学生姓名来查询学生，那么就应该在学生姓名对应的列上创建索引，通过索引来加速查询。 + +```SQL +create index idx_student_name on tb_student(stuname); +``` + +再次查看刚才的 SQL 对应的执行计划。 + +```SQL +explain select * from tb_student where stuname='林震南'\G +``` + +``` +*************************** 1. row *************************** + id: 1 + select_type: SIMPLE + table: tb_student + partitions: NULL + type: ref +possible_keys: idx_student_name + key: idx_student_name + key_len: 62 + ref: const + rows: 1 + filtered: 100.00 + Extra: NULL +1 row in set, 1 warning (0.00 sec) +``` + +可以注意到，在对学生姓名创建索引后，刚才的查询已经不是全表扫描而是基于索引的查询，而且扫描的行只有唯一的一行，这显然大大的提升了查询的性能。MySQL 中还允许创建前缀索引，即对索引字段的前N个字符创建索引，这样的话可以减少索引占用的空间（但节省了空间很有可能会浪费时间，**时间和空间是不可调和的矛盾**），如下所示。 + +```SQL +create index idx_student_name_1 on tb_student(stuname(1)); +``` + +上面的索引相当于是根据学生姓名的第一个字来创建的索引，我们再看看 SQL 执行计划。 + +```SQL +explain select * from tb_student where stuname='林震南'\G +``` + +``` +*************************** 1. row *************************** + id: 1 + select_type: SIMPLE + table: tb_student + partitions: NULL + type: ref +possible_keys: idx_student_name + key: idx_student_name + key_len: 5 + ref: const + rows: 2 + filtered: 100.00 + Extra: Using where +1 row in set, 1 warning (0.00 sec) +``` + +不知道大家是否注意到，这一次扫描的行变成了2行，因为学生表中有两个姓“林”的学生，我们只用姓名的第一个字作为索引的话，在查询时通过索引就会找到这两行。 + +如果要删除索引，可以使用下面的SQL。 + +```SQL +alter table tb_student drop index idx_student_name; +``` + +或者 + +```SQL +drop index idx_student_name on tb_student; +``` + +在创建索引时，我们还可以使用复合索引、函数索引（MySQL 5.7 开始支持），用好复合索引实现**索引覆盖**可以减少不必要的排序和回表操作，这样就会让查询的性能成倍的提升，有兴趣的读者可以自行研究。 + +我们简单的为大家总结一下索引的设计原则： + +1. **最适合**索引的列是出现在**WHERE子句**和连接子句中的列。 +2. 索引列的基数越大（取值多、重复值少），索引的效果就越好。 +3. 使用**前缀索引**可以减少索引占用的空间，内存中可以缓存更多的索引。 +4. **索引不是越多越好**，虽然索引加速了读操作（查询），但是写操作（增、删、改）都会变得更慢，因为数据的变化会导致索引的更新，就如同书籍章节的增删需要更新目录一样。 +5. 使用 InnoDB 存储引擎时，表的普通索引都会保存主键的值，所以**主键要尽可能选择较短的数据类型**，这样可以有效的减少索引占用的空间，提升索引的缓存效果。 + +最后，还有一点需要说明，InnoDB 使用的 B-tree 索引，数值类型的列除了等值判断时索引会生效之外，使用`>`、`<`、`>=`、`<=`、`BETWEEN...AND... `、`<>`时，索引仍然生效；对于字符串类型的列，如果使用不以通配符开头的模糊查询，索引也是起作用的，但是其他的情况会导致索引失效，这就意味着很有可能会做全表查询。 + +### 视图 + +视图是关系型数据库中将一组查询指令构成的结果集组合成可查询的数据表的对象。简单的说，视图就是虚拟的表，但与数据表不同的是，数据表是一种实体结构，而视图是一种虚拟结构，你也可以将视图理解为保存在数据库中被赋予名字的 SQL 语句。 + +使用视图可以获得以下好处： + +1. 可以将实体数据表隐藏起来，让外部程序无法得知实际的数据结构，让访问者可以使用表的组成部分而不是整个表，降低数据库被攻击的风险。 +2. 在大多数的情况下视图是只读的（更新视图的操作通常都有诸多的限制），外部程序无法直接透过视图修改数据。 +3. 重用 SQL 语句，将高度复杂的查询包装在视图表中，直接访问该视图即可取出需要的数据；也可以将视图视为数据表进行连接查询。 +4. 视图可以返回与实体数据表不同格式的数据，在创建视图的时候可以对数据进行格式化处理。 + +创建视图。 + +```SQL +-- 创建视图 +create view `vw_avg_score` +as + select `stu_id`, round(avg(`score`), 1) as `avg_score` + from `tb_record` group by `stu_id`; + +-- 基于已有的视图创建视图 +create view `vw_student_score` +as + select `stu_name`, `avg_score` + from `tb_student` natural join `vw_avg_score`; +``` + +> **提示**：因为视图不包含数据，所以每次使用视图时，都必须执行查询以获得数据，如果你使用了连接查询、嵌套查询创建了较为复杂的视图，你可能会发现查询性能下降得很厉害。因此，在使用复杂的视图前，应该进行测试以确保其性能能够满足应用的需求。 + +使用视图。 + +```SQL +select * from `vw_student_score` order by `avg_score` desc; +``` + +``` ++--------------+----------+ +| stuname | avgscore | ++--------------+----------+ +| 杨过 | 95.6 | +| 任我行 | 53.5 | +| 王语嫣 | 84.3 | +| 纪嫣然 | 73.8 | +| 岳不群 | 78.0 | +| 东方不败 | 88.0 | +| 项少龙 | 92.0 | ++--------------+----------+ +``` + +既然视图是一张虚拟的表，那么视图的中的数据可以更新吗？视图的可更新性要视具体情况而定，以下类型的视图是不能更新的： + +1. 使用了聚合函数（`SUM`、`MIN`、`MAX`、`AVG`、`COUNT`等）、`DISTINCT`、`GROUP BY`、`HAVING`、`UNION`或者`UNION ALL`的视图。 +2. `SELECT`中包含了子查询的视图。 +3. `FROM`子句中包含了一个不能更新的视图的视图。 +4. `WHERE`子句的子查询引用了`FROM`子句中的表的视图。 + +删除视图。 + +```SQL +drop view vw_student_score; +``` + +> **说明**：如果希望更新视图，可以先用上面的命令删除视图，也可以通过`create or replace view`来更新视图。 + +视图的规则和限制。 + +1. 视图可以嵌套，可以利用从其他视图中检索的数据来构造一个新的视图。视图也可以和表一起使用。 +2. 创建视图时可以使用`order by`子句，但如果从视图中检索数据时也使用了`order by`，那么该视图中原先的`order by`会被覆盖。 +3. 视图无法使用索引，也不会激发触发器（实际开发中因为性能等各方面的考虑，通常不建议使用触发器，所以我们也不对这个概念进行介绍）的执行。 + +### 函数 + +MySQL 中的函数跟 Python 中的函数太多的差异，因为函数都是用来封装功能上相对独立且会被重复使用的代码的。如果非要找出一些差别来，那么 MySQL 中的函数是可以执行 SQL 语句的。下面的例子，我们通过自定义函数实现了截断超长字符串的功能。 + +```SQL +delimiter $$ + +create function truncate_string( + content varchar(10000), + max_length int unsigned +) returns varchar(10000) no sql +begin + declare result varchar(10000) default content; + if char_length(content) > max_length then + set result = left(content, max_length); + set result = concat(result, '……'); + end if; + return result; +end $$ + +delimiter ; +``` + +> **说明1**：函数声明后面的`no sql`是声明函数体并没有使用 SQL 语句；如果函数体中需要通过 SQL 读取数据，需要声明为`reads sql data`。 +> +> **说明2**：定义函数前后的`delimiter`命令是为了修改定界符，因为函数体中的语句都是用`;`表示结束，如果不重新定义定界符，那么遇到的`;`的时候代码就会被截断执行，显然这不是我们想要的效果。 + +在查询中调用自定义函数。 + +```SQL +select truncate_string('和我在成都的街头走一走，直到所有的灯都熄灭了也不停留', 10) as short_string; +``` + +``` ++--------------------------------------+ +| short_string | ++--------------------------------------+ +| 和我在成都的街头走一…… | ++--------------------------------------+ +``` + +### 过程 + +过程（又称存储过程）是事先编译好存储在数据库中的一组 SQL 的集合，调用过程可以简化应用程序开发人员的工作，减少与数据库服务器之间的通信，对于提升数据操作的性能也是有帮助的。其实迄今为止，我们使用的 SQL 语句都是针对一个或多个表的单条语句，但在实际开发中经常会遇到某个操作需要多条 SQL 语句才能完成的情况。例如，电商网站在受理用户订单时，需要做以下一系列的处理。 + +1. 通过查询来核对库存中是否有对应的物品以及库存是否充足。 +2. 如果库存有物品，需要锁定库存以确保这些物品不再卖给别人， 并且要减少可用的物品数量以反映正确的库存量。 +3. 如果库存不足，可能需要进一步与供应商进行交互或者至少产生一条系统提示消息。 +4. 不管受理订单是否成功，都需要产生流水记录，而且需要给对应的用户产生一条通知信息。 + +我们可以通过过程将复杂的操作封装起来，这样不仅有助于保证数据的一致性，而且将来如果业务发生了变动，只需要调整和修改过程即可。对于调用过程的用户来说，过程并没有暴露数据表的细节，而且执行过程比一条条的执行一组 SQL 要快得多。 + +下面的过程实现了查询某门课程的最高分、最低分和平均分。 + +```SQL +drop procedure if exists sp_score_stat; + +delimiter $$ + +create procedure sp_score_stat( + courseId int, + out maxScore decimal(4,1), + out minScore decimal(4,1), + out avgScore decimal(4,1) +) +begin + select max(score) into maxScore from tb_record where cou_id=courseId; + select min(score) into minScore from tb_record where cou_id=courseId; + select avg(score) into avgScore from tb_record where cou_id=courseId; +end $$ + +delimiter ; +``` + +> **说明**：在定义过程时，因为可能需要书写多条 SQL，而分隔这些 SQL 需要使用分号作为分隔符，如果这个时候，仍然用分号表示整段代码结束，那么定义过程的 SQL 就会出现错误，所以上面我们用`delimiter $$`将整段代码结束的标记定义为`$$`，那么代码中的分号将不再表示整段代码的结束，整段代码只会在遇到`end $$`时才会执行。在定义完过程后，通过`delimiter ;`将结束符重新改回成分号（恢复现场）。 + +上面定义的过程有四个参数，其中第一个参数是输入参数，代表课程的编号，后面的参数都是输出参数，因为过程不能定义返回值，只能通过输出参数将执行结果带出，定义输出参数的关键字是`out`，默认情况下参数都是输入参数。 + +调用过程。 + +```SQL +call sp_score_stat(1111, @a, @b, @c); +``` + +获取输出参数的值。 + +```SQL +select @a as 最高分, @b as 最低分, @c as 平均分; +``` + +删除过程。 + +```SQL +drop procedure sp_score_stat; +``` + +在过程中，我们可以定义变量、条件，可以使用分支和循环语句，可以通过游标操作查询结果，还可以使用事件调度器，这些内容我们暂时不在此处进行介绍。虽然我们说了很多过程的好处，但是在实际开发中，如果频繁的使用过程并将大量复杂的运算放到过程中，会给据库服务器造成巨大的压力，而数据库往往都是性能瓶颈所在，使用过程无疑是雪上加霜的操作。所以，对于互联网产品开发，我们一般建议让数据库只做好存储，复杂的运算和处理交给应用服务器上的程序去完成，如果应用服务器变得不堪重负了，我们可以比较容易的部署多台应用服务器来分摊这些压力。 + +如果大家对上面讲到的视图、函数、过程包括我们没有讲到的触发器这些知识有兴趣，建议大家阅读 MySQL 的入门读物[《MySQL必知必会》](https://item.jd.com/12818982.html)进行一般性了解即可，因为这些知识点在大家将来的工作中未必用得上，学了也可能仅仅是为了应付面试而已。 + +### MySQL 新特性 + +#### JSON类型 + +很多开发者在使用关系型数据库做数据持久化的时候，常常感到结构化的存储缺乏灵活性，因为必须事先设计好所有的列以及对应的数据类型。在业务发展和变化的过程中，如果需要修改表结构，这绝对是比较麻烦和难受的事情。从 MySQL 5.7 版本开始，MySQL引入了对 JSON 数据类型的支持（MySQL 8.0 解决了 JSON 的日志性能瓶颈问题），用好 JSON 类型，其实就是打破了关系型数据库和非关系型数据库之间的界限，为数据持久化操作带来了更多的便捷。 + +JSON 类型主要分为 JSON 对象和 JSON数组两种，如下所示。 + +1. JSON 对象 + +```JSON +{"name": "骆昊", "tel": "13122335566", "QQ": "957658"} +``` + +2. JSON 数组 + +```JSON +[1, 2, 3] +``` + +```JSON +[{"name": "骆昊", "tel": "13122335566"}, {"name": "王大锤", "QQ": "123456"}] +``` + +哪些地方需要用到JSON类型呢？举一个简单的例子，现在很多产品的用户登录都支持多种方式，例如手机号、微信、QQ、新浪微博等，但是一般情况下我们又不会要求用户提供所有的这些信息，那么用传统的设计方式，就需要设计多个列来对应多种登录方式，可能还需要允许这些列存在空值，这显然不是很好的选择；另一方面，如果产品又增加了一种登录方式，那么就必然要修改之前的表结构，这就更让人痛苦了。但是，有了 JSON 类型，刚才的问题就迎刃而解了，我们可以做出如下所示的设计。 + +```SQL +create table `tb_test` +( +`user_id` bigint unsigned, +`login_info` json, +primary key (`user_id`) +) engine=innodb; + +insert into `tb_test` values + (1, '{"tel": "13122335566", "QQ": "654321", "wechat": "jackfrued"}'), + (2, '{"tel": "13599876543", "weibo": "wangdachui123"}'); +``` + +如果要查询用户的手机和微信号，可以用如下所示的 SQL 语句。 + +```SQL +select + `user_id`, + json_unquote(json_extract(`login_info`, '$.tel')) as 手机号, + json_unquote(json_extract(`login_info`, '$.wechat')) as 微信 +from `tb_test`; +``` + +``` ++---------+-------------+-----------+ +| user_id | 手机号 | 微信 | ++---------+-------------+-----------+ +| 1 | 13122335566 | jackfrued | +| 2 | 13599876543 | NULL | ++---------+-------------+-----------+ +``` + +因为支持 JSON 类型，MySQL 也提供了配套的处理 JSON 数据的函数，就像上面用到的`json_extract`和`json_unquote`。当然，上面的 SQL 还有更为便捷的写法，如下所示。 + +```SQL +select + `user_id`, + `login_info` ->> '$.tel' as 手机号, + `login_info` ->> '$.wechat' as 微信 +from `tb_test`; +``` + +再举个例子，如果我们的产品要实现用户画像功能（给用户打标签），然后基于用户画像给用户推荐平台的服务或消费品之类的东西，我们也可以使用 JSON 类型来保存用户画像数据，示意代码如下所示。 + +创建画像标签表。 + +```SQL +create table `tb_tags` +( +`tag_id` int unsigned not null comment '标签ID', +`tag_name` varchar(20) not null comment '标签名', +primary key (`tag_id`) +) engine=innodb; + +insert into `tb_tags` (`tag_id`, `tag_name`) +values + (1, '70后'), + (2, '80后'), + (3, '90后'), + (4, '00后'), + (5, '爱运动'), + (6, '高学历'), + (7, '小资'), + (8, '有房'), + (9, '有车'), + (10, '爱看电影'), + (11, '爱网购'), + (12, '常点外卖'); +``` + +为用户打标签。 + +```SQL +create table `tb_users_tags` +( +`user_id` bigint unsigned not null comment '用户ID', +`user_tags` json not null comment '用户标签' +) engine=innodb; + +insert into `tb_users_tags` values + (1, '[2, 6, 8, 10]'), + (2, '[3, 10, 12]'), + (3, '[3, 8, 9, 11]'); +``` + +接下来，我们通过一组查询来了解 JSON 类型的巧妙之处。 + +1. 查询爱看电影（有`10`这个标签）的用户ID。 + + ```SQL + select * from `tb_users` where 10 member of (user_tags->'$'); + ``` + +2. 查询爱看电影（有`10`这个标签）的80后（有`2`这个标签）用户ID。 + + ``` + select * from `tb_users` where json_contains(user_tags->'$', '[2, 10]'); + +3. 查询爱看电影或80后或90后的用户ID。 + + ```SQL + select `user_id` from `tb_users_tags` where json_overlaps(user_tags->'$', '[2, 3, 10]'); + ``` + +> **说明**：上面的查询用到了`member of`谓词和两个 JSON 函数，`json_contains`可以检查 JSON 数组是否包含了指定的元素，而`json_overlaps`可以检查 JSON 数组是否与指定的数组有重叠部分。 + +#### 窗口函数 + +MySQL 从8.0开始支持窗口函数，大多数商业数据库和一些开源数据库早已提供了对窗口函数的支持，有的也将其称之为 OLAP（联机分析和处理）函数，听名字就知道跟统计和分析相关。为了帮助大家理解窗口函数，我们先说说窗口的概念。 + +窗口可以理解为记录的集合，窗口函数也就是在满足某种条件的记录集合上执行的特殊函数，对于每条记录都要在此窗口内执行函数。窗口函数和我们上面讲到的聚合函数比较容易混淆，二者的区别主要在于聚合函数是将多条记录聚合为一条记录，窗口函数是每条记录都会执行，执行后记录条数不会变。窗口函数不仅仅是几个函数，它是一套完整的语法，函数只是该语法的一部分，基本语法如下所示： + +```SQL +<窗口函数> over (partition by <用于分组的列名> order by <用户排序的列名>) +``` + +上面语法中，窗口函数的位置可以放以下两种函数： + +1. 专用窗口函数，包括：`lead`、`lag`、`first_value`、`last_value`、`rank`、`dense_rank`和`row_number`等。 +2. 聚合函数，包括：`sum`、`avg`、`max`、`min`和`count`等。 + +下面为大家举几个使用窗口函数的简单例子，我们先用如下所示的 SQL 建库建表。 + +```SQL +-- 创建名为hrs的数据库并指定默认的字符集 +create database `hrs` default charset utf8mb4; + +-- 切换到hrs数据库 +use `hrs`; + +-- 创建部门表 +create table `tb_dept` +( +`dno` int not null comment '编号', +`dname` varchar(10) not null comment '名称', +`dloc` varchar(20) not null comment '所在地', +primary key (`dno`) +); + +-- 插入4个部门 +insert into `tb_dept` values + (10, '会计部', '北京'), + (20, '研发部', '成都'), + (30, '销售部', '重庆'), + (40, '运维部', '深圳'); + +-- 创建员工表 +create table `tb_emp` +( +`eno` int not null comment '员工编号', +`ename` varchar(20) not null comment '员工姓名', +`job` varchar(20) not null comment '员工职位', +`mgr` int comment '主管编号', +`sal` int not null comment '员工月薪', +`comm` int comment '每月补贴', +`dno` int not null comment '所在部门编号', +primary key (`eno`), +constraint `fk_emp_mgr` foreign key (`mgr`) references tb_emp (`eno`), +constraint `fk_emp_dno` foreign key (`dno`) references tb_dept (`dno`) +); + +-- 插入14个员工 +insert into `tb_emp` values + (7800, '张三丰', '总裁', null, 9000, 1200, 20), + (2056, '乔峰', '分析师', 7800, 5000, 1500, 20), + (3088, '李莫愁', '设计师', 2056, 3500, 800, 20), + (3211, '张无忌', '程序员', 2056, 3200, null, 20), + (3233, '丘处机', '程序员', 2056, 3400, null, 20), + (3251, '张翠山', '程序员', 2056, 4000, null, 20), + (5566, '宋远桥', '会计师', 7800, 4000, 1000, 10), + (5234, '郭靖', '出纳', 5566, 2000, null, 10), + (3344, '黄蓉', '销售主管', 7800, 3000, 800, 30), + (1359, '胡一刀', '销售员', 3344, 1800, 200, 30), + (4466, '苗人凤', '销售员', 3344, 2500, null, 30), + (3244, '欧阳锋', '程序员', 3088, 3200, null, 20), + (3577, '杨过', '会计', 5566, 2200, null, 10), + (3588, '朱九真', '会计', 5566, 2500, null, 10); +``` + +例子1：查询按月薪从高到低排在第4到第6名的员工的姓名和月薪。 + +```SQL +select * from ( + select + `ename`, `sal`, + row_number() over (order by `sal` desc) as `rank` + from `tb_emp` +) `temp` where `rank` between 4 and 6; +``` + +> **说明**：上面使用的函数`row_number()`可以为每条记录生成一个行号，在实际工作中可以根据需要将其替换为`rank()`或`dense_rank()`函数，三者的区别可以参考官方文档或阅读[《通俗易懂的学会：SQL窗口函数》](https://zhuanlan.zhihu.com/p/92654574)进行了解。在MySQL 8以前的版本，我们可以通过下面的方式来完成类似的操作。 +> +> ```SQL +> select `rank`, `ename`, `sal` from ( +> select @a:=@a+1 as `rank`, `ename`, `sal` +> from `tb_emp`, (select @a:=0) as t1 order by `sal` desc +> ) as `temp` where `rank` between 4 and 6; +> ``` + +例子2：查询每个部门月薪最高的两名的员工的姓名和部门名称。 + +```SQL +select `ename`, `sal`, `dname` +from ( + select + `ename`, `sal`, `dno`, + rank() over (partition by `dno` order by `sal` desc) as `rank` + from `tb_emp` +) as `temp` natural join `tb_dept` where `rank`<=2; +``` + +> 说明：在MySQL 8以前的版本，我们可以通过下面的方式来完成类似的操作。 +> +> ```SQL +> select `ename`, `sal`, `dname` from `tb_emp` as `t1` +natural join `tb_dept` +where ( + select count(*) from `tb_emp` as `t2` + where `t1`.`dno`=`t2`.`dno` and `t2`.`sal`>`t1`.`sal` +)<2 order by `dno` asc, `sal` desc; +> ``` + +### 其他内容 + +#### 范式理论 + +范式理论是设计关系型数据库中二维表的指导思想。 + +1. 第一范式：数据表的每个列的值域都是由原子值组成的，不能够再分割。 +2. 第二范式：数据表里的所有数据都要和该数据表的键（主键与候选键）有完全依赖关系。 +3. 第三范式：所有非键属性都只和候选键有相关性，也就是说非键属性之间应该是独立无关的。 + +> **说明**：实际工作中，出于效率的考虑，我们在设计表时很有可能做出反范式设计，即故意降低方式级别，增加冗余数据来获得更好的操作性能。 + +#### 数据完整性 + +1. 实体完整性 - 每个实体都是独一无二的 + + - 主键（`primary key`） / 唯一约束（`unique`） +2. 引用完整性（参照完整性）- 关系中不允许引用不存在的实体 + + - 外键（`foreign key`） +3. 域（domain）完整性 - 数据是有效的 + - 数据类型及长度 + + - 非空约束（`not null`） + + - 默认值约束（`default`） + + - 检查约束（`check`） + + > **说明**：在 MySQL 8.x 以前，检查约束并不起作用。 + +#### 数据一致性 + +1. 事务：一系列对数据库进行读/写的操作，这些操作要么全都成功，要么全都失败。 + +2. 事务的 ACID 特性 + - 原子性：事务作为一个整体被执行，包含在其中的对数据库的操作要么全部被执行，要么都不执行 + - 一致性：事务应确保数据库的状态从一个一致状态转变为另一个一致状态 + - 隔离性：多个事务并发执行时，一个事务的执行不应影响其他事务的执行 + - 持久性：已被提交的事务对数据库的修改应该永久保存在数据库中 + +3. MySQL 中的事务操作 + + - 开启事务环境 + + ```SQL + start transaction + ``` + + - 提交事务 + + ```SQL + commit + ``` + + - 回滚事务 + + ```SQL + rollback + ``` + +4. 查看事务隔离级别 + + ```SQL + show variables like 'transaction_isolation'; + ``` + + ``` + +-----------------------+-----------------+ + | Variable_name | Value | + +-----------------------+-----------------+ + | transaction_isolation | REPEATABLE-READ | + +-----------------------+-----------------+ + ``` + + 可以看出，MySQL 默认的事务隔离级别是`REPEATABLE-READ`。 + +5. 修改（当前会话）事务隔离级别 + + ```SQL + set session transaction isolation level read committed; + ``` + + 重新查看事务隔离级别，结果如下所示。 + + ``` + +-----------------------+----------------+ + | Variable_name | Value | + +-----------------------+----------------+ + | transaction_isolation | READ-COMMITTED | + +-----------------------+----------------+ + ``` + +关系型数据库的事务是一个很大的话题，因为当存在多个并发事务访问数据时，就有可能出现三类读数据的问题（脏读、不可重复读、幻读）和两类更新数据的问题（第一类丢失更新、第二类丢失更新）。想了解这五类问题的，可以阅读我发布在 CSDN 网站上的[《Java面试题全集（上）》](https://blog.csdn.net/jackfrued/article/details/44921941)一文的第80题。为了避免这些问题，关系型数据库底层是有对应的锁机制的，按锁定对象不同可以分为表级锁和行级锁，按并发事务锁定关系可以分为共享锁和独占锁。然而直接使用锁是非常麻烦的，为此数据库为用户提供了自动锁机制，只要用户指定适当的事务隔离级别，数据库就会通过分析 SQL 语句，然后为事务访问的资源加上合适的锁。此外，数据库还会维护这些锁通过各种手段提高系统的性能，这些对用户来说都是透明的。想了解 MySQL 事务和锁的细节知识，推荐大家阅读进阶读物[《高性能MySQL》](https://item.jd.com/11220393.html)，这也是数据库方面的经典书籍。 + +ANSI/ISO SQL 92标准定义了4个等级的事务隔离级别，如下表所示。需要说明的是，事务隔离级别和数据访问的并发性是对立的，事务隔离级别越高并发性就越差。所以要根据具体的应用来确定到底使用哪种事务隔离级别，这个地方没有万能的原则。 + + + +### 总结 + +关于 MySQL 的知识肯定远远不止上面列出的这些，比如 MySQL 性能调优、MySQL 运维相关工具、MySQL 数据的备份和恢复、监控 MySQL 服务、部署高可用架构等，这一系列的问题在这里都没有办法逐一展开来讨论，那就留到有需要的时候再进行讲解吧，各位读者也可以自行探索。 diff --git "a/\347\254\25443\350\257\276\357\274\232Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" "b/\347\254\25443\350\257\276\357\274\232Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" new file mode 100644 index 0000000..49c5e71 --- /dev/null +++ "b/\347\254\25443\350\257\276\357\274\232Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" @@ -0,0 +1,295 @@ +## 第43课：Python程序接入MySQL数据库 + +在 Python3 中，我们可以使用`mysqlclient`或者`pymysql`三方库来接入 MySQL 数据库并实现数据持久化操作。二者的用法完全相同，只是导入的模块名不一样。我们推荐大家使用纯 Python 的三方库`pymysql`，因为它更容易安装成功。下面我们仍然以之前创建的名为`hrs`的数据库为例，为大家演示如何通过 Python 程序操作 MySQL 数据库实现数据持久化操作。 + +### 建库建表 + +```SQL +-- 创建名为hrs的数据库并指定默认的字符集 +create database `hrs` default character set utf8mb4; + +-- 切换到hrs数据库 +use `hrs`; + +-- 创建部门表 +create table `tb_dept` +( +`dno` int not null comment '编号', +`dname` varchar(10) not null comment '名称', +`dloc` varchar(20) not null comment '所在地', +primary key (`dno`) +); + +-- 插入4个部门 +insert into `tb_dept` values + (10, '会计部', '北京'), + (20, '研发部', '成都'), + (30, '销售部', '重庆'), + (40, '运维部', '深圳'); + +-- 创建员工表 +create table `tb_emp` +( +`eno` int not null comment '员工编号', +`ename` varchar(20) not null comment '员工姓名', +`job` varchar(20) not null comment '员工职位', +`mgr` int comment '主管编号', +`sal` int not null comment '员工月薪', +`comm` int comment '每月补贴', +`dno` int not null comment '所在部门编号', +primary key (`eno`), +constraint `fk_emp_mgr` foreign key (`mgr`) references tb_emp (`eno`), +constraint `fk_emp_dno` foreign key (`dno`) references tb_dept (`dno`) +); + +-- 插入14个员工 +insert into `tb_emp` values + (7800, '张三丰', '总裁', null, 9000, 1200, 20), + (2056, '乔峰', '分析师', 7800, 5000, 1500, 20), + (3088, '李莫愁', '设计师', 2056, 3500, 800, 20), + (3211, '张无忌', '程序员', 2056, 3200, null, 20), + (3233, '丘处机', '程序员', 2056, 3400, null, 20), + (3251, '张翠山', '程序员', 2056, 4000, null, 20), + (5566, '宋远桥', '会计师', 7800, 4000, 1000, 10), + (5234, '郭靖', '出纳', 5566, 2000, null, 10), + (3344, '黄蓉', '销售主管', 7800, 3000, 800, 30), + (1359, '胡一刀', '销售员', 3344, 1800, 200, 30), + (4466, '苗人凤', '销售员', 3344, 2500, null, 30), + (3244, '欧阳锋', '程序员', 3088, 3200, null, 20), + (3577, '杨过', '会计', 5566, 2200, null, 10), + (3588, '朱九真', '会计', 5566, 2500, null, 10); +``` + +### 接入MySQL + +首先，我们可以在命令行或者 PyCharm 的终端中通过下面的命令安装`pymysql`，如果需要接入 MySQL 8，还需要安装一个名为`cryptography`的三方库来支持 MySQL 8 的密码认证方式。 + +```Shell +pip install pymysql cryptography +``` + +使用`pymysql`操作 MySQL 的步骤如下所示： + +1. 创建连接。MySQL 服务器启动后，提供了基于 TCP （传输控制协议）的网络服务。我们可以通过`pymysql`模块的`connect`函数连接 MySQL 服务器。在调用`connect`函数时，需要指定主机（`host`）、端口（`port`）、用户名（`user`）、口令（`password`）、数据库（`database`）、字符集（`charset`）等参数，该函数会返回一个`Connection`对象。 +2. 获取游标。连接 MySQL 服务器成功后，接下来要做的就是向数据库服务器发送 SQL 语句，MySQL 会执行接收到的 SQL 并将执行结果通过网络返回。要实现这项操作，需要先通过连接对象的`cursor`方法获取游标（`Cursor`）对象。 +3. 发出 SQL。通过游标对象的`execute`方法，我们可以向数据库发出 SQL 语句。 +4. 如果执行`insert`、`delete`或`update`操作，需要根据实际情况提交或回滚事务。因为创建连接时，默认开启了事务环境，在操作完成后，需要使用连接对象的`commit`或`rollback`方法，实现事务的提交或回滚，`rollback`方法通常会放在异常捕获代码块`except`中。如果执行`select`操作，需要通过游标对象抓取查询的结果，对应的方法有三个，分别是：`fetchone`、`fetchmany`和`fetchall`。其中`fetchone`方法会抓取到一条记录，并以元组或字典的方式返回；`fetchmany`和`fetchall`方法会抓取到多条记录，以嵌套元组或列表装字典的方式返回。 +5. 关闭连接。在完成持久化操作后，请不要忘记关闭连接，释放外部资源。我们通常会在`finally`代码块中使用连接对象的`close`方法来关闭连接。 + +### 代码实操 + +下面，我们通过代码实操的方式为大家演示上面说的五个步骤。 + +#### 插入数据 + +```Python +import pymysql + +no = int(input('部门编号: ')) +name = input('部门名称: ') +location = input('部门所在地: ') + +# 1. 创建连接（Connection） +conn = pymysql.connect(host='127.0.0.1', port=3306, + user='guest', password='Guest.618', + database='hrs', charset='utf8mb4') +try: + # 2. 获取游标对象（Cursor） + with conn.cursor() as cursor: + # 3. 通过游标对象向数据库服务器发出SQL语句 + affected_rows = cursor.execute( + 'insert into `tb_dept` values (%s, %s, %s)', + (no, name, location) + ) + if affected_rows == 1: + print('新增部门成功!!!') + # 4. 提交事务（transaction） + conn.commit() +except pymysql.MySQLError as err: + # 4. 回滚事务 + conn.rollback() + print(type(err), err) +finally: + # 5. 关闭连接释放资源 + conn.close() +``` + +> **说明**：上面的`127.0.0.1`称为回环地址，它代表的是本机。下面的`guest`是我提前创建好的用户，该用户拥有对`hrs`数据库的`insert`、`delete`、`update`和`select`权限。我们不建议大家在项目中直接使用`root`超级管理员账号访问数据库，这样做实在是太危险了。我们可以使用下面的命令创建名为`guest`的用户并为其授权。 +> +> ```SQL +> create user 'guest'@'%' identified by 'Guest.618'; +> grant insert, delete, update, select on `hrs`.* to 'guest'@'%'; +> ``` + +如果要插入大量数据，建议使用游标对象的`executemany`方法做批处理（一个`insert`操作后面跟上多组数据），大家可以尝试向一张表插入10000条记录，然后看看不使用批处理一条条的插入和使用批处理有什么差别。游标对象的`executemany`方法第一个参数仍然是 SQL 语句，第二个参数可以是包含多组数据的列表或元组。 + +#### 删除数据 + +```Python +import pymysql + +no = int(input('部门编号: ')) + +# 1. 创建连接（Connection） +conn = pymysql.connect(host='127.0.0.1', port=3306, + user='guest', password='Guest.618', + database='hrs', charset='utf8mb4', + autocommit=True) +try: + # 2. 获取游标对象（Cursor） + with conn.cursor() as cursor: + # 3. 通过游标对象向数据库服务器发出SQL语句 + affected_rows = cursor.execute( + 'delete from `tb_dept` where `dno`=%s', + (no, ) + ) + if affected_rows == 1: + print('删除部门成功!!!') +finally: + # 5. 关闭连接释放资源 + conn.close() +``` + +> **说明**：如果不希望每次 SQL 操作之后手动提交或回滚事务，可以`connect`函数中加一个名为`autocommit`的参数并将它的值设置为`True`，表示每次执行 SQL 成功后自动提交。但是我们建议大家手动提交或回滚，这样可以根据实际业务需要来构造事务环境。如果不愿意捕获异常并进行处理，可以在`try`代码块后直接跟`finally`块，省略`except`意味着发生异常时，代码会直接崩溃并将异常栈显示在终端中。 + +#### 更新数据 + +```Python +import pymysql + +no = int(input('部门编号: ')) +name = input('部门名称: ') +location = input('部门所在地: ') + +# 1. 创建连接（Connection） +conn = pymysql.connect(host='127.0.0.1', port=3306, + user='guest', password='Guest.618', + database='hrs', charset='utf8mb4') +try: + # 2. 获取游标对象（Cursor） + with conn.cursor() as cursor: + # 3. 通过游标对象向数据库服务器发出SQL语句 + affected_rows = cursor.execute( + 'update `tb_dept` set `dname`=%s, `dloc`=%s where `dno`=%s', + (name, location, no) + ) + if affected_rows == 1: + print('更新部门信息成功!!!') + # 4. 提交事务 + conn.commit() +except pymysql.MySQLError as err: + # 4. 回滚事务 + conn.rollback() + print(type(err), err) +finally: + # 5. 关闭连接释放资源 + conn.close() +``` + +#### 查询数据 + +1. 查询部门表的数据。 + +```Python +import pymysql + +# 1. 创建连接（Connection） +conn = pymysql.connect(host='127.0.0.1', port=3306, + user='guest', password='Guest.618', + database='hrs', charset='utf8mb4') +try: + # 2. 获取游标对象（Cursor） + with conn.cursor() as cursor: + # 3. 通过游标对象向数据库服务器发出SQL语句 + cursor.execute('select `dno`, `dname`, `dloc` from `tb_dept`') + # 4. 通过游标对象抓取数据 + row = cursor.fetchone() + while row: + print(row) + row = cursor.fetchone() +except pymysql.MySQLError as err: + print(type(err), err) +finally: + # 5. 关闭连接释放资源 + conn.close() +``` +>**说明**：上面的代码中，我们通过构造一个`while`循环实现了逐行抓取查询结果的操作。这种方式特别适合查询结果有非常多行的场景。因为如果使用`fetchall`一次性将所有记录抓取到一个嵌套元组中，会造成非常大的内存开销，这在很多场景下并不是一个好主意。如果不愿意使用`while`循环，还可以考虑使用`iter`函数构造一个迭代器来逐行抓取数据，有兴趣的读者可以自行研究。 + +2. 分页查询员工表的数据。 + +```Python +import pymysql + +page = int(input('页码: ')) +size = int(input('大小: ')) + +# 1. 创建连接（Connection） +con = pymysql.connect(host='127.0.0.1', port=3306, + user='guest', password='Guest.618', + database='hrs', charset='utf8') +try: + # 2. 获取游标对象（Cursor） + with con.cursor(pymysql.cursors.DictCursor) as cursor: + # 3. 通过游标对象向数据库服务器发出SQL语句 + cursor.execute( + 'select `eno`, `ename`, `job`, `sal` from `tb_emp` order by `sal` desc limit %s,%s', + ((page - 1) * size, size) + ) + # 4. 通过游标对象抓取数据 + for emp_dict in cursor.fetchall(): + print(emp_dict) +finally: + # 5. 关闭连接释放资源 + con.close() +``` + +### 案例讲解 + +下面我们为大家讲解一个将数据库表数据导出到 Excel 文件的例子，我们需要先安装`openpyxl`三方库，命令如下所示。 + +```Bash +pip install openpyxl +``` + +接下来，我们通过下面的代码实现了将数据库`hrs`中所有员工的编号、姓名、职位、月薪、补贴和部门名称导出到一个 Excel 文件中。 + +```Python +import openpyxl +import pymysql + +# 创建工作簿对象 +workbook = openpyxl.Workbook() +# 获得默认的工作表 +sheet = workbook.active +# 修改工作表的标题 +sheet.title = '员工基本信息' +# 给工作表添加表头 +sheet.append(('工号', '姓名', '职位', '月薪', '补贴', '部门')) +# 创建连接（Connection） +conn = pymysql.connect(host='127.0.0.1', port=3306, + user='guest', password='Guest.618', + database='hrs', charset='utf8mb4') +try: + # 获取游标对象（Cursor） + with conn.cursor() as cursor: + # 通过游标对象执行SQL语句 + cursor.execute( + 'select `eno`, `ename`, `job`, `sal`, coalesce(`comm`, 0), `dname` ' + 'from `tb_emp` natural join `tb_dept`' + ) + # 通过游标抓取数据 + row = cursor.fetchone() + while row: + # 将数据逐行写入工作表中 + sheet.append(row) + row = cursor.fetchone() + # 保存工作簿 + workbook.save('hrs.xlsx') +except pymysql.MySQLError as err: + print(err) +finally: + # 关闭连接释放资源 + conn.close() +``` + +大家可以参考上面的例子，试一试把 Excel 文件的数据导入到指定数据库的指定表中，看看是否可以成功。 \ No newline at end of file From 71b2cf87e0a524437ebe6b9dc8dfa86940a626d9 Mon Sep 17 00:00:00 2001 From: jackfrued Date: Thu, 31 Mar 2022 23:57:42 +0800 Subject: [PATCH 03/17] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E4=BA=86=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git "a/\347\254\25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" "b/\347\254\25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" index 9559e32..a14bf68 100644 --- "a/\347\254\25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" +++ "b/\347\254\25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" @@ -709,7 +709,7 @@ right outer join ( ) as `t2` on `t1`.`stu_id`=`t2`.`stu_id`; ``` -上面的DML有几个地方需要加以说明： +上面的DQL有几个地方需要加以说明： 1. MySQL目前的版本不支持全外连接，上面我们通过`union`操作，将左外连接和右外连接的结果求并集实现全外连接的效果。大家可以通过下面的图来加深对连表操作的认识。 From 620c7495bcbc97400f2580f8d47c78bd8c437b58 Mon Sep 17 00:00:00 2001 From: jackfrued Date: Sun, 12 Jun 2022 03:18:53 +0800 Subject: [PATCH 04/17] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E4=BA=86=E9=83=A8?= =?UTF-8?q?=E5=88=86=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...350\257\246\350\247\243\344\271\213DDL.md" | 415 +++++++++ ...357\274\232SQL\350\257\246\350\247\243.md" | 804 ------------------ ...350\257\246\350\247\243\344\271\213DML.md" | 159 ++++ ...7\274\232\346\267\261\345\205\245MySQL.md" | 661 -------------- ...350\257\246\350\247\243\344\271\213DQL.md" | 445 ++++++++++ ...350\257\246\350\247\243\344\271\213DCL.md" | 74 ++ ...5\350\257\276.\347\264\242\345\274\225.md" | 138 +++ ...5\346\225\260+\350\277\207\347\250\213.md" | 336 ++++++++ ...QL\346\226\260\347\211\271\346\200\247.md" | 192 +++++ ...QL\346\225\260\346\215\256\345\272\223.md" | 60 +- 10 files changed, 1760 insertions(+), 1524 deletions(-) create mode 100644 "\347\254\25441\350\257\276.SQL\350\257\246\350\247\243\344\271\213DDL.md" delete mode 100644 "\347\254\25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" create mode 100644 "\347\254\25442\350\257\276.SQL\350\257\246\350\247\243\344\271\213DML.md" delete mode 100644 "\347\254\25442\350\257\276\357\274\232\346\267\261\345\205\245MySQL.md" create mode 100644 "\347\254\25443\350\257\276.SQL\350\257\246\350\247\243\344\271\213DQL.md" create mode 100644 "\347\254\25444\350\257\276.SQL\350\257\246\350\247\243\344\271\213DCL.md" create mode 100644 "\347\254\25445\350\257\276.\347\264\242\345\274\225.md" create mode 100644 "\347\254\25446\350\257\276.\350\247\206\345\233\276+\345\207\275\346\225\260+\350\277\207\347\250\213.md" create mode 100644 "\347\254\25447\350\257\276.MySQL\346\226\260\347\211\271\346\200\247.md" rename "\347\254\25443\350\257\276\357\274\232Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" => "\347\254\25448\350\257\276.Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" (84%) diff --git "a/\347\254\25441\350\257\276.SQL\350\257\246\350\247\243\344\271\213DDL.md" "b/\347\254\25441\350\257\276.SQL\350\257\246\350\247\243\344\271\213DDL.md" new file mode 100644 index 0000000..9bd11f7 --- /dev/null +++ "b/\347\254\25441\350\257\276.SQL\350\257\246\350\247\243\344\271\213DDL.md" @@ -0,0 +1,415 @@ +## SQL详解之DDL + +我们通常可以将 SQL 分为四类，分别是 DDL（数据定义语言）、DML（数据操作语言）、DQL（数据查询语言）和 DCL（数据控制语言）。DDL 主要用于创建、删除、修改数据库中的对象，比如创建、删除和修改二维表，核心的关键字包括`create`、`drop`和`alter`；DML 主要负责数据的插入、删除和更新，关键词包括`insert`、`delete`和`update`；DQL 负责数据查询，最重要的一个关键词是`select`；DCL 通常用于授予和召回权限，核心关键词是`grant`和`revoke`。 + +> **说明**：SQL 是不区分大小写的语言，有人会建议将关键字大写，其他部分小写。为了书写和识别方便，下面的 SQL 我都是使用小写字母进行书写的。 如果公司的 SQL 编程规范有强制规定，那么就按照公司的要求来，个人的喜好不应该凌驾于公司的编程规范之上，这一点对职业人来说应该是常识。 + +### 建库建表 + +下面我们来实现一个非常简单的学校选课系统的数据库。我们将数据库命名为`school`，四个关键的实体分别是学院、老师、学生和课程，其中，学生跟学院是从属关系，这个关系从数量上来讲是多对一关系，因为一个学院可以有多名学生，而一个学生通常只属于一个学院；同理，老师跟学院的从属关系也是多对一关系。一名老师可以讲授多门课程，一门课程如果只有一个授课老师的话，那么课程跟老师也是多对一关系；如果允许多个老师合作讲授一门课程，那么课程和老师就是多对多关系。简单起见，我们将课程和老师设计为多对一关系。学生和课程是典型的多对多关系，因为一个学生可以选择多门课程，一门课程也可以被多个学生选择，而关系型数据库需要借助中间表才能维持维持两个实体的多对多关系。最终，我们的学校选课系统一共有五张表，分别是学院表（`tb_college`）、学生表（`tb_student`）、教师表（`tb_teacher`）、课程表（`tb_course`）和选课记录表（`tb_record`），其中选课记录表就是维持学生跟课程多对多关系的中间表。 + +```SQL +-- 如果存在名为school的数据库就删除它 +drop database if exists `school`; + +-- 创建名为school的数据库并设置默认的字符集和排序方式 +create database `school` default character set utf8mb4 collate utf8mb4_general_ci; + +-- 切换到school数据库上下文环境 +use `school`; + +-- 创建学院表 +create table `tb_college` +( +`col_id` int unsigned auto_increment comment '编号', +`col_name` varchar(50) not null comment '名称', +`col_intro` varchar(500) default '' comment '介绍', +primary key (`col_id`) +) engine=innodb auto_increment=1 comment '学院表'; + +-- 创建学生表 +create table `tb_student` +( +`stu_id` int unsigned not null comment '学号', +`stu_name` varchar(20) not null comment '姓名', +`stu_sex` boolean default 1 not null comment '性别', +`stu_birth` date not null comment '出生日期', +`stu_addr` varchar(255) default '' comment '籍贯', +`col_id` int unsigned not null comment '所属学院', +primary key (`stu_id`), +constraint `fk_student_col_id` foreign key (`col_id`) references `tb_college` (`col_id`) +) engine=innodb comment '学生表'; + +-- 创建教师表 +create table `tb_teacher` +( +`tea_id` int unsigned not null comment '工号', +`tea_name` varchar(20) not null comment '姓名', +`tea_title` varchar(10) default '助教' comment '职称', +`col_id` int unsigned not null comment '所属学院', +primary key (`tea_id`), +constraint `fk_teacher_col_id` foreign key (`col_id`) references `tb_college` (`col_id`) +) engine=innodb comment '老师表'; + +-- 创建课程表 +create table `tb_course` +( +`cou_id` int unsigned not null comment '编号', +`cou_name` varchar(50) not null comment '名称', +`cou_credit` int not null comment '学分', +`tea_id` int unsigned not null comment '授课老师', +primary key (`cou_id`), +constraint `fk_course_tea_id` foreign key (`tea_id`) references `tb_teacher` (`tea_id`) +) engine=innodb comment '课程表'; + +-- 创建选课记录表 +create table `tb_record` +( +`rec_id` bigint unsigned auto_increment comment '选课记录号', +`stu_id` int unsigned not null comment '学号', +`cou_id` int unsigned not null comment '课程编号', +`sel_date` date not null comment '选课日期', +`score` decimal(4,1) comment '考试成绩', +primary key (`rec_id`), +constraint `fk_record_stu_id` foreign key (`stu_id`) references `tb_student` (`stu_id`), +constraint `fk_record_cou_id` foreign key (`cou_id`) references `tb_course` (`cou_id`), +constraint `uk_record_stu_cou` unique (`stu_id`, `cou_id`) +) engine=innodb comment '选课记录表'; +``` + +上面的DDL有几个地方需要强调一下： + +- 首先，上面 SQL 中的数据库名、表名、字段名都被反引号（`）包裹起来，反引号并不是必须的，但是却可以解决表名、字段名等跟 SQL 关键字（SQL 中有特殊含义的单词）冲突的问题。 + +- 创建数据库时，我们通过`default character set utf8mb4`指定了数据库默认使用的字符集为`utf8mb4`（最大`4`字节的`utf-8`编码），我们推荐使用该字符集，它也是 MySQL 8.x 默认使用的字符集，因为它能够支持国际化编码，还可以存储 Emoji 字符。可以通过下面的命令查看 MySQL 支持的字符集以及默认的排序规则。 + + ```SQL + show character set; + ``` + + ``` + +----------+---------------------------------+---------------------+--------+ + | Charset | Description | Default collation | Maxlen | + +----------+---------------------------------+---------------------+--------+ + | big5 | Big5 Traditional Chinese | big5_chinese_ci | 2 | + | dec8 | DEC West European | dec8_swedish_ci | 1 | + | cp850 | DOS West European | cp850_general_ci | 1 | + | hp8 | HP West European | hp8_english_ci | 1 | + | koi8r | KOI8-R Relcom Russian | koi8r_general_ci | 1 | + | latin1 | cp1252 West European | latin1_swedish_ci | 1 | + | latin2 | ISO 8859-2 Central European | latin2_general_ci | 1 | + | swe7 | 7bit Swedish | swe7_swedish_ci | 1 | + | ascii | US ASCII | ascii_general_ci | 1 | + | ujis | EUC-JP Japanese | ujis_japanese_ci | 3 | + | sjis | Shift-JIS Japanese | sjis_japanese_ci | 2 | + | hebrew | ISO 8859-8 Hebrew | hebrew_general_ci | 1 | + | tis620 | TIS620 Thai | tis620_thai_ci | 1 | + | euckr | EUC-KR Korean | euckr_korean_ci | 2 | + | koi8u | KOI8-U Ukrainian | koi8u_general_ci | 1 | + | gb2312 | GB2312 Simplified Chinese | gb2312_chinese_ci | 2 | + | greek | ISO 8859-7 Greek | greek_general_ci | 1 | + | cp1250 | Windows Central European | cp1250_general_ci | 1 | + | gbk | GBK Simplified Chinese | gbk_chinese_ci | 2 | + | latin5 | ISO 8859-9 Turkish | latin5_turkish_ci | 1 | + | armscii8 | ARMSCII-8 Armenian | armscii8_general_ci | 1 | + | utf8 | UTF-8 Unicode | utf8_general_ci | 3 | + | ucs2 | UCS-2 Unicode | ucs2_general_ci | 2 | + | cp866 | DOS Russian | cp866_general_ci | 1 | + | keybcs2 | DOS Kamenicky Czech-Slovak | keybcs2_general_ci | 1 | + | macce | Mac Central European | macce_general_ci | 1 | + | macroman | Mac West European | macroman_general_ci | 1 | + | cp852 | DOS Central European | cp852_general_ci | 1 | + | latin7 | ISO 8859-13 Baltic | latin7_general_ci | 1 | + | utf8mb4 | UTF-8 Unicode | utf8mb4_general_ci | 4 | + | cp1251 | Windows Cyrillic | cp1251_general_ci | 1 | + | utf16 | UTF-16 Unicode | utf16_general_ci | 4 | + | utf16le | UTF-16LE Unicode | utf16le_general_ci | 4 | + | cp1256 | Windows Arabic | cp1256_general_ci | 1 | + | cp1257 | Windows Baltic | cp1257_general_ci | 1 | + | utf32 | UTF-32 Unicode | utf32_general_ci | 4 | + | binary | Binary pseudo charset | binary | 1 | + | geostd8 | GEOSTD8 Georgian | geostd8_general_ci | 1 | + | cp932 | SJIS for Windows Japanese | cp932_japanese_ci | 2 | + | eucjpms | UJIS for Windows Japanese | eucjpms_japanese_ci | 3 | + | gb18030 | China National Standard GB18030 | gb18030_chinese_ci | 4 | + +----------+---------------------------------+---------------------+--------+ + 41 rows in set (0.00 sec) + ``` + + 如果要设置 MySQL 服务启动时默认使用的字符集，可以修改MySQL的配置并添加以下内容。 + + ```INI + [mysqld] + character-set-server=utf8 + ``` + + > **提示**：如果不清楚如何修改 MySQL 的配置文件就先不要管它。 + +- 创建和删除数据库时，关键字`database`也可以替换为`schema`，二者作用相同。 + +- 建表语句中的`not null`是非空约束，它限定了字段不能为空；`default`用于为字段指定默认值，我们称之为默认值约束；`primary key`是主键约束，它设定了能够唯一确定一条记录的列，也确保了每条记录都是独一无二的，因为主键不允许重复；`foreign key`是外键约束，它维持了两张表的参照完整性，举个例子，由于学生表中为 col_id 字段添加了外键约束，限定其必须引用（`references`）学院表中的 col_id，因此学生表中的学院编号必须来自于学院表中的学院编号，不能够随意为该字段赋值。如果需要给主键约束、外键约束等起名字，可以使用`constriant`关键字并在后面跟上约束的名字。 + +- 建表语句中的`comment` 关键字用来给列和表添加注释，增强代码的可读性和可维护性。 + +- 在创建表的时候，可以自行选择底层的存储引擎。MySQL 支持多种存储引擎，可以通过`show engines`命令进行查看。MySQL 5.5 以后的版本默认使用的存储引擎是 InnoDB，它是我们推荐大家使用的存储引擎（因为更适合当下互联网应用对高并发、性能以及事务支持等方面的需求），为了 SQL 语句的向下兼容性，我们可以在建表语句结束处右圆括号的后面通过`engine=innodb`来指定使用 InnoDB 存储引擎。 + + ```SQL + show engines\G + ``` + + > **说明**：上面的 \G 是为了换一种输出方式，在命令行客户端中，如果表的字段很多一行显示不完，就会导致输出的内容看起来非常不舒服，使用 \G 可以将记录的每个列以独占整行的的方式输出，这种输出方式在命令行客户端中看起来会舒服很多。 + + ``` + *************************** 1. row *************************** + Engine: InnoDB + Support: DEFAULT + Comment: Supports transactions, row-level locking, and foreign keys + Transactions: YES + XA: YES + Savepoints: YES + *************************** 2. row *************************** + Engine: MRG_MYISAM + Support: YES + Comment: Collection of identical MyISAM tables + Transactions: NO + XA: NO + Savepoints: NO + *************************** 3. row *************************** + Engine: MEMORY + Support: YES + Comment: Hash based, stored in memory, useful for temporary tables + Transactions: NO + XA: NO + Savepoints: NO + *************************** 4. row *************************** + Engine: BLACKHOLE + Support: YES + Comment: /dev/null storage engine (anything you write to it disappears) + Transactions: NO + XA: NO + Savepoints: NO + *************************** 5. row *************************** + Engine: MyISAM + Support: YES + Comment: MyISAM storage engine + Transactions: NO + XA: NO + Savepoints: NO + *************************** 6. row *************************** + Engine: CSV + Support: YES + Comment: CSV storage engine + Transactions: NO + XA: NO + Savepoints: NO + *************************** 7. row *************************** + Engine: ARCHIVE + Support: YES + Comment: Archive storage engine + Transactions: NO + XA: NO + Savepoints: NO + *************************** 8. row *************************** + Engine: PERFORMANCE_SCHEMA + Support: YES + Comment: Performance Schema + Transactions: NO + XA: NO + Savepoints: NO + *************************** 9. row *************************** + Engine: FEDERATED + Support: NO + Comment: Federated MySQL storage engine + Transactions: NULL + XA: NULL + Savepoints: NULL + 9 rows in set (0.00 sec) + ``` + + 下面的表格对MySQL几种常用的数据引擎进行了简单的对比。 + + | 特性 | InnoDB | MRG_MYISAM | MEMORY | MyISAM | + | ------------ | ------------ | ---------- | ------ | ------ | + | 存储限制 | 有 | 没有 | 有 | 有 | + | 事务 | 支持 | | | | + | 锁机制 | 行锁 | 表锁 | 表锁 | 表锁 | + | B树索引 | 支持 | 支持 | 支持 | 支持 | + | 哈希索引 | | | 支持 | | + | 全文检索 | 支持（5.6+） | | | 支持 | + | 集群索引 | 支持 | | | | + | 数据缓存 | 支持 | | 支持 | | + | 索引缓存 | 支持 | 支持 | 支持 | 支持 | + | 数据可压缩 | | | | 支持 | + | 内存使用 | 高 | 低 | 中 | 低 | + | 存储空间使用 | 高 | 低 | | 低 | + | 批量插入性能 | 低 | 高 | 高 | 高 | + | 是否支持外键 | 支持 | | | | + + 通过上面的比较我们可以了解到，InnoDB 是唯一能够支持外键、事务以及行锁的存储引擎，所以我们之前说它更适合互联网应用，而且在较新版本的 MySQL 中，它也是默认使用的存储引擎。 + +- 在定义表结构为每个字段选择数据类型时，如果不清楚哪个数据类型更合适，可以通过 MySQL 的帮助系统来了解每种数据类型的特性、数据的长度和精度等相关信息。 + + ```SQL + ? data types + ``` + + > **说明**：在 MySQLWorkbench 中，不能使用`?`获取帮助，要使用对应的命令`help`。 + + ``` + You asked for help about help category: "Data Types" + For more information, type 'help ', where is one of the following + topics: + AUTO_INCREMENT + BIGINT + BINARY + BIT + BLOB + BLOB DATA TYPE + BOOLEAN + CHAR + CHAR BYTE + DATE + DATETIME + DEC + DECIMAL + DOUBLE + DOUBLE PRECISION + ENUM + FLOAT + INT + INTEGER + LONGBLOB + LONGTEXT + MEDIUMBLOB + MEDIUMINT + MEDIUMTEXT + SET DATA TYPE + SMALLINT + TEXT + TIME + TIMESTAMP + TINYBLOB + TINYINT + TINYTEXT + VARBINARY + VARCHAR + YEAR DATA TYPE + ``` + + 获取 varchar 类型的帮助： + + ```SQL + ? varchar + ``` + + 执行结果： + + ``` + Name: 'VARCHAR' + Description: + [NATIONAL] VARCHAR(M) [CHARACTER SET charset_name] [COLLATE + collation_name] + + A variable-length string. M represents the maximum column length in + characters. The range of M is 0 to 65,535. The effective maximum length + of a VARCHAR is subject to the maximum row size (65,535 bytes, which is + shared among all columns) and the character set used. For example, utf8 + characters can require up to three bytes per character, so a VARCHAR + column that uses the utf8 character set can be declared to be a maximum + of 21,844 characters. See + http://dev.mysql.com/doc/refman/5.7/en/column-count-limit.html. + + MySQL stores VARCHAR values as a 1-byte or 2-byte length prefix plus + data. The length prefix indicates the number of bytes in the value. A + VARCHAR column uses one length byte if values require no more than 255 + bytes, two length bytes if values may require more than 255 bytes. + + *Note*: + + MySQL follows the standard SQL specification, and does not remove + trailing spaces from VARCHAR values. + + VARCHAR is shorthand for CHARACTER VARYING. NATIONAL VARCHAR is the + standard SQL way to define that a VARCHAR column should use some + predefined character set. MySQL uses utf8 as this predefined character + set. http://dev.mysql.com/doc/refman/5.7/en/charset-national.html. + NVARCHAR is shorthand for NATIONAL VARCHAR. + + URL: http://dev.mysql.com/doc/refman/5.7/en/string-type-overview.html + ``` + + 在数据类型的选择上，保存字符串数据通常都使用 VARCHAR 和 CHAR 两种类型，前者通常称为变长字符串，而后者通常称为定长字符串；对于 InnoDB 存储引擎，行存储格式没有区分固定长度和可变长度列，因此 VARCHAR 类型和 CHAR 类型没有本质区别，后者不一定比前者性能更好。如果要保存的很大字符串，可以使用 TEXT 类型；如果要保存很大的字节串，可以使用 BLOB（二进制大对象）类型。在 MySQL 中，TEXT 和 BLOB又分别包括 TEXT、MEDIUMTEXT、LONGTEXT 和 BLOB、MEDIUMBLOB、LONGBLOB 三种不同的类型，它们主要的区别在于存储数据的最大大小不同。保存浮点数可以用 FLOAT 或 DOUBLE 类型，FLOAT 已经不推荐使用了，而且在 MySQL 后续的版本中可能会被移除掉。而保存定点数应该使用 DECIMAL 类型，它可以指定小数点前后有效数字的位数。如果要保存时间日期，DATETIME 类型优于 TIMESTAMP 类型，因为前者能表示的时间日期范围更大，后者底层其实就是一个整数，记录了指定的日期时间和 1970-01-01 00:00:00 相差多少个毫秒，该类型在 2038-01-19 03:14:07 之后就会溢出。 + + 对于自增字段 AUTO_INCREMENT，如果使用 MySQL 5.x 版本要注意自增字段的回溯问题，当然这个问题在 MySQL 8.x 中已经得到了很好的解决，当然，MySQL 8.x 还有很多其他的好处，不管是功能还是性能上都有很多的优化和调整，因此强烈推荐大家使用 MySQL 8.x 版本。对于高并发访问数据库的场景，AUTO_INCREMENT 不仅存在性能上的问题，还可能在多机结构上产生重复的 ID 值，在这种场景下，使用分布式 ID 生成算法（SnowFlake、TinyID等）才是最好的选择，有兴趣的读者可以自行研究。 + +### 删除表和修改表 + +下面以学生表为例，为大家说明如何删除表和修改表。删除表可以使用`drop table`，代码如下所示。 + +```SQL +drop table `tb_student`; +``` + +或 + +```SQL +drop table if exists `tb_student`; +``` + +需要注意的是，如果学生表已经录入了数据而且该数据被其他表引用了，那么就不能删除学生表，否则上面的操作会报错。在下一课中，我们会讲解如何向表中插入数据，到时候大家可以试一试，能否顺利删除学生表。 + +如果要修改学生表，可以使用`alter table`，具体可以分为以下几种情况： + +修改表，添加一个新列，例如给学生表添加一个联系电话的列。 + +```SQL +alter table `tb_student` add column `stu_tel` varchar(20) not null comment '联系电话'; +``` + +> **注意**：如果新增列的时候指定了非空约束（`not null`），那么学生表不能够有数据，否则原来的数据增加了 stu_tel 列之后是没有数据的，这就违反了非空约束的要求；当然，我们在添加列的时候也可以使用默认值约束来解决这个问题。 + +修改表，删除指定的列，例如将上面添加的联系电话列删除掉。 + +```SQL +alter table `tb_student` drop column `stu_tel`; +``` + +修改表，修改列的数据类型，例如将学生表的 stu_sex 修改为字符。 + +```SQL +alter table `tb_student` modify column `stu_sex` char(1) not null default 'M' comment '性别'; +``` + +修改表，修改列的命名，例如将学生表的 stu_sex 修改为 stu_gender。 + +```SQL +alter table `tb_student` change column `stu_sex` `stu_gender` boolean default 1 comment '性别'; +``` + +修改表，删除约束条件，例如删除学生表的 col_id 列的外键约束。 + +```SQL +alter table `tb_student` drop foreign key `fk_student_col_id`; +``` + +修改表，添加约束条件，例如给学生表的 col_id 列加上外键约束。 + +```SQL +alter table `tb_student` add foreign key (`col_id`) references `tb_college` (`col_id`); +``` + +或 + +```SQL +alter table `tb_student` add constraint `fk_student_col_id` foreign key (`col_id`) references `tb_college` (`col_id`); +``` + +> **说明**：在添加外键约束时，还可以通过`on update`和`on delete`来指定在被引用的表发生删除和更新操作时，应该进行何种处理，二者的默认值都是`restrict`，表示如果存在外键约束，则不允许更新和删除被引用的数据。除了`restrict`之外，这里可能的取值还有`cascade`（级联操作）和`set null`（设置为空），有兴趣的读者可以自行研究。 + +修改表的名字，例如将学生表的名字修改为 tb_stu_info。 + +```SQL +alter table `tb_student` rename to `tb_stu_info`; +``` + +> **提示**：一般情况下，请不要轻易修改数据库或表的名字。 \ No newline at end of file diff --git "a/\347\254\25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" "b/\347\254\25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" deleted file mode 100644 index a14bf68..0000000 --- "a/\347\254\25441\350\257\276\357\274\232SQL\350\257\246\350\247\243.md" +++ /dev/null @@ -1,804 +0,0 @@ -## 第41课：SQL详解 - -我们通常可以将 SQL 分为四类，分别是 DDL（数据定义语言）、DML（数据操作语言）、DQL（数据查询语言）和 DCL（数据控制语言）。DDL 主要用于创建、删除、修改数据库中的对象，比如创建、删除和修改二维表，核心的关键字包括`create`、`drop`和`alter`；DML 主要负责数据的插入、删除和更新，关键词包括`insert`、`delete`和`update`；DQL 负责数据查询，最重要的一个关键词是`select`；DCL 通常用于授予和召回权限，核心关键词是`grant`和`revoke`。 - -> **说明**：SQL 是不区分大小写的语言，为了书写和识别方便，下面的 SQL 都使用了小写字母来书写。 - -### DDL（数据定义语言） - -下面我们来实现一个选课系统的数据库，如下所示的 SQL 创建了名为`school`的数据库和五张表，分别是学院表（`tb_college`）、学生表（`tb_student`）、教师表（`tb_teacher`）、课程表（`tb_course`）和选课记录表（`tb_record`），其中学生和教师跟学院之间是多对一关系，课程跟老师之间也是多对一关系，学生和课程是多对多关系，选课记录表就是维持学生跟课程多对多关系的中间表。 - -```SQL --- 如果存在名为school的数据库就删除它 -drop database if exists `school`; - --- 创建名为school的数据库并设置默认的字符集和排序方式 -create database `school` default character set utf8mb4 collate utf8mb4_general_ci; - --- 切换到school数据库上下文环境 -use `school`; - --- 创建学院表 -create table `tb_college` -( -`col_id` int unsigned auto_increment comment '编号', -`col_name` varchar(50) not null comment '名称', -`col_intro` varchar(500) default '' comment '介绍', -primary key (`col_id`) -) engine=innodb auto_increment=1 comment '学院表'; - --- 创建学生表 -create table `tb_student` -( -`stu_id` int unsigned not null comment '学号', -`stu_name` varchar(20) not null comment '姓名', -`stu_sex` boolean default 1 not null comment '性别', -`stu_birth` date not null comment '出生日期', -`stu_addr` varchar(255) default '' comment '籍贯', -`col_id` int unsigned not null comment '所属学院', -primary key (`stu_id`), -constraint `fk_student_col_id` foreign key (`col_id`) references `tb_college` (`col_id`) -) engine=innodb comment '学生表'; - --- 创建教师表 -create table `tb_teacher` -( -`tea_id` int unsigned not null comment '工号', -`tea_name` varchar(20) not null comment '姓名', -`tea_title` varchar(10) default '助教' comment '职称', -`col_id` int unsigned not null comment '所属学院', -primary key (`tea_id`), -constraint `fk_teacher_col_id` foreign key (`col_id`) references `tb_college` (`col_id`) -) engine=innodb comment '老师表'; - --- 创建课程表 -create table `tb_course` -( -`cou_id` int unsigned not null comment '编号', -`cou_name` varchar(50) not null comment '名称', -`cou_credit` int not null comment '学分', -`tea_id` int unsigned not null comment '授课老师', -primary key (`cou_id`), -constraint `fk_course_tea_id` foreign key (`tea_id`) references `tb_teacher` (`tea_id`) -) engine=innodb comment '课程表'; - --- 创建选课记录表 -create table `tb_record` -( -`rec_id` bigint unsigned auto_increment comment '选课记录号', -`stu_id` int unsigned not null comment '学号', -`cou_id` int unsigned not null comment '课程编号', -`sel_date` date not null comment '选课日期', -`score` decimal(4,1) comment '考试成绩', -primary key (`rec_id`), -constraint `fk_record_stu_id` foreign key (`stu_id`) references `tb_student` (`stu_id`), -constraint `fk_record_cou_id` foreign key (`cou_id`) references `tb_course` (`cou_id`), -constraint `uk_record_stu_cou` unique (`stu_id`, `cou_id`) -) engine=innodb comment '选课记录表'; -``` - -上面的DDL有几个地方需要强调一下： - -- 创建数据库时，我们通过`default character set utf8mb4`指定了数据库默认使用的字符集为`utf8mb4`（最大`4`字节的`utf-8`编码），我们推荐使用该字符集，它也是 MySQL 8.x 默认使用的字符集，因为它能够支持国际化编码，还可以存储 Emoji 字符。可以通过下面的命令查看 MySQL 支持的字符集以及默认的排序规则。 - - ```SQL - show character set; - ``` - - ``` - +----------+---------------------------------+---------------------+--------+ - | Charset | Description | Default collation | Maxlen | - +----------+---------------------------------+---------------------+--------+ - | big5 | Big5 Traditional Chinese | big5_chinese_ci | 2 | - | dec8 | DEC West European | dec8_swedish_ci | 1 | - | cp850 | DOS West European | cp850_general_ci | 1 | - | hp8 | HP West European | hp8_english_ci | 1 | - | koi8r | KOI8-R Relcom Russian | koi8r_general_ci | 1 | - | latin1 | cp1252 West European | latin1_swedish_ci | 1 | - | latin2 | ISO 8859-2 Central European | latin2_general_ci | 1 | - | swe7 | 7bit Swedish | swe7_swedish_ci | 1 | - | ascii | US ASCII | ascii_general_ci | 1 | - | ujis | EUC-JP Japanese | ujis_japanese_ci | 3 | - | sjis | Shift-JIS Japanese | sjis_japanese_ci | 2 | - | hebrew | ISO 8859-8 Hebrew | hebrew_general_ci | 1 | - | tis620 | TIS620 Thai | tis620_thai_ci | 1 | - | euckr | EUC-KR Korean | euckr_korean_ci | 2 | - | koi8u | KOI8-U Ukrainian | koi8u_general_ci | 1 | - | gb2312 | GB2312 Simplified Chinese | gb2312_chinese_ci | 2 | - | greek | ISO 8859-7 Greek | greek_general_ci | 1 | - | cp1250 | Windows Central European | cp1250_general_ci | 1 | - | gbk | GBK Simplified Chinese | gbk_chinese_ci | 2 | - | latin5 | ISO 8859-9 Turkish | latin5_turkish_ci | 1 | - | armscii8 | ARMSCII-8 Armenian | armscii8_general_ci | 1 | - | utf8 | UTF-8 Unicode | utf8_general_ci | 3 | - | ucs2 | UCS-2 Unicode | ucs2_general_ci | 2 | - | cp866 | DOS Russian | cp866_general_ci | 1 | - | keybcs2 | DOS Kamenicky Czech-Slovak | keybcs2_general_ci | 1 | - | macce | Mac Central European | macce_general_ci | 1 | - | macroman | Mac West European | macroman_general_ci | 1 | - | cp852 | DOS Central European | cp852_general_ci | 1 | - | latin7 | ISO 8859-13 Baltic | latin7_general_ci | 1 | - | utf8mb4 | UTF-8 Unicode | utf8mb4_general_ci | 4 | - | cp1251 | Windows Cyrillic | cp1251_general_ci | 1 | - | utf16 | UTF-16 Unicode | utf16_general_ci | 4 | - | utf16le | UTF-16LE Unicode | utf16le_general_ci | 4 | - | cp1256 | Windows Arabic | cp1256_general_ci | 1 | - | cp1257 | Windows Baltic | cp1257_general_ci | 1 | - | utf32 | UTF-32 Unicode | utf32_general_ci | 4 | - | binary | Binary pseudo charset | binary | 1 | - | geostd8 | GEOSTD8 Georgian | geostd8_general_ci | 1 | - | cp932 | SJIS for Windows Japanese | cp932_japanese_ci | 2 | - | eucjpms | UJIS for Windows Japanese | eucjpms_japanese_ci | 3 | - | gb18030 | China National Standard GB18030 | gb18030_chinese_ci | 4 | - +----------+---------------------------------+---------------------+--------+ - 41 rows in set (0.00 sec) - ``` - - 如果要设置 MySQL 服务启动时默认使用的字符集，可以修改MySQL的配置并添加以下内容。 - - ```INI - [mysqld] - character-set-server=utf8 - ``` - -- 在创建表的时候，可以自行选择底层的存储引擎。MySQL 支持多种存储引擎，可以通过`show engines`命令进行查看。MySQL 5.5 以后的版本默认使用的存储引擎是 InnoDB，它是我们推荐大家使用的存储引擎（因为更适合当下互联网应用对高并发、性能以及事务支持等方面的需求），为了 SQL 语句的向下兼容性，我们可以在建表语句结束处右圆括号的后面通过`engine=innodb`来指定使用 InnoDB 存储引擎。 - - ```SQL - show engines\G - ``` - - ``` - *************************** 1. row *************************** - Engine: InnoDB - Support: DEFAULT - Comment: Supports transactions, row-level locking, and foreign keys - Transactions: YES - XA: YES - Savepoints: YES - *************************** 2. row *************************** - Engine: MRG_MYISAM - Support: YES - Comment: Collection of identical MyISAM tables - Transactions: NO - XA: NO - Savepoints: NO - *************************** 3. row *************************** - Engine: MEMORY - Support: YES - Comment: Hash based, stored in memory, useful for temporary tables - Transactions: NO - XA: NO - Savepoints: NO - *************************** 4. row *************************** - Engine: BLACKHOLE - Support: YES - Comment: /dev/null storage engine (anything you write to it disappears) - Transactions: NO - XA: NO - Savepoints: NO - *************************** 5. row *************************** - Engine: MyISAM - Support: YES - Comment: MyISAM storage engine - Transactions: NO - XA: NO - Savepoints: NO - *************************** 6. row *************************** - Engine: CSV - Support: YES - Comment: CSV storage engine - Transactions: NO - XA: NO - Savepoints: NO - *************************** 7. row *************************** - Engine: ARCHIVE - Support: YES - Comment: Archive storage engine - Transactions: NO - XA: NO - Savepoints: NO - *************************** 8. row *************************** - Engine: PERFORMANCE_SCHEMA - Support: YES - Comment: Performance Schema - Transactions: NO - XA: NO - Savepoints: NO - *************************** 9. row *************************** - Engine: FEDERATED - Support: NO - Comment: Federated MySQL storage engine - Transactions: NULL - XA: NULL - Savepoints: NULL - 9 rows in set (0.00 sec) - ``` - - 下面的表格对MySQL几种常用的数据引擎进行了简单的对比。 - - | 特性 | InnoDB | MRG_MYISAM | MEMORY | MyISAM | - | ------------ | ------------ | ---------- | ------ | ------ | - | 存储限制 | 有 | 没有 | 有 | 有 | - | 事务 | 支持 | | | | - | 锁机制 | 行锁 | 表锁 | 表锁 | 表锁 | - | B树索引 | 支持 | 支持 | 支持 | 支持 | - | 哈希索引 | | | 支持 | | - | 全文检索 | 支持（5.6+） | | | 支持 | - | 集群索引 | 支持 | | | | - | 数据缓存 | 支持 | | 支持 | | - | 索引缓存 | 支持 | 支持 | 支持 | 支持 | - | 数据可压缩 | | | | 支持 | - | 内存使用 | 高 | 低 | 中 | 低 | - | 存储空间使用 | 高 | 低 | | 低 | - | 批量插入性能 | 低 | 高 | 高 | 高 | - | 是否支持外键 | 支持 | | | | - - 通过上面的比较我们可以了解到，InnoDB 是唯一能够支持外键、事务以及行锁的存储引擎，所以我们之前说它更适合互联网应用，而且在较新版本的 MySQL 中，它也是默认使用的存储引擎。 - -- 在定义表结构为每个字段选择数据类型时，如果不清楚哪个数据类型更合适，可以通过 MySQL 的帮助系统来了解每种数据类型的特性、数据的长度和精度等相关信息。 - - ```SQL - ? data types - ``` - - ``` - You asked for help about help category: "Data Types" - For more information, type 'help ', where is one of the following - topics: - AUTO_INCREMENT - BIGINT - BINARY - BIT - BLOB - BLOB DATA TYPE - BOOLEAN - CHAR - CHAR BYTE - DATE - DATETIME - DEC - DECIMAL - DOUBLE - DOUBLE PRECISION - ENUM - FLOAT - INT - INTEGER - LONGBLOB - LONGTEXT - MEDIUMBLOB - MEDIUMINT - MEDIUMTEXT - SET DATA TYPE - SMALLINT - TEXT - TIME - TIMESTAMP - TINYBLOB - TINYINT - TINYTEXT - VARBINARY - VARCHAR - YEAR DATA TYPE - ``` - - ```SQL - ? varchar - ``` - - ``` - Name: 'VARCHAR' - Description: - [NATIONAL] VARCHAR(M) [CHARACTER SET charset_name] [COLLATE - collation_name] - - A variable-length string. M represents the maximum column length in - characters. The range of M is 0 to 65,535. The effective maximum length - of a VARCHAR is subject to the maximum row size (65,535 bytes, which is - shared among all columns) and the character set used. For example, utf8 - characters can require up to three bytes per character, so a VARCHAR - column that uses the utf8 character set can be declared to be a maximum - of 21,844 characters. See - http://dev.mysql.com/doc/refman/5.7/en/column-count-limit.html. - - MySQL stores VARCHAR values as a 1-byte or 2-byte length prefix plus - data. The length prefix indicates the number of bytes in the value. A - VARCHAR column uses one length byte if values require no more than 255 - bytes, two length bytes if values may require more than 255 bytes. - - *Note*: - - MySQL follows the standard SQL specification, and does not remove - trailing spaces from VARCHAR values. - - VARCHAR is shorthand for CHARACTER VARYING. NATIONAL VARCHAR is the - standard SQL way to define that a VARCHAR column should use some - predefined character set. MySQL uses utf8 as this predefined character - set. http://dev.mysql.com/doc/refman/5.7/en/charset-national.html. - NVARCHAR is shorthand for NATIONAL VARCHAR. - - URL: http://dev.mysql.com/doc/refman/5.7/en/string-type-overview.html - ``` - - 在数据类型的选择上，保存字符串数据通常都使用`VARCHAR`和`CHAR`两种类型，前者通常称为变长字符串，而后者通常称为定长字符串；对于 InnoDB 存储引擎，行存储格式没有区分固定长度和可变长度列，因此`VARCHAR`类型和`CHAR`类型没有本质区别，后者不一定比前者性能更好。如果要保存的很大字符串，可以使用`TEXT`类型；如果要保存很大的字节串，可以使用`BLOB`（二进制大对象）类型。在 MySQL 中，`TEXT`和`BLOB`又分别包括`TEXT`、`MEDIUMTEXT`、`LONGTEXT`和`BLOB`、`MEDIUMBLOB`、`LONGBLOB`三种不同的类型，它们主要的区别在于存储数据的最大大小不同。保存浮点数可以用`FLOAT`或`DOUBLE`类型，`FLOAT`已经不推荐使用了，而且在 MySQL 后续的版本中可能会被移除掉。而保存定点数应该使用`DECIMAL`类型。如果要保存时间日期，`DATETIME`类型优于`TIMESTAMP`类型，因为前者能表示的时间日期范围更大。 - -### DML（数据操作语言） - -我们通过如下所示的 SQL 给上面创建的表添加数据。 - -```SQL -use school; - --- 插入学院数据 -insert into `tb_college` - (`col_name`, `col_intro`) -values - ('计算机学院', '计算机学院1958年设立计算机专业，1981年建立计算机科学系，1998年设立计算机学院，2005年5月，为了进一步整合教学和科研资源，学校决定，计算机学院和软件学院行政班子合并统一运作、实行教学和学生管理独立运行的模式。 学院下设三个系：计算机科学与技术系、物联网工程系、计算金融系；两个研究所：图象图形研究所、网络空间安全研究院（2015年成立）；三个教学实验中心：计算机基础教学实验中心、IBM技术中心和计算机专业实验中心。'), - ('外国语学院', '外国语学院设有7个教学单位，6个文理兼收的本科专业；拥有1个一级学科博士授予点，3个二级学科博士授予点，5个一级学科硕士学位授权点，5个二级学科硕士学位授权点，5个硕士专业授权领域，同时还有2个硕士专业学位（MTI）专业；有教职员工210余人，其中教授、副教授80余人，教师中获得中国国内外名校博士学位和正在职攻读博士学位的教师比例占专任教师的60%以上。'), - ('经济管理学院', '经济学院前身是创办于1905年的经济科；已故经济学家彭迪先、张与九、蒋学模、胡寄窗、陶大镛、胡代光，以及当代学者刘诗白等曾先后在此任教或学习。'); - --- 插入学生数据 -insert into `tb_student` - (`stu_id`, `stu_name`, `stu_sex`, `stu_birth`, `stu_addr`, `col_id`) -values - (1001, '杨过', 1, '1990-3-4', '湖南长沙', 1), - (1002, '任我行', 1, '1992-2-2', '湖南长沙', 1), - (1033, '王语嫣', 0, '1989-12-3', '四川成都', 1), - (1572, '岳不群', 1, '1993-7-19', '陕西咸阳', 1), - (1378, '纪嫣然', 0, '1995-8-12', '四川绵阳', 1), - (1954, '林平之', 1, '1994-9-20', '福建莆田', 1), - (2035, '东方不败', 1, '1988-6-30', null, 2), - (3011, '林震南', 1, '1985-12-12', '福建莆田', 3), - (3755, '项少龙', 1, '1993-1-25', '四川成都', 3), - (3923, '杨不悔', 0, '1985-4-17', '四川成都', 3); - --- 插入老师数据 -insert into `tb_teacher` - (`tea_id`, `tea_name`, `tea_title`, `col_id`) -values - (1122, '张三丰', '教授', 1), - (1133, '宋远桥', '副教授', 1), - (1144, '杨逍', '副教授', 1), - (2255, '范遥', '副教授', 2), - (3366, '韦一笑', default, 3); - --- 插入课程数据 -insert into `tb_course` - (`cou_id`, `cou_name`, `cou_credit`, `tea_id`) -values - (1111, 'Python程序设计', 3, 1122), - (2222, 'Web前端开发', 2, 1122), - (3333, '操作系统', 4, 1122), - (4444, '计算机网络', 2, 1133), - (5555, '编译原理', 4, 1144), - (6666, '算法和数据结构', 3, 1144), - (7777, '经贸法语', 3, 2255), - (8888, '成本会计', 2, 3366), - (9999, '审计学', 3, 3366); - --- 插入选课数据 -insert into `tb_record` - (`stu_id`, `cou_id`, `sel_date`, `score`) -values - (1001, 1111, '2017-09-01', 95), - (1001, 2222, '2017-09-01', 87.5), - (1001, 3333, '2017-09-01', 100), - (1001, 4444, '2018-09-03', null), - (1001, 6666, '2017-09-02', 100), - (1002, 1111, '2017-09-03', 65), - (1002, 5555, '2017-09-01', 42), - (1033, 1111, '2017-09-03', 92.5), - (1033, 4444, '2017-09-01', 78), - (1033, 5555, '2017-09-01', 82.5), - (1572, 1111, '2017-09-02', 78), - (1378, 1111, '2017-09-05', 82), - (1378, 7777, '2017-09-02', 65.5), - (2035, 7777, '2018-09-03', 88), - (2035, 9999, '2019-09-02', null), - (3755, 1111, '2019-09-02', null), - (3755, 8888, '2019-09-02', null), - (3755, 9999, '2017-09-01', 92); -``` - -> **注意**：上面的`insert`语句使用了批处理的方式来插入数据，这种做法插入数据的效率比较高。 - -### DQL（数据查询语言） - -接下来，我们完成如下所示的查询。 - -```SQL --- 查询所有学生的所有信息 -select * from `tb_student`; - --- 查询学生的学号、姓名和籍贯(投影) -select `stu_id`, `stu_name`, `stu_addr` from `tb_student`; - --- 查询所有课程的名称及学分(投影和别名) -select `cou_name` as 课程名称, `cou_credit` as 学分 from `tb_course`; - --- 查询所有女学生的姓名和出生日期(筛选) -select `stu_name`, `stu_birth` from `tb_student` where `stu_sex`=0; - --- 查询籍贯为“四川成都”的女学生的姓名和出生日期(筛选) -select `stu_name`, `stu_birth` from `tb_student` where `stu_sex`=0 and `stu_addr`='四川成都'; - --- 查询籍贯为“四川成都”或者性别为“女生”的学生 -select `stu_name`, `stu_birth` from `tb_student` where `stu_sex`=0 or `stu_addr`='四川成都'; - --- 查询所有80后学生的姓名、性别和出生日期(筛选) -select `stu_name`, `stu_sex`, `stu_birth` from `tb_student` -where `stu_birth`>='1980-1-1' and `stu_birth`<='1989-12-31'; - -select `stu_name`, `stu_sex`, `stu_birth` from `tb_student` -where `stu_birth` between '1980-1-1' and '1989-12-31'; - --- 补充：将表示性别的 1 和 0 处理成 “男” 和 “女” -select - `stu_name` as 姓名, - if(`stu_sex`, '男', '女') as 性别, - `stu_birth` as 出生日期 -from `tb_student` -where `stu_birth` between '1980-1-1' and '1989-12-31'; - -select - `stu_name` as 姓名, - case `stu_sex` when 1 then '男' else '女' end as 性别, - `stu_birth` as 出生日期 -from `tb_student` -where `stu_birth` between '1980-1-1' and '1989-12-31'; - --- 查询学分大于2的课程的名称和学分(筛选) -select `cou_name`, `cou_credit` from `tb_course` where `cou_credit`>2; - --- 查询学分是奇数的课程的名称和学分(筛选) -select `cou_name`, `cou_credit` from `tb_course` where `cou_credit`%2<>0; - -select `cou_name`, `cou_credit` from `tb_course` where `cou_credit` mod 2<>0; - --- 查询选择选了1111的课程考试成绩在90分以上的学生学号(筛选) -select `stu_id` from `tb_record` where `cou_id`=1111 and `score`>90; - --- 查询名字叫“杨过”的学生的姓名和性别 -select `stu_name`, `stu_sex` from `tb_student` where `stu_name`='杨过'; - --- 查询姓“杨”的学生姓名和性别(模糊) --- % - 通配符（wildcard），它可以匹配0个或任意多个字符 -select `stu_name`, `stu_sex` from `tb_student` where `stu_name` like '杨%'; - --- 查询姓“杨”名字两个字的学生姓名和性别(模糊) --- _ - 通配符（wildcard），它可以精确匹配一个字符 -select `stu_name`, `stu_sex` from `tb_student` where `stu_name` like '杨_'; - --- 查询姓“杨”名字三个字的学生姓名和性别(模糊) -select `stu_name`, `stu_sex` from `tb_student` where `stu_name` like '杨__'; - --- 查询名字中有“不”字或“嫣”字的学生的姓名(模糊) -select `stu_name` from `tb_student` where `stu_name` like '%不%' or `stu_name` like '%嫣%'; - --- 将“岳不群”改名为“岳不嫣”，比较下面两个查询的区别 -update `tb_student` set `stu_name`='岳不嫣' where `stu_id`=1572; - -select `stu_name` from `tb_student` where `stu_name` like '%不%' -union -select `stu_name` from `tb_student` where `stu_name` like '%嫣%'; - -select `stu_name` from `tb_student` where `stu_name` like '%不%' -union all -select `stu_name` from `tb_student` where `stu_name` like '%嫣%'; - --- 查询姓“杨”或姓“林”名字三个字的学生的姓名(正则表达式模糊查询) -select `stu_name` from `tb_student` where `stu_name` regexp '[杨林].{2}'; - --- 查询没有录入籍贯的学生姓名(空值处理) -select `stu_name` from `tb_student` where `stu_addr` is null; - -select `stu_name` from `tb_student` where `stu_addr` <=> null; - --- 查询录入了籍贯的学生姓名(空值处理) -select `stu_name` from `tb_student` where `stu_addr` is not null; - --- 下面的查询什么也查不到，三值逻辑 --> true / false / unknown -select `stu_name` from `tb_student` where `stu_addr`=null or `stu_addr`<>null; - --- 查询学生选课的所有日期(去重) -select distinct `sel_date` from `tb_record`; - --- 查询学生的籍贯(去重) -select distinct `stu_addr` from `tb_student` where `stu_addr` is not null; - --- 查询男学生的姓名和生日按年龄从大到小排列(排序) --- 升序：从小到大 - asc，降序：从大到小 - desc -select `stu_id`, `stu_name`, `stu_birth` from `tb_student` -where `stu_sex`=1 order by `stu_birth` asc, `stu_id` desc; - --- 补充：将上面的生日换算成年龄(日期函数、数值函数) -select - `stu_id` as 学号, - `stu_name` as 姓名, - floor(datediff(curdate(), `stu_birth`)/365) as 年龄 -from `tb_student` -where `stu_sex`=1 order by 年龄 desc, `stu_id` desc; - --- 查询年龄最大的学生的出生日期(聚合函数) -select min(`stu_birth`) from `tb_student`; - --- 查询年龄最小的学生的出生日期(聚合函数) -select max(`stu_birth`) from `tb_student`; - --- 查询编号为1111的课程考试成绩的最高分(聚合函数) -select max(`score`) from `tb_record` where `cou_id`=1111; - --- 查询学号为1001的学生考试成绩的最低分(聚合函数) -select min(`score`) from `tb_record` where `stu_id`=1001; - --- 查询学号为1001的学生考试成绩的平均分(聚合函数) -select avg(`score`) from `tb_record` where `stu_id`=1001; - -select sum(`score`) / count(`score`) from `tb_record` where `stu_id`=1001; - --- 查询学号为1001的学生考试成绩的平均分，如果有null值，null值算0分(聚合函数) -select sum(`score`) / count(*) from `tb_record` where `stu_id`=1001; - -select avg(ifnull(`score`, 0)) from `tb_record` where `stu_id`=1001; - --- 查询学号为1001的学生考试成绩的标准差(聚合函数) -select std(`score`), variance(`score`) from `tb_record` where `stu_id`=1001; - --- 查询男女学生的人数(分组和聚合函数) -select - case `stu_sex` when 1 then '男' else '女' end as 性别, - count(*) as 人数 -from `tb_student` group by `stu_sex`; - --- 查询每个学院学生人数(分组和聚合函数) -select - `col_id` as 学院, - count(*) as 人数 -from `tb_student` group by `col_id` with rollup; - --- 查询每个学院男女学生人数(分组和聚合函数) -select - `col_id` as 学院, - if(`stu_sex`, '男', '女') as 性别, - count(*) as 人数 -from `tb_student` group by `col_id`, `stu_sex`; - --- 查询每个学生的学号和平均成绩(分组和聚合函数) -select - `stu_id`, - round(avg(`score`), 1) as avg_score -from `tb_record` group by `stu_id`; - --- 查询平均成绩大于等于90分的学生的学号和平均成绩 --- 分组以前的筛选使用where子句，分组以后的筛选使用having子句 -select - `stu_id`, - round(avg(`score`), 1) as avg_score -from `tb_record` -group by `stu_id` having avg_score>=90; - --- 查询1111、2222、3333三门课程平均成绩大于等于90分的学生的学号和平均成绩 -select - `stu_id`, - round(avg(`score`), 1) as avg_score -from `tb_record` where `cou_id` in (1111, 2222, 3333) -group by `stu_id` having avg_score>=90; - --- 查询年龄最大的学生的姓名(子查询/嵌套查询) --- 嵌套查询：把一个select的结果作为另一个select的一部分来使用 -select `stu_name` from `tb_student` -where `stu_birth`=( - select min(`stu_birth`) from `tb_student` -); - --- 查询选了两门以上的课程的学生姓名(子查询/分组条件/集合运算) -select `stu_name` from `tb_student` -where `stu_id` in ( - select `stu_id` from `tb_record` - group by `stu_id` having count(*)>2 -); - --- 查询学生的姓名、生日和所在学院名称 -select `stu_name`, `stu_birth`, `col_name` -from `tb_student`, `tb_college` -where `tb_student`.`col_id`=`tb_college`.`col_id`; - -select `stu_name`, `stu_birth`, `col_name` -from `tb_student` inner join `tb_college` -on `tb_student`.`col_id`=`tb_college`.`col_id`; - -select `stu_name`, `stu_birth`, `col_name` -from `tb_student` natural join `tb_college`; - --- 查询学生姓名、课程名称以及成绩(连接查询/联结查询) -select `stu_name`, `cou_name`, `score` -from `tb_student`, `tb_course`, `tb_record` -where `tb_student`.`stu_id`=`tb_record`.`stu_id` -and `tb_course`.`cou_id`=`tb_record`.`cou_id` -and `score` is not null; - -select `stu_name`, `cou_name`, `score` from `tb_student` -inner join `tb_record` on `tb_student`.`stu_id`=`tb_record`.`stu_id` -inner join `tb_course` on `tb_course`.`cou_id`=`tb_record`.`cou_id` -where `score` is not null; - -select `stu_name`, `cou_name`, `score` from `tb_student` -natural join `tb_record` -natural join `tb_course` -where `score` is not null; - --- 补充：上面的查询结果取前5条数据(分页查询) -select `stu_name`, `cou_name`, `score` -from `tb_student`, `tb_course`, `tb_record` -where `tb_student`.`stu_id`=`tb_record`.`stu_id` -and `tb_course`.`cou_id`=`tb_record`.`cou_id` -and `score` is not null -order by `score` desc -limit 0,5; - --- 补充：上面的查询结果取第6-10条数据(分页查询) -select `stu_name`, `cou_name`, `score` -from `tb_student`, `tb_course`, `tb_record` -where `tb_student`.`stu_id`=`tb_record`.`stu_id` -and `tb_course`.`cou_id`=`tb_record`.`cou_id` -and `score` is not null -order by `score` desc -limit 5 offset 5; - --- 补充：上面的查询结果取第11-15条数据(分页查询) -select `stu_name`, `cou_name`, `score` -from `tb_student`, `tb_course`, `tb_record` -where `tb_student`.`stu_id`=`tb_record`.`stu_id` -and `tb_course`.`cou_id`=`tb_record`.`cou_id` -and `score` is not null -order by `score` desc -limit 5 offset 10; - --- 查询选课学生的姓名和平均成绩(子查询和连接查询) -select `stu_name`, `avg_score` -from `tb_student` inner join ( - select `stu_id` as `sid`, round(avg(`score`), 1) as avg_score - from `tb_record` group by `stu_id` -) as `t2` on `stu_id`=`sid`; - --- 查询学生的姓名和选课的数量 -select `stu_name`, `total` from `tb_student` as `t1` -inner join ( - select `stu_id`, count(*) as `total` - from `tb_record` group by `stu_id` -) as `t2` on `t1`.`stu_id`=`t2`.`stu_id`; - --- 查询每个学生的姓名和选课数量(左外连接和子查询) --- 左外连接：左表（写在join左边的表）的每条记录都可以查出来，不满足连表条件的地方填充null。 -select `stu_name`, coalesce(`total`, 0) as `total` -from `tb_student` as `t1` -left outer join ( - select `stu_id`, count(*) as `total` - from `tb_record` group by `stu_id` -) as `t2` on `t1`.`stu_id`=`t2`.`stu_id`; - --- 修改选课记录表，去掉 stu_id 列的外键约束 -alter table `tb_record` drop foreign key `fk_record_stu_id`; - --- 插入两条新纪录（注意：没有学号为 5566 的学生） -insert into `tb_record` -values - (default, 5566, 1111, '2019-09-02', 80), - (default, 5566, 2222, '2019-09-02', 70); - --- 右外连接：右表（写在join右边的表）的每条记录都可以查出来，不满足连表条件的地方填充null。 -select `stu_name`, `total` from `tb_student` as `t1` -right outer join ( - select `stu_id`, count(*) as `total` - from `tb_record` group by `stu_id` -) as `t2` on `t1`.`stu_id`=`t2`.`stu_id`; - --- 全外连接：左表和右表的每条记录都可以查出来，不满足连表条件的地方填充null。 --- 说明：MySQL不支持全外连接，所以用左外连接和右外连接的并集来表示。 -select `stu_name`, `total` -from `tb_student` as `t1` -left outer join ( - select `stu_id`, count(*) as `total` - from `tb_record` group by `stu_id` -) as `t2` on `t1`.`stu_id`=`t2`.`stu_id` -union -select `stu_name`, `total` from `tb_student` as `t1` -right outer join ( - select `stu_id`, count(*) as `total` - from `tb_record` group by `stu_id` -) as `t2` on `t1`.`stu_id`=`t2`.`stu_id`; -``` - -上面的DQL有几个地方需要加以说明： - -1. MySQL目前的版本不支持全外连接，上面我们通过`union`操作，将左外连接和右外连接的结果求并集实现全外连接的效果。大家可以通过下面的图来加深对连表操作的认识。 - - - -2. MySQL 中支持多种类型的运算符，包括：算术运算符（`+`、`-`、`*`、`/`、`%`）、比较运算符（`=`、`<>`、`<=>`、`<`、`<=`、`>`、`>=`、`BETWEEN...AND..`.、`IN`、`IS NULL`、`IS NOT NULL`、`LIKE`、`RLIKE`、`REGEXP`）、逻辑运算符（`NOT`、`AND`、`OR`、`XOR`）和位运算符（`&`、`|`、`^`、`~`、`>>`、`<<`），我们可以在 DML 中使用这些运算符处理数据。 - -3. 在查询数据时，可以在`SELECT`语句及其子句（如`WHERE`子句、`ORDER BY`子句、`HAVING`子句等）中使用函数，这些函数包括字符串函数、数值函数、时间日期函数、流程函数等，如下面的表格所示。 - - 常用字符串函数。 - - | 函数 | 功能 | - | --------------------------- | ----------------------------------------------------- | - | `CONCAT` | 将多个字符串连接成一个字符串 | - | `FORMAT` | 将数值格式化成字符串并指定保留几位小数 | - | `FROM_BASE64` / `TO_BASE64` | BASE64解码/编码 | - | `BIN` / `OCT` / `HEX` | 将数值转换成二进制/八进制/十六进制字符串 | - | `LOCATE` | 在字符串中查找一个子串的位置 | - | `LEFT` / `RIGHT` | 返回一个字符串左边/右边指定长度的字符 | - | `LENGTH` / `CHAR_LENGTH` | 返回字符串的长度以字节/字符为单位 | - | `LOWER` / `UPPER` | 返回字符串的小写/大写形式 | - | `LPAD` / `RPAD` | 如果字符串的长度不足，在字符串左边/右边填充指定的字符 | - | `LTRIM` / `RTRIM` | 去掉字符串前面/后面的空格 | - | `ORD` / `CHAR` | 返回字符对应的编码/返回编码对应的字符 | - | `STRCMP` | 比较字符串，返回-1、0、1分别表示小于、等于、大于 | - | `SUBSTRING` | 返回字符串指定范围的子串 | - - 常用数值函数。 - - | 函数 | 功能 | - | -------------------------------------------------------- | ---------------------------------- | - | `ABS` | 返回一个数的绝度值 | - | `CEILING` / `FLOOR` | 返回一个数上取整/下取整的结果 | - | `CONV` | 将一个数从一种进制转换成另一种进制 | - | `CRC32` | 计算循环冗余校验码 | - | `EXP` / `LOG` / `LOG2` / `LOG10` | 计算指数/对数 | - | `POW` | 求幂 | - | `RAND` | 返回[0,1)范围的随机数 | - | `ROUND` | 返回一个数四舍五入后的结果 | - | `SQRT` | 返回一个数的平方根 | - | `TRUNCATE` | 截断一个数到指定的精度 | - | `SIN` / `COS` / `TAN` / `COT` / `ASIN` / `ACOS` / `ATAN` | 三角函数 | - - 常用时间日期函数。 - - | 函数 | 功能 | - | ----------------------------- | ------------------------------------- | - | `CURDATE` / `CURTIME` / `NOW` | 获取当前日期/时间/日期和时间 | - | `ADDDATE` / `SUBDATE` | 将两个日期表达式相加/相减并返回结果 | - | `DATE` / `TIME` | 从字符串中获取日期/时间 | - | `YEAR` / `MONTH` / `DAY` | 从日期中获取年/月/日 | - | `HOUR` / `MINUTE` / `SECOND` | 从时间中获取时/分/秒 | - | `DATEDIFF` / `TIMEDIFF` | 返回两个时间日期表达式相差多少天/小时 | - | `MAKEDATE` / `MAKETIME` | 制造一个日期/时间 | - - 常用流程函数。 - - | 函数 | 功能 | - | -------- | ------------------------------------------------ | - | `IF` | 根据条件是否成立返回不同的值 | - | `IFNULL` | 如果为NULL则返回指定的值否则就返回本身 | - | `NULLIF` | 两个表达式相等就返回NULL否则返回第一个表达式的值 | - - 其他常用函数。 - - | 函数 | 功能 | - | -------------------------- | ----------------------------- | - | `MD5` / `SHA1` / `SHA2` | 返回字符串对应的哈希摘要 | - | `CHARSET` / `COLLATION` | 返回字符集/校对规则 | - | `USER` / `CURRENT_USER` | 返回当前用户 | - | `DATABASE` | 返回当前数据库名 | - | `VERSION` | 返回当前数据库版本 | - | `FOUND_ROWS` / `ROW_COUNT` | 返回查询到的行数/受影响的行数 | - | `LAST_INSERT_ID` | 返回最后一个自增主键的值 | - | `UUID` / `UUID_SHORT` | 返回全局唯一标识符 | - -### DCL（数据控制语言） - -数据控制语言用于给指定的用户授权或者从召回指定用户的指定权限，这组操作对数据库管理员来说比较重要，将一个用户的权限最小化（刚好够用）是非常重要的，对数据库的安全至关重要。 - -```SQL --- 创建名为 wangdachui 的账号并为其指定口令，允许该账号从任意主机访问 -create user 'wangdachui'@'%' identified by '123456'; - --- 授权 wangdachui 可以对名为school的数据库执行 select 和 insert 操作 -grant select, insert on `school`.* to 'wangdachui'@'%'; - --- 召回 wangdachui 对school数据库的 insert 权限 -revoke insert on `school`.* from 'wangdachui'@'%'; -``` - -> **说明**：创建一个可以允许任意主机登录并且具有超级管理员权限的用户在现实中并不是一个明智的决定，因为一旦该账号的口令泄露或者被破解，数据库将会面临灾难级的风险。 diff --git "a/\347\254\25442\350\257\276.SQL\350\257\246\350\247\243\344\271\213DML.md" "b/\347\254\25442\350\257\276.SQL\350\257\246\350\247\243\344\271\213DML.md" new file mode 100644 index 0000000..78f28db --- /dev/null +++ "b/\347\254\25442\350\257\276.SQL\350\257\246\350\247\243\344\271\213DML.md" @@ -0,0 +1,159 @@ +## SQL详解之DML + +我们接着上一课中创建的学校选课系统数据库，为大家讲解 DML 的使用。DML 可以帮助将数据插入到二维表（`insert`操作）、从二维表删除数据（`delete`操作）以及更新二维表的数据（`update`操作）。在执行 DML 之前，我们先通过下面的`use`命令切换到`school`数据库。 + +```SQL +use `school`; +``` + +### insert操作 + +顾名思义，`insert`是用来插入行到二维表中的，插入的方式包括：插入完整的行、插入行的一部分、插入多行、插入查询的结果。我们通过如下所示的 SQL 向学院表中添加一个学院。 + +```SQL +insert into `tb_college` values (default, '计算机学院', '学习计算机科学与技术的地方'); +``` + +其中，由于学院表的主键是一个自增字段，因此上面的 SQL 中用`default`表示该列使用默认值，我们也可以使用下面的方式完成同样的操作。 + +```SQL +insert into `tb_college` (`col_name`, `col_intro`) values ('计算机学院', '学习计算机科学与技术的地方'); +``` + +我们推荐大家使用下面这种做法，指定为哪些字段赋值，这样做可以不按照建表时设定的字段顺序赋值，可以按照`values`前面的元组中给定的字段顺序为字段赋值，但是需要注意，除了允许为`null`和有默认值的字段外，其他的字段都必须要一一列出并在`values`后面的元组中为其赋值。如果希望一次性插入多条记录，我们可以在`values`后面跟上多个元组来实现批量插入，代码如下所示。 + +```SQL +insert into `tb_college` + (`col_name`, `col_intro`) +values + ('外国语学院', '学习歪果仁的语言的学院'), + ('经济管理学院', '经世济民，治理国家；管理科学，兴国之道'), + ('体育学院', '发展体育运动，增强人民体质'); +``` + +在插入数据时，要注意主键是不能重复的，如果插入的数据与表中已有记录主键相同，那么`insert`操作将会产生 Duplicated Entry 的报错信息。再次提醒大家，如果`insert`操作省略了某些列，那么这些列要么有默认值，要么允许为`null`，否则也将产生错误。在业务系统中，为了让`insert`操作不影响其他操作（主要是后面要讲的`select`操作）的性能，可以在`insert`和`into`之间加一个`low_priority`来降低`insert`操作的优先级，这个做法也适用于下面要讲的`delete`和`update`操作。 + +假如有一张名为`tb_temp`的表中有`a`和`b`两个列，分别保存了学院的名称和学院的介绍，我们也可以通过查询操作获得`tb_temp`表的数据并插入到学院表中，如下所示，其中的`select`就是我们之前提到的 DQL，在下一课中会详细讲解。 + +```SQL +insert into `tb_college` + (`col_name`, `col_intro`) +select `a`, `b` from `tb_temp`; +``` + +### delete 操作 + +如果需要从表中删除数据，可以使用`delete`操作，它可以帮助我们删除指定行或所有行，例如我们要删除编号为`1`的学院，就可以使用如下所示的 SQL。 + +```SQL +delete from `tb_college` where col_id=1; +``` + +注意，上面的`delete`操作中的`where`子句是用来指定条件的，只有满足条件的行会被删除。如果我们不小心写出了下面的 SQL，就会删除学院表中所有的记录，这是相当危险的，在实际工作中通常也不会这么做。 + +```SQL +delete from `tb_college`; +``` + +需要说明的是，即便删除了所有的数据，`delete`操作不会删除表本身，也不会让 AUTO_INCREMENT 字段的值回到初始值。如果需要删除所有的数据而且让 AUTO_INCREMENT 字段回到初始值，可以使用`truncate table`执行截断表操作，`truncate`的本质是删除原来的表并重新创建一个表，它的速度其实更快，因为不需要逐行删除数据。但是请大家记住一点，用`truncate table`删除数据是非常危险的，因为它会删除所有的数据，而且由于原来的表已经被删除了，要想恢复误删除的数据也会变得极为困难。 + +### update 操作 + +如果要修改表中的数据，可以使用`update`操作，它可以用来删除指定的行或所有的行。例如，我们将学生表中的“杨过”修改为“杨逍”，这里我们假设“杨过”的学号为`1001`，代码如下所示。 + +```SQL +update `tb_student` set `stu_name`='杨逍' where `stu_id`=1001; +``` + +注意上面 SQL 中的`where`子句，我们使用学号作为条件筛选出对应的学生，然后通过前面的赋值操作将其姓名修改为“杨逍”。这里为什么不直接使用姓名作为筛选条件，那是因为学生表中可能有多个名为“杨过”的学生，如果使用 stu_name 作为筛选条件，那么我们的`update`操作有可能会一次更新多条数据，这显然不是我们想要看到的。还有一个需要注意的地方是`update`操作中的`set`关键字，因为 SQL 中的`=`并不表示赋值，而是判断相等的运算符，只有出现在`set` 关键字后面的`=`，才具备赋值的能力。 + +如果要同时修改学生的姓名和生日，我们可以对上面的`update`语句稍作修改，如下所示。 + +```SQL +update `tb_student` set `stu_name`='杨逍', `stu_birth`='1975-12-29' where `stu_id`=1001; +``` + +`update`语句中也可以使用查询的方式获得数据并以此来更新指定的表数据，有兴趣的读者可以自行研究。在书写`update`语句时，通常都会有`where`子句，因为实际工作中几乎不太会用到更新全表的操作，这一点大家一定要注意。 + +### 完整的数据 + +下面我们给出完整的向 school 数据库的五张表中插入数据的 SQL。 + +```SQL +use `school`; + +-- 插入学院数据 +insert into `tb_college` + (`col_name`, `col_intro`) +values + ('计算机学院', '计算机学院1958年设立计算机专业，1981年建立计算机科学系，1998年设立计算机学院，2005年5月，为了进一步整合教学和科研资源，学校决定，计算机学院和软件学院行政班子合并统一运作、实行教学和学生管理独立运行的模式。 学院下设三个系：计算机科学与技术系、物联网工程系、计算金融系；两个研究所：图象图形研究所、网络空间安全研究院（2015年成立）；三个教学实验中心：计算机基础教学实验中心、IBM技术中心和计算机专业实验中心。'), + ('外国语学院', '外国语学院设有7个教学单位，6个文理兼收的本科专业；拥有1个一级学科博士授予点，3个二级学科博士授予点，5个一级学科硕士学位授权点，5个二级学科硕士学位授权点，5个硕士专业授权领域，同时还有2个硕士专业学位（MTI）专业；有教职员工210余人，其中教授、副教授80余人，教师中获得中国国内外名校博士学位和正在职攻读博士学位的教师比例占专任教师的60%以上。'), + ('经济管理学院', '经济学院前身是创办于1905年的经济科；已故经济学家彭迪先、张与九、蒋学模、胡寄窗、陶大镛、胡代光，以及当代学者刘诗白等曾先后在此任教或学习。'); + +-- 插入学生数据 +insert into `tb_student` + (`stu_id`, `stu_name`, `stu_sex`, `stu_birth`, `stu_addr`, `col_id`) +values + (1001, '杨过', 1, '1990-3-4', '湖南长沙', 1), + (1002, '任我行', 1, '1992-2-2', '湖南长沙', 1), + (1033, '王语嫣', 0, '1989-12-3', '四川成都', 1), + (1572, '岳不群', 1, '1993-7-19', '陕西咸阳', 1), + (1378, '纪嫣然', 0, '1995-8-12', '四川绵阳', 1), + (1954, '林平之', 1, '1994-9-20', '福建莆田', 1), + (2035, '东方不败', 1, '1988-6-30', null, 2), + (3011, '林震南', 1, '1985-12-12', '福建莆田', 3), + (3755, '项少龙', 1, '1993-1-25', '四川成都', 3), + (3923, '杨不悔', 0, '1985-4-17', '四川成都', 3); + +-- 插入老师数据 +insert into `tb_teacher` + (`tea_id`, `tea_name`, `tea_title`, `col_id`) +values + (1122, '张三丰', '教授', 1), + (1133, '宋远桥', '副教授', 1), + (1144, '杨逍', '副教授', 1), + (2255, '范遥', '副教授', 2), + (3366, '韦一笑', default, 3); + +-- 插入课程数据 +insert into `tb_course` + (`cou_id`, `cou_name`, `cou_credit`, `tea_id`) +values + (1111, 'Python程序设计', 3, 1122), + (2222, 'Web前端开发', 2, 1122), + (3333, '操作系统', 4, 1122), + (4444, '计算机网络', 2, 1133), + (5555, '编译原理', 4, 1144), + (6666, '算法和数据结构', 3, 1144), + (7777, '经贸法语', 3, 2255), + (8888, '成本会计', 2, 3366), + (9999, '审计学', 3, 3366); + +-- 插入选课数据 +insert into `tb_record` + (`stu_id`, `cou_id`, `sel_date`, `score`) +values + (1001, 1111, '2017-09-01', 95), + (1001, 2222, '2017-09-01', 87.5), + (1001, 3333, '2017-09-01', 100), + (1001, 4444, '2018-09-03', null), + (1001, 6666, '2017-09-02', 100), + (1002, 1111, '2017-09-03', 65), + (1002, 5555, '2017-09-01', 42), + (1033, 1111, '2017-09-03', 92.5), + (1033, 4444, '2017-09-01', 78), + (1033, 5555, '2017-09-01', 82.5), + (1572, 1111, '2017-09-02', 78), + (1378, 1111, '2017-09-05', 82), + (1378, 7777, '2017-09-02', 65.5), + (2035, 7777, '2018-09-03', 88), + (2035, 9999, '2019-09-02', null), + (3755, 1111, '2019-09-02', null), + (3755, 8888, '2019-09-02', null), + (3755, 9999, '2017-09-01', 92); +``` + +> **注意**：上面的`insert`语句使用了批处理的方式来插入数据，这种做法插入数据的效率比较高。 + + + diff --git "a/\347\254\25442\350\257\276\357\274\232\346\267\261\345\205\245MySQL.md" "b/\347\254\25442\350\257\276\357\274\232\346\267\261\345\205\245MySQL.md" deleted file mode 100644 index 27b941a..0000000 --- "a/\347\254\25442\350\257\276\357\274\232\346\267\261\345\205\245MySQL.md" +++ /dev/null @@ -1,661 +0,0 @@ -## 第42课：深入MySQL - -### 索引 - -索引是关系型数据库中用来提升查询性能最为重要的手段。关系型数据库中的索引就像一本书的目录，我们可以想象一下，如果要从一本书中找出某个知识点，但是这本书没有目录，这将是意见多么可怕的事情！我们估计得一篇一篇的翻下去，才能确定这个知识点到底在什么位置。创建索引虽然会带来存储空间上的开销，就像一本书的目录会占用一部分篇幅一样，但是在牺牲空间后换来的查询时间的减少也是非常显著的。 - -MySQL 数据库中所有数据类型的列都可以被索引。对于MySQL 8.0 版本的 InnoDB 存储引擎来说，它支持三种类型的索引，分别是 B+ 树索引、全文索引和 R 树索引。这里，我们只介绍使用得最为广泛的 B+ 树索引。使用 B+ 树的原因非常简单，因为它是目前在基于磁盘进行海量数据存储和排序上最有效率的数据结构。B+ 树是一棵[平衡树](https://zh.wikipedia.org/zh-cn/%E5%B9%B3%E8%A1%A1%E6%A0%91)，树的高度通常为3或4，但是却可以保存从百万级到十亿级的数据，而从这些数据里面查询一条数据，只需要3次或4次 I/O 操作。 - -B+ 树由根节点、中间节点和叶子节点构成，其中叶子节点用来保存排序后的数据。由于记录在索引上是排序过的，因此在一个叶子节点内查找数据时可以使用二分查找，这种查找方式效率非常的高。当数据很少的时候，B+ 树只有一个根节点，数据也就保存在根节点上。随着记录越来越多，B+ 树会发生分裂，根节点不再保存数据，而是提供了访问下一层节点的指针，帮助快速确定数据在哪个叶子节点上。 - -在创建二维表时，我们通常都会为表指定主键列，主键列上默认会创建索引，而对于 MySQL InnoDB 存储引擎来说，因为它使用的是索引组织表这种数据存储结构，所以主键上的索引就是整张表的数据，而这种索引我们也将其称之为**聚集索引**（clustered index）。很显然，一张表只能有一个聚集索引，否则表的数据岂不是要保存多次。我们自己创建的索引都是二级索引（secondary index），更常见的叫法是**非聚集索引**（non-clustered index）。通过我们自定义的非聚集索引只能定位记录的主键，在获取数据时可能需要再通过主键上的聚集索引进行查询，这种现象称为“回表”，因此通过非聚集索引检索数据通常比使用聚集索引检索数据要慢。 - -接下来我们通过一个简单的例子来说明索引的意义，比如我们要根据学生的姓名来查找学生，这个场景在实际开发中应该经常遇到，就跟通过商品名称查找商品是一个道理。我们可以使用 MySQL 的`explain`关键字来查看 SQL 的执行计划（数据库执行 SQL 语句的具体步骤）。 - -```SQL -explain select * from tb_student where stuname='林震南'\G -``` - -``` -*************************** 1. row *************************** - id: 1 - select_type: SIMPLE - table: tb_student - partitions: NULL - type: ALL -possible_keys: NULL - key: NULL - key_len: NULL - ref: NULL - rows: 11 - filtered: 10.00 - Extra: Using where -1 row in set, 1 warning (0.00 sec) -``` - -在上面的 SQL 执行计划中，有几项值得我们关注： - -1. `select_type`：查询的类型。 - - `SIMPLE`：简单 SELECT，不需要使用 UNION 操作或子查询。 - - `PRIMARY`：如果查询包含子查询，最外层的 SELECT 被标记为 PRIMARY。 - - `UNION`：UNION 操作中第二个或后面的 SELECT 语句。 - - `SUBQUERY`：子查询中的第一个 SELECT。 - - `DERIVED`：派生表的 SELECT 子查询。 -2. `table`：查询对应的表。 -3. `type`：MySQL 在表中找到满足条件的行的方式，也称为访问类型，包括：`ALL`（全表扫描）、`index`（索引全扫描，只遍历索引树）、`range`（索引范围扫描）、`ref`（非唯一索引扫描）、`eq_ref`（唯一索引扫描）、`const` / `system`（常量级查询）、`NULL`（不需要访问表或索引）。在所有的访问类型中，很显然 ALL 是性能最差的，它代表的全表扫描是指要扫描表中的每一行才能找到匹配的行。 -4. `possible_keys`：MySQL 可以选择的索引，但是**有可能不会使用**。 -5. `key`：MySQL 真正使用的索引，如果为`NULL`就表示没有使用索引。 -6. `key_len`：使用的索引的长度，在不影响查询的情况下肯定是长度越短越好。 -7. `rows`：执行查询需要扫描的行数，这是一个**预估值**。 -8. `extra`：关于查询额外的信息。 - - `Using filesort`：MySQL 无法利用索引完成排序操作。 - - `Using index`：只使用索引的信息而不需要进一步查表来获取更多的信息。 - - `Using temporary`：MySQL 需要使用临时表来存储结果集，常用于分组和排序。 - - `Impossible where`：`where`子句会导致没有符合条件的行。 - - `Distinct`：MySQL 发现第一个匹配行后，停止为当前的行组合搜索更多的行。 - - `Using where`：查询的列未被索引覆盖，筛选条件并不是索引的前导列。 - -从上面的执行计划可以看出，当我们通过学生名字查询学生时实际上是进行了全表扫描，不言而喻这个查询性能肯定是非常糟糕的，尤其是在表中的行很多的时候。如果我们需要经常通过学生姓名来查询学生，那么就应该在学生姓名对应的列上创建索引，通过索引来加速查询。 - -```SQL -create index idx_student_name on tb_student(stuname); -``` - -再次查看刚才的 SQL 对应的执行计划。 - -```SQL -explain select * from tb_student where stuname='林震南'\G -``` - -``` -*************************** 1. row *************************** - id: 1 - select_type: SIMPLE - table: tb_student - partitions: NULL - type: ref -possible_keys: idx_student_name - key: idx_student_name - key_len: 62 - ref: const - rows: 1 - filtered: 100.00 - Extra: NULL -1 row in set, 1 warning (0.00 sec) -``` - -可以注意到，在对学生姓名创建索引后，刚才的查询已经不是全表扫描而是基于索引的查询，而且扫描的行只有唯一的一行，这显然大大的提升了查询的性能。MySQL 中还允许创建前缀索引，即对索引字段的前N个字符创建索引，这样的话可以减少索引占用的空间（但节省了空间很有可能会浪费时间，**时间和空间是不可调和的矛盾**），如下所示。 - -```SQL -create index idx_student_name_1 on tb_student(stuname(1)); -``` - -上面的索引相当于是根据学生姓名的第一个字来创建的索引，我们再看看 SQL 执行计划。 - -```SQL -explain select * from tb_student where stuname='林震南'\G -``` - -``` -*************************** 1. row *************************** - id: 1 - select_type: SIMPLE - table: tb_student - partitions: NULL - type: ref -possible_keys: idx_student_name - key: idx_student_name - key_len: 5 - ref: const - rows: 2 - filtered: 100.00 - Extra: Using where -1 row in set, 1 warning (0.00 sec) -``` - -不知道大家是否注意到，这一次扫描的行变成了2行，因为学生表中有两个姓“林”的学生，我们只用姓名的第一个字作为索引的话，在查询时通过索引就会找到这两行。 - -如果要删除索引，可以使用下面的SQL。 - -```SQL -alter table tb_student drop index idx_student_name; -``` - -或者 - -```SQL -drop index idx_student_name on tb_student; -``` - -在创建索引时，我们还可以使用复合索引、函数索引（MySQL 5.7 开始支持），用好复合索引实现**索引覆盖**可以减少不必要的排序和回表操作，这样就会让查询的性能成倍的提升，有兴趣的读者可以自行研究。 - -我们简单的为大家总结一下索引的设计原则： - -1. **最适合**索引的列是出现在**WHERE子句**和连接子句中的列。 -2. 索引列的基数越大（取值多、重复值少），索引的效果就越好。 -3. 使用**前缀索引**可以减少索引占用的空间，内存中可以缓存更多的索引。 -4. **索引不是越多越好**，虽然索引加速了读操作（查询），但是写操作（增、删、改）都会变得更慢，因为数据的变化会导致索引的更新，就如同书籍章节的增删需要更新目录一样。 -5. 使用 InnoDB 存储引擎时，表的普通索引都会保存主键的值，所以**主键要尽可能选择较短的数据类型**，这样可以有效的减少索引占用的空间，提升索引的缓存效果。 - -最后，还有一点需要说明，InnoDB 使用的 B-tree 索引，数值类型的列除了等值判断时索引会生效之外，使用`>`、`<`、`>=`、`<=`、`BETWEEN...AND... `、`<>`时，索引仍然生效；对于字符串类型的列，如果使用不以通配符开头的模糊查询，索引也是起作用的，但是其他的情况会导致索引失效，这就意味着很有可能会做全表查询。 - -### 视图 - -视图是关系型数据库中将一组查询指令构成的结果集组合成可查询的数据表的对象。简单的说，视图就是虚拟的表，但与数据表不同的是，数据表是一种实体结构，而视图是一种虚拟结构，你也可以将视图理解为保存在数据库中被赋予名字的 SQL 语句。 - -使用视图可以获得以下好处： - -1. 可以将实体数据表隐藏起来，让外部程序无法得知实际的数据结构，让访问者可以使用表的组成部分而不是整个表，降低数据库被攻击的风险。 -2. 在大多数的情况下视图是只读的（更新视图的操作通常都有诸多的限制），外部程序无法直接透过视图修改数据。 -3. 重用 SQL 语句，将高度复杂的查询包装在视图表中，直接访问该视图即可取出需要的数据；也可以将视图视为数据表进行连接查询。 -4. 视图可以返回与实体数据表不同格式的数据，在创建视图的时候可以对数据进行格式化处理。 - -创建视图。 - -```SQL --- 创建视图 -create view `vw_avg_score` -as - select `stu_id`, round(avg(`score`), 1) as `avg_score` - from `tb_record` group by `stu_id`; - --- 基于已有的视图创建视图 -create view `vw_student_score` -as - select `stu_name`, `avg_score` - from `tb_student` natural join `vw_avg_score`; -``` - -> **提示**：因为视图不包含数据，所以每次使用视图时，都必须执行查询以获得数据，如果你使用了连接查询、嵌套查询创建了较为复杂的视图，你可能会发现查询性能下降得很厉害。因此，在使用复杂的视图前，应该进行测试以确保其性能能够满足应用的需求。 - -使用视图。 - -```SQL -select * from `vw_student_score` order by `avg_score` desc; -``` - -``` -+--------------+----------+ -| stuname | avgscore | -+--------------+----------+ -| 杨过 | 95.6 | -| 任我行 | 53.5 | -| 王语嫣 | 84.3 | -| 纪嫣然 | 73.8 | -| 岳不群 | 78.0 | -| 东方不败 | 88.0 | -| 项少龙 | 92.0 | -+--------------+----------+ -``` - -既然视图是一张虚拟的表，那么视图的中的数据可以更新吗？视图的可更新性要视具体情况而定，以下类型的视图是不能更新的： - -1. 使用了聚合函数（`SUM`、`MIN`、`MAX`、`AVG`、`COUNT`等）、`DISTINCT`、`GROUP BY`、`HAVING`、`UNION`或者`UNION ALL`的视图。 -2. `SELECT`中包含了子查询的视图。 -3. `FROM`子句中包含了一个不能更新的视图的视图。 -4. `WHERE`子句的子查询引用了`FROM`子句中的表的视图。 - -删除视图。 - -```SQL -drop view vw_student_score; -``` - -> **说明**：如果希望更新视图，可以先用上面的命令删除视图，也可以通过`create or replace view`来更新视图。 - -视图的规则和限制。 - -1. 视图可以嵌套，可以利用从其他视图中检索的数据来构造一个新的视图。视图也可以和表一起使用。 -2. 创建视图时可以使用`order by`子句，但如果从视图中检索数据时也使用了`order by`，那么该视图中原先的`order by`会被覆盖。 -3. 视图无法使用索引，也不会激发触发器（实际开发中因为性能等各方面的考虑，通常不建议使用触发器，所以我们也不对这个概念进行介绍）的执行。 - -### 函数 - -MySQL 中的函数跟 Python 中的函数太多的差异，因为函数都是用来封装功能上相对独立且会被重复使用的代码的。如果非要找出一些差别来，那么 MySQL 中的函数是可以执行 SQL 语句的。下面的例子，我们通过自定义函数实现了截断超长字符串的功能。 - -```SQL -delimiter $$ - -create function truncate_string( - content varchar(10000), - max_length int unsigned -) returns varchar(10000) no sql -begin - declare result varchar(10000) default content; - if char_length(content) > max_length then - set result = left(content, max_length); - set result = concat(result, '……'); - end if; - return result; -end $$ - -delimiter ; -``` - -> **说明1**：函数声明后面的`no sql`是声明函数体并没有使用 SQL 语句；如果函数体中需要通过 SQL 读取数据，需要声明为`reads sql data`。 -> -> **说明2**：定义函数前后的`delimiter`命令是为了修改定界符，因为函数体中的语句都是用`;`表示结束，如果不重新定义定界符，那么遇到的`;`的时候代码就会被截断执行，显然这不是我们想要的效果。 - -在查询中调用自定义函数。 - -```SQL -select truncate_string('和我在成都的街头走一走，直到所有的灯都熄灭了也不停留', 10) as short_string; -``` - -``` -+--------------------------------------+ -| short_string | -+--------------------------------------+ -| 和我在成都的街头走一…… | -+--------------------------------------+ -``` - -### 过程 - -过程（又称存储过程）是事先编译好存储在数据库中的一组 SQL 的集合，调用过程可以简化应用程序开发人员的工作，减少与数据库服务器之间的通信，对于提升数据操作的性能也是有帮助的。其实迄今为止，我们使用的 SQL 语句都是针对一个或多个表的单条语句，但在实际开发中经常会遇到某个操作需要多条 SQL 语句才能完成的情况。例如，电商网站在受理用户订单时，需要做以下一系列的处理。 - -1. 通过查询来核对库存中是否有对应的物品以及库存是否充足。 -2. 如果库存有物品，需要锁定库存以确保这些物品不再卖给别人， 并且要减少可用的物品数量以反映正确的库存量。 -3. 如果库存不足，可能需要进一步与供应商进行交互或者至少产生一条系统提示消息。 -4. 不管受理订单是否成功，都需要产生流水记录，而且需要给对应的用户产生一条通知信息。 - -我们可以通过过程将复杂的操作封装起来，这样不仅有助于保证数据的一致性，而且将来如果业务发生了变动，只需要调整和修改过程即可。对于调用过程的用户来说，过程并没有暴露数据表的细节，而且执行过程比一条条的执行一组 SQL 要快得多。 - -下面的过程实现了查询某门课程的最高分、最低分和平均分。 - -```SQL -drop procedure if exists sp_score_stat; - -delimiter $$ - -create procedure sp_score_stat( - courseId int, - out maxScore decimal(4,1), - out minScore decimal(4,1), - out avgScore decimal(4,1) -) -begin - select max(score) into maxScore from tb_record where cou_id=courseId; - select min(score) into minScore from tb_record where cou_id=courseId; - select avg(score) into avgScore from tb_record where cou_id=courseId; -end $$ - -delimiter ; -``` - -> **说明**：在定义过程时，因为可能需要书写多条 SQL，而分隔这些 SQL 需要使用分号作为分隔符，如果这个时候，仍然用分号表示整段代码结束，那么定义过程的 SQL 就会出现错误，所以上面我们用`delimiter $$`将整段代码结束的标记定义为`$$`，那么代码中的分号将不再表示整段代码的结束，整段代码只会在遇到`end $$`时才会执行。在定义完过程后，通过`delimiter ;`将结束符重新改回成分号（恢复现场）。 - -上面定义的过程有四个参数，其中第一个参数是输入参数，代表课程的编号，后面的参数都是输出参数，因为过程不能定义返回值，只能通过输出参数将执行结果带出，定义输出参数的关键字是`out`，默认情况下参数都是输入参数。 - -调用过程。 - -```SQL -call sp_score_stat(1111, @a, @b, @c); -``` - -获取输出参数的值。 - -```SQL -select @a as 最高分, @b as 最低分, @c as 平均分; -``` - -删除过程。 - -```SQL -drop procedure sp_score_stat; -``` - -在过程中，我们可以定义变量、条件，可以使用分支和循环语句，可以通过游标操作查询结果，还可以使用事件调度器，这些内容我们暂时不在此处进行介绍。虽然我们说了很多过程的好处，但是在实际开发中，如果频繁的使用过程并将大量复杂的运算放到过程中，会给据库服务器造成巨大的压力，而数据库往往都是性能瓶颈所在，使用过程无疑是雪上加霜的操作。所以，对于互联网产品开发，我们一般建议让数据库只做好存储，复杂的运算和处理交给应用服务器上的程序去完成，如果应用服务器变得不堪重负了，我们可以比较容易的部署多台应用服务器来分摊这些压力。 - -如果大家对上面讲到的视图、函数、过程包括我们没有讲到的触发器这些知识有兴趣，建议大家阅读 MySQL 的入门读物[《MySQL必知必会》](https://item.jd.com/12818982.html)进行一般性了解即可，因为这些知识点在大家将来的工作中未必用得上，学了也可能仅仅是为了应付面试而已。 - -### MySQL 新特性 - -#### JSON类型 - -很多开发者在使用关系型数据库做数据持久化的时候，常常感到结构化的存储缺乏灵活性，因为必须事先设计好所有的列以及对应的数据类型。在业务发展和变化的过程中，如果需要修改表结构，这绝对是比较麻烦和难受的事情。从 MySQL 5.7 版本开始，MySQL引入了对 JSON 数据类型的支持（MySQL 8.0 解决了 JSON 的日志性能瓶颈问题），用好 JSON 类型，其实就是打破了关系型数据库和非关系型数据库之间的界限，为数据持久化操作带来了更多的便捷。 - -JSON 类型主要分为 JSON 对象和 JSON数组两种，如下所示。 - -1. JSON 对象 - -```JSON -{"name": "骆昊", "tel": "13122335566", "QQ": "957658"} -``` - -2. JSON 数组 - -```JSON -[1, 2, 3] -``` - -```JSON -[{"name": "骆昊", "tel": "13122335566"}, {"name": "王大锤", "QQ": "123456"}] -``` - -哪些地方需要用到JSON类型呢？举一个简单的例子，现在很多产品的用户登录都支持多种方式，例如手机号、微信、QQ、新浪微博等，但是一般情况下我们又不会要求用户提供所有的这些信息，那么用传统的设计方式，就需要设计多个列来对应多种登录方式，可能还需要允许这些列存在空值，这显然不是很好的选择；另一方面，如果产品又增加了一种登录方式，那么就必然要修改之前的表结构，这就更让人痛苦了。但是，有了 JSON 类型，刚才的问题就迎刃而解了，我们可以做出如下所示的设计。 - -```SQL -create table `tb_test` -( -`user_id` bigint unsigned, -`login_info` json, -primary key (`user_id`) -) engine=innodb; - -insert into `tb_test` values - (1, '{"tel": "13122335566", "QQ": "654321", "wechat": "jackfrued"}'), - (2, '{"tel": "13599876543", "weibo": "wangdachui123"}'); -``` - -如果要查询用户的手机和微信号，可以用如下所示的 SQL 语句。 - -```SQL -select - `user_id`, - json_unquote(json_extract(`login_info`, '$.tel')) as 手机号, - json_unquote(json_extract(`login_info`, '$.wechat')) as 微信 -from `tb_test`; -``` - -``` -+---------+-------------+-----------+ -| user_id | 手机号 | 微信 | -+---------+-------------+-----------+ -| 1 | 13122335566 | jackfrued | -| 2 | 13599876543 | NULL | -+---------+-------------+-----------+ -``` - -因为支持 JSON 类型，MySQL 也提供了配套的处理 JSON 数据的函数，就像上面用到的`json_extract`和`json_unquote`。当然，上面的 SQL 还有更为便捷的写法，如下所示。 - -```SQL -select - `user_id`, - `login_info` ->> '$.tel' as 手机号, - `login_info` ->> '$.wechat' as 微信 -from `tb_test`; -``` - -再举个例子，如果我们的产品要实现用户画像功能（给用户打标签），然后基于用户画像给用户推荐平台的服务或消费品之类的东西，我们也可以使用 JSON 类型来保存用户画像数据，示意代码如下所示。 - -创建画像标签表。 - -```SQL -create table `tb_tags` -( -`tag_id` int unsigned not null comment '标签ID', -`tag_name` varchar(20) not null comment '标签名', -primary key (`tag_id`) -) engine=innodb; - -insert into `tb_tags` (`tag_id`, `tag_name`) -values - (1, '70后'), - (2, '80后'), - (3, '90后'), - (4, '00后'), - (5, '爱运动'), - (6, '高学历'), - (7, '小资'), - (8, '有房'), - (9, '有车'), - (10, '爱看电影'), - (11, '爱网购'), - (12, '常点外卖'); -``` - -为用户打标签。 - -```SQL -create table `tb_users_tags` -( -`user_id` bigint unsigned not null comment '用户ID', -`user_tags` json not null comment '用户标签' -) engine=innodb; - -insert into `tb_users_tags` values - (1, '[2, 6, 8, 10]'), - (2, '[3, 10, 12]'), - (3, '[3, 8, 9, 11]'); -``` - -接下来，我们通过一组查询来了解 JSON 类型的巧妙之处。 - -1. 查询爱看电影（有`10`这个标签）的用户ID。 - - ```SQL - select * from `tb_users` where 10 member of (user_tags->'$'); - ``` - -2. 查询爱看电影（有`10`这个标签）的80后（有`2`这个标签）用户ID。 - - ``` - select * from `tb_users` where json_contains(user_tags->'$', '[2, 10]'); - -3. 查询爱看电影或80后或90后的用户ID。 - - ```SQL - select `user_id` from `tb_users_tags` where json_overlaps(user_tags->'$', '[2, 3, 10]'); - ``` - -> **说明**：上面的查询用到了`member of`谓词和两个 JSON 函数，`json_contains`可以检查 JSON 数组是否包含了指定的元素，而`json_overlaps`可以检查 JSON 数组是否与指定的数组有重叠部分。 - -#### 窗口函数 - -MySQL 从8.0开始支持窗口函数，大多数商业数据库和一些开源数据库早已提供了对窗口函数的支持，有的也将其称之为 OLAP（联机分析和处理）函数，听名字就知道跟统计和分析相关。为了帮助大家理解窗口函数，我们先说说窗口的概念。 - -窗口可以理解为记录的集合，窗口函数也就是在满足某种条件的记录集合上执行的特殊函数，对于每条记录都要在此窗口内执行函数。窗口函数和我们上面讲到的聚合函数比较容易混淆，二者的区别主要在于聚合函数是将多条记录聚合为一条记录，窗口函数是每条记录都会执行，执行后记录条数不会变。窗口函数不仅仅是几个函数，它是一套完整的语法，函数只是该语法的一部分，基本语法如下所示： - -```SQL -<窗口函数> over (partition by <用于分组的列名> order by <用户排序的列名>) -``` - -上面语法中，窗口函数的位置可以放以下两种函数： - -1. 专用窗口函数，包括：`lead`、`lag`、`first_value`、`last_value`、`rank`、`dense_rank`和`row_number`等。 -2. 聚合函数，包括：`sum`、`avg`、`max`、`min`和`count`等。 - -下面为大家举几个使用窗口函数的简单例子，我们先用如下所示的 SQL 建库建表。 - -```SQL --- 创建名为hrs的数据库并指定默认的字符集 -create database `hrs` default charset utf8mb4; - --- 切换到hrs数据库 -use `hrs`; - --- 创建部门表 -create table `tb_dept` -( -`dno` int not null comment '编号', -`dname` varchar(10) not null comment '名称', -`dloc` varchar(20) not null comment '所在地', -primary key (`dno`) -); - --- 插入4个部门 -insert into `tb_dept` values - (10, '会计部', '北京'), - (20, '研发部', '成都'), - (30, '销售部', '重庆'), - (40, '运维部', '深圳'); - --- 创建员工表 -create table `tb_emp` -( -`eno` int not null comment '员工编号', -`ename` varchar(20) not null comment '员工姓名', -`job` varchar(20) not null comment '员工职位', -`mgr` int comment '主管编号', -`sal` int not null comment '员工月薪', -`comm` int comment '每月补贴', -`dno` int not null comment '所在部门编号', -primary key (`eno`), -constraint `fk_emp_mgr` foreign key (`mgr`) references tb_emp (`eno`), -constraint `fk_emp_dno` foreign key (`dno`) references tb_dept (`dno`) -); - --- 插入14个员工 -insert into `tb_emp` values - (7800, '张三丰', '总裁', null, 9000, 1200, 20), - (2056, '乔峰', '分析师', 7800, 5000, 1500, 20), - (3088, '李莫愁', '设计师', 2056, 3500, 800, 20), - (3211, '张无忌', '程序员', 2056, 3200, null, 20), - (3233, '丘处机', '程序员', 2056, 3400, null, 20), - (3251, '张翠山', '程序员', 2056, 4000, null, 20), - (5566, '宋远桥', '会计师', 7800, 4000, 1000, 10), - (5234, '郭靖', '出纳', 5566, 2000, null, 10), - (3344, '黄蓉', '销售主管', 7800, 3000, 800, 30), - (1359, '胡一刀', '销售员', 3344, 1800, 200, 30), - (4466, '苗人凤', '销售员', 3344, 2500, null, 30), - (3244, '欧阳锋', '程序员', 3088, 3200, null, 20), - (3577, '杨过', '会计', 5566, 2200, null, 10), - (3588, '朱九真', '会计', 5566, 2500, null, 10); -``` - -例子1：查询按月薪从高到低排在第4到第6名的员工的姓名和月薪。 - -```SQL -select * from ( - select - `ename`, `sal`, - row_number() over (order by `sal` desc) as `rank` - from `tb_emp` -) `temp` where `rank` between 4 and 6; -``` - -> **说明**：上面使用的函数`row_number()`可以为每条记录生成一个行号，在实际工作中可以根据需要将其替换为`rank()`或`dense_rank()`函数，三者的区别可以参考官方文档或阅读[《通俗易懂的学会：SQL窗口函数》](https://zhuanlan.zhihu.com/p/92654574)进行了解。在MySQL 8以前的版本，我们可以通过下面的方式来完成类似的操作。 -> -> ```SQL -> select `rank`, `ename`, `sal` from ( -> select @a:=@a+1 as `rank`, `ename`, `sal` -> from `tb_emp`, (select @a:=0) as t1 order by `sal` desc -> ) as `temp` where `rank` between 4 and 6; -> ``` - -例子2：查询每个部门月薪最高的两名的员工的姓名和部门名称。 - -```SQL -select `ename`, `sal`, `dname` -from ( - select - `ename`, `sal`, `dno`, - rank() over (partition by `dno` order by `sal` desc) as `rank` - from `tb_emp` -) as `temp` natural join `tb_dept` where `rank`<=2; -``` - -> 说明：在MySQL 8以前的版本，我们可以通过下面的方式来完成类似的操作。 -> -> ```SQL -> select `ename`, `sal`, `dname` from `tb_emp` as `t1` -natural join `tb_dept` -where ( - select count(*) from `tb_emp` as `t2` - where `t1`.`dno`=`t2`.`dno` and `t2`.`sal`>`t1`.`sal` -)<2 order by `dno` asc, `sal` desc; -> ``` - -### 其他内容 - -#### 范式理论 - -范式理论是设计关系型数据库中二维表的指导思想。 - -1. 第一范式：数据表的每个列的值域都是由原子值组成的，不能够再分割。 -2. 第二范式：数据表里的所有数据都要和该数据表的键（主键与候选键）有完全依赖关系。 -3. 第三范式：所有非键属性都只和候选键有相关性，也就是说非键属性之间应该是独立无关的。 - -> **说明**：实际工作中，出于效率的考虑，我们在设计表时很有可能做出反范式设计，即故意降低方式级别，增加冗余数据来获得更好的操作性能。 - -#### 数据完整性 - -1. 实体完整性 - 每个实体都是独一无二的 - - - 主键（`primary key`） / 唯一约束（`unique`） -2. 引用完整性（参照完整性）- 关系中不允许引用不存在的实体 - - - 外键（`foreign key`） -3. 域（domain）完整性 - 数据是有效的 - - 数据类型及长度 - - - 非空约束（`not null`） - - - 默认值约束（`default`） - - - 检查约束（`check`） - - > **说明**：在 MySQL 8.x 以前，检查约束并不起作用。 - -#### 数据一致性 - -1. 事务：一系列对数据库进行读/写的操作，这些操作要么全都成功，要么全都失败。 - -2. 事务的 ACID 特性 - - 原子性：事务作为一个整体被执行，包含在其中的对数据库的操作要么全部被执行，要么都不执行 - - 一致性：事务应确保数据库的状态从一个一致状态转变为另一个一致状态 - - 隔离性：多个事务并发执行时，一个事务的执行不应影响其他事务的执行 - - 持久性：已被提交的事务对数据库的修改应该永久保存在数据库中 - -3. MySQL 中的事务操作 - - - 开启事务环境 - - ```SQL - start transaction - ``` - - - 提交事务 - - ```SQL - commit - ``` - - - 回滚事务 - - ```SQL - rollback - ``` - -4. 查看事务隔离级别 - - ```SQL - show variables like 'transaction_isolation'; - ``` - - ``` - +-----------------------+-----------------+ - | Variable_name | Value | - +-----------------------+-----------------+ - | transaction_isolation | REPEATABLE-READ | - +-----------------------+-----------------+ - ``` - - 可以看出，MySQL 默认的事务隔离级别是`REPEATABLE-READ`。 - -5. 修改（当前会话）事务隔离级别 - - ```SQL - set session transaction isolation level read committed; - ``` - - 重新查看事务隔离级别，结果如下所示。 - - ``` - +-----------------------+----------------+ - | Variable_name | Value | - +-----------------------+----------------+ - | transaction_isolation | READ-COMMITTED | - +-----------------------+----------------+ - ``` - -关系型数据库的事务是一个很大的话题，因为当存在多个并发事务访问数据时，就有可能出现三类读数据的问题（脏读、不可重复读、幻读）和两类更新数据的问题（第一类丢失更新、第二类丢失更新）。想了解这五类问题的，可以阅读我发布在 CSDN 网站上的[《Java面试题全集（上）》](https://blog.csdn.net/jackfrued/article/details/44921941)一文的第80题。为了避免这些问题，关系型数据库底层是有对应的锁机制的，按锁定对象不同可以分为表级锁和行级锁，按并发事务锁定关系可以分为共享锁和独占锁。然而直接使用锁是非常麻烦的，为此数据库为用户提供了自动锁机制，只要用户指定适当的事务隔离级别，数据库就会通过分析 SQL 语句，然后为事务访问的资源加上合适的锁。此外，数据库还会维护这些锁通过各种手段提高系统的性能，这些对用户来说都是透明的。想了解 MySQL 事务和锁的细节知识，推荐大家阅读进阶读物[《高性能MySQL》](https://item.jd.com/11220393.html)，这也是数据库方面的经典书籍。 - -ANSI/ISO SQL 92标准定义了4个等级的事务隔离级别，如下表所示。需要说明的是，事务隔离级别和数据访问的并发性是对立的，事务隔离级别越高并发性就越差。所以要根据具体的应用来确定到底使用哪种事务隔离级别，这个地方没有万能的原则。 - - - -### 总结 - -关于 MySQL 的知识肯定远远不止上面列出的这些，比如 MySQL 性能调优、MySQL 运维相关工具、MySQL 数据的备份和恢复、监控 MySQL 服务、部署高可用架构等，这一系列的问题在这里都没有办法逐一展开来讨论，那就留到有需要的时候再进行讲解吧，各位读者也可以自行探索。 diff --git "a/\347\254\25443\350\257\276.SQL\350\257\246\350\247\243\344\271\213DQL.md" "b/\347\254\25443\350\257\276.SQL\350\257\246\350\247\243\344\271\213DQL.md" new file mode 100644 index 0000000..480d1c7 --- /dev/null +++ "b/\347\254\25443\350\257\276.SQL\350\257\246\350\247\243\344\271\213DQL.md" @@ -0,0 +1,445 @@ +## SQL详解之DQL + +接下来，我们利用之前创建的学校选课系统数据库，为大家讲解 DQL 的应用。无论对于开发人员还是数据分析师，DQL 都是非常重要的，它关系着我们能否从关系数据库中获取我们需要的数据。建议大家把上上一节课中建库建表的 DDL 以及 上一节课中插入数据的 DML 重新执行一次，确保表和数据跟没有问题再执行下面的操作。 + +```SQL +use `school`; + +-- 查询所有学生的所有信息 +-- 说明：实际工作中不建议使用 select * 的方式进行查询 +select * + from tb_student; + +-- 查询学生的学号、姓名和籍贯 +select stu_id, + stu_name, + stu_addr + from tb_student; + +select stu_id as 学号, + stu_name as 姓名, + stu_addr as 籍贯 + from tb_student; + +-- 查询所有课程的名称及学分 +select cou_name as 课程名称, + cou_credit as 学分 + from tb_course; + +-- 查询所有女学生的姓名和出生日期 +select stu_name, + stu_birth + from tb_student + where stu_sex=0; + +-- 查询籍贯为“四川成都”的女学生的姓名和出生日期 +select stu_name, + stu_birth + from tb_student + where stu_sex=0 + and stu_addr='四川成都'; + +-- 查询籍贯为“四川成都”或者性别是女的学生 +select stu_name, + stu_birth + from tb_student + where stu_sex=0 + or stu_addr='四川成都'; + +-- 查询所有80后学生的姓名、性别和出生日期 +-- 方法一： +select stu_name, + stu_sex, + stu_birth + from tb_student + where stu_birth >= '1980-1-1' + and stu_birth <= '1989-12-31'; + +-- 方法二： +select stu_name, + stu_sex, + stu_birth + from tb_student + where stu_birth between '1980-1-1' and '1989-12-31'; + +-- 查询学分大于2的课程的名称和学分 +select cou_name, + cou_credit + from tb_course + where cou_credit > 2; + +-- 查询学分是奇数的课程的名称和学分 +select cou_name, + cou_credit + from tb_course + where cou_credit % 2 <> 0; + +-- 查询选择选了1111的课程考试成绩在90分以上的学生学号 +select stu_id + from tb_record + where cou_id = 1111 + and score > 90; + +-- 查询姓“杨”的学生姓名和性别(模糊) +-- % 可以匹配零个或任意多个字符 +select stu_name, + stu_sex + from tb_student + where stu_name like '杨%'; + +-- 查询姓“杨”名字两个字的学生姓名和性别(模糊) +-- _ 可以匹配一个字符 +select stu_name, + stu_sex + from tb_student + where stu_name like '杨_'; + +-- 查询姓“杨”名字三个字的学生姓名和性别(模糊) +select stu_name, + stu_sex + from tb_student + where stu_name like '杨__'; + +-- 查询名字中有“不”字或“嫣”字的学生的姓名(模糊) +-- 方法一： +select stu_name, + stu_sex + from tb_student + where stu_name like '%不%' + or stu_name like '%嫣%'; + +-- 方法二： +select stu_name, + stu_sex + from tb_student + where stu_name like '%不%' + union +select stu_name, + stu_sex + from tb_student + where stu_name like '%嫣%'; + +-- 查询姓“杨”或姓“林”名字三个字的学生的姓名 +select stu_name, + stu_sex + from tb_student + where stu_name regexp '^[杨林][\\u4e00-\\u9fa5]{2}$'; + +-- 查询没有录入籍贯的学生姓名 +select stu_name + from tb_student + where stu_addr = '' + or stu_addr is null; + +-- 查询录入了籍贯的学生姓名 +select stu_name + from tb_student + where stu_addr <> '' + and stu_addr is not null; + +-- 查询学生选课的所有日期 +select distinct sel_date + from tb_record; + +-- 查询学生的籍贯 +select distinct stu_addr + from tb_student + where stu_addr <> '' + and stu_addr is not null; + +-- 查询学院编号为1的学生姓名、性别和生日按年龄从大到小排列 +-- asc - 升序（从小到大，默认），desc - 降序（从大到小） + select stu_name, + stu_sex, + stu_birth + from tb_student + where col_id = 1 +order by stu_sex asc, + stu_birth asc; + +-- 补充：将上面的性别处理成“男”或“女”，将生日换算成年龄 + select stu_name as 姓名, + if(stu_sex, '男', '女') as 性别, + floor(datediff(curdate(), stu_birth) / 365) as 年龄 + from tb_student + where col_id = 1 +order by stu_sex asc, + 年龄 desc; + +-- 查询年龄最大的学生的出生日期 +select min(stu_birth) + from tb_student; + +-- 查询年龄最小的学生的出生日期 +select max(stu_birth) + from tb_student; + +-- 查询学号为1001的学生一共选了几门课 +select count(*) + from tb_record + where stu_id = 1001; + +-- 查询学号为1001的学生考试成绩的平均分 +select round(avg(score), 1) as 平均分 + from tb_record + where stu_id = 1001; + +-- 查询学号为1001的学生考试成绩的平均分，如果有null值，null值算0分 +-- 方法一： +select sum(score) / count(*) + from tb_record + where stu_id = 1001; + +-- 方法二： +select avg(coalesce(score, 0)) + from tb_record + where stu_id = 1001; + +-- 查询学号为1001的学生考试成绩的标准差(聚合函数) +select stddev_samp(score) + from tb_record + where stu_id = 1001; + +-- 查询男女学生的人数 + select case stu_sex when 1 then '男' else '女' end as 性别, + count(*) as 人数 + from tb_student +group by stu_sex; + +-- 查询每个学院学生人数 + select col_id as 学院编号, + count(*) as 人数 + from tb_student +group by col_id; + +-- 查询每个学院男女学生人数 + select col_id as 学院编号, + case stu_sex when 1 then '男' else '女' end as 性别, + count(*) as 人数 + from tb_student +group by col_id, stu_sex; + +-- 查询每个学生的学号和平均成绩 + select stu_id as 学号, + round(avg(score), 2) as 平均成绩 + from tb_record +group by stu_id; + +-- 查询平均成绩大于等于90分的学生的学号和平均成绩 +-- 方法一： + select stu_id as 学号, + round(avg(score), 2) as 平均成绩 + from tb_record +group by stu_id + having 平均成绩 >= 90; + +-- 方法二： +select * + from ( select stu_id as 学号, + round(avg(score), 2) as 平均成绩 + from tb_record + group by stu_id) as t + where 平均成绩 >= 90; + +-- 查询1111、2222、3333三门课程平均成绩大于等于90分的学生的学号和平均成绩 + select stu_id as 学号, + round(avg(score), 2) as 平均成绩 + from tb_record + where cou_id in (1111, 2222, 3333) +group by stu_id + having avg(score) >= 90; + +-- 嵌套查询：把一个查询的结果作为另外一个查询的一部分来使用 +select stu_name + from tb_student + where stu_birth = (select min(stu_birth) + from tb_student); + +-- 查询选了两门以上的课程的学生姓名 +select stu_name + from tb_student + where stu_id in ( select stu_id + from tb_record + group by stu_id + having count(*) > 2); + +-- 查询学生的姓名、生日和所在学院名称 +-- 方法一： +select stu_name, + stu_birth, + col_name + from tb_student, tb_college + where tb_student.col_id = tb_college.col_id; + +-- 方法二： +select stu_name, + stu_birth, + col_name + from tb_student inner join tb_college + on tb_student.col_id = tb_college.col_id; + +-- 方法三： +select stu_name, + stu_birth, + col_name + from tb_student natural join tb_college; + +-- 查询学生姓名、课程名称以及成绩 +-- 方法一： +select stu_name, + cou_name, + score + from tb_student, tb_course, tb_record + where tb_student.stu_id = tb_record.stu_id + and tb_course.cou_id = tb_record.cou_id + and score is not null; + +-- 方法二： +select stu_name, + cou_name, + score + from tb_student inner join tb_record inner join tb_course + on tb_student.stu_id = tb_record.stu_id + and tb_course.cou_id = tb_record.cou_id + where score is not null; + +-- 方法三： +select stu_name, + cou_name, + score + from tb_student natural join tb_record natural join tb_course + where score is not null; + +-- 补充：上面的查询结果取前5条数据 + select stu_name, + cou_name, + score + from tb_student natural join tb_record natural join tb_course + where score is not null +order by stu_id asc, score desc + limit 5; + +-- 补充：上面的查询结果取第6-10条数据 + select stu_name, + cou_name, + score + from tb_student inner join tb_record inner join tb_course + on tb_student.stu_id = tb_record.stu_id + and tb_course.cou_id = tb_record.cou_id +order by stu_id asc, score desc + limit 5 + offset 5; + +-- 补充：上面的查询结果取第11-15条数据 + select stu_name, + cou_name, + score + from tb_student natural join tb_record natural join tb_course + where score is not null +order by stu_id asc, score desc + limit 5 + offset 10; + +-- 查询选课学生的姓名和平均成绩 +select stu_name, + avg_score + from tb_student t1 inner join ( select stu_id, + round(avg(score), 2) as avg_score + from tb_record + group by stu_id) t2 + on t1.stu_id = t2.stu_id; + +-- 查询学生的姓名和选课的数量 +select stu_name, + total + from tb_student t1 natural join ( select stu_id, + count(*) as total + from tb_record + group by stu_id) t2; + +-- 查询每个学生的姓名和选课数量(左外连接和子查询) +select stu_name as 姓名, + coalesce (total, 0) as 选课数量 + from tb_student t1 left join ( select stu_id, + count(*) as total + from tb_record + group by stu_id) t2 + on t1.stu_id = t2.stu_id; +``` + +上面的 DQL 有几个地方需要加以说明： + +1. MySQL目前的版本不支持全外连接，上面我们通过`union`操作，将左外连接和右外连接的结果求并集实现全外连接的效果。大家可以通过下面的图来加深对连表操作的认识。 + + + +2. MySQL 中支持多种类型的运算符，包括：算术运算符（`+`、`-`、`*`、`/`、`%`）、比较运算符（`=`、`<>`、`<=>`、`<`、`<=`、`>`、`>=`、`BETWEEN...AND..`.、`IN`、`IS NULL`、`IS NOT NULL`、`LIKE`、`RLIKE`、`REGEXP`）、逻辑运算符（`NOT`、`AND`、`OR`、`XOR`）和位运算符（`&`、`|`、`^`、`~`、`>>`、`<<`），我们可以在 DML 中使用这些运算符处理数据。 + +3. 在查询数据时，可以在`SELECT`语句及其子句（如`WHERE`子句、`ORDER BY`子句、`HAVING`子句等）中使用函数，这些函数包括字符串函数、数值函数、时间日期函数、流程函数等，如下面的表格所示。 + + 常用字符串函数。 + + | 函数 | 功能 | + | --------------------------- | ----------------------------------------------------- | + | `CONCAT` | 将多个字符串连接成一个字符串 | + | `FORMAT` | 将数值格式化成字符串并指定保留几位小数 | + | `FROM_BASE64` / `TO_BASE64` | BASE64解码/编码 | + | `BIN` / `OCT` / `HEX` | 将数值转换成二进制/八进制/十六进制字符串 | + | `LOCATE` | 在字符串中查找一个子串的位置 | + | `LEFT` / `RIGHT` | 返回一个字符串左边/右边指定长度的字符 | + | `LENGTH` / `CHAR_LENGTH` | 返回字符串的长度以字节/字符为单位 | + | `LOWER` / `UPPER` | 返回字符串的小写/大写形式 | + | `LPAD` / `RPAD` | 如果字符串的长度不足，在字符串左边/右边填充指定的字符 | + | `LTRIM` / `RTRIM` | 去掉字符串前面/后面的空格 | + | `ORD` / `CHAR` | 返回字符对应的编码/返回编码对应的字符 | + | `STRCMP` | 比较字符串，返回-1、0、1分别表示小于、等于、大于 | + | `SUBSTRING` | 返回字符串指定范围的子串 | + + 常用数值函数。 + + | 函数 | 功能 | + | -------------------------------------------------------- | ---------------------------------- | + | `ABS` | 返回一个数的绝度值 | + | `CEILING` / `FLOOR` | 返回一个数上取整/下取整的结果 | + | `CONV` | 将一个数从一种进制转换成另一种进制 | + | `CRC32` | 计算循环冗余校验码 | + | `EXP` / `LOG` / `LOG2` / `LOG10` | 计算指数/对数 | + | `POW` | 求幂 | + | `RAND` | 返回[0,1)范围的随机数 | + | `ROUND` | 返回一个数四舍五入后的结果 | + | `SQRT` | 返回一个数的平方根 | + | `TRUNCATE` | 截断一个数到指定的精度 | + | `SIN` / `COS` / `TAN` / `COT` / `ASIN` / `ACOS` / `ATAN` | 三角函数 | + + 常用时间日期函数。 + + | 函数 | 功能 | + | ----------------------------- | ------------------------------------- | + | `CURDATE` / `CURTIME` / `NOW` | 获取当前日期/时间/日期和时间 | + | `ADDDATE` / `SUBDATE` | 将两个日期表达式相加/相减并返回结果 | + | `DATE` / `TIME` | 从字符串中获取日期/时间 | + | `YEAR` / `MONTH` / `DAY` | 从日期中获取年/月/日 | + | `HOUR` / `MINUTE` / `SECOND` | 从时间中获取时/分/秒 | + | `DATEDIFF` / `TIMEDIFF` | 返回两个时间日期表达式相差多少天/小时 | + | `MAKEDATE` / `MAKETIME` | 制造一个日期/时间 | + + 常用流程函数。 + + | 函数 | 功能 | + | -------- | ------------------------------------------------ | + | `IF` | 根据条件是否成立返回不同的值 | + | `IFNULL` | 如果为NULL则返回指定的值否则就返回本身 | + | `NULLIF` | 两个表达式相等就返回NULL否则返回第一个表达式的值 | + + 其他常用函数。 + + | 函数 | 功能 | + | -------------------------- | ----------------------------- | + | `MD5` / `SHA1` / `SHA2` | 返回字符串对应的哈希摘要 | + | `CHARSET` / `COLLATION` | 返回字符集/校对规则 | + | `USER` / `CURRENT_USER` | 返回当前用户 | + | `DATABASE` | 返回当前数据库名 | + | `VERSION` | 返回当前数据库版本 | + | `FOUND_ROWS` / `ROW_COUNT` | 返回查询到的行数/受影响的行数 | + | `LAST_INSERT_ID` | 返回最后一个自增主键的值 | + | `UUID` / `UUID_SHORT` | 返回全局唯一标识符 | diff --git "a/\347\254\25444\350\257\276.SQL\350\257\246\350\247\243\344\271\213DCL.md" "b/\347\254\25444\350\257\276.SQL\350\257\246\350\247\243\344\271\213DCL.md" new file mode 100644 index 0000000..e3bb186 --- /dev/null +++ "b/\347\254\25444\350\257\276.SQL\350\257\246\350\247\243\344\271\213DCL.md" @@ -0,0 +1,74 @@ +## SQL详解之DCL + +数据库服务器通常包含了非常重要的数据，可以通过访问控制来确保这些数据的安全，而 DCL 就是解决这一问题的，它可以为指定的用户授予访问权限或者从指定用户处召回指定的权限。DCL 对数据库管理员来说非常重要，因为用户权限的管理关系到数据库的安全。简单的说，我们可以通过 DCL 允许受信任的用户访问数据库，阻止不受信任的用户访问数据库，同时还可以通过 DCL 将每个访问者的的权限最小化（让访问者的权限刚刚够用）。 + +### 创建用户 + +我们可以使用下面的 SQL 来创建一个用户并为其指定访问口令。 + +```SQL +create user 'wangdachui'@'%' identified by 'Wang.618'; +``` + +上面的 SQL 创建了名为 wangdachui 的用户，它的访问口令是 Wang.618，该用户可以从任意主机访问数据库服务器，因为 @ 后面使用了可以表示任意多个字符的通配符 %。如果要限制 wangdachui 这个用户只能从 192.168.0.x 这个网段的主机访问数据库服务器，可以按照下面的方式来修改 SQL 语句。 + +```SQL +drop user if exists 'wangdachui'@'%'; + +create user 'wangdachui'@'192.168.0.%' identified by 'Wang.618'; +``` + +此时，如果我们使用 wangdachui 这个账号访问数据库服务器，我们几乎不能做任何操作，因为该账号没有任何操作权限。 + +### 授予权限 + +我们用下面的语句为 wangdachui 授予查询 school 数据库学院表（`tb_college`）的权限。 + +```SQL +grant select on `school`.`tb_college` to 'wangdachui'@'192.168.0.%'; +``` + +我们也可以让 wangdachui 对 school 数据库的所有对象都具有查询权限，代码如下所示。 + +```SQL +grant select on `school`.* to 'wangdachui'@'192.168.0.%'; +``` + +如果我们希望 wangdachui 还有 insert、delete 和 update 权限，可以使用下面的方式进行操作。 + +```SQL +grant insert, delete, update on `school`.* to 'wangdachui'@'192.168.0.%'; +``` + +如果我们还想授予 wangdachui 执行 DDL 的权限，可以使用如下所示的 SQL。 + +```SQL +grant create, drop, alter on `school`.* to 'wangdachui'@'192.168.0.%'; +``` + +如果我们希望 wangdachui 账号对所有数据库的所有对象都具备所有的操作权限，可以执行如下所示的操作，但是一般情况下，我们不会这样做，因为我们之前说过，权限刚刚够用就行，一个普通的账号不应该拥有这么大的权限。 + +```SQL +grant all privileges on *.* to 'wangdachui'@'192.168.0.%'; +``` + +### 召回权限 + +如果要召回 wangdachui 对 school 数据库的 insert、delete 和 update 权限，可以使用下面的操作。 + +```SQL +revoke insert, delete, update on `school`.* from 'wangdachui'@'192.168.0.%'; +``` + +如果要召回所有的权限，可以按照如下所示的方式进行操作。 + +```SQL +revoke all privileges on *.* from 'wangdachui'@'192.168.0.%'; +``` + +需要说明的是，由于数据库可能会缓存用户的权限，可以在授予或召回权限后执行下面的语句使新的权限即时生效。 + +```SQL +flush privileges; +``` + diff --git "a/\347\254\25445\350\257\276.\347\264\242\345\274\225.md" "b/\347\254\25445\350\257\276.\347\264\242\345\274\225.md" new file mode 100644 index 0000000..7691a55 --- /dev/null +++ "b/\347\254\25445\350\257\276.\347\264\242\345\274\225.md" @@ -0,0 +1,138 @@ +## 索引 + +索引是关系型数据库中用来提升查询性能最为重要的手段。关系型数据库中的索引就像一本书的目录，我们可以想象一下，如果要从一本书中找出某个知识点，但是这本书没有目录，这将是意见多么可怕的事情！我们估计得一篇一篇的翻下去，才能确定这个知识点到底在什么位置。创建索引虽然会带来存储空间上的开销，就像一本书的目录会占用一部分篇幅一样，但是在牺牲空间后换来的查询时间的减少也是非常显著的。 + +MySQL 数据库中所有数据类型的列都可以被索引。对于MySQL 8.0 版本的 InnoDB 存储引擎来说，它支持三种类型的索引，分别是 B+ 树索引、全文索引和 R 树索引。这里，我们只介绍使用得最为广泛的 B+ 树索引。使用 B+ 树的原因非常简单，因为它是目前在基于磁盘进行海量数据存储和排序上最有效率的数据结构。B+ 树是一棵[平衡树](https://zh.wikipedia.org/zh-cn/%E5%B9%B3%E8%A1%A1%E6%A0%91)，树的高度通常为3或4，但是却可以保存从百万级到十亿级的数据，而从这些数据里面查询一条数据，只需要3次或4次 I/O 操作。 + +B+ 树由根节点、中间节点和叶子节点构成，其中叶子节点用来保存排序后的数据。由于记录在索引上是排序过的，因此在一个叶子节点内查找数据时可以使用二分查找，这种查找方式效率非常的高。当数据很少的时候，B+ 树只有一个根节点，数据也就保存在根节点上。随着记录越来越多，B+ 树会发生分裂，根节点不再保存数据，而是提供了访问下一层节点的指针，帮助快速确定数据在哪个叶子节点上。 + +在创建二维表时，我们通常都会为表指定主键列，主键列上默认会创建索引，而对于 MySQL InnoDB 存储引擎来说，因为它使用的是索引组织表这种数据存储结构，所以主键上的索引就是整张表的数据，而这种索引我们也将其称之为**聚集索引**（clustered index）。很显然，一张表只能有一个聚集索引，否则表的数据岂不是要保存多次。我们自己创建的索引都是二级索引（secondary index），更常见的叫法是**非聚集索引**（non-clustered index）。通过我们自定义的非聚集索引只能定位记录的主键，在获取数据时可能需要再通过主键上的聚集索引进行查询，这种现象称为“回表”，因此通过非聚集索引检索数据通常比使用聚集索引检索数据要慢。 + +接下来我们通过一个简单的例子来说明索引的意义，比如我们要根据学生的姓名来查找学生，这个场景在实际开发中应该经常遇到，就跟通过商品名称查找商品是一个道理。我们可以使用 MySQL 的`explain`关键字来查看 SQL 的执行计划（数据库执行 SQL 语句的具体步骤）。 + +```SQL +explain select * from tb_student where stuname='林震南'\G +``` + +``` +*************************** 1. row *************************** + id: 1 + select_type: SIMPLE + table: tb_student + partitions: NULL + type: ALL +possible_keys: NULL + key: NULL + key_len: NULL + ref: NULL + rows: 11 + filtered: 10.00 + Extra: Using where +1 row in set, 1 warning (0.00 sec) +``` + +在上面的 SQL 执行计划中，有几项值得我们关注： + +1. `select_type`：查询的类型。 + - `SIMPLE`：简单 SELECT，不需要使用 UNION 操作或子查询。 + - `PRIMARY`：如果查询包含子查询，最外层的 SELECT 被标记为 PRIMARY。 + - `UNION`：UNION 操作中第二个或后面的 SELECT 语句。 + - `SUBQUERY`：子查询中的第一个 SELECT。 + - `DERIVED`：派生表的 SELECT 子查询。 +2. `table`：查询对应的表。 +3. `type`：MySQL 在表中找到满足条件的行的方式，也称为访问类型，包括：`ALL`（全表扫描）、`index`（索引全扫描，只遍历索引树）、`range`（索引范围扫描）、`ref`（非唯一索引扫描）、`eq_ref`（唯一索引扫描）、`const` / `system`（常量级查询）、`NULL`（不需要访问表或索引）。在所有的访问类型中，很显然 ALL 是性能最差的，它代表的全表扫描是指要扫描表中的每一行才能找到匹配的行。 +4. `possible_keys`：MySQL 可以选择的索引，但是**有可能不会使用**。 +5. `key`：MySQL 真正使用的索引，如果为`NULL`就表示没有使用索引。 +6. `key_len`：使用的索引的长度，在不影响查询的情况下肯定是长度越短越好。 +7. `rows`：执行查询需要扫描的行数，这是一个**预估值**。 +8. `extra`：关于查询额外的信息。 + - `Using filesort`：MySQL 无法利用索引完成排序操作。 + - `Using index`：只使用索引的信息而不需要进一步查表来获取更多的信息。 + - `Using temporary`：MySQL 需要使用临时表来存储结果集，常用于分组和排序。 + - `Impossible where`：`where`子句会导致没有符合条件的行。 + - `Distinct`：MySQL 发现第一个匹配行后，停止为当前的行组合搜索更多的行。 + - `Using where`：查询的列未被索引覆盖，筛选条件并不是索引的前导列。 + +从上面的执行计划可以看出，当我们通过学生名字查询学生时实际上是进行了全表扫描，不言而喻这个查询性能肯定是非常糟糕的，尤其是在表中的行很多的时候。如果我们需要经常通过学生姓名来查询学生，那么就应该在学生姓名对应的列上创建索引，通过索引来加速查询。 + +```SQL +create index idx_student_name on tb_student(stuname); +``` + +再次查看刚才的 SQL 对应的执行计划。 + +```SQL +explain select * from tb_student where stuname='林震南'\G +``` + +``` +*************************** 1. row *************************** + id: 1 + select_type: SIMPLE + table: tb_student + partitions: NULL + type: ref +possible_keys: idx_student_name + key: idx_student_name + key_len: 62 + ref: const + rows: 1 + filtered: 100.00 + Extra: NULL +1 row in set, 1 warning (0.00 sec) +``` + +可以注意到，在对学生姓名创建索引后，刚才的查询已经不是全表扫描而是基于索引的查询，而且扫描的行只有唯一的一行，这显然大大的提升了查询的性能。MySQL 中还允许创建前缀索引，即对索引字段的前N个字符创建索引，这样的话可以减少索引占用的空间（但节省了空间很有可能会浪费时间，**时间和空间是不可调和的矛盾**），如下所示。 + +```SQL +create index idx_student_name_1 on tb_student(stuname(1)); +``` + +上面的索引相当于是根据学生姓名的第一个字来创建的索引，我们再看看 SQL 执行计划。 + +```SQL +explain select * from tb_student where stuname='林震南'\G +``` + +``` +*************************** 1. row *************************** + id: 1 + select_type: SIMPLE + table: tb_student + partitions: NULL + type: ref +possible_keys: idx_student_name + key: idx_student_name + key_len: 5 + ref: const + rows: 2 + filtered: 100.00 + Extra: Using where +1 row in set, 1 warning (0.00 sec) +``` + +不知道大家是否注意到，这一次扫描的行变成了2行，因为学生表中有两个姓“林”的学生，我们只用姓名的第一个字作为索引的话，在查询时通过索引就会找到这两行。 + +如果要删除索引，可以使用下面的SQL。 + +```SQL +alter table tb_student drop index idx_student_name; +``` + +或者 + +```SQL +drop index idx_student_name on tb_student; +``` + +在创建索引时，我们还可以使用复合索引、函数索引（MySQL 5.7 开始支持），用好复合索引实现**索引覆盖**可以减少不必要的排序和回表操作，这样就会让查询的性能成倍的提升，有兴趣的读者可以自行研究。 + +我们简单的为大家总结一下索引的设计原则： + +1. **最适合**索引的列是出现在**WHERE子句**和连接子句中的列。 +2. 索引列的基数越大（取值多、重复值少），索引的效果就越好。 +3. 使用**前缀索引**可以减少索引占用的空间，内存中可以缓存更多的索引。 +4. **索引不是越多越好**，虽然索引加速了读操作（查询），但是写操作（增、删、改）都会变得更慢，因为数据的变化会导致索引的更新，就如同书籍章节的增删需要更新目录一样。 +5. 使用 InnoDB 存储引擎时，表的普通索引都会保存主键的值，所以**主键要尽可能选择较短的数据类型**，这样可以有效的减少索引占用的空间，提升索引的缓存效果。 + +最后，还有一点需要说明，InnoDB 使用的 B-tree 索引，数值类型的列除了等值判断时索引会生效之外，使用`>`、`<`、`>=`、`<=`、`BETWEEN...AND... `、`<>`时，索引仍然生效；对于字符串类型的列，如果使用不以通配符开头的模糊查询，索引也是起作用的，但是其他的情况会导致索引失效，这就意味着很有可能会做全表查询。 diff --git "a/\347\254\25446\350\257\276.\350\247\206\345\233\276+\345\207\275\346\225\260+\350\277\207\347\250\213.md" "b/\347\254\25446\350\257\276.\350\247\206\345\233\276+\345\207\275\346\225\260+\350\277\207\347\250\213.md" new file mode 100644 index 0000000..1c45b2d --- /dev/null +++ "b/\347\254\25446\350\257\276.\350\247\206\345\233\276+\345\207\275\346\225\260+\350\277\207\347\250\213.md" @@ -0,0 +1,336 @@ +## 视图、函数和过程 + +为了讲解视图、函数和过程，我们首先用下面的 DDL 和 DML 创建名为 hrs 的数据库并为其二维表添加如下所示的数据。 + +```SQL +-- 创建名为hrs的数据库并指定默认的字符集 +create database `hrs` default charset utf8mb4; + +-- 切换到hrs数据库 +use `hrs`; + +-- 创建部门表 +create table `tb_dept` +( +`dno` int not null comment '编号', +`dname` varchar(10) not null comment '名称', +`dloc` varchar(20) not null comment '所在地', +primary key (`dno`) +); + +-- 插入4个部门 +insert into `tb_dept` values + (10, '会计部', '北京'), + (20, '研发部', '成都'), + (30, '销售部', '重庆'), + (40, '运维部', '深圳'); + +-- 创建员工表 +create table `tb_emp` +( +`eno` int not null comment '员工编号', +`ename` varchar(20) not null comment '员工姓名', +`job` varchar(20) not null comment '员工职位', +`mgr` int comment '主管编号', +`sal` int not null comment '员工月薪', +`comm` int comment '每月补贴', +`dno` int not null comment '所在部门编号', +primary key (`eno`), +constraint `fk_emp_mgr` foreign key (`mgr`) references tb_emp (`eno`), +constraint `fk_emp_dno` foreign key (`dno`) references tb_dept (`dno`) +); + +-- 插入14个员工 +insert into `tb_emp` values + (7800, '张三丰', '总裁', null, 9000, 1200, 20), + (2056, '乔峰', '分析师', 7800, 5000, 1500, 20), + (3088, '李莫愁', '设计师', 2056, 3500, 800, 20), + (3211, '张无忌', '程序员', 2056, 3200, null, 20), + (3233, '丘处机', '程序员', 2056, 3400, null, 20), + (3251, '张翠山', '程序员', 2056, 4000, null, 20), + (5566, '宋远桥', '会计师', 7800, 4000, 1000, 10), + (5234, '郭靖', '出纳', 5566, 2000, null, 10), + (3344, '黄蓉', '销售主管', 7800, 3000, 800, 30), + (1359, '胡一刀', '销售员', 3344, 1800, 200, 30), + (4466, '苗人凤', '销售员', 3344, 2500, null, 30), + (3244, '欧阳锋', '程序员', 3088, 3200, null, 20), + (3577, '杨过', '会计', 5566, 2200, null, 10), + (3588, '朱九真', '会计', 5566, 2500, null, 10); +``` + +### 视图 + +视图是关系型数据库中将一组查询指令构成的结果集组合成可查询的数据表的对象。简单的说，视图就是虚拟的表，但与数据表不同的是，数据表是一种实体结构，而视图是一种虚拟结构，你也可以将视图理解为保存在数据库中被赋予名字的 SQL 语句。 + +使用视图可以获得以下好处： + +1. 可以将实体数据表隐藏起来，让外部程序无法得知实际的数据结构，让访问者可以使用表的组成部分而不是整个表，降低数据库被攻击的风险。 +2. 在大多数的情况下视图是只读的（更新视图的操作通常都有诸多的限制），外部程序无法直接透过视图修改数据。 +3. 重用 SQL 语句，将高度复杂的查询包装在视图表中，直接访问该视图即可取出需要的数据；也可以将视图视为数据表进行连接查询。 +4. 视图可以返回与实体数据表不同格式的数据，在创建视图的时候可以对数据进行格式化处理。 + +创建视图。 + +```SQL +create view `vw_emp_simple` +as +select `eno`, + `ename`, + `job`, + `dno` + from `tb_emp`; +``` + +> **提示**：因为视图不包含数据，所以每次使用视图时，都必须执行查询以获得数据，如果你使用了连接查询、嵌套查询创建了较为复杂的视图，你可能会发现查询性能下降得很厉害。因此，在使用复杂的视图前，应该进行测试以确保其性能能够满足应用的需求。 + +有了上面的视图，我们就可以使用之前讲过的 DCL， 限制某些用户只能从视图中获取员工信息，这样员工表中的工资（`sal`）、补贴（`comm`）等敏感字段便不会暴露给用户。下面的代码演示了如何从视图中获取数据。 + +```SQL +select * from `vw_emp_simple`; +``` + +查询结果： + +``` ++------+-----------+--------------+-----+ +| eno | ename | job | dno | ++------+-----------+--------------+-----+ +| 1359 | 胡二刀 | 销售员 | 30 | +| 2056 | 乔峰 | 分析师 | 20 | +| 3088 | 李莫愁 | 设计师 | 20 | +| 3211 | 张无忌 | 程序员 | 20 | +| 3233 | 丘处机 | 程序员 | 20 | +| 3244 | 欧阳锋 | 程序员 | 20 | +| 3251 | 张翠山 | 程序员 | 20 | +| 3344 | 黄蓉 | 销售主管 | 30 | +| 3577 | 杨过 | 会计 | 10 | +| 3588 | 朱九真 | 会计 | 10 | +| 4466 | 苗人凤 | 销售员 | 30 | +| 5234 | 郭靖 | 出纳 | 10 | +| 5566 | 宋远桥 | 会计师 | 10 | +| 7800 | 张三丰 | 总裁 | 20 | ++------+-----------+--------------+-----+ +``` + +既然视图是一张虚拟的表，那么视图的中的数据可以更新吗？视图的可更新性要视具体情况而定，以下类型的视图是不能更新的： + +1. 使用了聚合函数（`SUM`、`MIN`、`MAX`、`AVG`、`COUNT`等）、`DISTINCT`、`GROUP BY`、`HAVING`、`UNION`或者`UNION ALL`的视图。 +2. `SELECT`中包含了子查询的视图。 +3. `FROM`子句中包含了一个不能更新的视图的视图。 +4. `WHERE`子句的子查询引用了`FROM`子句中的表的视图。 + +删除视图。 + +```SQL +drop view if exists `vw_emp_simple`; +``` + +> **说明**：如果希望更新视图，可以先用上面的命令删除视图，也可以通过`create or replace view`来更新视图。 + +视图的规则和限制。 + +1. 视图可以嵌套，可以利用从其他视图中检索的数据来构造一个新的视图。视图也可以和表一起使用。 +2. 创建视图时可以使用`order by`子句，但如果从视图中检索数据时也使用了`order by`，那么该视图中原先的`order by`会被覆盖。 +3. 视图无法使用索引，也不会激发触发器（实际开发中因为性能等各方面的考虑，通常不建议使用触发器，所以我们也不对这个概念进行介绍）的执行。 + +### 函数 + +MySQL 中的函数跟 Python 中的函数大同小异，因为函数都是用来封装功能上相对独立且会被重复使用的代码的。如果非要找出一些差别来，那么 MySQL 中的函数是可以执行 SQL 语句的。下面的例子，我们通过自定义函数实现了截断超长字符串的功能。 + +```SQL +delimiter $$ + +create function fn_truncate_string( + content varchar(10000), + max_length int unsigned +) returns varchar(10000) no sql +begin + declare result varchar(10000) default content; + if char_length(content) > max_length then + set result = left(content, max_length); + set result = concat(result, '……'); + end if; + return result; +end $$ + +delimiter ; +``` + +> **说明1**：函数声明后面的`no sql`是声明函数体并没有使用 SQL 语句；如果函数体中需要通过 SQL 读取数据，需要声明为`reads sql data`。 +> +> **说明2**：定义函数前后的`delimiter`命令是为了修改终止符（定界符），因为函数体中的语句都是用`;`表示结束，如果不重新定义定界符，那么遇到的`;`的时候代码就会被截断执行，显然这不是我们想要的效果。 + +在查询中调用自定义函数。 + +```SQL +select fn_truncate_string('和我在成都的街头走一走，直到所有的灯都熄灭了也不停留', 10) as short_string; +``` + +``` ++--------------------------------------+ +| short_string | ++--------------------------------------+ +| 和我在成都的街头走一…… | ++--------------------------------------+ +``` + +### 过程 + +过程（又称存储过程）是事先编译好存储在数据库中的一组 SQL 的集合，调用过程可以简化应用程序开发人员的工作，减少与数据库服务器之间的通信，对于提升数据操作的性能也是有帮助的。其实迄今为止，我们使用的 SQL 语句都是针对一个或多个表的单条语句，但在实际开发中经常会遇到某个操作需要多条 SQL 语句才能完成的情况。例如，电商网站在受理用户订单时，需要做以下一系列的处理。 + +1. 通过查询来核对库存中是否有对应的物品以及库存是否充足。 +2. 如果库存有物品，需要锁定库存以确保这些物品不再卖给别人， 并且要减少可用的物品数量以反映正确的库存量。 +3. 如果库存不足，可能需要进一步与供应商进行交互或者至少产生一条系统提示消息。 +4. 不管受理订单是否成功，都需要产生流水记录，而且需要给对应的用户产生一条通知信息。 + +我们可以通过过程将复杂的操作封装起来，这样不仅有助于保证数据的一致性，而且将来如果业务发生了变动，只需要调整和修改过程即可。对于调用过程的用户来说，过程并没有暴露数据表的细节，而且执行过程比一条条的执行一组 SQL 要快得多。 + +下面的过程实现 hrs 数据库中员工工资的普调，具体的规则是：`10`部门的员工薪资上浮`300`， `20`部门的员工薪资上浮`800`，`30`部门的员工薪资上浮`500`。 + +```SQL +delimiter $$ + +create procedure sp_upgrade_salary() +begin + declare flag boolean default 1; + -- 定义一个异常处理器 + declare continue handler for sqlexception set flag=0; + + -- 开启事务环境 + start transaction; + + update tb_emp set sal=sal+300 where dno=10; + update tb_emp set sal=sal+800 where dno=20; + update tb_emp set sal=sal+500 where dno=30; + + -- 提交或回滚事务 + if flag then + commit; + else + rollback; + end if; +end $$ + +delimiter ; +``` + +> **说明**：上面的过程代码中使用了`start transaction`来开启事务环境，关于事务，在本课的最后有一个简单的介绍。为了确定代码中是否发生异常，从而提交或回滚事务，上面的过程中定义了一个名为`flag`的变量和一个异常处理器，如果发生了异常，`flag`将会被赋值为`0`，后面的分支结构会根据`flag`的值来决定是执行`commit`，还是执行`rollback`。 + +调用过程。 + +```SQL +call sp_upgrade_salary(); +``` + +删除过程。 + +```SQL +drop procedure if exists sp_upgrade_salary; +``` + +在过程中，我们可以定义变量、条件，可以使用分支和循环语句，可以通过游标操作查询结果，还可以使用事件调度器，这些内容我们暂时不在此处进行介绍。虽然我们说了很多过程的好处，但是在实际开发中，如果频繁的使用过程并将大量复杂的运算放到过程中，会给据库服务器造成巨大的压力，而数据库往往都是性能瓶颈所在，使用过程无疑是雪上加霜的操作。所以，对于互联网产品开发，我们一般建议让数据库只做好存储，复杂的运算和处理交给应用服务器上的程序去完成，如果应用服务器变得不堪重负了，我们可以比较容易的部署多台应用服务器来分摊这些压力。 + +如果大家对上面讲到的视图、函数、过程包括我们没有讲到的触发器这些知识有兴趣，建议大家阅读 MySQL 的入门读物[《MySQL必知必会》](https://item.jd.com/12818982.html)进行一般性了解即可，因为这些知识点在大家将来的工作中未必用得上，学了也可能仅仅是为了应付面试而已。 + +### 其他内容 + +#### 范式理论 + +范式理论是设计关系型数据库中二维表的指导思想。 + +1. 第一范式：数据表的每个列的值域都是由原子值组成的，不能够再分割。 +2. 第二范式：数据表里的所有数据都要和该数据表的键（主键与候选键）有完全依赖关系。 +3. 第三范式：所有非键属性都只和候选键有相关性，也就是说非键属性之间应该是独立无关的。 + +> **说明**：实际工作中，出于效率的考虑，我们在设计表时很有可能做出反范式设计，即故意降低方式级别，增加冗余数据来获得更好的操作性能。 + +#### 数据完整性 + +1. 实体完整性 - 每个实体都是独一无二的 + + - 主键（`primary key`） / 唯一约束（`unique`） +2. 引用完整性（参照完整性）- 关系中不允许引用不存在的实体 + + - 外键（`foreign key`） +3. 域（domain）完整性 - 数据是有效的 + - 数据类型及长度 + + - 非空约束（`not null`） + + - 默认值约束（`default`） + + - 检查约束（`check`） + + > **说明**：在 MySQL 8.x 以前，检查约束并不起作用。 + +#### 数据一致性 + +1. 事务：一系列对数据库进行读/写的操作，这些操作要么全都成功，要么全都失败。 + +2. 事务的 ACID 特性 + - 原子性：事务作为一个整体被执行，包含在其中的对数据库的操作要么全部被执行，要么都不执行 + - 一致性：事务应确保数据库的状态从一个一致状态转变为另一个一致状态 + - 隔离性：多个事务并发执行时，一个事务的执行不应影响其他事务的执行 + - 持久性：已被提交的事务对数据库的修改应该永久保存在数据库中 + +3. MySQL 中的事务操作 + + - 开启事务环境 + + ```SQL + start transaction + ``` + + - 提交事务 + + ```SQL + commit + ``` + + - 回滚事务 + + ```SQL + rollback + ``` + +4. 查看事务隔离级别 + + ```SQL + show variables like 'transaction_isolation'; + ``` + + ``` + +-----------------------+-----------------+ + | Variable_name | Value | + +-----------------------+-----------------+ + | transaction_isolation | REPEATABLE-READ | + +-----------------------+-----------------+ + ``` + + 可以看出，MySQL 默认的事务隔离级别是`REPEATABLE-READ`。 + +5. 修改（当前会话）事务隔离级别 + + ```SQL + set session transaction isolation level read committed; + ``` + + 重新查看事务隔离级别，结果如下所示。 + + ``` + +-----------------------+----------------+ + | Variable_name | Value | + +-----------------------+----------------+ + | transaction_isolation | READ-COMMITTED | + +-----------------------+----------------+ + ``` + +关系型数据库的事务是一个很大的话题，因为当存在多个并发事务访问数据时，就有可能出现三类读数据的问题（脏读、不可重复读、幻读）和两类更新数据的问题（第一类丢失更新、第二类丢失更新）。想了解这五类问题的，可以阅读我发布在 CSDN 网站上的[《Java面试题全集（上）》](https://blog.csdn.net/jackfrued/article/details/44921941)一文的第80题。为了避免这些问题，关系型数据库底层是有对应的锁机制的，按锁定对象不同可以分为表级锁和行级锁，按并发事务锁定关系可以分为共享锁和独占锁。然而直接使用锁是非常麻烦的，为此数据库为用户提供了自动锁机制，只要用户指定适当的事务隔离级别，数据库就会通过分析 SQL 语句，然后为事务访问的资源加上合适的锁。此外，数据库还会维护这些锁通过各种手段提高系统的性能，这些对用户来说都是透明的。想了解 MySQL 事务和锁的细节知识，推荐大家阅读进阶读物[《高性能MySQL》](https://item.jd.com/11220393.html)，这也是数据库方面的经典书籍。 + +ANSI/ISO SQL 92标准定义了4个等级的事务隔离级别，如下表所示。需要说明的是，事务隔离级别和数据访问的并发性是对立的，事务隔离级别越高并发性就越差。所以要根据具体的应用来确定到底使用哪种事务隔离级别，这个地方没有万能的原则。 + + + +### 总结 + +关于 MySQL 的知识肯定远远不止上面列出的这些，比如 MySQL 性能调优、MySQL 运维相关工具、MySQL 数据的备份和恢复、监控 MySQL 服务、部署高可用架构等，这一系列的问题在这里都没有办法逐一展开来讨论，那就留到有需要的时候再进行讲解吧，各位读者也可以自行探索。 diff --git "a/\347\254\25447\350\257\276.MySQL\346\226\260\347\211\271\346\200\247.md" "b/\347\254\25447\350\257\276.MySQL\346\226\260\347\211\271\346\200\247.md" new file mode 100644 index 0000000..38c05c5 --- /dev/null +++ "b/\347\254\25447\350\257\276.MySQL\346\226\260\347\211\271\346\200\247.md" @@ -0,0 +1,192 @@ +## MySQL 新特性 + +#### JSON类型 + +很多开发者在使用关系型数据库做数据持久化的时候，常常感到结构化的存储缺乏灵活性，因为必须事先设计好所有的列以及对应的数据类型。在业务发展和变化的过程中，如果需要修改表结构，这绝对是比较麻烦和难受的事情。从 MySQL 5.7 版本开始，MySQL引入了对 JSON 数据类型的支持（MySQL 8.0 解决了 JSON 的日志性能瓶颈问题），用好 JSON 类型，其实就是打破了关系型数据库和非关系型数据库之间的界限，为数据持久化操作带来了更多的便捷。 + +JSON 类型主要分为 JSON 对象和 JSON数组两种，如下所示。 + +1. JSON 对象 + +```JSON +{"name": "骆昊", "tel": "13122335566", "QQ": "957658"} +``` + +2. JSON 数组 + +```JSON +[1, 2, 3] +``` + +```JSON +[{"name": "骆昊", "tel": "13122335566"}, {"name": "王大锤", "QQ": "123456"}] +``` + +哪些地方需要用到JSON类型呢？举一个简单的例子，现在很多产品的用户登录都支持多种方式，例如手机号、微信、QQ、新浪微博等，但是一般情况下我们又不会要求用户提供所有的这些信息，那么用传统的设计方式，就需要设计多个列来对应多种登录方式，可能还需要允许这些列存在空值，这显然不是很好的选择；另一方面，如果产品又增加了一种登录方式，那么就必然要修改之前的表结构，这就更让人痛苦了。但是，有了 JSON 类型，刚才的问题就迎刃而解了，我们可以做出如下所示的设计。 + +```SQL +create table `tb_test` +( +`user_id` bigint unsigned, +`login_info` json, +primary key (`user_id`) +) engine=innodb; + +insert into `tb_test` values + (1, '{"tel": "13122335566", "QQ": "654321", "wechat": "jackfrued"}'), + (2, '{"tel": "13599876543", "weibo": "wangdachui123"}'); +``` + +如果要查询用户的手机和微信号，可以用如下所示的 SQL 语句。 + +```SQL +select + `user_id`, + json_unquote(json_extract(`login_info`, '$.tel')) as 手机号, + json_unquote(json_extract(`login_info`, '$.wechat')) as 微信 +from `tb_test`; +``` + +``` ++---------+-------------+-----------+ +| user_id | 手机号 | 微信 | ++---------+-------------+-----------+ +| 1 | 13122335566 | jackfrued | +| 2 | 13599876543 | NULL | ++---------+-------------+-----------+ +``` + +因为支持 JSON 类型，MySQL 也提供了配套的处理 JSON 数据的函数，就像上面用到的`json_extract`和`json_unquote`。当然，上面的 SQL 还有更为便捷的写法，如下所示。 + +```SQL +select + `user_id`, + `login_info` ->> '$.tel' as 手机号, + `login_info` ->> '$.wechat' as 微信 +from `tb_test`; +``` + +再举个例子，如果我们的产品要实现用户画像功能（给用户打标签），然后基于用户画像给用户推荐平台的服务或消费品之类的东西，我们也可以使用 JSON 类型来保存用户画像数据，示意代码如下所示。 + +创建画像标签表。 + +```SQL +create table `tb_tags` +( +`tag_id` int unsigned not null comment '标签ID', +`tag_name` varchar(20) not null comment '标签名', +primary key (`tag_id`) +) engine=innodb; + +insert into `tb_tags` (`tag_id`, `tag_name`) +values + (1, '70后'), + (2, '80后'), + (3, '90后'), + (4, '00后'), + (5, '爱运动'), + (6, '高学历'), + (7, '小资'), + (8, '有房'), + (9, '有车'), + (10, '爱看电影'), + (11, '爱网购'), + (12, '常点外卖'); +``` + +为用户打标签。 + +```SQL +create table `tb_users_tags` +( +`user_id` bigint unsigned not null comment '用户ID', +`user_tags` json not null comment '用户标签' +) engine=innodb; + +insert into `tb_users_tags` values + (1, '[2, 6, 8, 10]'), + (2, '[3, 10, 12]'), + (3, '[3, 8, 9, 11]'); +``` + +接下来，我们通过一组查询来了解 JSON 类型的巧妙之处。 + +1. 查询爱看电影（有`10`这个标签）的用户ID。 + + ```SQL + select `user_id` from `tb_users_tags` where 10 member of (`user_tags`->'$'); + ``` + +2. 查询爱看电影（有`10`这个标签）的80后（有`2`这个标签）用户ID。 + + ```SQL + select `user_id` from `tb_users_tags` where json_contains(`user_tags`->'$', '[2, 10]'); + ``` + +3. 查询爱看电影或80后或90后的用户ID。 + + ```SQL + select `user_id` from `tb_users_tags` where json_overlaps(user_tags->'$', '[2, 3, 10]'); + ``` + +> **说明**：上面的查询用到了`member of`谓词和两个 JSON 函数，`json_contains`可以检查 JSON 数组是否包含了指定的元素，而`json_overlaps`可以检查 JSON 数组是否与指定的数组有重叠部分。 + +#### 窗口函数 + +MySQL 从8.0开始支持窗口函数，大多数商业数据库和一些开源数据库早已提供了对窗口函数的支持，有的也将其称之为 OLAP（联机分析和处理）函数，听名字就知道跟统计和分析相关。为了帮助大家理解窗口函数，我们先说说窗口的概念。 + +窗口可以理解为记录的集合，窗口函数也就是在满足某种条件的记录集合上执行的特殊函数，对于每条记录都要在此窗口内执行函数。窗口函数和我们上面讲到的聚合函数比较容易混淆，二者的区别主要在于聚合函数是将多条记录聚合为一条记录，窗口函数是每条记录都会执行，执行后记录条数不会变。窗口函数不仅仅是几个函数，它是一套完整的语法，函数只是该语法的一部分，基本语法如下所示： + +```SQL +<窗口函数> over (partition by <用于分组的列名> order by <用户排序的列名>) +``` + +上面语法中，窗口函数的位置可以放以下两种函数： + +1. 专用窗口函数，包括：`lead`、`lag`、`first_value`、`last_value`、`rank`、`dense_rank`和`row_number`等。 +2. 聚合函数，包括：`sum`、`avg`、`max`、`min`和`count`等。 + +下面为大家举几个使用窗口函数的简单例子，我们直接使用上一课创建的 hrs 数据库。 + +例子1：查询按月薪从高到低排在第4到第6名的员工的姓名和月薪。 + +```SQL +select * from ( + select + `ename`, `sal`, + row_number() over (order by `sal` desc) as `rank` + from `tb_emp` +) `temp` where `rank` between 4 and 6; +``` + +> **说明**：上面使用的函数`row_number()`可以为每条记录生成一个行号，在实际工作中可以根据需要将其替换为`rank()`或`dense_rank()`函数，三者的区别可以参考官方文档或阅读[《通俗易懂的学会：SQL窗口函数》](https://zhuanlan.zhihu.com/p/92654574)进行了解。在MySQL 8以前的版本，我们可以通过下面的方式来完成类似的操作。 +> +> ```SQL +> select `rank`, `ename`, `sal` from ( +> select @a:=@a+1 as `rank`, `ename`, `sal` +> from `tb_emp`, (select @a:=0) as t1 order by `sal` desc +> ) as `temp` where `rank` between 4 and 6; +> ``` + +例子2：查询每个部门月薪最高的两名的员工的姓名和部门名称。 + +```SQL +select `ename`, `sal`, `dname` +from ( + select + `ename`, `sal`, `dno`, + rank() over (partition by `dno` order by `sal` desc) as `rank` + from `tb_emp` +) as `temp` natural join `tb_dept` where `rank`<=2; +``` + +> 说明：在MySQL 8以前的版本，我们可以通过下面的方式来完成类似的操作。 +> +> ```SQL +> select `ename`, `sal`, `dname` from `tb_emp` as `t1` +natural join `tb_dept` +where ( + select count(*) from `tb_emp` as `t2` + where `t1`.`dno`=`t2`.`dno` and `t2`.`sal`>`t1`.`sal` +)<2 order by `dno` asc, `sal` desc; +> ``` diff --git "a/\347\254\25443\350\257\276\357\274\232Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" "b/\347\254\25448\350\257\276.Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" similarity index 84% rename from "\347\254\25443\350\257\276\357\274\232Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" rename to "\347\254\25448\350\257\276.Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" index 49c5e71..24f1fbc 100644 --- "a/\347\254\25443\350\257\276\357\274\232Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" +++ "b/\347\254\25448\350\257\276.Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" @@ -1,65 +1,7 @@ -## 第43课：Python程序接入MySQL数据库 +## Python程序接入MySQL数据库 在 Python3 中，我们可以使用`mysqlclient`或者`pymysql`三方库来接入 MySQL 数据库并实现数据持久化操作。二者的用法完全相同，只是导入的模块名不一样。我们推荐大家使用纯 Python 的三方库`pymysql`，因为它更容易安装成功。下面我们仍然以之前创建的名为`hrs`的数据库为例，为大家演示如何通过 Python 程序操作 MySQL 数据库实现数据持久化操作。 -### 建库建表 - -```SQL --- 创建名为hrs的数据库并指定默认的字符集 -create database `hrs` default character set utf8mb4; - --- 切换到hrs数据库 -use `hrs`; - --- 创建部门表 -create table `tb_dept` -( -`dno` int not null comment '编号', -`dname` varchar(10) not null comment '名称', -`dloc` varchar(20) not null comment '所在地', -primary key (`dno`) -); - --- 插入4个部门 -insert into `tb_dept` values - (10, '会计部', '北京'), - (20, '研发部', '成都'), - (30, '销售部', '重庆'), - (40, '运维部', '深圳'); - --- 创建员工表 -create table `tb_emp` -( -`eno` int not null comment '员工编号', -`ename` varchar(20) not null comment '员工姓名', -`job` varchar(20) not null comment '员工职位', -`mgr` int comment '主管编号', -`sal` int not null comment '员工月薪', -`comm` int comment '每月补贴', -`dno` int not null comment '所在部门编号', -primary key (`eno`), -constraint `fk_emp_mgr` foreign key (`mgr`) references tb_emp (`eno`), -constraint `fk_emp_dno` foreign key (`dno`) references tb_dept (`dno`) -); - --- 插入14个员工 -insert into `tb_emp` values - (7800, '张三丰', '总裁', null, 9000, 1200, 20), - (2056, '乔峰', '分析师', 7800, 5000, 1500, 20), - (3088, '李莫愁', '设计师', 2056, 3500, 800, 20), - (3211, '张无忌', '程序员', 2056, 3200, null, 20), - (3233, '丘处机', '程序员', 2056, 3400, null, 20), - (3251, '张翠山', '程序员', 2056, 4000, null, 20), - (5566, '宋远桥', '会计师', 7800, 4000, 1000, 10), - (5234, '郭靖', '出纳', 5566, 2000, null, 10), - (3344, '黄蓉', '销售主管', 7800, 3000, 800, 30), - (1359, '胡一刀', '销售员', 3344, 1800, 200, 30), - (4466, '苗人凤', '销售员', 3344, 2500, null, 30), - (3244, '欧阳锋', '程序员', 3088, 3200, null, 20), - (3577, '杨过', '会计', 5566, 2200, null, 10), - (3588, '朱九真', '会计', 5566, 2500, null, 10); -``` - ### 接入MySQL 首先，我们可以在命令行或者 PyCharm 的终端中通过下面的命令安装`pymysql`，如果需要接入 MySQL 8，还需要安装一个名为`cryptography`的三方库来支持 MySQL 8 的密码认证方式。 From 4f1b0900749835d60f9dbf7d249d6a9b8a67c30e Mon Sep 17 00:00:00 2001 From: jackfrued Date: Mon, 13 Jun 2022 21:22:04 +0800 Subject: [PATCH 05/17] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E4=BA=86=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E5=9B=BE=E7=89=87=E8=B5=84=E6=BA=90=E9=93=BE=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 3 +- ...\274\232\345\210\235\350\257\206Python.md" | 18 +++---- ...\270\252Python\347\250\213\345\272\217.md" | 8 +-- ...13\345\255\227\347\254\246\344\270\262.md" | 2 +- ...04\344\271\213\351\233\206\345\220\210.md" | 2 +- ...04\344\271\213\345\255\227\345\205\270.md" | 2 +- ...77\347\224\250\350\277\233\351\230\266.md" | 2 +- ...26\347\250\213\345\205\245\351\227\250.md" | 4 +- ...02\345\270\270\345\244\204\347\220\206.md" | 2 +- ...15\345\272\217\345\210\227\345\214\226.md" | 8 +-- ...206\231Excel\346\226\207\344\273\266-2.md" | 2 +- ...\207\344\273\266\345\222\214PowerPoint.md" | 8 +-- ...04\347\220\206\345\233\276\345\203\217.md" | 16 +++--- ...66\345\222\214\347\237\255\344\277\241.md" | 10 ++-- ...17\347\232\204\345\272\224\347\224\250.md" | 2 +- ...07\351\233\206\346\246\202\350\277\260.md" | 16 +++--- ...21\347\273\234\350\265\204\346\272\220.md" | 8 +-- ...46\236\220HTML\351\241\265\351\235\242.md" | 4 +- ...\345\217\221\347\274\226\347\250\213-1.md" | 2 +- ...55\347\232\204\345\272\224\347\224\250.md" | 2 +- ...50\346\200\201\345\206\205\345\256\271.md" | 4 +- ...\236\266Scrapy\347\256\200\344\273\213.md" | 2 +- ...5\222\214MySQL\346\246\202\350\277\260.md" | 50 +++++++++---------- 23 files changed, 90 insertions(+), 87 deletions(-) diff --git a/README.md b/README.md index 03b08ab..9196caa 100644 --- a/README.md +++ b/README.md @@ -14,4 +14,5 @@ 下面是我创建的学习交流群（群号：789050736），欢迎加入一起学习共同进步。 - + + diff --git "a/\347\254\25401\350\257\276\357\274\232\345\210\235\350\257\206Python.md" "b/\347\254\25401\350\257\276\357\274\232\345\210\235\350\257\206Python.md" index 2169264..15b4892 100644 --- "a/\347\254\25401\350\257\276\357\274\232\345\210\235\350\257\206Python.md" +++ "b/\347\254\25401\350\257\276\357\274\232\345\210\235\350\257\206Python.md" @@ -4,7 +4,7 @@ Python是由荷兰人吉多·范罗苏姆（Guido von Rossum）发明的一种编程语言，是目前世界上最受欢迎和拥有最多用户群体的编程语言。 - + #### Python的历史 @@ -41,29 +41,29 @@ Python最主要的缺点是执行效率低，但是当我们更看重产品的 可以在[Python官方网站](https://www.python.org/downloads/)找到下载链接并下载Python 3的安装程序。 -![](https://gitee.com/jackfrued/mypic/raw/master/20210719222940.png) +![](https://github.com/jackfrued/mypic/raw/master/20210719222940.png) 对于Windows操作系统，可以下载“executable installer”。需要注意的是，如果在Windows 7环境下安装Python 3，需要先安装Service Pack 1补丁包，大家可以在Windows的“运行”中输入`winver`命令，从弹出的窗口上可以看到你的系统是否安装了该补丁包。如果没有该补丁包，一定要先通过“Windows Update”或者类似“CCleaner”这样的工具自动安装该补丁包，安装完成后通常需要重启你的Windows系统，然后再开始安装Python环境。 -![](https://gitee.com/jackfrued/mypic/raw/master/20210719222956.png) +![](https://github.com/jackfrued/mypic/raw/master/20210719222956.png) 双击运行刚才下载的安装程序，会打开Python环境的安装向导。在执行安装向导的时候，记得勾选“Add Python 3.x to PATH”选项，这个选项会帮助我们将Python的解释器添加到PATH环境变量中（不理解没关系，照做就行），具体的步骤如下图所示。 -![](https://gitee.com/jackfrued/mypic/raw/master/20210719223007.png) +![](https://github.com/jackfrued/mypic/raw/master/20210719223007.png) -![](https://gitee.com/jackfrued/mypic/raw/master/20210719223021.png) +![](https://github.com/jackfrued/mypic/raw/master/20210719223021.png) -![](https://gitee.com/jackfrued/mypic/raw/master/20210719223317.png) +![](https://github.com/jackfrued/mypic/raw/master/20210719223317.png) -![](https://gitee.com/jackfrued/mypic/raw/master/20210719223332.png) +![](https://github.com/jackfrued/mypic/raw/master/20210719223332.png) 安装完成后可以打开Windows的“命令行提示符”工具（或“PowerShell”）并输入`python --version`或`python -V`来检查安装是否成功，命令行提示符可以在“运行”中输入`cmd`来打开或者在“开始菜单”的附件中找到它。如果看了Python解释器对应的版本号（如：Python 3.7.8），说明你的安装已经成功了，如下图所示。 -![](https://gitee.com/jackfrued/mypic/raw/master/20210719223350.png) +![](https://github.com/jackfrued/mypic/raw/master/20210719223350.png) > **说明**：如果安装过程显示安装失败或执行上面的命令报错，很有可能是因为你的Windows系统缺失了一些动态链接库文件或C构建工具导致的问题。可以在[微软官网](https://www.microsoft.com/zh-cn/download/details.aspx?id=48145)下载Visual C++ Redistributable for Visual Studio 2015文件进行修复，64位的系统需要下载有x64标记的安装文件。也可以通过下面的百度云盘地址获取修复工具，运行修复工具，按照如下图所示的方式进行修复，链接: https://pan.baidu.com/s/1iNDnU5UVdDX5sKFqsiDg5Q 提取码: cjs3。 > -> ![QQ20210711-0](https://gitee.com/jackfrued/mypic/raw/master/20210816234614.png) +> ![QQ20210711-0](https://github.com/jackfrued/mypic/raw/master/20210816234614.png) 除此之外，你还应该检查一下Python的包管理工具是否已经可用，对应的命令是`pip --version`。 diff --git "a/\347\254\25402\350\257\276\357\274\232\347\254\254\344\270\200\344\270\252Python\347\250\213\345\272\217.md" "b/\347\254\25402\350\257\276\357\274\232\347\254\254\344\270\200\344\270\252Python\347\250\213\345\272\217.md" index 776fc72..b3067f1 100644 --- "a/\347\254\25402\350\257\276\357\274\232\347\254\254\344\270\200\344\270\252Python\347\250\213\345\272\217.md" +++ "b/\347\254\25402\350\257\276\357\274\232\347\254\254\344\270\200\344\270\252Python\347\250\213\345\272\217.md" @@ -51,19 +51,19 @@ Visual Studio Code（通常简称为VSCode）是一个由微软开发能够在Wi 运行PyCharm，可以看到如下图所示的欢迎界面，可以选择“New Project”来创建一个新的项目。 - + 创建项目的时候需要指定项目的路径并创建运行项目的”虚拟环境“，如下图所示。 - + 项目创建好以后会出现如下图所示的画面，我们可以通过在项目文件夹上点击鼠标右键，选择“New”菜单下的“Python File”来创建一个Python文件，创建好的Python文件会自动打开进入可编辑的状态。 -![image-20210720133621079](https://gitee.com/jackfrued/mypic/raw/master/20210720133621.png) +![image-20210720133621079](https://github.com/jackfrued/mypic/raw/master/20210720133621.png) 写好代码后，可以在编辑代码的窗口点击鼠标右键，选择“Run”菜单项来运行代码，下面的“Run”窗口会显示代码的执行结果，如下图所示。 -![image-20210720134039848](https://gitee.com/jackfrued/mypic/raw/master/20210720134039.png) +![image-20210720134039848](https://github.com/jackfrued/mypic/raw/master/20210720134039.png) PyCharm常用的快捷键如下表所示，我们也可以在“File”菜单的“Settings”中定制PyCharm的快捷键（macOS系统是在“PyCharm”菜单的“Preferences”中对快捷键进行设置）。 diff --git "a/\347\254\25410\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\347\254\246\344\270\262.md" "b/\347\254\25410\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\347\254\246\344\270\262.md" index 91ac34c..c872d40 100644 --- "a/\347\254\25410\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\347\254\246\344\270\262.md" +++ "b/\347\254\25410\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\347\254\246\344\270\262.md" @@ -2,7 +2,7 @@ 第二次世界大战促使了现代电子计算机的诞生，世界上的第一台通用电子计算机叫ENIAC（电子数值积分计算机），诞生于美国的宾夕法尼亚大学，占地167平米，重量27吨，每秒钟大约能够完成约5000次浮点运算，如下图所示。ENIAC诞生之后被应用于导弹弹道的计算，而数值计算也是现代电子计算机最为重要的一项功能。 - + 随着时间的推移，虽然数值运算仍然是计算机日常工作中最为重要的组成部分，但是今天的计算机还要处理大量的以文本形式存在的信息。如果我们希望通过Python程序来操作本这些文本信息，就必须要先了解字符串这种数据类型以及与它相关的知识。 diff --git "a/\347\254\25411\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\351\233\206\345\220\210.md" "b/\347\254\25411\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\351\233\206\345\220\210.md" index 173b043..7bbf566 100644 --- "a/\347\254\25411\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\351\233\206\345\220\210.md" +++ "b/\347\254\25411\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\351\233\206\345\220\210.md" @@ -91,7 +91,7 @@ print((set1 | set2) - (set1 & set2)) # {1, 3, 5, 7, 8, 10} 通过上面的代码可以看出，对两个集合求交集，`&`运算符和`intersection`方法的作用是完全相同的，使用运算符的方式更直观而且代码也比较简短。相信大家对交集、并集、差集、对称差这几个概念是比较清楚的，如果没什么印象了可以看看下面的图。 - + 集合的交集、并集、差集运算还可以跟赋值运算一起构成复合赋值运算，如下所示。 diff --git "a/\347\254\25412\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\345\205\270.md" "b/\347\254\25412\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\345\205\270.md" index ba7780b..254024a 100644 --- "a/\347\254\25412\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\345\205\270.md" +++ "b/\347\254\25412\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\345\205\270.md" @@ -12,7 +12,7 @@ person3 = {'王大锤', 55, 60, '科华北路62号', '中同仁路8号', '131223 说到字典这个词，大家一定不陌生，读小学的时候每个人基本上都有一本《新华字典》，如下图所示。 -![dictionary](https://gitee.com/jackfrued/mypic/raw/master/20210820204829.jpg) +![dictionary](https://github.com/jackfrued/mypic/raw/master/20210820204829.jpg) Python程序中的字典跟现实生活中的字典很像，它以键值对（键和值的组合）的方式把数据组织到一起，我们可以通过键找到与之对应的值并进行操作。就像《新华字典》中，每个字（键）都有与它对应的解释（值）一样，每个字和它的解释合在一起就是字典中的一个条目，而字典中通常包含了很多个这样的条目。 diff --git "a/\347\254\25415\350\257\276\357\274\232\345\207\275\346\225\260\344\275\277\347\224\250\350\277\233\351\230\266.md" "b/\347\254\25415\350\257\276\357\274\232\345\207\275\346\225\260\344\275\277\347\224\250\350\277\233\351\230\266.md" index 8816ae3..3c3a3da 100644 --- "a/\347\254\25415\350\257\276\357\274\232\345\207\275\346\225\260\344\275\277\347\224\250\350\277\233\351\230\266.md" +++ "b/\347\254\25415\350\257\276\357\274\232\345\207\275\346\225\260\344\275\277\347\224\250\350\277\233\351\230\266.md" @@ -1,4 +1,4 @@ -## 第13课：函数使用进阶 +## 第15课：函数使用进阶 前面我们讲到了关于函数的知识，我们还讲到过Python中常用的数据类型，这些类型的变量都可以作为函数的参数或返回值，用好函数还可以让我们做更多的事情。 diff --git "a/\347\254\25417\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\345\205\245\351\227\250.md" "b/\347\254\25417\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\345\205\245\351\227\250.md" index 29312ac..4fb9e45 100644 --- "a/\347\254\25417\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\345\205\245\351\227\250.md" +++ "b/\347\254\25417\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\345\205\245\351\227\250.md" @@ -22,7 +22,7 @@ 在面向对象编程的世界中，**一切皆为对象**，**对象都有属性和行为**，**每个对象都是独一无二的**，而且**对象一定属于某个类**。对象的属性是对象的静态特征，对象的行为是对象的动态特征。按照上面的说法，如果我们把拥有共同特征的对象的属性和行为都抽取出来，就可以定义出一个类。 - + ### 定义类 @@ -224,7 +224,7 @@ print(p1.distance_to(p2)) 面向对象编程是一种非常流行的编程范式，除此之外还有**指令式编程**、**函数式编程**等编程范式。由于现实世界是由对象构成的，而对象是可以接收消息的实体，所以**面向对象编程更符合人类正常的思维习惯**。类是抽象的，对象是具体的，有了类就能创建对象，有了对象就可以接收消息，这就是面向对象编程的基础。定义类的过程是一个抽象的过程，找到对象公共的属性属于数据抽象，找到对象公共的方法属于行为抽象。抽象的过程是一个仁者见仁智者见智的过程，对同一类对象进行抽象可能会得到不同的结果，如下图所示。 - + > **说明：** 本节课的插图来自于 Grady Booc 等撰写的《面向对象分析与设计》一书，该书是讲解面向对象编程的经典著作，有兴趣的读者可以购买和阅读这本书来了解更多的面向对象的相关知识。 diff --git "a/\347\254\25421\350\257\276\357\274\232\346\226\207\344\273\266\350\257\273\345\206\231\345\222\214\345\274\202\345\270\270\345\244\204\347\220\206.md" "b/\347\254\25421\350\257\276\357\274\232\346\226\207\344\273\266\350\257\273\345\206\231\345\222\214\345\274\202\345\270\270\345\244\204\347\220\206.md" index cb28820..b3de67b 100644 --- "a/\347\254\25421\350\257\276\357\274\232\346\226\207\344\273\266\350\257\273\345\206\231\345\222\214\345\274\202\345\270\270\345\244\204\347\220\206.md" +++ "b/\347\254\25421\350\257\276\357\274\232\346\226\207\344\273\266\350\257\273\345\206\231\345\222\214\345\274\202\345\270\270\345\244\204\347\220\206.md" @@ -20,7 +20,7 @@ 下图展示了如何根据程序的需要来设置`open`函数的操作模式。 - + 在使用`open`函数时，如果打开的文件是字符文件（文本文件），可以通过`encoding`参数来指定读写文件使用的字符编码。如果对字符编码和字符集这些概念不了解，可以看看[《字符集和字符编码》](https://www.cnblogs.com/skynet/archive/2011/05/03/2035105.html)一文，此处不再进行赘述。 diff --git "a/\347\254\25422\350\257\276\357\274\232\345\257\271\350\261\241\347\232\204\345\272\217\345\210\227\345\214\226\345\222\214\345\217\215\345\272\217\345\210\227\345\214\226.md" "b/\347\254\25422\350\257\276\357\274\232\345\257\271\350\261\241\347\232\204\345\272\217\345\210\227\345\214\226\345\222\214\345\217\215\345\272\217\345\210\227\345\214\226.md" index a3a7830..950f77d 100644 --- "a/\347\254\25422\350\257\276\357\274\232\345\257\271\350\261\241\347\232\204\345\272\217\345\210\227\345\214\226\345\222\214\345\217\215\345\272\217\345\210\227\345\214\226.md" +++ "b/\347\254\25422\350\257\276\357\274\232\345\257\271\350\261\241\347\232\204\345\272\217\345\210\227\345\214\226\345\222\214\345\217\215\345\272\217\345\210\227\345\214\226.md" @@ -32,11 +32,11 @@ let obj = { } ``` -image-20210820143756353 +image-20210820143756353 上面的`obj`就是JavaScript中的一个对象，我们可以通过`obj.name`或`obj["name"]`两种方式获取到`name`对应的值，如下图所示。可以注意到，`obj["name"]`这种获取数据的方式跟Python字典通过键获取值的索引操作是完全一致的，而Python中也通过名为`json`的模块提供了字典与JSON双向转换的支持。 - + 我们在JSON中使用的数据类型（JavaScript数据类型）和Python中的数据类型也是很容易找到对应关系的，大家可以看看下面的两张表。 @@ -205,7 +205,7 @@ pip uninstall -y ujson 国内有很多提供网络API接口的网站，例如[聚合数据](https://www.juhe.cn/)、[阿凡达数据](http://www.avatardata.cn/)等，这些网站上有免费的和付费的数据接口，国外的[{API}Search](http://apis.io/)网站也提供了类似的功能，有兴趣的可以自行研究。下面的例子演示了如何使用[`requests`](http://docs.python-requests.org/zh_CN/latest/)库（基于HTTP进行网络资源访问的三方库）访问网络API获取国内新闻并显示新闻标题和链接。在这个例子中，我们使用了名为[天行数据](https://www.tianapi.com/)的网站提供的国内新闻数据接口，其中的APIKey需要自己到网站上注册申请。在天行数据网站注册账号后会自动分配APIKey，但是要访问接口获取数据，需要绑定验证邮箱或手机，然后还要申请需要使用的接口，如下图所示。 -image-20210820151134034 +image-20210820151134034 Python通过URL接入网络，我们推荐大家使用`requests`三方库，它简单且强大，但需要自行安装。 @@ -229,7 +229,7 @@ if resp.status_code == 200: 上面的代码通过`requests`模块的`get`函数向天行数据的国内新闻接口发起了一次请求，如果请求过程没有出现问题，`get`函数会返回一个`Response`对象，通过该对象的`status_code`属性表示HTTP响应状态码，如果不理解没关系，你只需要关注它的值，如果值等于`200`或者其他`2`字头的值，那么我们的请求是成功的。通过`Response`对象的`json()`方法可以将返回的JSON格式的数据直接处理成Python字典，非常方便。天行数据国内新闻接口返回的JSON格式的数据（部分）如下图所示。 - + > **提示**：上面代码中的APIKey需要换成自己在天行数据网站申请的APIKey。天行数据网站上还有提供了很多非常有意思的API接口，例如：垃圾分类、周公解梦等，大家可以仿照上面的代码来调用这些接口。每个接口都有对应的接口文档，文档中有关于如何使用接口的详细说明。 diff --git "a/\347\254\25425\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266-2.md" "b/\347\254\25425\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266-2.md" index 0a24643..8efa132 100644 --- "a/\347\254\25425\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266-2.md" +++ "b/\347\254\25425\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266-2.md" @@ -175,7 +175,7 @@ wb.save('demo.xlsx') 运行上面的代码，打开生成的Excel文件，效果如下图所示。 -image-20210819235009026 +image-20210819235009026 ### 简单的总结 diff --git "a/\347\254\25426\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234Word\346\226\207\344\273\266\345\222\214PowerPoint.md" "b/\347\254\25426\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234Word\346\226\207\344\273\266\345\222\214PowerPoint.md" index 295123d..5552bc3 100644 --- "a/\347\254\25426\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234Word\346\226\207\344\273\266\345\222\214PowerPoint.md" +++ "b/\347\254\25426\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234Word\346\226\207\344\273\266\345\222\214PowerPoint.md" @@ -87,7 +87,7 @@ document.save('demo.docx') 执行上面的代码，打开生成的Word文档，效果如下图所示。 -image-20210820002742341  image-20210820002843696 +image-20210820002742341  image-20210820002843696 对于一个已经存在的Word文件，我们可以通过下面的代码去遍历它所有的段落并获取对应的内容。 @@ -121,7 +121,7 @@ for no, p in enumerate(doc.paragraphs): 按照上面的思路，我们首先编辑一个离职证明的模板文件，如下图所示。 -image-20210820004223731 +image-20210820004223731 接下来我们读取该文件，将占位符替换为真实信息，就可以生成一个新的Word文档，如下所示。 @@ -182,7 +182,7 @@ for emp_dict in employees: 执行上面的代码，会在当前路径下生成三个Word文档，如下图所示。 -image-20210820004825183 +image-20210820004825183 ### 生成PowerPoint @@ -238,7 +238,7 @@ pres.save('test.pptx') 运行上面的代码，生成的PowerPoint文件如下图所示。 -image-20210820010306008 +image-20210820010306008 ### 简单的总结 diff --git "a/\347\254\25428\350\257\276\357\274\232\347\224\250Python\345\244\204\347\220\206\345\233\276\345\203\217.md" "b/\347\254\25428\350\257\276\357\274\232\347\224\250Python\345\244\204\347\220\206\345\233\276\345\203\217.md" index c0dba9b..6b7c079 100644 --- "a/\347\254\25428\350\257\276\357\274\232\347\224\250Python\345\244\204\347\220\206\345\233\276\345\203\217.md" +++ "b/\347\254\25428\350\257\276\357\274\232\347\224\250Python\345\244\204\347\220\206\345\233\276\345\203\217.md" @@ -40,7 +40,7 @@ Pillow中最为重要的是`Image`类，可以通过`Image`模块的`open`函数 image.show() ``` - + 2. 剪裁图像 @@ -49,7 +49,7 @@ Pillow中最为重要的是`Image`类，可以通过`Image`模块的`open`函数 image.crop((80, 20, 310, 360)).show() ``` - + 3. 生成缩略图 @@ -59,7 +59,7 @@ Pillow中最为重要的是`Image`类，可以通过`Image`模块的`open`函数 image.show() ``` - + 4. 缩放和黏贴图像 @@ -77,7 +77,7 @@ Pillow中最为重要的是`Image`类，可以通过`Image`模块的`open`函数 luohao_image.show() ``` - + 5. 旋转和翻转 @@ -91,7 +91,7 @@ Pillow中最为重要的是`Image`类，可以通过`Image`模块的`open`函数 image.transpose(Image.FLIP_TOP_BOTTOM).show() ``` - + 6. 操作像素 @@ -103,7 +103,7 @@ Pillow中最为重要的是`Image`类，可以通过`Image`模块的`open`函数 image.show() ``` - + 7. 滤镜效果 @@ -115,13 +115,13 @@ Pillow中最为重要的是`Image`类，可以通过`Image`模块的`open`函数 image.filter(ImageFilter.CONTOUR).show() ``` - + ### 使用Pillow绘图 Pillow中有一个名为`ImageDraw`的模块，该模块的`Draw`函数会返回一个`ImageDraw`对象，通过`ImageDraw`对象的`arc`、`line`、`rectangle`、`ellipse`、`polygon`等方法，可以在图像上绘制出圆弧、线条、矩形、椭圆、多边形等形状，也可以通过该对象的`text`方法在图像上添加文字。 - + 要绘制如上图所示的图像，完整的代码如下所示。 diff --git "a/\347\254\25429\350\257\276\357\274\232\347\224\250Python\345\217\221\351\200\201\351\202\256\344\273\266\345\222\214\347\237\255\344\277\241.md" "b/\347\254\25429\350\257\276\357\274\232\347\224\250Python\345\217\221\351\200\201\351\202\256\344\273\266\345\222\214\347\237\255\344\277\241.md" index b2ec68d..ca745b5 100644 --- "a/\347\254\25429\350\257\276\357\274\232\347\224\250Python\345\217\221\351\200\201\351\202\256\344\273\266\345\222\214\347\237\255\344\277\241.md" +++ "b/\347\254\25429\350\257\276\357\274\232\347\224\250Python\345\217\221\351\200\201\351\202\256\344\273\266\345\222\214\347\237\255\344\277\241.md" @@ -10,9 +10,9 @@ 我们先尝试一下发送一封极为简单的邮件，该邮件不包含附件、图片以及其他超文本内容。发送邮件首先需要接入邮件服务器，我们可以自己架设邮件服务器，这件事情对新手并不友好，但是我们可以选择使用第三方提供的邮件服务。例如，我在已经注册了账号，登录成功之后，就可以在设置中开启SMTP服务，这样就相当于获得了邮件服务器，具体的操作如下所示。 -image-20210820190306861 +image-20210820190306861 -![image-20210820190816557](https://gitee.com/jackfrued/mypic/raw/master/20210820190816.png) +![image-20210820190816557](https://github.com/jackfrued/mypic/raw/master/20210820190816.png) 用手机扫码上面的二维码可以通过发送短信的方式来获取授权码，短信发送成功后，点击“我已发送”就可以获得授权码。授权码需要妥善保管，因为一旦泄露就会被其他人冒用你的身份来发送邮件。接下来，我们就可以编写发送邮件的代码了，如下所示。 @@ -147,7 +147,7 @@ def send_email(*, from_user, to_users, subject='', content='', filenames=[]): 发送短信也是项目中常见的功能，网站的注册码、验证码、营销信息基本上都是通过短信来发送给用户的。发送短信需要三方平台的支持，下面我们以[螺丝帽平台](https://luosimao.com/)为例，为大家介绍如何用Python程序发送短信。注册账号和购买短信服务的细节我们不在这里进行赘述，大家可以咨询平台的客服。 -![image-20210820194420911](https://gitee.com/jackfrued/mypic/raw/master/20210820194421.png) +![image-20210820194420911](https://github.com/jackfrued/mypic/raw/master/20210820194421.png) 接下来，我们可以通过`requests`库向平台提供的短信网关发起一个HTTP请求，通过将接收短信的手机号和短信内容作为参数，就可以发送短信，代码如下所示。 @@ -189,11 +189,11 @@ if __name__ == '__main__': 上面请求螺丝帽的短信网关`http://sms-api.luosimao.com/v1/send.json`会返回JSON格式的数据，如果返回`{'error': 0, 'msg': 'OK'}`就说明短信已经发送成功了，如果`error`的值不是`0`，可以通过查看官方的[开发文档](https://luosimao.com/docs/api/)了解到底哪个环节出了问题。螺丝帽平台常见的错误类型如下图所示。 -image-20210820195505761 +image-20210820195505761 目前，大多数短信平台都会要求短信内容必须附上签名，下图是我在螺丝帽平台配置的短信签名“【Python小课】”。有些涉及到敏感内容的短信，还需要提前配置短信模板，有兴趣的读者可以自行研究。一般情况下，平台为了防范短信被盗用，还会要求设置“IP白名单”，不清楚如何配置的可以咨询平台客服。 -![image-20210820194653785](https://gitee.com/jackfrued/mypic/raw/master/20210820194653.png) +![image-20210820194653785](https://github.com/jackfrued/mypic/raw/master/20210820194653.png) 当然国内的短信平台很多，读者可以根据自己的需要进行选择（通常会考虑费用预算、短信达到率、使用的难易程度等指标），如果需要在商业项目中使用短信服务建议购买短信平台提供的套餐服务。 diff --git "a/\347\254\25430\350\257\276\357\274\232\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217\347\232\204\345\272\224\347\224\250.md" "b/\347\254\25430\350\257\276\357\274\232\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217\347\232\204\345\272\224\347\224\250.md" index bd86212..940daa2 100644 --- "a/\347\254\25430\350\257\276\357\274\232\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217\347\232\204\345\272\224\347\224\250.md" +++ "b/\347\254\25430\350\257\276\357\274\232\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217\347\232\204\345\272\224\347\224\250.md" @@ -100,7 +100,7 @@ if m1 and m2: 下面这张图是截止到2017年底，国内三家运营商推出的手机号段。 - + ```Python import re diff --git "a/\347\254\25431\350\257\276\357\274\232\347\275\221\347\273\234\346\225\260\346\215\256\351\207\207\351\233\206\346\246\202\350\277\260.md" "b/\347\254\25431\350\257\276\357\274\232\347\275\221\347\273\234\346\225\260\346\215\256\351\207\207\351\233\206\346\246\202\350\277\260.md" index cd4b240..cc101a1 100644 --- "a/\347\254\25431\350\257\276\357\274\232\347\275\221\347\273\234\346\225\260\346\215\256\351\207\207\351\233\206\346\246\202\350\277\260.md" +++ "b/\347\254\25431\350\257\276\357\274\232\347\275\221\347\273\234\346\225\260\346\215\256\351\207\207\351\233\206\346\246\202\350\277\260.md" @@ -40,7 +40,7 @@ Disallow: / 图1. 百度搜索淘宝的结果 -![](https://gitee.com/jackfrued/mypic/raw/master/20210824004320.png) +![](https://github.com/jackfrued/mypic/raw/master/20210824004320.png) 下面是豆瓣网的[`robots.txt`](https://www.douban.com/robots.txt)文件，大家可以自行解读，看看它做出了什么样的限制。 @@ -89,19 +89,19 @@ Disallow: /j/ 图2. HTTP请求 -![http-request](https://gitee.com/jackfrued/mypic/raw/master/20210824003915.png) +![http-request](https://github.com/jackfrued/mypic/raw/master/20210824003915.png) HTTP 请求通常是由请求行、请求头、空行、消息体四个部分构成，如果没有数据发给服务器，消息体就不是必须的部分。请求行中包含了请求方法（GET、POST 等，如下表所示）、资源路径和协议版本；请求头由若干键值对构成，包含了浏览器、编码方式、首选语言、缓存策略等信息；请求头的后面是空行和消息体。 - + 图3. HTTP响应 -![http-response](https://gitee.com/jackfrued/mypic/raw/master/20210824234158.png) +![http-response](https://github.com/jackfrued/mypic/raw/master/20210824234158.png) HTTP 响应通常是由响应行、响应头、空行、消息体四个部分构成，其中消息体是服务响应的数据，可能是 HTML 页面，也有可能是JSON或二进制数据等。响应行中包含了协议版本和响应状态码，响应状态码有很多种，常见的如下表所示。 - + #### 相关工具 @@ -115,11 +115,11 @@ HTTP 响应通常是由响应行、响应头、空行、消息体四个部分构 - 网络（Network）：用于 HTTP 请求、HTTP 响应以及与网络连接相关的信息。 - 应用（Application）：用于查看浏览器本地存储、后台任务等内容，本地存储主要包括Cookie、Local Storage、Session Storage等。 - ![chrome-developer-tools](https://gitee.com/jackfrued/mypic/raw/master/20210824004034.png) + ![chrome-developer-tools](https://github.com/jackfrued/mypic/raw/master/20210824004034.png) 2. Postman：功能强大的网页调试与 RESTful 请求工具。Postman可以帮助我们模拟请求，非常方便的定制我们的请求以及查看服务器的响应。 - ![postman](https://gitee.com/jackfrued/mypic/raw/master/20210824004048.png) + ![postman](https://github.com/jackfrued/mypic/raw/master/20210824004048.png) 3. HTTPie：命令行HTTP客户端。 @@ -187,7 +187,7 @@ HTTP 响应通常是由响应行、响应头、空行、消息体四个部分构 一个基本的爬虫通常分为数据采集（网页下载）、数据处理（网页解析）和数据存储（将有用的信息持久化）三个部分的内容，当然更为高级的爬虫在数据采集和处理时会使用并发编程或分布式技术，这就需要有调度器（安排线程或进程执行对应的任务）、后台管理程序（监控爬虫的工作状态以及检查数据抓取的结果）等的参与。 -![crawler-workflow](https://gitee.com/jackfrued/mypic/raw/master/20210824004107.png) +![crawler-workflow](https://github.com/jackfrued/mypic/raw/master/20210824004107.png) 一般来说，爬虫的工作流程包括以下几个步骤： diff --git "a/\347\254\25432\350\257\276\357\274\232\347\224\250Python\350\216\267\345\217\226\347\275\221\347\273\234\350\265\204\346\272\220.md" "b/\347\254\25432\350\257\276\357\274\232\347\224\250Python\350\216\267\345\217\226\347\275\221\347\273\234\350\265\204\346\272\220.md" index ab7ede2..e182131 100644 --- "a/\347\254\25432\350\257\276\357\274\232\347\224\250Python\350\216\267\345\217\226\347\275\221\347\273\234\350\265\204\346\272\220.md" +++ "b/\347\254\25432\350\257\276\357\274\232\347\224\250Python\350\216\267\345\217\226\347\275\221\347\273\234\350\265\204\346\272\220.md" @@ -6,7 +6,7 @@ 要使用 Python 获取网络数据，我们推荐大家使用名为`requests` 的三方库，这个库我们在之前的课程中其实已经使用过了。按照官方网站的解释，`requests`是基于 Python 标准库进行了封装，简化了通过 HTTP 或 HTTPS 访问网络资源的操作。上课我们提到过，HTTP 是一个请求响应式的协议，当我们在浏览器中输入正确的 [URL](https://developer.mozilla.org/zh-CN/docs/Learn/Common_questions/What_is_a_URL)（通常也称为网址）并按下 Enter 键时，我们就向网络上的 [Web 服务器](https://developer.mozilla.org/zh-CN/docs/Learn/Common_questions/What_is_a_web_server)发送了一个 HTTP 请求，服务器在收到请求后会给我们一个 HTTP 响应。在 Chrome 浏览器中的菜单中打开“开发者工具”切换到“Network”选项卡就能够查看 HTTP 请求和响应到底是什么样子的，如下图所示。 -![](https://gitee.com/jackfrued/mypic/raw/master/20210822093434.png) +![](https://github.com/jackfrued/mypic/raw/master/20210822093434.png) 通过`requests`库，我们可以让 Python 程序向浏览器一样向 Web 服务器发起请求，并接收服务器返回的响应，从响应中我们就可以提取出想要的数据。浏览器呈现给我们的网页是用 [HTML](https://developer.mozilla.org/zh-CN/docs/Web/HTML) 编写的，浏览器相当于是 HTML 的解释器环境，我们看到的网页中的内容都包含在 HTML 的标签中。在获取到 HTML 代码后，就可以从标签的属性或标签体中提取内容。下面例子演示了如何获取网页 HTML 代码，我们通过`requests`库的`get`函数，获取了搜狐首页的代码。 @@ -54,7 +54,7 @@ with open('baidu.png', 'wb') as file: 接下来，我们以“豆瓣电影”为例，为大家讲解如何编写爬虫代码。按照上面提供的方法，我们先使用`requests`获取到网页的HTML代码，然后将整个代码看成一个长字符串，这样我们就可以使用正则表达式的捕获组从字符串提取我们需要的内容。下面的代码演示了如何从[豆瓣电影](https://movie.douban.com/)获取排前250名的电影的名称。[豆瓣电影Top250](https://movie.douban.com/top250)的页面结构和对应代码如下图所示，可以看出，每页共展示了25部电影，如果要获取到 Top250 数据，我们共需要访问10个页面，对应的地址是，这里的`xxx`如果为`0`就是第一页，如果`xxx`的值是`100`，那么我们可以访问到第五页。为了代码简单易读，我们只获取电影的标题和评分。 -![](https://gitee.com/jackfrued/mypic/raw/master/20210822093447.png) +![](https://github.com/jackfrued/mypic/raw/master/20210822093447.png) ```Python import random @@ -92,7 +92,7 @@ for page in range(1, 11): 下面以[蘑菇代理](http://www.moguproxy.com/)为例，为大家讲解商业 IP 代理的使用方法。首先需要在该网站注册一个账号，注册账号后就可以[购买](http://www.moguproxy.com/buy)相应的套餐来获得商业 IP 代理。作为商业用途，建议大家购买不限量套餐，这样可以根据实际需要获取足够多的代理 IP 地址；作为学习用途，可以购买包时套餐或根据自己的需求来决定。蘑菇代理提供了两种接入代理的方式，分别是 API 私密代理和 HTTP 隧道代理，前者是通过请求蘑菇代理的 API 接口获取代理服务器地址，后者是直接使用统一的入口（蘑菇代理提供的域名）进行接入。 - + 下面，我们以HTTP隧道代理为例，为大家讲解接入 IP 代理的方式，大家也可以直接参考蘑菇代理官网提供的代码来为爬虫设置代理。 @@ -127,6 +127,8 @@ for page in range(1, 11): ``` > **说明**：上面的代码需要修改`APP_KEY`为自己创建的订单对应的`Appkey`值，这个值可以在用户中心用户订单中查看到。蘑菇代理提供了免费的 API 代理和 HTTP 隧道代理试用，但是试用的代理接通率不能保证，建议大家还是直接购买一个在自己支付能力范围内的代理服务来体验。 +> +> **另注**：蘑菇代理目前已经停止服务了，大家可以按照上面讲解的方式使用其他商业代理即可。 ### 简单的总结 diff --git "a/\347\254\25433\350\257\276\357\274\232\347\224\250Python\350\247\243\346\236\220HTML\351\241\265\351\235\242.md" "b/\347\254\25433\350\257\276\357\274\232\347\224\250Python\350\247\243\346\236\220HTML\351\241\265\351\235\242.md" index b357bcb..309471d 100644 --- "a/\347\254\25433\350\257\276\357\274\232\347\224\250Python\350\247\243\346\236\220HTML\351\241\265\351\235\242.md" +++ "b/\347\254\25433\350\257\276\357\274\232\347\224\250Python\350\247\243\346\236\220HTML\351\241\265\351\235\242.md" @@ -6,7 +6,7 @@ 我们在浏览器中打开任意一个网站，然后通过鼠标右键菜单，选择“显示网页源代码”菜单项，就可以看到网页对应的 HTML 代码。 -![image-20210822094218269](https://gitee.com/jackfrued/mypic/raw/master/20210822094218.png) +![](https://github.com/jackfrued/mypic/raw/master/20210822094218.png) 代码的第`1`行是文档类型声明，第`2`行的``标签是整个页面根标签的开始标签，最后一行是根标签的结束标签``。``标签下面有两个子标签``和``，放在``标签下的内容会显示在浏览器窗口中，这部分内容是网页的主体；放在``标签下的内容不会显示在浏览器窗口中，但是却包含了页面重要的元信息，通常称之为网页的头部。HTML 页面大致的代码结构如下所示。 @@ -78,7 +78,7 @@ XPath还支持通配符用法，如下所示。 当然，如果不理解或不熟悉 XPath 语法，可以在浏览器的开发者工具中按照如下所示的方法查看元素的 XPath 语法，下图是在 Chrome 浏览器的开发者工具中查看豆瓣网电影详情信息中影片标题的 XPath 语法。 -![](https://gitee.com/jackfrued/mypic/raw/master/20210822093707.png) +![](https://github.com/jackfrued/mypic/raw/master/20210822093707.png) 实现 XPath 解析需要三方库`lxml` 的支持，可以使用下面的命令安装`lxml`。 diff --git "a/\347\254\25434\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-1.md" "b/\347\254\25434\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-1.md" index 1183e14..7d1c64a 100644 --- "a/\347\254\25434\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-1.md" +++ "b/\347\254\25434\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-1.md" @@ -10,7 +10,7 @@ 在程序中使用多线程技术通常都会带来不言而喻的好处，最主要的体现在提升程序的性能和改善用户体验，今天我们使用的软件几乎都用到了多线程技术，这一点可以利用系统自带的进程监控工具（如 macOS 中的“活动监视器”、Windows 中的“任务管理器”）来证实，如下图所示。 - + 这里，我们还需要跟大家再次强调两个概念：**并发**（concurrency）和**并行**（parallel）。**并发**通常是指同一时刻只能有一条指令执行，但是多个线程对应的指令被快速轮换地执行。比如一个处理器，它先执行线程 A 的指令一段时间，再执行线程 B 的指令一段时间，再切回到线程 A 执行一段时间。由于处理器执行指令的速度和切换的速度极快，人们完全感知不到计算机在这个过程中有多个线程切换上下文执行的操作，这就使得宏观上看起来多个线程在同时运行，但微观上其实只有一个线程在执行。**并行**是指同一时刻，有多条指令在多个处理器上同时执行，并行必须要依赖于多个处理器，不论是从宏观上还是微观上，多个线程可以在同一时刻一起执行的。很多时候，我们并不用严格区分并发和并行两个词，所以我们有时候也把 Python 中的多线程、多进程以及异步 I/O 都视为实现并发编程的手段，但实际上前面两者也可以实现并行编程，当然这里还有一个全局解释器锁（GIL）的问题，我们稍后讨论。 diff --git "a/\347\254\25437\350\257\276\357\274\232\345\271\266\345\217\221\347\274\226\347\250\213\345\234\250\347\210\254\350\231\253\344\270\255\347\232\204\345\272\224\347\224\250.md" "b/\347\254\25437\350\257\276\357\274\232\345\271\266\345\217\221\347\274\226\347\250\213\345\234\250\347\210\254\350\231\253\344\270\255\347\232\204\345\272\224\347\224\250.md" index 6662c24..63136eb 100644 --- "a/\347\254\25437\350\257\276\357\274\232\345\271\266\345\217\221\347\274\226\347\250\213\345\234\250\347\210\254\350\231\253\344\270\255\347\232\204\345\272\224\347\224\250.md" +++ "b/\347\254\25437\350\257\276\357\274\232\345\271\266\345\217\221\347\274\226\347\250\213\345\234\250\347\210\254\350\231\253\344\270\255\347\232\204\345\272\224\347\224\250.md" @@ -4,7 +4,7 @@ “360图片”网站的页面使用了 [Ajax](https://developer.mozilla.org/zh-CN/docs/Web/Guide/AJAX) 技术，这是很多网站都会使用的一种异步加载数据和局部刷新页面的技术。简单的说，页面上的图片都是通过 JavaScript 代码异步获取 JSON 数据并动态渲染生成的，而且整个页面还使用了瀑布式加载（一边向下滚动，一边加载更多的图片）。我们在浏览器的“开发者工具”中可以找到提供动态内容的数据接口，如下图所示，我们需要的图片信息就在服务器返回的 JSON 数据中。 - + 例如，要获取“美女”频道的图片，我们可以请求如下所示的URL，其中参数`ch`表示请求的频道，`=`后面的参数值`beauty`就代表了“美女”频道，参数`sn`相当于是页码，`0`表示第一页（共`30`张图片），`30`表示第二页，`60`表示第三页，以此类推。 diff --git "a/\347\254\25438\350\257\276\357\274\232\346\212\223\345\217\226\347\275\221\351\241\265\345\212\250\346\200\201\345\206\205\345\256\271.md" "b/\347\254\25438\350\257\276\357\274\232\346\212\223\345\217\226\347\275\221\351\241\265\345\212\250\346\200\201\345\206\205\345\256\271.md" index f04b86f..e1ace08 100644 --- "a/\347\254\25438\350\257\276\357\274\232\346\212\223\345\217\226\347\275\221\351\241\265\345\212\250\346\200\201\345\206\205\345\256\271.md" +++ "b/\347\254\25438\350\257\276\357\274\232\346\212\223\345\217\226\347\275\221\351\241\265\345\212\250\346\200\201\345\206\205\345\256\271.md" @@ -6,7 +6,7 @@ Selenium 是一个自动化测试工具，利用它可以驱动浏览器执行特定的行为，最终帮助爬虫开发者获取到网页的动态内容。简单的说，只要我们在浏览器窗口中能够看到的内容，都可以使用 Selenium 获取到，对于那些使用了 JavaScript 动态渲染技术的网站，Selenium 会是一个重要的选择。下面，我们还是以 Chrome 浏览器为例，来讲解 Selenium 的用法，大家需要先安装 Chrome 浏览器并下载它的驱动。Chrome 浏览器的驱动程序可以在[ChromeDriver官网](https://chromedriver.chromium.org/downloads)进行下载，驱动的版本要跟浏览器的版本对应，如果没有完全对应的版本，就选择版本代号最为接近的版本。 - + ### 使用Selenium @@ -136,7 +136,7 @@ browser.execute_script('document.documentElement.scrollTop = document.documentEl 有一些网站专门针对 Selenium 设置了反爬措施，因为使用 Selenium 驱动的浏览器，在控制台中可以看到如下所示的`webdriver`属性值为`true`，如果要绕过这项检查，可以在加载页面之前，先通过执行 JavaScript 代码将其修改为`undefined`。 - + 另一方面，我们还可以将浏览器窗口上的“Chrome正受到自动测试软件的控制”隐藏掉，完整的代码如下所示。 diff --git "a/\347\254\25439\350\257\276\357\274\232\347\210\254\350\231\253\346\241\206\346\236\266Scrapy\347\256\200\344\273\213.md" "b/\347\254\25439\350\257\276\357\274\232\347\210\254\350\231\253\346\241\206\346\236\266Scrapy\347\256\200\344\273\213.md" index 5b2ca62..377e88a 100644 --- "a/\347\254\25439\350\257\276\357\274\232\347\210\254\350\231\253\346\241\206\346\236\266Scrapy\347\256\200\344\273\213.md" +++ "b/\347\254\25439\350\257\276\357\274\232\347\210\254\350\231\253\346\241\206\346\236\266Scrapy\347\256\200\344\273\213.md" @@ -6,7 +6,7 @@ Scrapy 是基于 Python 的一个非常流行的网络爬虫框架，可以用来抓取 Web 站点并从页面中提取结构化的数据。下图展示了 Scrapy 的基本架构，其中包含了主要组件和系统的数据处理流程（图中带数字的红色箭头）。 -![](https://gitee.com/jackfrued/mypic/raw/master/20210824003638.png) +![](https://github.com/jackfrued/mypic/raw/master/20210824003638.png) #### Scrapy的组件 diff --git "a/\347\254\25440\350\257\276\357\274\232\345\205\263\347\263\273\345\236\213\346\225\260\346\215\256\345\272\223\345\222\214MySQL\346\246\202\350\277\260.md" "b/\347\254\25440\350\257\276\357\274\232\345\205\263\347\263\273\345\236\213\346\225\260\346\215\256\345\272\223\345\222\214MySQL\346\246\202\350\277\260.md" index 63dc6cf..1d3439c 100644 --- "a/\347\254\25440\350\257\276\357\274\232\345\205\263\347\263\273\345\236\213\346\225\260\346\215\256\345\272\223\345\222\214MySQL\346\246\202\350\277\260.md" +++ "b/\347\254\25440\350\257\276\357\274\232\345\205\263\347\263\273\345\236\213\346\225\260\346\215\256\345\272\223\345\222\214MySQL\346\246\202\350\277\260.md" @@ -20,7 +20,7 @@ **ER模型**，全称为**实体关系模型**（Entity-Relationship Model），由美籍华裔计算机科学家陈品山先生提出，是概念数据模型的高层描述方式，如下图所示。 - + - 实体 - 矩形框 - 属性 - 椭圆框 @@ -29,7 +29,7 @@ 实际项目开发中，我们可以利用数据库建模工具（如：PowerDesigner）来绘制概念数据模型（其本质就是 ER 模型），然后再设置好目标数据库系统，将概念模型转换成物理模型，最终生成创建二维表的 SQL（很多工具都可以根据我们设计的物理模型图以及设定的目标数据库来导出 SQL 或直接生成数据表）。 - ![](https://gitee.com/jackfrued/mypic/raw/master/20210826003212.png) + ![](https://github.com/jackfrued/mypic/raw/master/20210826003212.png) 5. 关系数据库产品。 - [Oracle](https://www.oracle.com/index.html) - 目前世界上使用最为广泛的数据库管理系统，作为一个通用的数据库系统，它具有完整的数据管理功能；作为一个关系数据库，它是一个完备关系的产品；作为分布式数据库，它实现了分布式处理的功能。在 Oracle 最新的 12c 版本中，还引入了多承租方架构，使用该架构可轻松部署和管理数据库云。 @@ -52,85 +52,85 @@ MySQL 在过去由于性能高、成本低、可靠性好，已经成为最流 1. 通过[官方网站](https://www.mysql.com/)提供的[下载链接](https://dev.mysql.com/downloads/windows/installer/8.0.html)下载“MySQL社区版服务器”安装程序，如下图所示，建议大家下载离线安装版的MySQL Installer。 - + 2. 运行 Installer，按照下面的步骤进行安装。 - 选择自定义安装。 - + - 选择需要安装的组件。 - + - 如果缺少依赖项，需要先安装依赖项。 - + - 准备开始安装。 - + - 安装完成。 - + - 准备执行配置向导。 - + 3. 执行安装后的配置向导。 - 配置服务器类型和网络。 - + - 配置认证方法（保护密码的方式）。 - + - 配置用户和角色。 - + - 配置Windows服务名以及是否开机自启。 - + - 配置日志。 - + - 配置高级选项。 - ACAC15B8633133B65476286A49BFBD7E + ACAC15B8633133B65476286A49BFBD7E - 应用配置。 - + 4. 可以在 Windows 系统的“服务”窗口中启动或停止 MySQL。 - + 5. 配置 PATH 环境变量，以便在命令行提示符窗口使用 MySQL 客户端工具。 - 打开 Windows 的“系统”窗口并点击“高级系统设置”。 - + - 在“系统属性”的“高级”窗口，点击“环境变量”按钮。 - + - 修改PATH环境变量，将MySQL安装路径下的`bin`文件夹的路径配置到PATH环境变量中。 - + - 配置完成后，可以尝试在“命令提示符”下使用 MySQL 的命令行工具。 - + #### Linux 环境 @@ -273,22 +273,22 @@ MySQL 在过去由于性能高、成本低、可靠性好，已经成为最流 - MySQL Workbench（官方工具） - + - Navicat for MySQL（界面简单友好） - + #### macOS环境 macOS 系统安装 MySQL 是比较简单的，只需要从刚才说到的官方网站下载 DMG 安装文件并运行就可以了，下载的时候需要根据自己使用的是 Intel 的芯片还是苹果的 M1 芯片选择下载链接，如下图所示。 - + 安装成功后，可以在“系统偏好设置”中找到“MySQL”，在如下所示的画面中，可以启动和停止 MySQL 服务器，也可以对 MySQL 核心文件的路径进行配置。 - + ### MySQL 基本命令 From c5c6973bf9885b05590aec70fe545efe6d2dd0eb Mon Sep 17 00:00:00 2001 From: jackfrued Date: Thu, 16 Jun 2022 12:09:06 +0800 Subject: [PATCH 06/17] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E4=BA=86README.md?= =?UTF-8?q?=E6=96=87=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 9196caa..1b26f8d 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,25 @@ 151.101.184.133 camo.githubusercontent.com ``` -下面是我创建的学习交流群（群号：789050736），欢迎加入一起学习共同进步。 +### 视频资源 - +1. [《Python零基础教程快速上手》](https://www.bilibili.com/video/BV1FT4y1R7sz) - Python基础部分的视频，因为随堂录制，有的时候声音会有点小，点赞过3000就为大家重新录制一套声音和画面都更好的精讲版视频。 +2. [《Python零基础数据库可视化教程》](https://www.bilibili.com/video/BV1dA411w7tu)- 数据库部分的视频，随堂录制，数据库部分讲得比较简单，后面还讲了一些做数据可视化系统的内容，我自己对这套视频不是很满意，点赞过2000之后就重新做一套面向数据分析师精讲数据库的视频，重点放在SQL和业务查询知识上，解决数据分析师日常提数问题。 +3. [《Scrapy爬虫框架教学》](https://www.bilibili.com/video/BV1QY411F7Vt)- 爬虫框架Scrapy教学视频，随堂录制，讲解了一个爬取淘宝商品信息的项目，有一点实用价值，爬虫本身并不是我感兴趣的内容，就将就看看吧。 + +### 文件资源 + +教程和视频中用到的文件、代码等内容，请统一访问百度网盘获取。 + +链接：https://pan.baidu.com/s/1NhWtYcpFzF72cxcsoDoXjQ?pwd=swg1，提取码：swg1。 + +### 交流大群 + +下面是我创建的学习交流群，欢迎加入一起学习共同进步。 + +1. 骆昊的Python学习群-1，群号：789050736，2000人大群。 +2. 骆昊的Python学习群-2，群号：837590310，2000人大群。 +3. 骆昊的Python学习群-3，群号：784430256，1000人大群。 + + From 558049fd0da2e9c5f3bdef1876f99f4bb78a68c9 Mon Sep 17 00:00:00 2001 From: jackfrued Date: Thu, 16 Jun 2022 12:10:02 +0800 Subject: [PATCH 07/17] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E4=BA=86README.md?= =?UTF-8?q?=E6=96=87=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1b26f8d..60256f7 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ 教程和视频中用到的文件、代码等内容，请统一访问百度网盘获取。 -链接：https://pan.baidu.com/s/1NhWtYcpFzF72cxcsoDoXjQ?pwd=swg1，提取码：swg1。 +链接：，提取码：swg1。 ### 交流大群 From 965af7c53f4f34d3e392f8d02218089ef2a482e9 Mon Sep 17 00:00:00 2001 From: jackfrued Date: Mon, 6 Feb 2023 00:54:41 +0800 Subject: [PATCH 08/17] =?UTF-8?q?=E6=9B=B4=E6=AD=A3=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E4=B8=AD=E7=9A=84=E9=97=AE=E9=A2=98=E5=92=8C=E7=AC=94=E8=AF=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 0 README.md | 0 ...\274\232\345\210\235\350\257\206Python.md" | 0 ...\270\252Python\347\250\213\345\272\217.md" | 0 ...40\344\271\213\345\217\230\351\207\217.md" | 0 ...13\350\277\220\347\256\227\347\254\246.md" | 0 ...06\346\224\257\347\273\223\346\236\204.md" | 0 ...52\347\216\257\347\273\223\346\236\204.md" | 0 ...04\347\232\204\345\272\224\347\224\250.md" | 0 ...04\344\271\213\345\210\227\350\241\250.md" | 0 ...04\344\271\213\345\205\203\347\273\204.md" | 0 ...13\345\255\227\347\254\246\344\270\262.md" | 0 ...04\344\271\213\351\233\206\345\220\210.md" | 0 ...04\344\271\213\345\255\227\345\205\270.md" | 0 ...60\345\222\214\346\250\241\345\235\227.md" | 0 ...60\347\232\204\345\272\224\347\224\250.md" | 0 ...77\347\224\250\350\277\233\351\230\266.md" | 0 ...30\347\272\247\345\272\224\347\224\250.md" | 0 ...26\347\250\213\345\205\245\351\227\250.md" | 0 ...26\347\250\213\350\277\233\351\230\266.md" | 0 ...26\347\250\213\345\272\224\347\224\250.md" | 2 +- ...06\345\272\223\345\210\235\346\216\242.md" | 0 ...02\345\270\270\345\244\204\347\220\206.md" | 0 ...15\345\272\217\345\210\227\345\214\226.md" | 0 ...345\206\231CSV\346\226\207\344\273\266.md" | 0 ...206\231Excel\346\226\207\344\273\266-1.md" | 0 ...206\231Excel\346\226\207\344\273\266-2.md" | 0 ...\207\344\273\266\345\222\214PowerPoint.md" | 0 ...344\275\234PDF\346\226\207\344\273\266.md" | 0 ...04\347\220\206\345\233\276\345\203\217.md" | 0 ...66\345\222\214\347\237\255\344\277\241.md" | 0 ...17\347\232\204\345\272\224\347\224\250.md" | 0 ...07\351\233\206\346\246\202\350\277\260.md" | 0 ...21\347\273\234\350\265\204\346\272\220.md" | 0 ...46\236\220HTML\351\241\265\351\235\242.md" | 0 ...\345\217\221\347\274\226\347\250\213-1.md" | 0 ...\345\217\221\347\274\226\347\250\213-2.md" | 0 ...\345\217\221\347\274\226\347\250\213-3.md" | 0 ...55\347\232\204\345\272\224\347\224\250.md" | 0 ...50\346\200\201\345\206\205\345\256\271.md" | 0 ...\236\266Scrapy\347\256\200\344\273\213.md" | 0 ...5\222\214MySQL\346\246\202\350\277\260.md" | 0 ...350\257\246\350\247\243\344\271\213DDL.md" | 2 +- ...350\257\246\350\247\243\344\271\213DML.md" | 2 +- ...350\257\246\350\247\243\344\271\213DQL.md" | 757 ++++++++++-------- ...350\257\246\350\247\243\344\271\213DCL.md" | 2 +- ...5\350\257\276.\347\264\242\345\274\225.md" | 2 +- ...5\346\225\260+\350\277\207\347\250\213.md" | 2 +- ...QL\346\226\260\347\211\271\346\200\247.md" | 2 +- ...QL\346\225\260\346\215\256\345\272\223.md" | 2 +- 50 files changed, 409 insertions(+), 364 deletions(-) mode change 100644 => 100755 .gitignore mode change 100644 => 100755 README.md mode change 100644 => 100755 "\347\254\25401\350\257\276\357\274\232\345\210\235\350\257\206Python.md" mode change 100644 => 100755 "\347\254\25402\350\257\276\357\274\232\347\254\254\344\270\200\344\270\252Python\347\250\213\345\272\217.md" mode change 100644 => 100755 "\347\254\25403\350\257\276\357\274\232Python\350\257\255\350\250\200\345\205\203\347\264\240\344\271\213\345\217\230\351\207\217.md" mode change 100644 => 100755 "\347\254\25404\350\257\276\357\274\232Python\350\257\255\350\250\200\345\205\203\347\264\240\344\271\213\350\277\220\347\256\227\347\254\246.md" mode change 100644 => 100755 "\347\254\25405\350\257\276\357\274\232\345\210\206\346\224\257\347\273\223\346\236\204.md" mode change 100644 => 100755 "\347\254\25406\350\257\276\357\274\232\345\276\252\347\216\257\347\273\223\346\236\204.md" mode change 100644 => 100755 "\347\254\25407\350\257\276\357\274\232\345\210\206\346\224\257\345\222\214\345\276\252\347\216\257\347\273\223\346\236\204\347\232\204\345\272\224\347\224\250.md" mode change 100644 => 100755 "\347\254\25408\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\210\227\350\241\250.md" mode change 100644 => 100755 "\347\254\25409\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\205\203\347\273\204.md" mode change 100644 => 100755 "\347\254\25410\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\347\254\246\344\270\262.md" mode change 100644 => 100755 "\347\254\25411\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\351\233\206\345\220\210.md" mode change 100644 => 100755 "\347\254\25412\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\345\205\270.md" mode change 100644 => 100755 "\347\254\25413\350\257\276\357\274\232\345\207\275\346\225\260\345\222\214\346\250\241\345\235\227.md" mode change 100644 => 100755 "\347\254\25414\350\257\276\357\274\232\345\207\275\346\225\260\347\232\204\345\272\224\347\224\250.md" mode change 100644 => 100755 "\347\254\25415\350\257\276\357\274\232\345\207\275\346\225\260\344\275\277\347\224\250\350\277\233\351\230\266.md" mode change 100644 => 100755 "\347\254\25416\350\257\276\357\274\232\345\207\275\346\225\260\347\232\204\351\253\230\347\272\247\345\272\224\347\224\250.md" mode change 100644 => 100755 "\347\254\25417\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\345\205\245\351\227\250.md" mode change 100644 => 100755 "\347\254\25418\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\350\277\233\351\230\266.md" mode change 100644 => 100755 "\347\254\25419\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\345\272\224\347\224\250.md" mode change 100644 => 100755 "\347\254\25420\350\257\276\357\274\232Python\346\240\207\345\207\206\345\272\223\345\210\235\346\216\242.md" mode change 100644 => 100755 "\347\254\25421\350\257\276\357\274\232\346\226\207\344\273\266\350\257\273\345\206\231\345\222\214\345\274\202\345\270\270\345\244\204\347\220\206.md" mode change 100644 => 100755 "\347\254\25422\350\257\276\357\274\232\345\257\271\350\261\241\347\232\204\345\272\217\345\210\227\345\214\226\345\222\214\345\217\215\345\272\217\345\210\227\345\214\226.md" mode change 100644 => 100755 "\347\254\25423\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231CSV\346\226\207\344\273\266.md" mode change 100644 => 100755 "\347\254\25424\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266-1.md" mode change 100644 => 100755 "\347\254\25425\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266-2.md" mode change 100644 => 100755 "\347\254\25426\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234Word\346\226\207\344\273\266\345\222\214PowerPoint.md" mode change 100644 => 100755 "\347\254\25427\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234PDF\346\226\207\344\273\266.md" mode change 100644 => 100755 "\347\254\25428\350\257\276\357\274\232\347\224\250Python\345\244\204\347\220\206\345\233\276\345\203\217.md" mode change 100644 => 100755 "\347\254\25429\350\257\276\357\274\232\347\224\250Python\345\217\221\351\200\201\351\202\256\344\273\266\345\222\214\347\237\255\344\277\241.md" mode change 100644 => 100755 "\347\254\25430\350\257\276\357\274\232\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217\347\232\204\345\272\224\347\224\250.md" mode change 100644 => 100755 "\347\254\25431\350\257\276\357\274\232\347\275\221\347\273\234\346\225\260\346\215\256\351\207\207\351\233\206\346\246\202\350\277\260.md" mode change 100644 => 100755 "\347\254\25432\350\257\276\357\274\232\347\224\250Python\350\216\267\345\217\226\347\275\221\347\273\234\350\265\204\346\272\220.md" mode change 100644 => 100755 "\347\254\25433\350\257\276\357\274\232\347\224\250Python\350\247\243\346\236\220HTML\351\241\265\351\235\242.md" mode change 100644 => 100755 "\347\254\25434\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-1.md" mode change 100644 => 100755 "\347\254\25435\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-2.md" mode change 100644 => 100755 "\347\254\25436\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-3.md" mode change 100644 => 100755 "\347\254\25437\350\257\276\357\274\232\345\271\266\345\217\221\347\274\226\347\250\213\345\234\250\347\210\254\350\231\253\344\270\255\347\232\204\345\272\224\347\224\250.md" mode change 100644 => 100755 "\347\254\25438\350\257\276\357\274\232\346\212\223\345\217\226\347\275\221\351\241\265\345\212\250\346\200\201\345\206\205\345\256\271.md" mode change 100644 => 100755 "\347\254\25439\350\257\276\357\274\232\347\210\254\350\231\253\346\241\206\346\236\266Scrapy\347\256\200\344\273\213.md" mode change 100644 => 100755 "\347\254\25440\350\257\276\357\274\232\345\205\263\347\263\273\345\236\213\346\225\260\346\215\256\345\272\223\345\222\214MySQL\346\246\202\350\277\260.md" mode change 100644 => 100755 "\347\254\25441\350\257\276.SQL\350\257\246\350\247\243\344\271\213DDL.md" mode change 100644 => 100755 "\347\254\25442\350\257\276.SQL\350\257\246\350\247\243\344\271\213DML.md" mode change 100644 => 100755 "\347\254\25443\350\257\276.SQL\350\257\246\350\247\243\344\271\213DQL.md" mode change 100644 => 100755 "\347\254\25444\350\257\276.SQL\350\257\246\350\247\243\344\271\213DCL.md" mode change 100644 => 100755 "\347\254\25445\350\257\276.\347\264\242\345\274\225.md" mode change 100644 => 100755 "\347\254\25446\350\257\276.\350\247\206\345\233\276+\345\207\275\346\225\260+\350\277\207\347\250\213.md" mode change 100644 => 100755 "\347\254\25447\350\257\276.MySQL\346\226\260\347\211\271\346\200\247.md" mode change 100644 => 100755 "\347\254\25448\350\257\276.Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" diff --git a/.gitignore b/.gitignore old mode 100644 new mode 100755 diff --git a/README.md b/README.md old mode 100644 new mode 100755 diff --git "a/\347\254\25401\350\257\276\357\274\232\345\210\235\350\257\206Python.md" "b/\347\254\25401\350\257\276\357\274\232\345\210\235\350\257\206Python.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25402\350\257\276\357\274\232\347\254\254\344\270\200\344\270\252Python\347\250\213\345\272\217.md" "b/\347\254\25402\350\257\276\357\274\232\347\254\254\344\270\200\344\270\252Python\347\250\213\345\272\217.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25403\350\257\276\357\274\232Python\350\257\255\350\250\200\345\205\203\347\264\240\344\271\213\345\217\230\351\207\217.md" "b/\347\254\25403\350\257\276\357\274\232Python\350\257\255\350\250\200\345\205\203\347\264\240\344\271\213\345\217\230\351\207\217.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25404\350\257\276\357\274\232Python\350\257\255\350\250\200\345\205\203\347\264\240\344\271\213\350\277\220\347\256\227\347\254\246.md" "b/\347\254\25404\350\257\276\357\274\232Python\350\257\255\350\250\200\345\205\203\347\264\240\344\271\213\350\277\220\347\256\227\347\254\246.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25405\350\257\276\357\274\232\345\210\206\346\224\257\347\273\223\346\236\204.md" "b/\347\254\25405\350\257\276\357\274\232\345\210\206\346\224\257\347\273\223\346\236\204.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25406\350\257\276\357\274\232\345\276\252\347\216\257\347\273\223\346\236\204.md" "b/\347\254\25406\350\257\276\357\274\232\345\276\252\347\216\257\347\273\223\346\236\204.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25407\350\257\276\357\274\232\345\210\206\346\224\257\345\222\214\345\276\252\347\216\257\347\273\223\346\236\204\347\232\204\345\272\224\347\224\250.md" "b/\347\254\25407\350\257\276\357\274\232\345\210\206\346\224\257\345\222\214\345\276\252\347\216\257\347\273\223\346\236\204\347\232\204\345\272\224\347\224\250.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25408\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\210\227\350\241\250.md" "b/\347\254\25408\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\210\227\350\241\250.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25409\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\205\203\347\273\204.md" "b/\347\254\25409\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\205\203\347\273\204.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25410\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\347\254\246\344\270\262.md" "b/\347\254\25410\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\347\254\246\344\270\262.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25411\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\351\233\206\345\220\210.md" "b/\347\254\25411\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\351\233\206\345\220\210.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25412\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\345\205\270.md" "b/\347\254\25412\350\257\276\357\274\232\345\270\270\347\224\250\346\225\260\346\215\256\347\273\223\346\236\204\344\271\213\345\255\227\345\205\270.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25413\350\257\276\357\274\232\345\207\275\346\225\260\345\222\214\346\250\241\345\235\227.md" "b/\347\254\25413\350\257\276\357\274\232\345\207\275\346\225\260\345\222\214\346\250\241\345\235\227.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25414\350\257\276\357\274\232\345\207\275\346\225\260\347\232\204\345\272\224\347\224\250.md" "b/\347\254\25414\350\257\276\357\274\232\345\207\275\346\225\260\347\232\204\345\272\224\347\224\250.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25415\350\257\276\357\274\232\345\207\275\346\225\260\344\275\277\347\224\250\350\277\233\351\230\266.md" "b/\347\254\25415\350\257\276\357\274\232\345\207\275\346\225\260\344\275\277\347\224\250\350\277\233\351\230\266.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25416\350\257\276\357\274\232\345\207\275\346\225\260\347\232\204\351\253\230\347\272\247\345\272\224\347\224\250.md" "b/\347\254\25416\350\257\276\357\274\232\345\207\275\346\225\260\347\232\204\351\253\230\347\272\247\345\272\224\347\224\250.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25417\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\345\205\245\351\227\250.md" "b/\347\254\25417\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\345\205\245\351\227\250.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25418\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\350\277\233\351\230\266.md" "b/\347\254\25418\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\350\277\233\351\230\266.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25419\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\345\272\224\347\224\250.md" "b/\347\254\25419\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\345\272\224\347\224\250.md" old mode 100644 new mode 100755 index e99062b..863a027 --- "a/\347\254\25419\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\345\272\224\347\224\250.md" +++ "b/\347\254\25419\350\257\276\357\274\232\351\235\242\345\220\221\345\257\271\350\261\241\347\274\226\347\250\213\345\272\224\347\224\250.md" @@ -1,4 +1,4 @@ -## 第18课：面向对象编程应用 +## 第19课：面向对象编程应用 面向对象编程对初学者来说不难理解但很难应用，虽然我们为大家总结过面向对象的三步走方法（定义类、创建对象、给对象发消息），但是说起来容易做起来难。**大量的编程练习**和**阅读优质的代码**可能是这个阶段最能够帮助到大家的两件事情。接下来我们还是通过经典的案例来剖析面向对象编程的知识，同时也通过这些案例为大家讲解如何运用之前学过的Python知识。 diff --git "a/\347\254\25420\350\257\276\357\274\232Python\346\240\207\345\207\206\345\272\223\345\210\235\346\216\242.md" "b/\347\254\25420\350\257\276\357\274\232Python\346\240\207\345\207\206\345\272\223\345\210\235\346\216\242.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25421\350\257\276\357\274\232\346\226\207\344\273\266\350\257\273\345\206\231\345\222\214\345\274\202\345\270\270\345\244\204\347\220\206.md" "b/\347\254\25421\350\257\276\357\274\232\346\226\207\344\273\266\350\257\273\345\206\231\345\222\214\345\274\202\345\270\270\345\244\204\347\220\206.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25422\350\257\276\357\274\232\345\257\271\350\261\241\347\232\204\345\272\217\345\210\227\345\214\226\345\222\214\345\217\215\345\272\217\345\210\227\345\214\226.md" "b/\347\254\25422\350\257\276\357\274\232\345\257\271\350\261\241\347\232\204\345\272\217\345\210\227\345\214\226\345\222\214\345\217\215\345\272\217\345\210\227\345\214\226.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25423\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231CSV\346\226\207\344\273\266.md" "b/\347\254\25423\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231CSV\346\226\207\344\273\266.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25424\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266-1.md" "b/\347\254\25424\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266-1.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25425\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266-2.md" "b/\347\254\25425\350\257\276\357\274\232\347\224\250Python\350\257\273\345\206\231Excel\346\226\207\344\273\266-2.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25426\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234Word\346\226\207\344\273\266\345\222\214PowerPoint.md" "b/\347\254\25426\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234Word\346\226\207\344\273\266\345\222\214PowerPoint.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25427\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234PDF\346\226\207\344\273\266.md" "b/\347\254\25427\350\257\276\357\274\232\347\224\250Python\346\223\215\344\275\234PDF\346\226\207\344\273\266.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25428\350\257\276\357\274\232\347\224\250Python\345\244\204\347\220\206\345\233\276\345\203\217.md" "b/\347\254\25428\350\257\276\357\274\232\347\224\250Python\345\244\204\347\220\206\345\233\276\345\203\217.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25429\350\257\276\357\274\232\347\224\250Python\345\217\221\351\200\201\351\202\256\344\273\266\345\222\214\347\237\255\344\277\241.md" "b/\347\254\25429\350\257\276\357\274\232\347\224\250Python\345\217\221\351\200\201\351\202\256\344\273\266\345\222\214\347\237\255\344\277\241.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25430\350\257\276\357\274\232\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217\347\232\204\345\272\224\347\224\250.md" "b/\347\254\25430\350\257\276\357\274\232\346\255\243\345\210\231\350\241\250\350\276\276\345\274\217\347\232\204\345\272\224\347\224\250.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25431\350\257\276\357\274\232\347\275\221\347\273\234\346\225\260\346\215\256\351\207\207\351\233\206\346\246\202\350\277\260.md" "b/\347\254\25431\350\257\276\357\274\232\347\275\221\347\273\234\346\225\260\346\215\256\351\207\207\351\233\206\346\246\202\350\277\260.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25432\350\257\276\357\274\232\347\224\250Python\350\216\267\345\217\226\347\275\221\347\273\234\350\265\204\346\272\220.md" "b/\347\254\25432\350\257\276\357\274\232\347\224\250Python\350\216\267\345\217\226\347\275\221\347\273\234\350\265\204\346\272\220.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25433\350\257\276\357\274\232\347\224\250Python\350\247\243\346\236\220HTML\351\241\265\351\235\242.md" "b/\347\254\25433\350\257\276\357\274\232\347\224\250Python\350\247\243\346\236\220HTML\351\241\265\351\235\242.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25434\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-1.md" "b/\347\254\25434\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-1.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25435\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-2.md" "b/\347\254\25435\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-2.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25436\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-3.md" "b/\347\254\25436\350\257\276\357\274\232Python\344\270\255\347\232\204\345\271\266\345\217\221\347\274\226\347\250\213-3.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25437\350\257\276\357\274\232\345\271\266\345\217\221\347\274\226\347\250\213\345\234\250\347\210\254\350\231\253\344\270\255\347\232\204\345\272\224\347\224\250.md" "b/\347\254\25437\350\257\276\357\274\232\345\271\266\345\217\221\347\274\226\347\250\213\345\234\250\347\210\254\350\231\253\344\270\255\347\232\204\345\272\224\347\224\250.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25438\350\257\276\357\274\232\346\212\223\345\217\226\347\275\221\351\241\265\345\212\250\346\200\201\345\206\205\345\256\271.md" "b/\347\254\25438\350\257\276\357\274\232\346\212\223\345\217\226\347\275\221\351\241\265\345\212\250\346\200\201\345\206\205\345\256\271.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25439\350\257\276\357\274\232\347\210\254\350\231\253\346\241\206\346\236\266Scrapy\347\256\200\344\273\213.md" "b/\347\254\25439\350\257\276\357\274\232\347\210\254\350\231\253\346\241\206\346\236\266Scrapy\347\256\200\344\273\213.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25440\350\257\276\357\274\232\345\205\263\347\263\273\345\236\213\346\225\260\346\215\256\345\272\223\345\222\214MySQL\346\246\202\350\277\260.md" "b/\347\254\25440\350\257\276\357\274\232\345\205\263\347\263\273\345\236\213\346\225\260\346\215\256\345\272\223\345\222\214MySQL\346\246\202\350\277\260.md" old mode 100644 new mode 100755 diff --git "a/\347\254\25441\350\257\276.SQL\350\257\246\350\247\243\344\271\213DDL.md" "b/\347\254\25441\350\257\276.SQL\350\257\246\350\247\243\344\271\213DDL.md" old mode 100644 new mode 100755 index 9bd11f7..55c5b51 --- "a/\347\254\25441\350\257\276.SQL\350\257\246\350\247\243\344\271\213DDL.md" +++ "b/\347\254\25441\350\257\276.SQL\350\257\246\350\247\243\344\271\213DDL.md" @@ -1,4 +1,4 @@ -## SQL详解之DDL +## 第41课：SQL详解之DDL 我们通常可以将 SQL 分为四类，分别是 DDL（数据定义语言）、DML（数据操作语言）、DQL（数据查询语言）和 DCL（数据控制语言）。DDL 主要用于创建、删除、修改数据库中的对象，比如创建、删除和修改二维表，核心的关键字包括`create`、`drop`和`alter`；DML 主要负责数据的插入、删除和更新，关键词包括`insert`、`delete`和`update`；DQL 负责数据查询，最重要的一个关键词是`select`；DCL 通常用于授予和召回权限，核心关键词是`grant`和`revoke`。 diff --git "a/\347\254\25442\350\257\276.SQL\350\257\246\350\247\243\344\271\213DML.md" "b/\347\254\25442\350\257\276.SQL\350\257\246\350\247\243\344\271\213DML.md" old mode 100644 new mode 100755 index 78f28db..a7e83ed --- "a/\347\254\25442\350\257\276.SQL\350\257\246\350\247\243\344\271\213DML.md" +++ "b/\347\254\25442\350\257\276.SQL\350\257\246\350\247\243\344\271\213DML.md" @@ -1,4 +1,4 @@ -## SQL详解之DML +## 第42课：SQL详解之DML 我们接着上一课中创建的学校选课系统数据库，为大家讲解 DML 的使用。DML 可以帮助将数据插入到二维表（`insert`操作）、从二维表删除数据（`delete`操作）以及更新二维表的数据（`update`操作）。在执行 DML 之前，我们先通过下面的`use`命令切换到`school`数据库。 diff --git "a/\347\254\25443\350\257\276.SQL\350\257\246\350\247\243\344\271\213DQL.md" "b/\347\254\25443\350\257\276.SQL\350\257\246\350\247\243\344\271\213DQL.md" old mode 100644 new mode 100755 index 480d1c7..418f050 --- "a/\347\254\25443\350\257\276.SQL\350\257\246\350\247\243\344\271\213DQL.md" +++ "b/\347\254\25443\350\257\276.SQL\350\257\246\350\247\243\344\271\213DQL.md" @@ -1,370 +1,415 @@ -## SQL详解之DQL +## 第43课：SQL详解之DQL 接下来，我们利用之前创建的学校选课系统数据库，为大家讲解 DQL 的应用。无论对于开发人员还是数据分析师，DQL 都是非常重要的，它关系着我们能否从关系数据库中获取我们需要的数据。建议大家把上上一节课中建库建表的 DDL 以及 上一节课中插入数据的 DML 重新执行一次，确保表和数据跟没有问题再执行下面的操作。 ```SQL use `school`; --- 查询所有学生的所有信息 --- 说明：实际工作中不建议使用 select * 的方式进行查询 -select * - from tb_student; - --- 查询学生的学号、姓名和籍贯 -select stu_id, - stu_name, - stu_addr - from tb_student; +-- 01. 查询所有学生的所有信息 +select * + from tb_student; -select stu_id as 学号, - stu_name as 姓名, - stu_addr as 籍贯 - from tb_student; - --- 查询所有课程的名称及学分 -select cou_name as 课程名称, - cou_credit as 学分 - from tb_course; - --- 查询所有女学生的姓名和出生日期 -select stu_name, - stu_birth - from tb_student - where stu_sex=0; - --- 查询籍贯为“四川成都”的女学生的姓名和出生日期 -select stu_name, - stu_birth - from tb_student - where stu_sex=0 - and stu_addr='四川成都'; - --- 查询籍贯为“四川成都”或者性别是女的学生 -select stu_name, - stu_birth - from tb_student - where stu_sex=0 - or stu_addr='四川成都'; - --- 查询所有80后学生的姓名、性别和出生日期 --- 方法一： -select stu_name, - stu_sex, - stu_birth - from tb_student - where stu_birth >= '1980-1-1' - and stu_birth <= '1989-12-31'; - --- 方法二： -select stu_name, - stu_sex, - stu_birth - from tb_student - where stu_birth between '1980-1-1' and '1989-12-31'; - --- 查询学分大于2的课程的名称和学分 -select cou_name, - cou_credit - from tb_course - where cou_credit > 2; - --- 查询学分是奇数的课程的名称和学分 -select cou_name, - cou_credit - from tb_course - where cou_credit % 2 <> 0; - --- 查询选择选了1111的课程考试成绩在90分以上的学生学号 -select stu_id - from tb_record - where cou_id = 1111 - and score > 90; +select stu_id + , stu_name + , stu_sex + , stu_birth + , stu_addr + , col_id + from tb_student; + +-- 02. 查询学生的学号、姓名和籍贯(投影和别名) +select stu_id as 学号 + , stu_name as 姓名 + , stu_addr as 籍贯 + from tb_student; + +-- 03. 查询所有课程的名称及学分(投影和别名) +select cou_name as 课程名称 + , cou_credit as 学分 + from tb_course; + +-- 04. 查询所有女学生的姓名和出生日期(数据筛选) +select stu_name + , stu_birth + from tb_student + where stu_sex = 0; + +-- 05. 查询籍贯为“四川成都”的女学生的姓名和出生日期(数据筛选) +select stu_name + , stu_birth + from tb_student + where stu_sex = 0 and stu_addr = '四川成都'; + +-- 06. 查询籍贯为“四川成都”或者性别是女的学生(数据筛选) +select stu_name + , stu_birth + from tb_student + where stu_sex = 0 or stu_addr = '四川成都'; + +-- 07. 查询所有80后学生的姓名、性别和出生日期(数据筛选) +select stu_name + , stu_sex + , stu_birth + from tb_student + where '1980-1-1' <= stu_birth and stu_birth <= '1989-12-31'; + +select stu_name + , stu_sex + , stu_birth + from tb_student + where stu_birth between '1980-1-1' and '1989-12-31'; + +-- MySQL方言 +select stu_name + , if(stu_sex, '男', '女') as stu_sex + , stu_birth + from tb_student + where stu_birth between '1980-1-1' and '1989-12-31'; + +select stu_name + , case stu_sex + when 1 then '男' + else '女' + end as stu_sex + , stu_birth + from tb_student + where stu_birth between '1980-1-1' and '1989-12-31'; + +-- 08. 查询学分大于2分的课程名称和学分(数据筛选) +select cou_name + , cou_credit + from tb_course + where cou_credit > 2; + +-- 09. 查询学分是奇数的课程的名称和学分(数据筛选) +select cou_name + , cou_credit + from tb_course + where cou_credit mod 2 <> 0; + +-- 10. 查询选择选了1111的课程考试成绩在90分以上的学生学号(数据筛选) +select stu_id + from tb_record + where cou_id = 1111 and score > 90; + +-- 11. 查询名字叫“杨过”的学生的姓名和性别 +select stu_name + , stu_sex + from tb_student + where stu_name = '杨过'; + +-- 12. 查询姓“杨”的学生姓名和性别(模糊查询) +-- wild card - 通配符 - % - 代表零个或任意多个字符 +select stu_name + , stu_sex + from tb_student + where stu_name like '杨%'; + +-- 13. 查询姓“杨”名字两个字的学生姓名和性别(模糊查询) +-- wild card - 通配符 - _ - 精确匹配一个字符 +select stu_name + , stu_sex + from tb_student + where stu_name like '杨_'; + +-- 14. 查询姓“杨”名字三个字的学生姓名和性别(模糊查询) +select stu_name + , stu_sex + from tb_student + where stu_name like '杨__'; + +-- 15. 查询名字中有“不”字或“嫣”字的学生的姓名(模糊查询) +select stu_name + from tb_student + where stu_name like '%不%' or stu_name like '%嫣%'; --- 查询姓“杨”的学生姓名和性别(模糊) --- % 可以匹配零个或任意多个字符 -select stu_name, - stu_sex - from tb_student - where stu_name like '杨%'; - --- 查询姓“杨”名字两个字的学生姓名和性别(模糊) --- _ 可以匹配一个字符 -select stu_name, - stu_sex - from tb_student - where stu_name like '杨_'; - --- 查询姓“杨”名字三个字的学生姓名和性别(模糊) -select stu_name, - stu_sex - from tb_student - where stu_name like '杨__'; - --- 查询名字中有“不”字或“嫣”字的学生的姓名(模糊) --- 方法一： -select stu_name, - stu_sex - from tb_student - where stu_name like '%不%' - or stu_name like '%嫣%'; - --- 方法二： -select stu_name, - stu_sex - from tb_student - where stu_name like '%不%' +select stu_name + from tb_student + where stu_name like '%不%' union -select stu_name, - stu_sex - from tb_student - where stu_name like '%嫣%'; - --- 查询姓“杨”或姓“林”名字三个字的学生的姓名 -select stu_name, - stu_sex - from tb_student - where stu_name regexp '^[杨林][\\u4e00-\\u9fa5]{2}$'; - --- 查询没有录入籍贯的学生姓名 -select stu_name - from tb_student - where stu_addr = '' - or stu_addr is null; - --- 查询录入了籍贯的学生姓名 -select stu_name - from tb_student - where stu_addr <> '' - and stu_addr is not null; - --- 查询学生选课的所有日期 -select distinct sel_date - from tb_record; - --- 查询学生的籍贯 -select distinct stu_addr - from tb_student - where stu_addr <> '' - and stu_addr is not null; - --- 查询学院编号为1的学生姓名、性别和生日按年龄从大到小排列 --- asc - 升序（从小到大，默认），desc - 降序（从大到小） - select stu_name, - stu_sex, - stu_birth - from tb_student - where col_id = 1 -order by stu_sex asc, - stu_birth asc; - --- 补充：将上面的性别处理成“男”或“女”，将生日换算成年龄 - select stu_name as 姓名, - if(stu_sex, '男', '女') as 性别, - floor(datediff(curdate(), stu_birth) / 365) as 年龄 - from tb_student - where col_id = 1 -order by stu_sex asc, - 年龄 desc; - --- 查询年龄最大的学生的出生日期 -select min(stu_birth) - from tb_student; - --- 查询年龄最小的学生的出生日期 -select max(stu_birth) - from tb_student; - --- 查询学号为1001的学生一共选了几门课 -select count(*) - from tb_record - where stu_id = 1001; - --- 查询学号为1001的学生考试成绩的平均分 -select round(avg(score), 1) as 平均分 - from tb_record - where stu_id = 1001; - --- 查询学号为1001的学生考试成绩的平均分，如果有null值，null值算0分 --- 方法一： -select sum(score) / count(*) - from tb_record - where stu_id = 1001; +select stu_name + from tb_student + where stu_name like '%嫣%'; + +update tb_student + set stu_name = '岳不嫣' + where stu_id = 1572; + +select stu_name + from tb_student + where stu_name like '%不%' + union all +select stu_name + from tb_student + where stu_name like '%嫣%'; + +-- 16. 查询姓“杨”或姓“林”名字三个字的学生的姓名(正则表达式模糊查询) +-- regular expression +select stu_name + from tb_student + where stu_name regexp '[杨林][\\u4e00-\\u9fa5]{2}'; + +-- 17. 查询没有录入籍贯的学生姓名(空值处理) +select stu_name + from tb_student + where stu_addr is null or trim(stu_addr) = ''; + +update tb_student + set stu_addr = ' ' + where stu_id = 1572; + +-- 18. 查询录入了籍贯的学生姓名(空值处理) +select stu_name + from tb_student + where stu_addr is not null and trim(stu_addr) <> ''; + +-- 19. 查询学生选课的所有日期(去重) +select distinct sel_date + from tb_record; + +-- 20. 查询学生的籍贯(空值处理和去重) +select distinct stu_addr + from tb_student + where stu_addr is not null and trim(stu_addr) <> ''; + +-- 21. 查询男学生的姓名和生日按年龄从大到小排列(排序) +-- ascending / descending +select stu_name + , stu_birth + from tb_student + where stu_sex = 1 + order by stu_birth asc; + +-- 22. 将上面查询中的生日换算成年龄(日期函数、数值函数) +-- 获取当前日期：curdate() +-- 计算时间差：timestampdiff(unit, date1, date2) +select stu_name + , timestampdiff(year, stu_birth, curdate()) as stu_age + from tb_student + where stu_sex = 1 + order by stu_age desc; + +-- 聚合函数：max / min / avg / sum / count / std / variance +-- 聚合函数会自动忽略掉null +-- 23. 查询年龄最大的学生的出生日期(聚合函数) +select min(stu_birth) + from tb_student; + +-- 24. 查询年龄最小的学生的出生日期(聚合函数) +select max(stu_birth) + from tb_student; + +-- 25. 查询编号为1111的课程考试成绩的最高分(聚合函数) +select max(score) + from tb_record + where cou_id = 1111; + +-- 26. 查询学号为1001的学生考试成绩的最低分(聚合函数) +select min(score) + from tb_record + where stu_id = 1001; + +-- 27. 查询学号为1001的学生考试成绩的平均分和标准差(聚合函数) +-- 四舍五入函数：round(num, n) +select round(avg(score), 1) as avg_score + , round(std(score), 4) as std_score + from tb_record + where stu_id = 1001; + +-- 28. 查询学号为1001的学生考试成绩的平均分，如果有null值，null值算0分(聚合函数) +select sum(score) / count(*) + from tb_record + where stu_id = 1001; + +-- 29. 查询男女学生的人数(分组和聚合函数) +select case stu_sex when 1 then '男' else '女' end as stu_sex + , count(*) as total + from tb_student + group by stu_sex; + +-- 30. 查询每个学院学生人数(分组和聚合函数) +select col_id + , count(*) as total + from tb_student + group by col_id + with rollup; + +-- 31. 查询每个学院男女学生人数(分组和聚合函数) +select col_id + , case stu_sex when 1 then '男' else '女' end as stu_sex + , count(*) as total + from tb_student + group by col_id, stu_sex; + +-- 32. 查询选课学生的学号和平均成绩(分组和聚合函数) +select stu_id + , round(avg(score), 1) as avg_score + from tb_record + group by stu_id; + +-- 33. 查询平均成绩大于等于90分的学生的学号和平均成绩(分组和聚合函数) +-- 结论：分组前的筛选使用where子句，分组后的筛选使用having子句 +select stu_id + , round(avg(score), 1) as avg_score + from tb_record + group by stu_id +having avg(score) >= 90; + +-- 34. 查询所有课程成绩大于80分的同学的学号(分组和聚合函数) +select stu_id + from tb_record + group by stu_id +having min(score) > 80; + +-- Error Code: 1242. Subquery returns more than 1 row +select stu_id + , stu_name + from tb_student + where stu_id in (select stu_id + from tb_record + group by stu_id + having min(score) > 80); + +-- 35. 查询年龄最大的学生的姓名(嵌套查询) +-- 嵌套查询/子查询：把一个查询的结果作为另外一个查询的一部分来使用 +select @a := min(stu_birth) + from tb_student; + +select stu_name + from tb_student + where stu_birth = @a; + +select stu_name + from tb_student + where stu_birth = (select min(stu_birth) + from tb_student); + +-- 36. 查询选了两门以上的课程的学生姓名(嵌套查询/分组/数据筛选) +select stu_name + from tb_student + where stu_id in (select stu_id + from tb_record + group by stu_id + having count(*) > 2); + +-- 37. 查询学生的姓名、生日和所在学院名称(连接查询) +select stu_name + , stu_birth + , col_name + from tb_student, tb_college + where tb_student.col_id = tb_college.col_id; + +select stu_name + , stu_birth + , col_name + from tb_student inner join tb_college + on tb_student.col_id = tb_college.col_id; + +select stu_name + , stu_birth + , col_name + from tb_student natural join tb_college; + +-- 38. 查询学生姓名、课程名称以及成绩(连接查询) +select stu_name + , cou_name + , score + from tb_student, tb_course, tb_record + where tb_student.stu_id = tb_record.stu_id + and tb_course.cou_id = tb_record.cou_id + and score is not null; + +select stu_name + , cou_name + , score + from tb_student + inner join tb_record + on tb_student.stu_id = tb_record.stu_id + inner join tb_course + on tb_course.cou_id = tb_record.cou_id + where score is not null; --- 方法二： -select avg(coalesce(score, 0)) - from tb_record - where stu_id = 1001; - --- 查询学号为1001的学生考试成绩的标准差(聚合函数) -select stddev_samp(score) - from tb_record - where stu_id = 1001; - --- 查询男女学生的人数 - select case stu_sex when 1 then '男' else '女' end as 性别, - count(*) as 人数 - from tb_student -group by stu_sex; - --- 查询每个学院学生人数 - select col_id as 学院编号, - count(*) as 人数 - from tb_student -group by col_id; - --- 查询每个学院男女学生人数 - select col_id as 学院编号, - case stu_sex when 1 then '男' else '女' end as 性别, - count(*) as 人数 - from tb_student -group by col_id, stu_sex; - --- 查询每个学生的学号和平均成绩 - select stu_id as 学号, - round(avg(score), 2) as 平均成绩 - from tb_record -group by stu_id; - --- 查询平均成绩大于等于90分的学生的学号和平均成绩 --- 方法一： - select stu_id as 学号, - round(avg(score), 2) as 平均成绩 - from tb_record -group by stu_id - having 平均成绩 >= 90; - --- 方法二： -select * - from ( select stu_id as 学号, - round(avg(score), 2) as 平均成绩 - from tb_record - group by stu_id) as t - where 平均成绩 >= 90; - --- 查询1111、2222、3333三门课程平均成绩大于等于90分的学生的学号和平均成绩 - select stu_id as 学号, - round(avg(score), 2) as 平均成绩 - from tb_record - where cou_id in (1111, 2222, 3333) -group by stu_id - having avg(score) >= 90; - --- 嵌套查询：把一个查询的结果作为另外一个查询的一部分来使用 -select stu_name - from tb_student - where stu_birth = (select min(stu_birth) - from tb_student); - --- 查询选了两门以上的课程的学生姓名 -select stu_name - from tb_student - where stu_id in ( select stu_id - from tb_record - group by stu_id - having count(*) > 2); - --- 查询学生的姓名、生日和所在学院名称 --- 方法一： -select stu_name, - stu_birth, - col_name - from tb_student, tb_college - where tb_student.col_id = tb_college.col_id; - --- 方法二： -select stu_name, - stu_birth, - col_name - from tb_student inner join tb_college - on tb_student.col_id = tb_college.col_id; - --- 方法三： -select stu_name, - stu_birth, - col_name - from tb_student natural join tb_college; - --- 查询学生姓名、课程名称以及成绩 --- 方法一： -select stu_name, - cou_name, - score - from tb_student, tb_course, tb_record - where tb_student.stu_id = tb_record.stu_id - and tb_course.cou_id = tb_record.cou_id - and score is not null; - --- 方法二： -select stu_name, - cou_name, - score - from tb_student inner join tb_record inner join tb_course - on tb_student.stu_id = tb_record.stu_id - and tb_course.cou_id = tb_record.cou_id - where score is not null; +select stu_name + , cou_name + , score + from tb_student + natural join tb_record + natural join tb_course + where score is not null; --- 方法三： -select stu_name, - cou_name, - score - from tb_student natural join tb_record natural join tb_course - where score is not null; - --- 补充：上面的查询结果取前5条数据 - select stu_name, - cou_name, - score - from tb_student natural join tb_record natural join tb_course - where score is not null -order by stu_id asc, score desc - limit 5; - --- 补充：上面的查询结果取第6-10条数据 - select stu_name, - cou_name, - score - from tb_student inner join tb_record inner join tb_course - on tb_student.stu_id = tb_record.stu_id - and tb_course.cou_id = tb_record.cou_id -order by stu_id asc, score desc - limit 5 - offset 5; - --- 补充：上面的查询结果取第11-15条数据 - select stu_name, - cou_name, - score - from tb_student natural join tb_record natural join tb_course - where score is not null -order by stu_id asc, score desc - limit 5 - offset 10; - --- 查询选课学生的姓名和平均成绩 -select stu_name, - avg_score - from tb_student t1 inner join ( select stu_id, - round(avg(score), 2) as avg_score - from tb_record - group by stu_id) t2 - on t1.stu_id = t2.stu_id; - --- 查询学生的姓名和选课的数量 -select stu_name, - total - from tb_student t1 natural join ( select stu_id, - count(*) as total - from tb_record - group by stu_id) t2; - --- 查询每个学生的姓名和选课数量(左外连接和子查询) -select stu_name as 姓名, - coalesce (total, 0) as 选课数量 - from tb_student t1 left join ( select stu_id, - count(*) as total - from tb_record - group by stu_id) t2 - on t1.stu_id = t2.stu_id; +-- 39. 上面的查询结果按课程和成绩排序取前5条数据(分页查询) +select stu_name + , cou_name + , score + from tb_student + natural join tb_record + natural join tb_course + where score is not null + order by cou_id asc, score desc + limit 5; + +-- 40. 上面的查询结果按课程和成绩排序取第6-10条数据(分页查询) +select stu_name + , cou_name + , score + from tb_student + natural join tb_record + natural join tb_course + where score is not null + order by cou_id asc, score desc + limit 5 +offset 5; + +-- 41. 上面的查询结果按课程和成绩排序取第11-15条数据(分页查询) +select stu_name + , cou_name + , score + from tb_student + natural join tb_record + natural join tb_course + where score is not null + order by cou_id asc, score desc + limit 5 +offset 10; + +-- 42. 查询选课学生的姓名和平均成绩(嵌套查询和连接查询) +select stu_name + , avg_score + from tb_student + natural join (select stu_id + , avg(score) as avg_score + from tb_record + group by stu_id) as tmp; + +-- 43. 查询学生的姓名和选课的数量(嵌套查询和连接查询) +select stu_name + , total + from tb_student + inner join (select stu_id + , count(*) as total + from tb_record + group by stu_id) as tmp + on tb_student.stu_id = tmp.stu_id; + +-- 44. 查询所有学生的姓名和选课数量(左外连接和嵌套查询) +-- 左外连接：把左表（写在join左边的表）所有的数据都拿到，不满足连表条件的地方填充null - left outer join +-- 右外连接：把右表（写在join右边的表）所有的数据都拿到，不满足连表条件的地方填充null - right outer join +-- 全外连接：把左表和右表的数据全部拿到即便它们不满足连表条件，MySQL不支持全外连接 - full outer join +select stu_name + , coalesce(total, 0) as total + from tb_student + left join (select stu_id + , count(*) as total + from tb_record + group by stu_id) as tmp + on tb_student.stu_id = tmp.stu_id; + +-- 45. 查询没有选课的学生的姓名(左外连接和数据筛选) +select stu_name + from tb_student + left join tb_record + on tb_student.stu_id = tb_record.stu_id + where tb_record.stu_id is null; ``` 上面的 DQL 有几个地方需要加以说明： diff --git "a/\347\254\25444\350\257\276.SQL\350\257\246\350\247\243\344\271\213DCL.md" "b/\347\254\25444\350\257\276.SQL\350\257\246\350\247\243\344\271\213DCL.md" old mode 100644 new mode 100755 index e3bb186..9c797aa --- "a/\347\254\25444\350\257\276.SQL\350\257\246\350\247\243\344\271\213DCL.md" +++ "b/\347\254\25444\350\257\276.SQL\350\257\246\350\247\243\344\271\213DCL.md" @@ -1,4 +1,4 @@ -## SQL详解之DCL +## 第44课：SQL详解之DCL 数据库服务器通常包含了非常重要的数据，可以通过访问控制来确保这些数据的安全，而 DCL 就是解决这一问题的，它可以为指定的用户授予访问权限或者从指定用户处召回指定的权限。DCL 对数据库管理员来说非常重要，因为用户权限的管理关系到数据库的安全。简单的说，我们可以通过 DCL 允许受信任的用户访问数据库，阻止不受信任的用户访问数据库，同时还可以通过 DCL 将每个访问者的的权限最小化（让访问者的权限刚刚够用）。 diff --git "a/\347\254\25445\350\257\276.\347\264\242\345\274\225.md" "b/\347\254\25445\350\257\276.\347\264\242\345\274\225.md" old mode 100644 new mode 100755 index 7691a55..a38bb64 --- "a/\347\254\25445\350\257\276.\347\264\242\345\274\225.md" +++ "b/\347\254\25445\350\257\276.\347\264\242\345\274\225.md" @@ -1,4 +1,4 @@ -## 索引 +## 第45课：索引 索引是关系型数据库中用来提升查询性能最为重要的手段。关系型数据库中的索引就像一本书的目录，我们可以想象一下，如果要从一本书中找出某个知识点，但是这本书没有目录，这将是意见多么可怕的事情！我们估计得一篇一篇的翻下去，才能确定这个知识点到底在什么位置。创建索引虽然会带来存储空间上的开销，就像一本书的目录会占用一部分篇幅一样，但是在牺牲空间后换来的查询时间的减少也是非常显著的。 diff --git "a/\347\254\25446\350\257\276.\350\247\206\345\233\276+\345\207\275\346\225\260+\350\277\207\347\250\213.md" "b/\347\254\25446\350\257\276.\350\247\206\345\233\276+\345\207\275\346\225\260+\350\277\207\347\250\213.md" old mode 100644 new mode 100755 index 1c45b2d..6d32e09 --- "a/\347\254\25446\350\257\276.\350\247\206\345\233\276+\345\207\275\346\225\260+\350\277\207\347\250\213.md" +++ "b/\347\254\25446\350\257\276.\350\247\206\345\233\276+\345\207\275\346\225\260+\350\277\207\347\250\213.md" @@ -1,4 +1,4 @@ -## 视图、函数和过程 +## 第46课：视图、函数和过程 为了讲解视图、函数和过程，我们首先用下面的 DDL 和 DML 创建名为 hrs 的数据库并为其二维表添加如下所示的数据。 diff --git "a/\347\254\25447\350\257\276.MySQL\346\226\260\347\211\271\346\200\247.md" "b/\347\254\25447\350\257\276.MySQL\346\226\260\347\211\271\346\200\247.md" old mode 100644 new mode 100755 index 38c05c5..5b729a9 --- "a/\347\254\25447\350\257\276.MySQL\346\226\260\347\211\271\346\200\247.md" +++ "b/\347\254\25447\350\257\276.MySQL\346\226\260\347\211\271\346\200\247.md" @@ -1,4 +1,4 @@ -## MySQL 新特性 +## 第47课：MySQL 新特性 #### JSON类型 diff --git "a/\347\254\25448\350\257\276.Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" "b/\347\254\25448\350\257\276.Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" old mode 100644 new mode 100755 index 24f1fbc..504d8a8 --- "a/\347\254\25448\350\257\276.Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" +++ "b/\347\254\25448\350\257\276.Python\347\250\213\345\272\217\346\216\245\345\205\245MySQL\346\225\260\346\215\256\345\272\223.md" @@ -1,4 +1,4 @@ -## Python程序接入MySQL数据库 +## 第48课：Python程序接入MySQL数据库 在 Python3 中，我们可以使用`mysqlclient`或者`pymysql`三方库来接入 MySQL 数据库并实现数据持久化操作。二者的用法完全相同，只是导入的模块名不一样。我们推荐大家使用纯 Python 的三方库`pymysql`，因为它更容易安装成功。下面我们仍然以之前创建的名为`hrs`的数据库为例，为大家演示如何通过 Python 程序操作 MySQL 数据库实现数据持久化操作。 From cd4d226f34e1fdaeb59791095f6df1d2a89260a7 Mon Sep 17 00:00:00 2001 From: jackfrued Date: Tue, 2 Jan 2024 20:43:08 +0800 Subject: [PATCH 09/17] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E4=BA=86README.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 8 +- res/qrcode.JPG | Bin 0 -> 748185 bytes ...13\350\277\220\347\256\227\347\254\246.md" | 2 +- ...344\275\234PDF\346\226\207\344\273\266.md" | 81 +++++++----------- 4 files changed, 37 insertions(+), 54 deletions(-) create mode 100644 res/qrcode.JPG diff --git a/README.md b/README.md index 60256f7..3c85cc8 100755 --- a/README.md +++ b/README.md @@ -14,9 +14,9 @@ ### 视频资源 -1. [《Python零基础教程快速上手》](https://www.bilibili.com/video/BV1FT4y1R7sz) - Python基础部分的视频，因为随堂录制，有的时候声音会有点小，点赞过3000就为大家重新录制一套声音和画面都更好的精讲版视频。 -2. [《Python零基础数据库可视化教程》](https://www.bilibili.com/video/BV1dA411w7tu)- 数据库部分的视频，随堂录制，数据库部分讲得比较简单，后面还讲了一些做数据可视化系统的内容，我自己对这套视频不是很满意，点赞过2000之后就重新做一套面向数据分析师精讲数据库的视频，重点放在SQL和业务查询知识上，解决数据分析师日常提数问题。 -3. [《Scrapy爬虫框架教学》](https://www.bilibili.com/video/BV1QY411F7Vt)- 爬虫框架Scrapy教学视频，随堂录制，讲解了一个爬取淘宝商品信息的项目，有一点实用价值，爬虫本身并不是我感兴趣的内容，就将就看看吧。 +视频在抖音和B站都可以找到，有兴趣的小伙伴可以关注我的抖音或B站账号，最近刚刚起号，还希望大家多多支持，非常感谢！ + + ### 文件资源 @@ -30,7 +30,7 @@ 1. 骆昊的Python学习群-1，群号：789050736，2000人大群。 2. 骆昊的Python学习群-2，群号：837590310，2000人大群。 -3. 骆昊的Python学习群-3，群号：784430256，1000人大群。 +3. 骆昊的Python学习群-3，群号：784430256，2000人大群。 diff --git a/res/qrcode.JPG b/res/qrcode.JPG new file mode 100644 index 0000000000000000000000000000000000000000..8697cc0d2c180c88c9eb80db096f29e61ebd1f15 GIT binary patch literal 748185 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
    d4ehXbrYiq8Wt3JI%7TeOBH7ON+KHKipx^? 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
    6)m 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