Mutable Table functions
================================
The ETL Toolkit has special functions to create and update tables that are using the ``MutableTable` component from Atlas data apps. Mutable tables are useful when there needs to human-entered data or updates to databricks tables. This should be a preferred method over using google sheets as mutable tables are performant, durable, and preserve change tracking of human edits.

.. tip:: It is required to use these functions to when creating tables as they will automatically add the necessary meatadata fields and settings to work seamlessly with data apps using this component.

--------------------------
Table Operations
--------------------------
There is a dedicated function to initialize a mutable table in databricks and subsequently sync or merge in human-edits into a mutable table inside databricks. The idea is that sync operations should be run periodically in accordance to pipeline needs while humans can edit the mutable table as needed.

.. autoapifunction:: etl_toolkit.create_mutable_table
.. autoapifunction:: etl_toolkit.sync_mutable_table