
# SHOW_COMMIT_FILES
#### 约束与限制
本章节仅适用于MRS 3.3.0-LTS及之后版本。
#### 命令功能
Hudi提供SHOW_COMMIT_FILES命令，查看指定Instant（即某次写入操作在Timeline上的记录）对应的文件更新和插入详情。以便了解某次Commit操作具体更新或插入了哪些文件，排查数据问题或确认写入结果。
#### 命令格式
**call show_commit_files(table=\>'\[table\]', instant_time=\>'\[instant_time\]', limit=\>'\[limit\]');**
#### 参数描述
表1参数描述 
| **参数**       | **描述**                               | 是否必填 |
|:---|:---|:---|
| table        | 需要查询Hudi表的表名，支持database.tablename格式。 | 是    |
| instant_time | 某次commit对应的时间戳。                      | 是    |
| limit        | 限制返回结果的条数。                           | 否    |
   
#### 示例
```
call show_commit_files(table=>'hudi_mor', instant_time=>'20230216144548249');
call show_commit_files(table=>'hudi_mor', instant_time=>'20230216144548249', limit=>'1');
```
#### 返回结果
| **参数**                | **描述**                                                          |
|:---|:---|
| action                | instant_time对应的commit所属的action类型，如compaction、deltacommit、clean等 |
| partition_path        | 指定的instant所更新或插入的文件位于哪个分区                                       |
| file_id               | 指定的instant所更新或插入的文件的ID                                          |
| previous_commit       | 指定的instant所更新或插入文件名中的时间戳                                        |
| total_records_updated | 该文件中多少个record被更新                                                |
| total_records_written | 该文件中新插入了多少个record                                               |
| total_bytes_written   | 该文件新增多少bytes的数据                                                 |
| total_errors          | 指定的instant在更新或者插入过程中的报错                                         |
| file_size             | 该文件的大小（bytes）                                                   |
   
#### 系统响应
可在客户端中查看查询结果。
