multimport : 一次性导入并合并多个文件

发布时间：2020-07-22 阅读 7452

Stata 连享会主页 || 视频 || 推文

温馨提示： 定期清理浏览器缓存，可以获得最佳浏览体验。

✌ 课程详情： https://gitee.com/arlionn/Course | lianxh.cn

✨ 课程主页： https://gitee.com/arlionn/Course

作者：吴玉轩 (南开大学)
E-mail：peteral@yeah.net

实证分析中经常需要把多个 Excel 或 txt 文档导入 Stata 并纵向追加。

在此前的推文 [Stata: 如何快速合并 3500 个无规则命名的数据文件？] 中，我们介绍了如何使用循环语句 foreach，以及外部命令 openall 一次性合并某个文件夹下的所有 .txt 文档。

这里任务通常需要两个步骤来完成：读入与纵向追加。

我们可以用 fs 命令解决读入的问题，用 openall 或者 append 循环对读入的文件进行纵向追加，但对于初学者而言略显繁琐。

今天介绍的 multimport 命令可以将上述两步合二为一，真正实现一次性导入并合并多个文件的目的。

1. 命令的安装

该命令的安装较为简单，在 Stata 命令窗口输入如下代码即可（若此前已经安装，附加 replace 选项可以自动更新）：

ssc install multimport, replace

这样就完成了安装的过程，下面是对该命令的介绍。

2. 命令的含义

该命令的语法如下：

multimport import_method, 
  [directory(filespec) 
  extension(ext1[ext2...]) 
  include(file1[file2...]) 
  exclude(file1[file2...]) 
  importoptions(import_method_opts) 
  appendoptions(append_opts) ]

各个主要选项的含义：

import_method, 必选项，包括 excel 与 delimited 两个填项，multimport excel 表示导入 excel 格式的文件，multimport delimited 则表示导入文本文件（txt 或 csv）
directory, 简记为dir, 可选项，设定导入文件所在的路径，若不填写则默认为当前工作路径
extension, 简记为 ext, 可选项，用以覆盖 multimport 默认导入的文件的类型 (即文件的扩展名 \ 后缀)。例如，下面的代码将会导入扩展名为 txt 与 csv 的文本文件

multimport delimited,ext(csv txt)

include 与 exclude 选项，顾名思义，就是包括与排除某些文件，这些文件不会被读入内存。

multimport excel, include("svy2011.xls" "svy2012.xls" "svy2013.xls")

上述代码将导入 svy2011-svy2013 等3个 excel 文件，其余 excel 文件不会读入。

importoptions 与 appendoptions 选项是对 import_method 与 append 方法的进一步设定，较少使用。

3. 命令的使用

下面将通过一个实例来简要说明如何通过 multimport 命令来导入并合并文本文件与 excel 文件。

3.1 文本文件的导入与合并

为方便起见，基于 Stata 官方数据集 nhanes2.dta 构造所需要的文本文件，代码如下：

虚构一些文本文件

webuse nhanes2.dta, clear 
tab region //region 取值为1-4
levelsof region // 根据region变量的不同取值构造暂元，并存储在r(levels)中
foreach r in `r(levels)' {
  export delimited using nhanes_reg`r' if region == `r' //导出不同region分类的文本文件
}

上述代码生成了基于不同 region 的文本文件：nhanes_reg1.csv-nhanes_reg4.csv，下面将选定的文本文件导入并进行合并。

读入并合并文本文件

multimport delimited, clear include(nhanes_reg1.csv nhanes_reg2.csv)

上述代码将 nhanes_reg1 与 nhanes_reg2 两个 csv 文件导入并进行了纵向合并。如果想合并所有的 csv 文件，去掉 include 选项即可。

值得注意的是，在上述代码的执行过程中，Stata 输出界面会提示交互信息： Proceed(yes/no?)，需要手动输入yes/no，较为繁琐。为解决这一问题，加入force选项即可，强制读入并进行合并，修正后的代码如下：

multimport delimited, clear include(nhanes_reg1.csv nhanes_reg2.csv) force
save nhanes_csv, replace  // 保存合并后的数据文件

3.2 excel 文件的读入与合并

excel 文件的读入与合并过程与上面的类似，同样以数据集 nhanes2.dta 为例，相应的执行代码如下：

虚构一些 excel 文件

use http://www.stata-press.com/data/r14/nhanes2.dta 
levelsof region 
foreach r in `r(levels)' {
  export excel using nhanes_reg`r' if region == `r' 
}

上述代码生成了 nhanes_reg1.xls-nhanes_reg4.xls 等 4 个 excel 文件。

读入并合并文件

multimport excel, clear exclude(nhanes_reg2.xls) force
save nhanes_excel,replace

上述代码排除了名称为 nhanes_reg2 的 excel 文件，并将剩余的 excel 文件导入并进行合并。

以上便是 multimport 命令的基本内容，掌握该命令的用法后可以迅速而简洁地完成文件的读入与合并工作。

最后，为了便于大家使用，提供如下模板：

local in ""  //需要合并的文件
local ex ""  //无需合并的文件，若无，可以留空
multimport excel, clear exclude(nhanes_reg2.xls) force
save nhanes_excel,replace

4. 相关命令

help csvconvert // 纵向合并多个 csv 文件并存储为 Stata 数据格式
help multimport //一次性总纵向合并多个非 Stata 格式的数据，并存储为 Stata 数据文件
help dsconcat //一次性纵向合并多个 Stata 数据文件

5. 相关推文和链接

相关课程

连享会-直播课 上线了！
http://lianxh.duanshu.com

免费公开课：

直击面板数据模型 - 连玉君，时长：1小时40分钟
Stata 33 讲 - 连玉君, 每讲 15 分钟.
部分直播课课程资料下载 (PPT，dofiles等)

课程一览

支持回看，所有课程可以随时购买观看。

专题	嘉宾	直播/回看视频
⭐ 最新专题 ⭐		DSGE, 因果推断, 空间计量等
⭕ Stata数据清洗	游万海	直播, 2 小时，已上线
研究设计	连玉君	我的特斯拉-实证研究设计，-幻灯片-
面板模型	连玉君	动态面板模型，-幻灯片-
面板模型	连玉君	直击面板数据模型 [免费公开课，2小时]

Note: 部分课程的资料，PPT 等可以前往连享会-直播课主页查看，下载。

关于我们

Stata连享会 由中山大学连玉君老师团队创办，定期分享实证分析经验。直播间有很多视频课程，可以随时观看。
连享会-主页和知乎专栏，300+ 推文，实证分析不再抓狂。
公众号推文分类： 计量专题 | 分类推文 | 资源工具。推文分成 内生性 | 空间计量 | 时序面板 | 结果输出 | 交乘调节 五类，主流方法介绍一目了然：DID, RDD, IV, GMM, FE, Probit 等。
公众号关键词搜索/回复 功能已经上线。大家可以在公众号左下角点击键盘图标，输入简要关键词，以便快速呈现历史推文，获取工具软件和数据下载。常见关键词：课程, 直播, 视频, 客服, 模型设定, 研究设计, stata, plus, 绘图, 编程, 面板, 论文重现, 可视化, RDD, DID, PSM, 合成控制法 等