DOCSP-30572 Table Filters Drawer (#8)

* DOCSP-30572 Table Filters

* *

* apply table UI bold

* guilabel role

* IR Feedback

* IR Feedback

Author: ianf-mongodb

source/mapping-rules/mapping-rules.txt

@@ -1,3 +1,5 @@
+.. _rm-mapping-rules:
+
 =============
 Mapping Rules
 =============

source/mapping-rules/new-rules-from-relational.txt

@@ -1,3 +1,5 @@
+.. _rm-create-mapping-rules:
+
 ===========================
 Create Rule From Relational
 ===========================

source/table-filters/apply-table-filters.txt

@@ -1,3 +1,45 @@
 ===================
 Apply Table Filters
-===================
+===================
+
+
+You can use table filters to migrate specific subsets of your table data.
+Table filters allow you to apply SQL where and row limit clauses
+when pulling data from your table.
+
+Before you Begin
+----------------
+
+Table filters are applied while you are creating mapping rules. See 
+:ref:`<rm-create-mapping-rules>` for more details.
+
+You can apply one filter per table. Each filter can have a SQL where 
+clause, a row limit clause, or both.
+
+Steps
+-----
+
+
+#. From the :guilabel:`Schema model` pane, click the table that you want to apply a filter to.
+#. On the :guilabel:`Filter on` section in the edit :guilabel:`mapping rule` pane, click :guilabel:`+ Add`.
+#. Under the :guilabel:`SQL query` header, enter a SQL where criteria. The 
+   SQL you specify must be ANSI SQL compliant with your relational database.
+   The following are examples of SQL where clauses used to apply 
+   :guilabel:`SQL query` table filters:
+
+   - ``LASTNAME LIKE '%SMITH%'``
+   - ``LASTNAME = 'SMITH'``
+   - ``LASTNAME IN('SMITH')``
+   - ``LASTNAME IN(SELECT LASTNAME FROM ASIA_CUSTOMERS WHERE ID < 100000)``
+   - ``LASTNAME IN(SELECT LASTNAME FROM ASIA_CUSTOMERS 
+     WHERE PAYMENT_DATE >= 05/25/2015)``
+
+#. (Optional) Under the :guilabel:`Row limit` header, click the :guilabel:`Limit number of rows`
+   radio button and enter a value. This applies a limit clause at the 
+   end of your SQL query.
+#. Click :guilabel:`Save and close`.
+
+Learn More
+----------
+
+:ref:`<rm-mapping-rules>`

source/table-filters/table-filters.txt

@@ -2,6 +2,42 @@
 Table Filters
 =============
 
+In a migration project, you can apply table filters to control the 
+volume of data migrated from each table. You can apply table filters 
+when you configure the mapping rules from the relational schema model.
+
+Table filters allow you to:
+
+- Migrate your data in logical batches.
+- Limit the read operations on your source database.
+- Create test environments before migrating your entire database.
+
+Table Filter Types
+------------------
+
+You can apply one filter per table. Each filter can have a SQL where 
+clause, a row limit clause, or both.
+
+.. list-table::
+   :header-rows: 1
+
+   * - Filter Component
+     - Description
+     - Example
+     - SQL Syntax
+   * - SQL
+     - Apply a SQL where clause to the tables database query.
+     - Only the customers who have a last name of Smith.
+     - ``WHERE LASTNAME = 'SMITH'``
+   * - Row limit
+     - Apply a SQL limit clause to the tables database query.
+     - Only migrate the top 100 rows.
+     - ``... LIMIT 100``
+   * - Both
+     - Apply a SQL where clause and a limit clause to the tables database query.
+     - Only 100 rows for customers who have a last name of Smith.
+     - ``WHERE LASTNAME = 'SMITH' LIMIT 100``
+
 .. toctree::
    :titlesonly:
    :hidden: