reorganize sqlite3 user guide example

cookbook/docs/conf.py

@@ -238,9 +238,8 @@ def __call__(self, filename):
     "../deployment/cluster",
     # "../deployment/guides",  # TODO: add content to this section
     # "../control_plane",  # TODO: add content to this section
-    # "../integrations/flytekit_plugins/sqllite3",  # TODO: add content to this section
+    "../integrations/flytekit_plugins/sql",
     "../integrations/flytekit_plugins/papermilltasks",
-    # "../integrations/flytekit_plugins/sqlalchemy",  # TODO: add content to this section
     "../integrations/flytekit_plugins/pandera",
     "../integrations/flytekit_plugins/dolt",
     "../integrations/kubernetes/pod",
@@ -267,9 +266,8 @@ def __call__(self, filename):
     "auto/deployment/cluster",
     # "auto/deployment/guides",  # TODO: add content to this section
     # "auto/control_plane",  # TODO: add content to this section
-    # "auto/integrations/flytekit_plugins/sqllite3",  # TODO: add content to this section
+    "auto/integrations/flytekit_plugins/sql",
     "auto/integrations/flytekit_plugins/papermilltasks",
-    # "auto/integrations/flytekit_plugins/sqlalchemy",  # TODO: add content to this section
     "auto/integrations/flytekit_plugins/pandera",
     "auto/integrations/flytekit_plugins/dolt",
     "auto/integrations/kubernetes/pod",

cookbook/docs/flytekit_plugins.rst

@@ -18,6 +18,15 @@ You can find the plugins maintained by the core flyte team `here <https://github
 .. panels::
    :header: text-center
 
+   .. link-button:: auto/integrations/flytekit_plugins/sql/index
+      :type: ref
+      :text: SQL
+      :classes: btn-block stretched-link
+   ^^^^^^^^^^^^
+   Execute SQL queries as tasks.
+
+   ---
+
    .. link-button:: auto/integrations/flytekit_plugins/papermilltasks/index
       :type: ref
       :text: Papermill
@@ -34,16 +43,22 @@ You can find the plugins maintained by the core flyte team `here <https://github
    ^^^^^^^^^^^^
    Validate pandas dataframes with ``pandera``.
 
+   ---
+
+   .. link-button:: auto/integrations/flytekit_plugins/dolt/index
+      :type: ref
+      :text: Dolt
+      :classes: btn-block stretched-link
+   ^^^^^^^^^^^^
+   Validate pandas dataframes with ``pandera``.
 
-.. TODO: add the following items to the TOC when the content is written.
-.. - auto/integrations/flytekit_plugins/sqllite3/index
-.. - auto/integrations/flytekit_plugins/sqlalchemy/index
 
 .. toctree::
    :maxdepth: -1
    :caption: Contents
    :hidden:
 
+   auto/integrations/flytekit_plugins/sql/index
    auto/integrations/flytekit_plugins/papermilltasks/index
    auto/integrations/flytekit_plugins/pandera/index
    auto/integrations/flytekit_plugins/dolt/index

cookbook/integrations/flytekit_plugins/sql/README.rst

@@ -0,0 +1,7 @@
+###
+SQL
+###
+
+Flyte tasks are not always restricted to running user-supplied containers, nor even containers at all. Indeed, this is
+one of the most important design decisions in Flyte. Non-container tasks can have arbitrary targets for execution -
+example an API that executes SQL queries like SnowFlake, BigQuery etc, a synchronous WebAPI etc.

cookbook/core/extend_flyte/sql.py → cookbook/integrations/flytekit_plugins/sql/sqlite3.py

@@ -1,15 +1,8 @@
 """
-.. _extend_sql_sqlite3:
+.. _integrations_sql_sqlite3:
 
-SQL Query Tasks
-===============
-
-SQLite3 Example 
----------------
-
-Flyte tasks are not always restricted to running user-supplied containers, nor even containers at all. Indeed, this is
-one of the most important design decisions in Flyte. Non-container tasks can have arbitrary targets for execution -
-example an API that executes SQL queries like SnowFlake, BigQuery etc, a synchronous WebAPI etc
+Sqlite3
+#######
 
 The following example shows how you can write SQLite3 queries using the SQLite3Task, which is bundled as part of the
 core flytekit. Since SQL Queries are portable across workflows and Flyte installations (as long as the data exists),