Skip to content

Add Common Issues troubleshooting tables to 10 skills#281

Open
CheeYuTan wants to merge 2 commits intodatabricks-solutions:mainfrom
CheeYuTan:fix/consolidated-common-issues
Open

Add Common Issues troubleshooting tables to 10 skills#281
CheeYuTan wants to merge 2 commits intodatabricks-solutions:mainfrom
CheeYuTan:fix/consolidated-common-issues

Conversation

@CheeYuTan
Copy link
Contributor

Summary

Adds structured Common Issues troubleshooting tables to the 10 skills that were missing them. Each table follows the | Issue | Solution | format consistent with skills that already have this section.

This is a consolidated resubmission of PRs #250-257 and #260, which were individually closed per maintainer feedback requesting a single combined PR.

Skills updated (10 files, +115 lines):

Skill Key Issues Covered
databricks-agent-bricks KA provisioning, MAS routing, endpoint naming
databricks-aibi-dashboards API 404s, SQL permissions, layout grid, filters
databricks-config Profile setup, token expiry, env var conflicts
databricks-dbsql ai_query, pipe syntax, COLLATE, MVs, MERGE performance
databricks-docs llms.txt usage, URL changes, version-specific APIs
databricks-mlflow-evaluation genai.evaluate API, scorers, datasets, MemAlign
databricks-python-sdk Auth errors, SDK versioning, Databricks Connect
databricks-spark-structured-streaming Checkpoints, state store, watermarks, Auto Loader
databricks-unity-catalog System tables, grants, tags, Delta Sharing
spark-python-data-source Schema types, registration, serialization, streaming

Test plan

  • All 10 SKILL.md files parse correctly (valid markdown tables)
  • No existing content was modified — only additions
  • Table format matches existing Common Issues sections in other skills (e.g., databricks-genie, databricks-jobs)
  • Each issue/solution pair is based on real troubleshooting scenarios

Consolidated from previously individual PRs (databricks-solutions#250-257, databricks-solutions#260) per
maintainer feedback to submit as a single combined PR.

Skills updated:
- databricks-agent-bricks: KA provisioning, routing, endpoint naming
- databricks-aibi-dashboards: API errors, SQL permissions, layout grid
- databricks-config: profile setup, token expiry, env var conflicts
- databricks-dbsql: ai_query, pipe syntax, COLLATE, MVs, MERGE perf
- databricks-docs: llms.txt usage, URL changes, version-specific APIs
- databricks-mlflow-evaluation: genai.evaluate API, scorers, datasets
- databricks-python-sdk: auth errors, SDK versioning, Connect setup
- databricks-spark-structured-streaming: checkpoints, state store, watermarks
- databricks-unity-catalog: system tables, grants, tags, Delta Sharing
- spark-python-data-source: schema, registration, serialization, streaming
These files were already failing the CI Lint & Format check on main.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant