:orphan:

Dolt
====

The ``DoltTable`` plugin is a wrapper that uses `Dolt <https://github.com/dolthub/dolt>`__ to move data between
``pandas.DataFrame``'s at execution time and database tables at rest.

Installation
------------
The dolt plugin and dolt command line tool are required to run these examples:

.. code:: bash

   pip install flytekitplugins.dolt
   sudo bash -c 'curl -L https://github.com/dolthub/dolt/releases/latest/download/install.sh | sudo bash'

Dolt requires a user configuration to run ``init``:

.. code:: bash

   dolt config --global --add user.email <email>
   dolt config --global --add user.name <name>

These demos assume a ``foo`` database has been created locally:

.. code:: bash

   mkdir foo
   cd foo
   dolt init

.. panels::
    :header: text-center
    :column: col-lg-12 p-2

    .. link-button:: https://blog.flyte.org/upleveling-flyte-data-lineage-using-dolt
       :type: url
       :text: Blog Post
       :classes: btn-block stretched-link
    ^^^^^^^^^^^^
    An article detailing Dolt and Flyte integration.

.. toctree::
    :maxdepth: -1
    :caption: Contents
    :hidden:

    Blog Post <https://blog.flyte.org/upleveling-flyte-data-lineage-using-dolt>



.. raw:: html

    <div class="sphx-glr-thumbnails">


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this demo and following example, learn how to use DoltTable to annotate DataFrame inputs and...">

.. only:: html

  .. image:: /auto/integrations/flytekit_plugins/dolt/images/thumb/sphx_glr_dolt_quickstart_example_thumb.png
    :alt: Quickstart

  :ref:`sphx_glr_auto_integrations_flytekit_plugins_dolt_dolt_quickstart_example.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Quickstart</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example, we&#x27;ll show how to use DoltTable along with Dolt&#x27;s Branch feature.">

.. only:: html

  .. image:: /auto/integrations/flytekit_plugins/dolt/images/thumb/sphx_glr_dolt_branch_example_thumb.png
    :alt: Dolt Branches

  :ref:`sphx_glr_auto_integrations_flytekit_plugins_dolt_dolt_branch_example.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Dolt Branches</div>
    </div>


.. raw:: html

    </div>


.. toctree::
   :hidden:

   /auto/integrations/flytekit_plugins/dolt/dolt_quickstart_example
   /auto/integrations/flytekit_plugins/dolt/dolt_branch_example


.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-gallery

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download all examples in Python source code: dolt_python.zip </auto/integrations/flytekit_plugins/dolt/dolt_python.zip>`

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download all examples in Jupyter notebooks: dolt_jupyter.zip </auto/integrations/flytekit_plugins/dolt/dolt_jupyter.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_