作者：吴玉轩 (南开大学)

Stata 连享会： 知乎 | 简书 | 码云

 

• Stata连享会 精品专题 || 精彩推文

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

实证分析中经常需要把多个 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

 

相关命令

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

相关推文和链接

• Stata: 如何快速合并 3500 个无规则命名的数据文件？
• Stata小白系列之一：调入数据
• Stata小白系列之二：数据拆分与合并
• 普林斯顿Stata教程 - Stata数据管理
• Stata 新命令 readWind：快速读入并转换万德数据
• Stata: 你还在用reshape转换长宽数据吗？那你就OUT了！
• multimport: automatic import and append of non-Stata data
• 送你一只粘合剂——用 openall 命令合并数据

 

关于我们

• 【Stata 连享会(公众号：StataChina)】由中山大学连玉君老师团队创办，旨在定期与大家分享 Stata 应用的各种经验和技巧。
• 公众号推文同步发布于 CSDN-Stata连享会 、简书-Stata连享会 和 知乎-连玉君Stata专栏。可以在上述网站中搜索关键词Stata或Stata连享会后关注我们。
• 点击推文底部【阅读原文】可以查看推文中的链接并下载相关资料。
• Stata连享会 精品专题 || 精彩推文

联系我们

• 欢迎赐稿： 欢迎将您的文章或笔记投稿至Stata连享会(公众号: StataChina)，我们会保留您的署名；录用稿件达五篇以上，即可免费获得 Stata 现场培训 (初级或高级选其一) 资格。
• 意见和资料： 欢迎您的宝贵意见，您也可以来信索取推文中提及的程序和数据。
• 招募英才： 欢迎加入我们的团队，一起学习 Stata。合作编辑或撰写稿件五篇以上，即可免费获得 Stata 现场培训 (初级或高级选其一) 资格。
• 联系邮件： StataChina@163.com

往期精彩推文

• Stata连享会推文列表
• Stata连享会 精品专题 || 精彩推文

image

---

欢迎加入Stata连享会(公众号: StataChina)