# Best practices

Find guidance for the decisions you make when you build, govern, and operate Azure Databricks.
Start with the Well-Architected Framework for a platform review, or choose a focused guide below.

## Architecture

- [Databricks well-architected framework](../best-practices/well-architected-framework.md): Review an Azure Databricks platform against the seven architecture pillars.
- [Platform lessons](../lessons-learned/platform-lessons.md): Compare architecture, networking, compute, and operating decisions from platform delivery.
- [Community best practices](../best-practices/community-best-practices.md): Find vendor and practitioner guidance across architecture, governance, security, and cost.

## Identity and governance

- [Identity with Entra ID and SCIM](../best-practices/identity-entra-scim.md): Choose an account identity and group provisioning approach with Entra ID and SCIM.
- [Unity Catalog grants](../best-practices/unity-catalog-grants.md): Understand privilege inheritance, discovery, and Terraform grant ownership.
- [PII and ABAC governance](../best-practices/governance-pii-abac.md): Plan sensitive-data controls with governed tags, masks, row filters, and groups.

## Development and delivery

- [Terraform vs DABs](../best-practices/terraform-vs-dabs.md): Separate shared infrastructure from application delivery with Terraform and bundles.
- [Lakeflow data engineering](../best-practices/lakeflow-data-engineering.md): Plan ingestion, pipelines, orchestration, replay, and production ownership.
- [Databricks Agent Skills](../best-practices/databricks-agent-skills.md): Install and use Databricks Agent Skills with Claude Code, Codex, and OpenCode.

## Operations and workloads

- [Delta and storage](../best-practices/delta-storage.md): Choose table layouts, optimization, retention, and VACUUM safeguards.
- [SQL and BI](../best-practices/sql-bi.md): Plan SQL warehouses, dashboards, Genie, BI access, and cost controls.
- [AI and ML platform](../best-practices/ai-ml-platform.md): Govern and operate model tracking, serving, evaluation, and AI workloads.


## More ways to browse

- [Migration guides](../migrations/README.md) cover assessment, conversion, validation, and cutover.
- [Browse topics](../topic/) to find related guidance and sources across the wiki.
- [Product updates](../topic/product-watch) collect release notes and vendor and community sources.