kernel

Overview ¶

Command kernel demonstrates the experimental SEA-via-kernel backend.

The kernel backend is opt-in and compiled in only under the databricks_kernel build tag with CGO enabled, and it links the Rust kernel static library. Build the library first, then run this example with the tag:

make -C ../.. kernel-lib                       # build the pinned kernel .a + header
CGO_ENABLED=1 go run -tags databricks_kernel .

Without the tag, the program still compiles (it uses only the stable public API), but WithUseKernel(true) returns an error wrapping dbsqlerr.ErrKernelNotCompiled at connect — which this example detects and reports rather than treating as a hard failure.

Required environment (a .env file in this directory is loaded automatically):

DATABRICKS_HOST         workspace hostname (no scheme)
DATABRICKS_ACCESSTOKEN  personal access token
DATABRICKS_HTTPPATH     warehouse http path (or set DATABRICKS_WAREHOUSEID)
DATABRICKS_WAREHOUSEID  bare warehouse id (kernel routes by this when set)