databricks-zerobus-ingest

Ingest records into Databricks Delta tables via the Zerobus gRPC API.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/JingyiWng/databricks_ai_dev_kit_price_watcher --skill databricks-zerobus-ingest-jingyiwng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: databricks-zerobus-ingest
Source: https://github.com/JingyiWng/databricks_ai_dev_kit_price_watcher/tree/main/.claude/skills/databricks-zerobus-ingest
Command: npx skills add https://github.com/JingyiWng/databricks_ai_dev_kit_price_watcher --skill databricks-zerobus-ingest-jingyiwng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Build and operate producers that write records directly into Databricks managed Delta tables without requiring a separate message bus, enabling near real-time ingestion with durability acknowledgments and schema validation. The Skill centralizes guidance for authentication, table preparation, SDK usage, Protobuf schema generation from Unity Catalog, and production-safe retry and ACK handling so teams can reliably deliver data into the lakehouse.

Core Features & Use Cases

  • Multi-language SDK patterns for Python, Java, Go, TypeScript/Node.js and Rust to create streams, ingest records, wait for ACKs, flush, and close.
  • Protobuf generation and compilation from Unity Catalog table definitions to ensure type safety and forward-compatible schemas.
  • Operational best practices including service principal grants, environment variable configuration, firewall allowlisting, retry with exponential backoff, and at-least-once delivery handling.
  • Use Case: A telemetry pipeline that compiles a Protobuf schema from a Unity Catalog table, spins up multiple producers across regions, and ingests high-throughput sensor data with offset-based durability tracking.

Quick Start

Create a producer that initializes the Zerobus SDK, creates a stream to your Unity Catalog managed Delta table, ingest sample records using JSON or Protobuf, wait for offsets to be acknowledged, then flush and close the stream.

Frequently Asked Questions about databricks-zerobus-ingest

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ingest records directly into Databricks Delta tables without a separate message bus?

You can ingest records directly into Databricks Delta tables using the Zerobus gRPC API. This approach enables near-real-time, ACK-backed durability and Protobuf schema validation without requiring an external message bus.

How do I generate Protobuf schemas from Unity Catalog for streaming ingestion?

Generating Protobuf schemas from Unity Catalog involves compiling table definitions to ensure type safety and forward compatibility. This allows your producers to stream records into Delta tables with validated structures.

Can I use the Zerobus gRPC API with Python, Java, or Go for Delta table ingestion?

Yes, the Zerobus gRPC API supports multi-language SDK patterns for Python, Java, Go, TypeScript, and Rust. Producers can create streams, ingest records, wait for ACKs, and flush data to Unity Catalog managed Delta tables.

What's the best way to handle durability and retries when streaming into Delta tables?

For durable streaming into Delta tables, use ACK-based offset tracking and exponential backoff retries. This ensures at-least-once delivery by handling failures safely and confirming record acknowledgments before closing streams.

Do I need specific service principal grants to stream records into Unity Catalog managed Delta tables?

Yes, streaming records into Unity Catalog managed Delta tables requires explicit service principal MODIFY and SELECT grants on the target table. You also need environment variable configuration and firewall allowlisting for the gRPC API.