Skip to content

Examples

Working code examples demonstrating langchain-cockroachdb features.

Available Examples

All examples are available in the examples/ directory of the repository.

Basic Usage

Example Description Features
quickstart.py Get started in 5 minutes Basic CRUD, search
sync_usage.py Synchronous API Sync wrapper, simple scripts

Advanced Features

Example Description Features
vector_indexes.py Optimize query performance C-SPANN indexes, tuning
hybrid_search.py Combine FTS + vectors Fusion strategies
metadata_filtering.py Complex metadata queries Advanced filters

Configuration and Resilience

Example Description Features
retry_configuration.py Production configurations Retry logic, connection pooling
resilience.py Fault injection and retries Real CockroachDB errors, retry behavior

Chat Applications

Example Description Features
chat_history.py Persistent conversations Session management

LangGraph Checkpointer

Example Description Features
checkpointer.py LangGraph state persistence Short-term memory, human-in-the-loop

LangGraph Long-Term Memory

Example Description Features
long_term_memory.py Agent memory across threads Semantic search, TTL, delete_namespace

Multi-Tenancy

Example Description Features
multi_tenancy.py Namespace-based tenant isolation Per-tenant stores, admin view

Running Examples

Prerequisites

  1. CockroachDB running: 

    docker-compose up -d

  2. Install package: 

    pip install langchain-cockroachdb langchain-openai langchain

  3. Set connection string (optional): 

    export COCKROACHDB_URL="cockroachdb://root@localhost:26257/defaultdb?sslmode=disable"

  4. Set OpenAI key (for some examples): 

    export OPENAI_API_KEY="your-key-here"

Run an Example

cd examples
python quickstart.py

Example Categories

Getting Started

  • Basic Usage - CRUD operations, simple search
  • Quick start guides for common scenarios

Advanced Techniques

Production Patterns

  • Configuration for different workloads
  • Error handling and retry logic
  • Multi-tenancy patterns

Next Steps