---
title: "SQL 条件过滤数据 | OceanBase 文档中心"
description: SQL 条件过滤数据 本文为您介绍创建数据迁移项目时，选择迁移对象后通过 SQL 条件过滤数据的适用场景、使用限制和操作步骤。 适用场景 创建数据迁移项目时，您可以设置 SQL 过滤条件来过滤数据。完成设置后，只有满足过滤条件的数据才会被迁移或同步至目标数据库。该功能适用于数据的定期同步或迁移、拆分数据表、过滤历史数…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*L03BS6f-o40AAAAAAAAAAAAADiGDAQ/original) 迁移服务 OMSV 4.2.1 社区版

# SQL 条件过滤数据

更新时间：2026-04-14 15:40:37

[编辑](https://github.com/oceanbase/oms-doc/edit/V4.2.1/zh-CN/600.data-migration/1600.migration-function-introduction/600.migration-row-filters.md)  

本文为您介绍创建数据迁移项目时，选择迁移对象后通过 SQL 条件过滤数据的适用场景、使用限制和操作步骤。

## 适用场景

创建数据迁移项目时，您可以设置 SQL 过滤条件来过滤数据。完成设置后，只有满足过滤条件的数据才会被迁移或同步至目标数据库。该功能适用于数据的定期同步或迁移、拆分数据表、过滤历史数据和脏数据等多种应用场景。

## 使用限制

- 通过 SQL 条件过滤数据时，仅支持过滤当前表的字段，不支持跨表过滤。
 - SQL 条件过滤数据的作用范围为全量迁移、增量同步和全量校验。
 - SQL 条件过滤数据使用的列请勿执行 DDL 变更，否则可能导致数据迁移异常。

## 操作步骤

1. 新建数据迁移项目，并配置至 **选择迁移对象** 步骤。

   详情请参见 [数据迁移](https://www.oceanbase.com/docs/community-oms-cn-1000000000425830) 模块相应类型的创建数据迁移项目文档。
 2. 选择迁移对象后，在 **选择迁移范围** 区域右侧的 **目标端对象** 列表中，鼠标悬停至目标表对象。
 3. 单击显示的 **设置**。

   ![filters-1-zh](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/filters1-1-zh.png)
 4. 在 **设置** 对话框中，输入标准的 SQL 语句中的 `WHERE` 子句，来配置行过滤。

   ![row-filter-1-zh](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/row-filter-1-zh.png)

   SQL WHERE 语句的语法说明如下：

      - 列名不会进行大小写转换，请输入正确的列名，并对列名添加转义符（`）。例如，`col`。
      - 过滤条件支持标准的 SQL WHERE 语句（仅支持 =、!=、< 和 > 操作符），只有满足 WHERE 条件的数据才会被同步至目标数据库。例如，`id` > 200。
      - 过滤条件支持根据时间条件进行过滤，但请注意 SQL WHERE 语句中对时间的格式要求（yyyy-MM-dd HH:mm:ss 或 yyyy-MM-dd）。例如，您需要过滤 2022 年 12 月 31 日之后的增量数据，请输入 `date_now` > '2022-12-31' 或 `date_now` > '2022-12-31 00:00:00'。
      - 如果您需要过滤某个时间段内的数据，请使用 and 或 or 语句。例如，您需要过滤 2021 年 12 月 31 日至 2022 年 4 月 1 日之间的数据，请输入 `init_date`>'2021-12-31' and `init_date`<'2022-04-01'。
      - 过滤条件中需要使用英文单引号（'）。例如 `address` in ('BEIJING','HANGZHOU')。
 5. 配置完成后，单击 **验证语法**。

   ![row-filter-2-zh](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/row-filter-2-zh.png)
 6. 单击 **确定**。
 7. 根据提示完成后续的项目配置。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线