---
source_url: https://docs.dolphindb.cn/zh/funcs/b/backupTable.html
fetched_at: 2026-05-19T09:13:35Z
category: funcs
title: backupTable
sha1: ee1d05f0e668b1ee5b4d126c89764300124520a9
---

# backupTable

## 语法

`backupTable(backupDir, dbPath, tableName, [keyPath])`

## 详情

备份数据库中的表到指定路径。

该函数是 [backup](backup.html) 函数的特例，其等价于调用 `backup(backupDir,
dbPath, force=false, parallel=true, snapshot=true, tableName)`。
调用该函数可以简化代码，方便用户一次性备份数据库的一张表。

## 参数

**backupDir** 字符串，表示存放备份数据的目录。

**dbPath** 字符串，表示数据库路径。

**tableName** 字符串，表示表名。

**keyPath** 字符串标量，指定备份时使用的密钥文件路径。仅 Linux 系统支持该参数。该密钥用于对备份数据进行加密。设置为空即不加密。

## 返回值

INT 类型标量，表示备份成功的表数量。

## 例子

```dolphindb
dbName = "dfs://compoDB2"
n=1000
ID=rand("a"+string(1..10), n)
dates=2017.08.07..2017.08.11
date=rand(dates, n)
x=rand(10, n)
t=table(ID, date, x)
db1 = database(, VALUE, 2017.08.07..2017.08.11)
db2 = database(, HASH,[INT, 20])
if(existsDatabase(dbName)){
  dropDatabase(dbName)
}
db = database(dbName, COMPO,[ db1,db2])

// 创建2个表
pt1 = db.createPartitionedTable(t, `pt1, `date`x).append!(t)
pt2 = db.createPartitionedTable(t, `pt2, `date`x).append!(t)

backupTable(backupDir,dbName,`pt1)
// output
50
```

相关函数：[backup](backup.html), [backupDB](backupDB.html), [restore](../r/restore.html), [restoreDB](../r/restoreDB.html), [restoreTable](../r/restoreTable.html), [migrate](../m/migrate.html)
