使用來源篩選條件

您可以使用來源篩選條件來限制從來源傳輸到目標的記錄數量和類型。例如，您可以指定只將位置是總部的員工移動到目標資料庫。篩選條件是選取規則的一部分。您可以在資料的資料行上套用篩選條件。

來源篩選條件必須遵循這些限制條件：

• 選取規則可以沒有篩選條件，或擁有一或多個篩選條件。

• 每個篩選可以擁有一或多個篩選條件。

• 若使用超過一個篩選條件，則會合併篩選條件清單，就好像在篩選條件間使用 AND 運算子。

• 若在單一篩選中使用超過一個篩選條件，則會合併篩選條件清單，就好像在篩選條件間使用 OR 運算子。

• 篩選條件只會在 rule-action = 'include' 時套用。

• 篩選需要資料行名稱和篩選條件清單。篩選條件必須具有與一個值、兩個值或無值相關聯的篩選運算子，具體取決於運算子。

• 資料行名稱、資料表名稱、檢視名稱和結構描述名稱都區分大小寫。Oracle 和 Db2 應一律使用大寫。

• 篩選器僅支援具有精確名稱的資料表。篩選器不支援萬用字元。

下列限制適用於使用來源篩選條件：

• 篩選器不會計算 right-to-left 語言欄。

• 請勿將篩選條件套用至 LOB 欄。

• 僅將篩選條件套用至不可變欄，在建立後不會更新。如果來源篩選條件套用於可變欄時，在建立後更新並可能會導致不良行為。

  例如，在欄中排除或包含特定資料列的篩選條件一律排除或包含指定的資料列，即使這些資料列之後有所變更。假設您在 A 欄中排除或包含資料列 1-10，然後它們稍後會變更為資料列 11-20。在這種情況下，即使資料不再相同，也會繼續排除或包含這些資料。

  同樣地，假設篩選條件範圍外的資料列稍後更新了 (或更新後刪除)，則應該依據篩選條件的定義予以排除或包含。在這種情況下，它將複寫至目標。

使用來源篩選器時，會有下列其他考量：

• 建議您使用篩選定義中包含的資料行和主索引鍵來建立索引。

以 JSON 建立來源篩選條件規則

您可以使用選擇規則的 JSON filters 參數建立來源篩選條件。filters 參數指定一或多個 JSON 物件所組成的陣列。每個物件都有參數指定來源篩選類型、欄名稱和篩選條件。這些篩選條件包括一或多個篩選運算子和篩選值。

下表顯示在 filters 物件中用於指定來源篩選的參數。

參數	Value
filter-type	source
column-name	此參數具有您希望套用篩選條件的來源資料欄名稱。名稱區分大小寫。
filter-conditions	一或多個物件組成的陣列，其中包含 filter-operator 參數和零，或是更多相關聯的值參數，具體取決於 filter-operator 值。
filter-operator	具有下列其中一個值的參數： lte – 小於或等於一個值 ste – 小於或等於一個值 (lte 別名) gte – 大於或等於一個值 eq – 等於一個值 noteq – 不等於一個值 between – 等於或介於兩個值之間 notbetween – 不等於或介於兩個值之間 null – NULL 值 notnull – 沒有 NULL 值
value 或 start-value 和 end-value 或 沒有值	零個或多個值參數關聯至 filter-operator： 如果 filter-operator 是 lte、ste、gte、eq 或 noteq，則使用 value 指定一個值參數。 如果filter-operator 是 between 或 notbetween，則使用 start-value 和 end-value 來指定兩個值參數。 如果 filter-operator 是 null 或 notnull，則不指定任何值參數。

以下範例示範使用來源篩選條件的常見方式。

範例 單一篩選條件

以下篩選條件會將所有 empid >= 100 的員工複寫到目標資料庫。

 {
     "rules": [{
         "rule-type": "selection",
         "rule-id": "1",
         "rule-name": "1",
         "object-locator": {
             "schema-name": "test",
             "table-name": "employee"
         },
         "rule-action": "include",
         "filters": [{
             "filter-type": "source",
             "column-name": "empid",
             "filter-conditions": [{
                 "filter-operator": "gte",
                 "value": "50"
             },{
                 "filter-operator": "noteq",
                 "value": "100"
             }]
         }]
     }]
 }

範例 多個篩選條件運算子

以下篩選條件會將多個篩選條件運算子套用到資料的單一資料行。篩選條件會將所有 (empid <= 10) 或 (empid is between 50 and 75) 或 (empid >= 100) 的員工複寫到目標資料庫。

