Skip to content

Conversation

hiroyukinakazato-db
Copy link

Changes

This PR adds comprehensive documentation for Switch, an LLM-powered transpiler that has been integrated into Lakebridge. Switch converts SQL and other source formats into Databricks notebooks using Large Language Models.

What does this PR do?

Adds comprehensive documentation for Switch, the new LLM-powered transpiler integrated into Lakebridge. This includes a complete Switch documentation file and updates to existing documentation to include Switch references.

Relevant implementation details

New Documentation:

  • docs/lakebridge/docs/transpile/pluggable_transpilers/switch.mdx - Comprehensive Switch guide covering installation, usage, configuration, architecture, custom prompts, and troubleshooting

Updated Existing Documentation:

  • docs/lakebridge/docs/overview.mdx - Added Switch to transpiler list
  • docs/lakebridge/docs/transpile/overview.mdx - Added Switch section with key characteristics and comparison
  • docs/lakebridge/docs/transpile/pluggable_transpilers/index.mdx - Updated to mention Switch installation

Caveats/things to watch out for when reviewing:

This PR contains only documentation changes - no code modifications

Linked issues

Resolves #2044

Functionality

  • added relevant user documentation
  • added new CLI command
  • modified existing command: databricks labs lakebridge ...

Tests

  • manually tested
  • added unit tests
  • added integration tests

Add comprehensive Switch documentation and references to existing docs:
- New switch.mdx with installation, usage, and configuration guide
- Updated overview.mdx to mention Switch transpiler
- Updated transpile/overview.mdx with Switch section and comparison
- Updated pluggable_transpilers/index.mdx with Switch installation info

Switch is an LLM-powered transpiler using Mosaic AI Model Serving
for SQL and generic source format conversion to Databricks notebooks.
Copy link

✅ 27/27 passed, 2 flaky, 1m28s total

Flaky tests:

  • 🤪 test_transpiles_informatica_with_sparksql (9.296s)
  • 🤪 test_transpile_sql_file (12.416s)

Running from acceptance #2342

@hiroyukinakazato-db
Copy link
Author

I will close this one and open a new PR for better alignment.

@hiroyukinakazato-db hiroyukinakazato-db deleted the switch-documentation branch September 30, 2025 09:21
@hiroyukinakazato-db hiroyukinakazato-db restored the switch-documentation branch September 30, 2025 09:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[DOCS]: Add comprehensive Switch transpiler documentation
1 participant