20 Spreadsheets
20.1 Introduction
在 Chapter 7 中,你学习了如何从纯文本文件(如.csv和.tsv)导入数据。 现在是时候学习如何从电子表格(无论是Excel电子表格还是Google Sheets)中获取数据了。 这部分内容将建立在你在 Chapter 7 中所学知识的基础上,但我们也将讨论处理电子表格数据时需要考虑的其他事项和复杂性。
如果你或你的合作者正在使用电子表格来组织数据,我们强烈推荐阅读Karl Broman和Kara Woo撰写的论文”Data Organization in Spreadsheets”:https://doi.org/10.1080/00031305.2017.1375989。 这篇论文中提出的最佳实践将为你后续将电子表格数据导入R进行分析和可视化时省去大量麻烦。
20.2 Excel
Microsoft Excel是一款广泛使用的电子表格软件程序,数据被组织在电子表格文件内的工作表中。
20.2.1 Prerequisites
在本节中,你将学习如何使用readxl包将Excel电子表格中的数据加载到R中。 这个包不属于tidyverse的核心包,因此你需要显式加载它,但当你安装tidyverse包时,它会被自动安装。 稍后,我们还将使用writexl包,它允许我们创建Excel电子表格。
20.2.2 Getting started
readxl的大部分函数允许你将Excel电子表格加载到R中:
-
read_xls()用于读取xls格式的Excel文件。 -
read_xlsx()用于读取xlsx格式的Excel文件。 -
read_excel()可以读取xls和xlsx两种格式的文件。它会根据输入自动判断文件类型。
这些函数的语法与我们之前介绍过的用于读取其他类型文件(例如 read_csv()、read_table() 等)的函数非常相似。 在本章的剩余部分,我们将重点介绍如何使用read_excel()。
20.2.3 Reading Excel spreadsheets
Figure 20.1 展示了我们将要读入R的电子表格在Excel中的样子。
read_excel() 的第一个参数是要读取文件的路径。
students <- read_excel("data/students.xlsx")read_excel() 会将文件读取为tibble
students
#> # A tibble: 6 × 5
#> `Student ID` `Full Name` favourite.food mealPlan AGE
#> <dbl> <chr> <chr> <chr> <chr>
#> 1 1 Sunil Huffmann Strawberry yoghurt Lunch only 4
#> 2 2 Barclay Lynn French fries Lunch only 5
#> 3 3 Jayendra Lyne N/A Breakfast and lunch 7
#> 4 4 Leon Rossini Anchovies Lunch only <NA>
#> 5 5 Chidiegwu Dunkel Pizza Breakfast and lunch five
#> 6 6 Güvenç Attila Ice cream Lunch only 6数据中包含六名学生和每个学生的五个变量。 然而,在这个数据集中,我们可能需要处理几个问题:
-
列名格式不统一。 你可以通过提供列名遵循一致的格式;我们推荐
snake_case命名法使用col_names参数。read_excel( "data/students.xlsx", col_names = c("student_id", "full_name", "favourite_food", "meal_plan", "age") ) #> # A tibble: 7 × 5 #> student_id full_name favourite_food meal_plan age #> <chr> <chr> <chr> <chr> <chr> #> 1 Student ID Full Name favourite.food mealPlan AGE #> 2 1 Sunil Huffmann Strawberry yoghurt Lunch only 4 #> 3 2 Barclay Lynn French fries Lunch only 5 #> 4 3 Jayendra Lyne N/A Breakfast and lunch 7 #> 5 4 Leon Rossini Anchovies Lunch only <NA> #> 6 5 Chidiegwu Dunkel Pizza Breakfast and lunch five #> 7 6 Güvenç Attila Ice cream Lunch only 6遗憾的是,这招并不完全奏效。 虽然我们得到了想要的变量名,但之前作为标题行(表头)的内容现在却显示为数据中的第一条观测值。 你可以使用
skip参数来明确跳过那一行。read_excel( "data/students.xlsx", col_names = c("student_id", "full_name", "favourite_food", "meal_plan", "age"), skip = 1 ) #> # A tibble: 6 × 5 #> student_id full_name favourite_food meal_plan age #> <dbl> <chr> <chr> <chr> <chr> #> 1 1 Sunil Huffmann Strawberry yoghurt Lunch only 4 #> 2 2 Barclay Lynn French fries Lunch only 5 #> 3 3 Jayendra Lyne N/A Breakfast and lunch 7 #> 4 4 Leon Rossini Anchovies Lunch only <NA> #> 5 5 Chidiegwu Dunkel Pizza Breakfast and lunch five #> 6 6 Güvenç Attila Ice cream Lunch only 6 -
在
favourite_food列中,有一个观测值是N/A,它代表“不可用”(not available),但目前它并未被识别为NA(请注意此处的N/A与列表中第四名学生年龄的对比)。 你可以使用na参数来指定哪些字符串应被识别为NAs。 默认情况下,只有""(空字符串,或者在从电子表格读取的情况下,指空单元格或包含公式=NA()的单元格)会被识别为NA。read_excel( "data/students.xlsx", col_names = c("student_id", "full_name", "favourite_food", "meal_plan", "age"), skip = 1, na = c("", "N/A") ) #> # A tibble: 6 × 5 #> student_id full_name favourite_food meal_plan age #> <dbl> <chr> <chr> <chr> <chr> #> 1 1 Sunil Huffmann Strawberry yoghurt Lunch only 4 #> 2 2 Barclay Lynn French fries Lunch only 5 #> 3 3 Jayendra Lyne <NA> Breakfast and lunch 7 #> 4 4 Leon Rossini Anchovies Lunch only <NA> #> 5 5 Chidiegwu Dunkel Pizza Breakfast and lunch five #> 6 6 Güvenç Attila Ice cream Lunch only 6 -
另一个遗留问题是
age(年龄)被读取为字符型变量,但它本应是数值型。 与用于从平面文件读取数据的read_csv()及其同类函数一样,你可以向read_excel()提供一个col_types参数,并指定所读取变量的列类型。 不过,语法稍有不同。 你可选的类型有:"skip","guess","logical","numeric","date","text"or"list".read_excel( "data/students.xlsx", col_names = c("student_id", "full_name", "favourite_food", "meal_plan", "age"), skip = 1, na = c("", "N/A"), col_types = c("numeric", "text", "text", "text", "numeric") ) #> Warning: Expecting numeric in E6 / R6C5: got 'five' #> # A tibble: 6 × 5 #> student_id full_name favourite_food meal_plan age #> <dbl> <chr> <chr> <chr> <dbl> #> 1 1 Sunil Huffmann Strawberry yoghurt Lunch only 4 #> 2 2 Barclay Lynn French fries Lunch only 5 #> 3 3 Jayendra Lyne <NA> Breakfast and lunch 7 #> 4 4 Leon Rossini Anchovies Lunch only NA #> 5 5 Chidiegwu Dunkel Pizza Breakfast and lunch NA #> 6 6 Güvenç Attila Ice cream Lunch only 6然而,这样操作也未能完全达到预期效果。 通过指定
age应为数值型,我们将那个包含非数字条目(值为five)的单元格转换成了NA。 在这种情况下,我们应该先将 age 作为"text"读取进来,待数据加载到 R 中后再进行转换。students <- read_excel( "data/students.xlsx", col_names = c("student_id", "full_name", "favourite_food", "meal_plan", "age"), skip = 1, na = c("", "N/A"), col_types = c("numeric", "text", "text", "text", "text") ) students <- students |> mutate( age = if_else(age == "five", "5", age), age = parse_number(age) ) students #> # A tibble: 6 × 5 #> student_id full_name favourite_food meal_plan age #> <dbl> <chr> <chr> <chr> <dbl> #> 1 1 Sunil Huffmann Strawberry yoghurt Lunch only 4 #> 2 2 Barclay Lynn French fries Lunch only 5 #> 3 3 Jayendra Lyne <NA> Breakfast and lunch 7 #> 4 4 Leon Rossini Anchovies Lunch only NA #> 5 5 Chidiegwu Dunkel Pizza Breakfast and lunch 5 #> 6 6 Güvenç Attila Ice cream Lunch only 6
我们花了多个步骤,通过反复试验才将数据加载成我们想要的精确格式,这并不出乎意料。 数据科学本身就是一个迭代的过程,而从电子表格读取数据时,这个迭代过程可能比处理其他纯文本、矩形数据文件更为繁琐,因为人们倾向于将数据输入到电子表格中,并不仅将其用于数据存储,还用于共享和交流。
在你加载数据并查看之前,你无法确切知道数据会是什么样子。 嗯,实际上有一种方法可以预先了解。 你可以在Excel中打开文件瞧一瞧。 如果你打算这样做,我们建议先复制一份Excel文件用于打开和交互式浏览,同时保留原始数据文件不动,并从这份未修改的文件中将数据读入R。 这样可以确保你在查看过程中不会意外地覆盖电子表格中的任何内容。 同时,你也不应畏惧我们在这里所做的事情:加载数据,查看一番,调整代码,再次加载,如此反复,直到你对结果满意为止。
20.2.4 Reading worksheets
电子表格与平面文件的一个重要区别在于其包含多个工作表(worksheets)的概念。 Figure 20.2 展示了一个包含多个工作表的Excel电子表格。 这些数据来自 palmerpenguins 包。 每个工作表包含来自不同数据收集岛屿的企鹅信息。
你可以使用 read_excel() 中的 sheet 参数从电子表格中读取单个工作表。 默认情况下(我们一直沿用至今),读取的是第一个工作表。
read_excel("data/penguins.xlsx", sheet = "Torgersen Island")
#> # A tibble: 52 × 8
#> species island bill_length_mm bill_depth_mm flipper_length_mm
#> <chr> <chr> <chr> <chr> <chr>
#> 1 Adelie Torgersen 39.1 18.7 181
#> 2 Adelie Torgersen 39.5 17.399999999999999 186
#> 3 Adelie Torgersen 40.299999999999997 18 195
#> 4 Adelie Torgersen NA NA NA
#> 5 Adelie Torgersen 36.700000000000003 19.3 193
#> 6 Adelie Torgersen 39.299999999999997 20.6 190
#> # ℹ 46 more rows
#> # ℹ 3 more variables: body_mass_g <chr>, sex <chr>, year <dbl>由于字符串 "NA" 未被识别为真正的 NA 值,一些看似包含数值数据的变量会被读取为字符型。
penguins_torgersen <- read_excel("data/penguins.xlsx", sheet = "Torgersen Island", na = "NA")
penguins_torgersen
#> # A tibble: 52 × 8
#> species island bill_length_mm bill_depth_mm flipper_length_mm
#> <chr> <chr> <dbl> <dbl> <dbl>
#> 1 Adelie Torgersen 39.1 18.7 181
#> 2 Adelie Torgersen 39.5 17.4 186
#> 3 Adelie Torgersen 40.3 18 195
#> 4 Adelie Torgersen NA NA NA
#> 5 Adelie Torgersen 36.7 19.3 193
#> 6 Adelie Torgersen 39.3 20.6 190
#> # ℹ 46 more rows
#> # ℹ 3 more variables: body_mass_g <dbl>, sex <chr>, year <dbl>另外,你也可以使用 excel_sheets() 来获取Excel电子表格中所有工作表的信息,然后读取你感兴趣的一个或多个。
excel_sheets("data/penguins.xlsx")
#> [1] "Torgersen Island" "Biscoe Island" "Dream Island"一旦知道了工作表的名称,就可以使用 read_excel() 分别读取它们。
penguins_biscoe <- read_excel("data/penguins.xlsx", sheet = "Biscoe Island", na = "NA")
penguins_dream <- read_excel("data/penguins.xlsx", sheet = "Dream Island", na = "NA")在这个例子中,完整的企鹅数据集分布在电子表格的三个工作表中。 每个工作表具有相同的列数,但行数不同。
我们可以使用 bind_rows() 将它们合并在一起。
penguins <- bind_rows(penguins_torgersen, penguins_biscoe, penguins_dream)
penguins
#> # A tibble: 344 × 8
#> species island bill_length_mm bill_depth_mm flipper_length_mm
#> <chr> <chr> <dbl> <dbl> <dbl>
#> 1 Adelie Torgersen 39.1 18.7 181
#> 2 Adelie Torgersen 39.5 17.4 186
#> 3 Adelie Torgersen 40.3 18 195
#> 4 Adelie Torgersen NA NA NA
#> 5 Adelie Torgersen 36.7 19.3 193
#> 6 Adelie Torgersen 39.3 20.6 190
#> # ℹ 338 more rows
#> # ℹ 3 more variables: body_mass_g <dbl>, sex <chr>, year <dbl>在 Chapter 26 中,我们将讨论如何以更简洁的代码完成此类任务,避免重复编写。
20.2.5 Reading part of a sheet
由于许多人将Excel电子表格既用于数据展示也用于数据存储,因此经常发现电子表格中的某些单元格内容并非你想要读入R的数据的一部分。 Figure 20.3 展示了这样一个电子表格:工作表中间看起来像一个数据框,但数据上下的单元格中却存在无关的文本。
这个电子表格是readxl包提供的示例电子表格之一。 你可以使用 readxl_example() 函数在你的系统上定位该电子表格在包安装目录中的位置。 这个函数会返回电子表格的路径,你可以像往常一样在 read_excel() 中使用该路径。
deaths_path <- readxl_example("deaths.xlsx")
deaths <- read_excel(deaths_path)
#> New names:
#> • `` -> `...2`
#> • `` -> `...3`
#> • `` -> `...4`
#> • `` -> `...5`
#> • `` -> `...6`
deaths
#> # A tibble: 18 × 6
#> `Lots of people` ...2 ...3 ...4 ...5 ...6
#> <chr> <chr> <chr> <chr> <chr> <chr>
#> 1 simply cannot resi… <NA> <NA> <NA> <NA> some notes
#> 2 at the top <NA> of their spreadsh…
#> 3 or merging <NA> <NA> <NA> cells
#> 4 Name Profession Age Has kids Date of birth Date of death
#> 5 David Bowie musician 69 TRUE 17175 42379
#> 6 Carrie Fisher actor 60 TRUE 20749 42731
#> # ℹ 12 more rows最上面三行和最下面四行不属于数据框的一部分。 可以使用 skip 和 n_max 参数来排除这些无关的行,但我们更推荐使用单元格区域。 在Excel中,左上角的单元格是 A1。 当您向右移动列时,单元格标签会按字母顺序变化,即 B1, C1 等。 而当您向下移动行时,单元格标签中的数字会增加,即 A2, A3 等。
这里,我们想要读取的数据起始于单元格 A5,结束于单元格 F15。 在电子表格表示法中,这即 A5:F15,我们将其提供给 range 参数:
read_excel(deaths_path, range = "A5:F15")
#> # A tibble: 10 × 6
#> Name Profession Age `Has kids` `Date of birth`
#> <chr> <chr> <dbl> <lgl> <dttm>
#> 1 David Bowie musician 69 TRUE 1947-01-08 00:00:00
#> 2 Carrie Fisher actor 60 TRUE 1956-10-21 00:00:00
#> 3 Chuck Berry musician 90 TRUE 1926-10-18 00:00:00
#> 4 Bill Paxton actor 61 TRUE 1955-05-17 00:00:00
#> 5 Prince musician 57 TRUE 1958-06-07 00:00:00
#> 6 Alan Rickman actor 69 FALSE 1946-02-21 00:00:00
#> # ℹ 4 more rows
#> # ℹ 1 more variable: `Date of death` <dttm>20.2.6 Data types
在CSV文件中,所有值都是字符串。 这对数据本身来说并不完全真实,但它很简单:一切都是字符串。
Excel电子表格中的底层数据则更为复杂。 一个单元格可以是以下四种类型之一:
A boolean, 例如
TRUE,FALSE, 或NA.A number, 例如 “10” 或 “10.5”.
A datetime, 也可以包含时间,例如 “11/1/21” 或 “11/1/21 3:00 PM”.
A text string, 例如 “ten”.
处理电子表格数据时,务必记住底层数据可能与您在单元格中看到的截然不同。 例如,Excel没有整数的概念。 所有数字都存储为浮点数,但您可以选择以自定义小数位数显示数据。 类似地,日期实际上存储为数字,具体来说是自1970年1月1日以来的秒数。 您可以通过在Excel中应用格式来自定义日期的显示方式。 令人困惑的是,也可能存在看起来像数字但实际上是字符串的情况(例如,在Excel的单元格中输入 '10)。
底层数据存储方式与数据显示方式之间的这些差异,可能会导致数据加载到R时出现意外情况。 默认情况下,readxl会猜测给定列的数据类型。 一个推荐的工作流程是让readxl猜测列类型,确认您对猜测的列类型是否满意,如果不满意,则返回并重新导入,同时指定 col_types,如 Section 20.2.3 所示。
另一个挑战是当您的Excel电子表格中有一列混合了这些类型时,例如,某些单元格是数字,其他是文本,还有一些是日期。 在将数据导入R时,readxl必须做出一些决定。在 这些情况下,您可以将此列的类型设置为 "list",这将把该列加载为一个长度为1的向量列表,其中每个向量元素的类型是被猜测出来的。
有时数据以更特殊的方式存储,例如单元格背景的颜色,或者文本是否为粗体。 在这种情况下,您可能会发现 tidyxl package 包 很有用。 有关处理来自Excel的非表格数据策略的更多信息,请参阅 https://nacnudus.github.io/spreadsheet-munging-strategies/。
20.2.7 Writing to Excel
让我们创建一个可以随后写入文件的小型数据框。 请注意,item 是一个因子型变量,quantity 是一个整型变量。
你可以使用 writexl package 中的 write_xlsx() 函数将数据写回磁盘,保存为Excel文件:
write_xlsx(bake_sale, path = "data/bake-sale.xlsx")Figure 20.4 展示了该数据在Excel中的样子。 请注意,列名已被包含在内并设置为粗体。 这可以通过将 col_names 和 format_headers 参数设置为 FALSE 来关闭。
就像从CSV读取数据一样,当我们重新读回这个Excel文件时,数据类型信息会丢失。 这使得Excel文件也不适合用于缓存中间结果。 关于其他替代方案,请参见 Section 7.5。
read_excel("data/bake-sale.xlsx")
#> # A tibble: 3 × 2
#> item quantity
#> <chr> <dbl>
#> 1 brownie 10
#> 2 cupcake 5
#> 3 cookie 820.2.8 Formatted output
writexl 包是写入简单 Excel 电子表格的轻量级解决方案,但如果你需要更多功能,例如在工作簿内的多个工作表写入数据或进行样式设置,那么你可能需要使用 openxlsx package 包。 我们在此不深入探讨该包的使用细节,但如果你想了解如何使用openxlsx将从R导出的数据写入Excel并进行更多格式设置,我们推荐阅读其官方文档https://ycphs.github.io/openxlsx/articles/Formatting.html。
请注意,这个包并不属于tidyverse,因此其函数和工作流程可能会让你感到不太熟悉。 例如,函数名采用驼峰式命名(camelCase),多个函数不能通过管道符组合使用,而且参数的排列顺序也与tidyverse的习惯不同。 不过,这很正常。 随着你在本书之外进一步学习和使用R,你会遇到各种各样的R包,它们为了实现特定目标而采用了不同的编程风格。 熟悉一个新包编码风格的好方法是:运行函数文档中提供的示例,以感受其语法和输出格式;同时阅读该包可能附带的任何 vignette。
20.2.9 Exercises
-
在一个 Excel 文件中,创建以下数据集并将其保存为
survey.xlsx。 或者,你也可以从此处下载该 Excel 文件 here。
然后,将其读入 R,并将
survey_id指定为字符变量,n_pets指定为数值变量。#> # A tibble: 6 × 2 #> survey_id n_pets #> <chr> <dbl> #> 1 1 0 #> 2 2 1 #> 3 3 NA #> 4 4 2 #> 5 5 2 #> 6 6 NA -
在另一个 Excel 文件中,创建以下数据集并将其保存为
roster.xlsx。 或者,你也可以从此处下载该 Excel 文件 here。
然后,将其读入 R。 生成的数据框应命名为
roster,并且看起来像下面这样。#> # A tibble: 12 × 3 #> group subgroup id #> <dbl> <chr> <dbl> #> 1 1 A 1 #> 2 1 A 2 #> 3 1 A 3 #> 4 1 B 4 #> 5 1 B 5 #> 6 1 B 6 #> 7 1 B 7 #> 8 2 A 8 #> 9 2 A 9 #> 10 2 B 10 #> 11 2 B 11 #> 12 2 B 12 -
在一个新的 Excel 文件中,创建以下数据集并将其保存为
sales.xlsx。 或者,你也可以从此处下载该 Excel 文件 here。
a. 读取
sales.xlsx文件并将其保存为sales。 该数据框应如下所示,包含id和n作为列名,并且有 9 行数据。#> # A tibble: 9 × 2 #> id n #> <chr> <chr> #> 1 Brand 1 n #> 2 1234 8 #> 3 8721 2 #> 4 1822 3 #> 5 Brand 2 n #> 6 3333 1 #> 7 2156 3 #> 8 3987 6 #> 9 3216 5b. 进一步修改
sales,使其成为如下整洁的格式,包含三列(brand、id和n)以及 7 行数据。 请注意,id和n是数值型,brand是字符型变量。#> # A tibble: 7 × 3 #> brand id n #> <chr> <dbl> <dbl> #> 1 Brand 1 1234 8 #> 2 Brand 1 8721 2 #> 3 Brand 1 1822 3 #> 4 Brand 2 3333 1 #> 5 Brand 2 2156 3 #> 6 Brand 2 3987 6 #> 7 Brand 2 3216 5 重新创建
bake_sale数据框,并使用 openxlsx 包中的write.xlsx()函数将其写入一个 Excel 文件。在 Chapter 7 中,你学习了使用
janitor::clean_names()函数将列名转换为蛇形命名法(snake case)。 读取我们本节前文介绍的students.xlsx文件,并使用此函数来“清洗”列名。如果你尝试用
read_xls()读取一个扩展名为.xlsx的文件,会发生什么?
20.3 Google Sheets
Google Sheets 是另一种广泛使用的电子表格程序。 它是免费的,并且基于网页运行。 与 Excel 一样,在 Google Sheets 中,数据也组织在电子表格文件内的工作表(也称为 sheets)中。
20.3.1 Prerequisites
本节同样聚焦于电子表格,但这次你将使用 googlesheets4 包从 Google Sheet 加载数据。 这个包同样不属于 tidyverse 核心包,你需要显式加载它。
关于这个包的名称有个简短说明:googlesheets4 使用了 Sheets API v4 来提供 R 与 Google Sheets 的接口,因此得名。
20.3.2 Getting started
googlesheets4 包的主要函数是 read_sheet(),它通过 URL 或文件 ID 读取 Google Sheet。 这个函数还有一个名称是 range_read()。
你也可以使用 gs4_create() 创建一个全新的 sheet,或者使用 sheet_write() 及相关函数写入一个已有的 sheet。
在本节中,我们将使用与 Excel 部分相同的数据集,以突出从 Excel 和 Google Sheets 读取数据的工作流程之间的异同。 readxl 和 googlesheets4 包都旨在模拟 readr 包的功能,你在 Chapter 7 中已经见过 readr 包提供的 read_csv() 函数。 因此,许多任务只需简单地将 read_excel() 替换为 read_sheet() 即可完成。 但是,你也会发现 Excel 和 Google Sheets 的行为方式并非完全相同,因此其他任务可能需要对函数调用做进一步调整。
20.3.3 Reading Google Sheets
Figure 20.5 展示了我们将要读入 R 的电子表格在 Google Sheets 中的样子。 这与 Figure 20.1 中的是同一数据集,只是它存储在 Google Sheet 而非 Excel 中。
read_sheet() 的第一个参数是要读取文件的 URL,它会返回一个 tibble:
https://docs.google.com/spreadsheets/d/1V1nPp1tzOuutXFLb3G9Eyxi3qxeEhnOXUzL5_BcCQ0w. 这些 URLs 使用起来不太方便,因此你通常更希望通过其 ID 来标识一个 sheet。
#students_sheet_id <- "1V1nPp1tzOuutXFLb3G9Eyxi3qxeEhnOXUzL5_BcCQ0w"
#students <- read_sheet(students_sheet_id)
#students就像我们对 read_excel() 所做的那样,我们可以向 read_sheet() 提供列名、NA 字符串以及列类型。
#students <- read_sheet(
# students_sheet_id,
# col_names = c("student_id", "full_name", "favourite_food", "meal_plan", #"age"),
# skip = 1,
# na = c("", "N/A"),
# col_types = "dcccc"
#)
#students请注意,我们在这里定义列类型的方式略有不同,使用了简短代码。 例如,“dcccc” 代表 “double, character, character, character, character”。
从 Google Sheets 中读取单个工作表也是可行的。 让我们从 penguins Google Sheet 中读取 “Torgersen Island” 工作表:
#penguins_sheet_id <- "1aFu8lnD_g0yjF5O-K6SFgSEWiHPpgvFCF0NY9D6LXnY"
#read_sheet(penguins_sheet_id, sheet = "Torgersen Island")你可以使用 sheet_names() 获取 Google Sheet 中所有工作表的列表:
#sheet_names(penguins_sheet_id)最后,与 read_excel() 类似,我们可以通过在 read_sheet() 中定义 range 参数来读取 Google Sheet 的一部分。 请注意,我们在下面也使用了 gs4_example() 函数来定位 googlesheets4 包自带的一个示例 Google Sheet。
#deaths_url <- gs4_example("deaths")
#deaths <- read_sheet(deaths_url, range = "A5:F15")
#deaths20.3.4 Writing to Google Sheets
你可以使用 write_sheet() 将数据从 R 写入 Google Sheets。 第一个参数是要写入的数据框,第二个参数是要写入的 Google Sheet 的名称(或其他标识符):
write_sheet(bake_sale, ss = "bake-sale")如果你想要将数据写入 Google Sheet 内的特定工作表,也可以通过 sheet 参数来指定。
write_sheet(bake_sale, ss = "bake-sale", sheet = "Sales")20.3.5 Authentication
虽然你无需通过 Google 账户验证即可读取公开的 Google Sheet,但读取私有 sheet 或写入 sheet 则需要验证,以便 googlesheets4 能够查看和管理你的 Google Sheets。
当你尝试读取需要验证的 sheet 时,googlesheets4 会引导你打开网页浏览器,提示你登录 Google 账户并授予其代表你操作 Google Sheets 的权限。 然而,如果你想指定特定的 Google 账户、验证范围等,可以使用 gs4_auth() 来实现,例如 gs4_auth(email = "mine@example.com"),这将强制使用与特定电子邮件关联的令牌。 有关验证的更多细节,我们建议阅读 googlesheets4 验证插文的文档: https://googlesheets4.tidyverse.org/articles/auth.html.
20.3.6 Exercises
从本章前文的 Excel 和 Google Sheets 中读取
students数据集,在调用read_excel()和read_sheet()函数时不提供任何额外参数。 在 R 中得到的数据框完全相同吗? 如果不是,它们有何不同?从 https://pos.it/r4ds-survey 读取名为 survey 的 Google Sheet,并将
survey_id指定为字符变量,n_pets指定为数值变量。从 https://pos.it/r4ds-roster 读取名为 roster 的 Google Sheet。 生成的数据框应命名为
roster,并且看起来像下面这样。
20.4 Summary
Microsoft Excel 和 Google Sheets 是两个最流行的电子表格系统。 能够直接从 R 中与存储在 Excel 和 Google Sheets 文件中的数据进行交互,是一项强大的技能! 在本章中,你学习了如何使用 readxl 包中的 read_excel() 函数将 Excel 电子表格中的数据读入 R,以及如何使用 googlesheets4 包中的 read_sheet() 函数将 Google Sheets 中的数据读入 R。 这些函数的工作方式非常相似,并且具有相似的参数,用于指定列名、NA 字符串、要跳过的文件顶部行数等。 此外,这两个函数都可以从电子表格中读取单个工作表。
另一方面,写入 Excel 文件需要使用不同的包和函数(writexl::write_xlsx()),而你可以使用 googlesheets4 包中的 write_sheet() 函数写入 Google Sheet。
在下一章中,你将学习一个不同的数据源以及如何将该数据源中的数据读入R:数据库。