{
    "rules": [{
        "rule-type": "selection",
        "rule-id": "1",
        "rule-name": "1",
        "object-locator": {
            "schema-name": "test",
            "table-name": "employee"
        },
        "rule-action": "include",
        "filters": [{
            "filter-type": "source",
            "column-name": "empid",
            "filter-conditions": [{
                "filter-operator": "lte",
                "value": "10"
            }, {
                "filter-operator": "between",
                "start-value": "50",
                "end-value": "75"
            }, {
                "filter-operator": "gte",
                "value": "100"
            }]
        }]
    }]
} 
 

範例 多個篩選條件

以下篩選條件會將多個篩選條件套用到資料表中的兩個資料行。篩選條件會將所有 (empid <= 100) 和 (dept = tech) 的員工複寫到目標資料庫。

{
    "rules": [{
        "rule-type": "selection",
        "rule-id": "1",
        "rule-name": "1",
        "object-locator": {
            "schema-name": "test",
            "table-name": "employee"
        },
        "rule-action": "include",
        "filters": [{
            "filter-type": "source",
            "column-name": "empid",
            "filter-conditions": [{
                "filter-operator": "lte",
                "value": "100"
            }]
        }, {
            "filter-type": "source",
            "column-name": "dept",
            "filter-conditions": [{
                "filter-operator": "eq",
                "value": "tech"
            }]
        }]
    }]
} 
 

範例 篩選 NULL 值

下列篩選條件展示如何篩選空值。它會將條件為 dept = NULL 的所有員工複寫到目標資料庫。

{
    "rules": [{
        "rule-type": "selection",
        "rule-id": "1",
        "rule-name": "1",
        "object-locator": {
            "schema-name": "test",
            "table-name": "employee"
        },
        "rule-action": "include",
        "filters": [{
            "filter-type": "source",
            "column-name": "dept",
            "filter-conditions": [{
                "filter-operator": "null"
            }]
        }]
    }]
} 
 

範例 使用 NOT 運算子篩選

部分運算子可以反向模式使用。以下篩選條件會將所有 (empid is < 50) OR (empid is > 75) 的員工複寫到目標資料庫。

{
    "rules": [{
        "rule-type": "selection",
        "rule-id": "1",
        "rule-name": "1",
        "object-locator": {
            "schema-name": "test",
            "table-name": "employee"
        },
        "rule-action": "include",
        "filters": [{
            "filter-type": "source",
            "column-name": "empid",
            "filter-conditions": [{
                "filter-operator": "notbetween",
                "start-value": "50",
                "end-value": "75"
            }]
        }]
    }]
} 
 

範例 使用混合篩選運算子

從 AWS DMS 版本 3.5.0 開始，您可以混合包含運算符和負運算符。

以下篩選條件會將所有 (empid != 50) AND (dept is not NULL) 的員工複寫到目標資料庫。

{
    "rules": [{
        "rule-type": "selection",
        "rule-id": "1",
        "rule-name": "1",
        "object-locator": {
            "schema-name": "test",
            "table-name": "employee"
        },
        "rule-action": "include",
        "filters": [{
            "filter-type": "source",
            "column-name": "empid",
            "filter-conditions": [{
                "filter-operator": "noteq",
                "value": "50"
            }]
        }, {
            "filter-type": "source",
            "column-name": "dept",
            "filter-conditions": [{
                "filter-operator": "notnull"
            }]
        }]
    }]
} 
 

使用 null 搭配其他篩選運算子時，請注意下列事項：

• 在相同的篩選條件中同時使用包含、反向和 null 篩選條件，將不會複寫具有 NULL 值的記錄。

• 若在相同的篩選條件中同時使用反向和 null 篩選條件，且不使用包含篩選條件時，系統將不會複製任何資料。

• 使用反向篩選條件而沒有明確設定 null 篩選條件時，將不會複寫具有 NULL 值的記錄。

依時間和日期篩選

選取要匯入的資料時，您可以指定日期或時間做為篩選條件的一部分。 AWS DMS 使用日期格式 YYYY-MM-DD 和時間格式 YYYY-MM-DD 高:MM: SS 進行篩選。比 AWS DMS 較函數遵循 SQLite 慣例。如需 SQLite 資料類型和日期比較的詳細資訊，請參閱 SQLite 文件中的 Datatypes In SQLite Version 3。

以下篩選條件示範如何篩選日期。它會將條件為 empstartdate >= January 1, 2002 的所有員工複寫到目標資料庫。

範例 單一日期篩選條件

{
    "rules": [{
        "rule-type": "selection",
        "rule-id": "1",
        "rule-name": "1",
        "object-locator": {
            "schema-name": "test",
            "table-name": "employee"
        },
        "rule-action": "include",
        "filters": [{
            "filter-type": "source",
            "column-name": "empstartdate",
            "filter-conditions": [{
                "filter-operator": "gte",
                "value": "2002-01-01"
            }]
        }]
    }]
}