连享会   主页 || 推文 || 知乎 || B 站 || 在线课堂

New！ 搜推文，找资料，用 lianxh 命令：
安装： ssc install lianxh, replace
使用： lianxh 合成控制
       lianxh DID + 多期, w

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

目录
[[TOC]]

实证分析中经常需要把多个 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. 相关推文和链接

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

资源共享

• 连享会资料 ……
• 在线视频：lianxh-class.cn
  • Stata 33 讲，100 万+ 播放，Stata 入门必备，公开课
  • 直击面板数据模型，10 万+ 播放，白话面板模型，公开课
  • … more …
• 论文复现和数据
  • 学术论文重现网站大全
  • 常用数据库 | 人文社科开放数据库
• 主题分类
  • 所有分类 | Stata教程 | 结果输出 | 绘图 | 数据处理
  • 回归分析 | 面板数据 | 交乘项 | 因果推断 | DID | RDD
  • Markdown | 工具软件 | 机器学习 | 其它
• 热门推文
  • Stata：DID 入门教程
  • 稳健性检验！ | 安慰剂检验！ | 内生性！
  • 面板数据模型 |  聚类调整后的标准误

尊敬的老师 / 亲爱的同学们：
连享会致力于不断优化和丰富课程内容，以确保每位学员都能获得最有价值的学习体验。为了更精准地满足您的学习需求，我们诚挚地邀请您参与到我们的课程规划中来。
请您在下面的问卷中，分享您 感兴趣的学习主题或您希望深入了解的知识领域 。您的每一条建议都是我们宝贵的资源，将直接影响到我们课程的改进和创新。
我们期待您的反馈，因为您的参与和支持是我们不断前进的动力。感谢您抽出宝贵时间，与我们共同塑造更加精彩的学习旅程！https://www.wjx.cn/vm/YgPfdsJ.aspx# 再次感谢大家宝贵的意见！

关于我们

• Stata连享会 由中山大学连玉君老师团队创办，定期分享实证分析经验。more……
• 扫码加入连享会微信群，提问交流更方便