delta_engine.databricks
=======================

.. py:module:: delta_engine.databricks

.. autoapi-nested-parse::

   Public Databricks entry points.

   The implementation lives in ``delta_engine.adapters.databricks``. This module
   keeps the user-facing Databricks import path short while preserving lazy
   backend imports (PySpark, databricks-sql-connector) for code that only
   declares schemas or inspects result types.



Functions
---------

.. autoapisummary::

   delta_engine.databricks.build_spark_engine
   delta_engine.databricks.build_sql_engine
   delta_engine.databricks.configure_logging


Module Contents
---------------

.. py:function:: build_spark_engine(spark: pyspark.sql.SparkSession) -> delta_engine.application.engine.Engine

   Create an engine that syncs through an active Spark session.


.. py:function:: build_sql_engine(connection: databricks.sql.client.Connection) -> delta_engine.application.engine.Engine

   Create an engine that syncs through a Databricks SQL warehouse connection.

   PySpark-free: pass a connection from ``databricks.sql.connect(...)``
   (the ``delta-engine[sql]`` extra) and syncs run from any plain Python
   environment. Unity Catalog only.


.. py:function:: configure_logging(level: int = logging.INFO, stream: TextIO | None = None) -> None

   Install the package's colored logging handler.