---
source_url: https://docs.dolphindb.cn/zh/funcs/s/settablecomment.html
fetched_at: 2026-05-19T09:39:07Z
category: funcs
title: setTableComment
sha1: db4f60acbdadc4b025f5d794ccb8ea6fa70f3160
---

# setTableComment

## 语法

`setTableComment(table, comment)`

## 详情

给分布式表添加注释，表注释可通过函数 [schema](schema.html) 查看。

## 参数

**table** 是一个分布式表。

**comment** 字符串标量，表示表注释。长度不可超过 4096 字节。

## 例子

```dolphindb
// 创建分布式表
db = database(directory="dfs://testDB", partitionType=VALUE, partitionScheme=1..5)
schemaTB = table(1..5 as id, take(`A`B`C,5) as sym, rand(10.0,5) as price)
pt = db.createPartitionedTable(table=schemaTB, tableName="pt", partitionColumns="id")

// 设置表的注释
setTableComment(table=pt, comment="my first pt")

// 通过 schema 查看
schema(pt)["tableComment"]
// output：'my first pt'
```
