Cloud Scale Analytics — Reference Library¶
This section is a comprehensive reference library covering Azure analytics services, architecture patterns, implementation guides, code examples, and tutorials, originally maintained as the separate fgarofalo56/csa-inabox-docs repository. It was merged into this repo on 2026-05-08 so the standalone docs repo can be retired and the platform's primary guides (docs/guides/) and the broader knowledge base live in one searchable, versioned place.
Where to start
- New to Azure analytics? Begin with the curriculum.
- Looking up a specific service? Jump to Services.
- Designing a system? Browse Architecture Patterns.
- Debugging? Use Troubleshooting.
- Looking for working code? See Code Examples.
- Walking through a service? Check the step-by-step tutorials for Data Factory, Synapse, and Stream Analytics.
Layout¶
| Section | Contents |
|---|---|
01-overview/ | Platform overview, quick-start guides |
02-services/ | Service-by-service reference: Synapse, Cosmos DB, Databricks, Storage, Event Hubs, Stream Analytics, Purview, ADF, HDInsight, Power BI, ML, Key Vault, Logic Apps, Functions, Cognitive Services |
03-architecture-patterns/ | Streaming, batch, ML, governance, hybrid, integration, reference architectures |
04-implementation-guides/ | End-to-end solutions, Databricks deep-dives, integration scenarios, migration guides |
05-best-practices/ | Cross-cutting concerns, operational excellence, service-specific tuning |
06-code-examples/ | Working code by service, Delta Lake patterns, integration snippets |
07-troubleshooting/ | Common errors, performance issues, service-specific diagnostics |
08-reference/ | API references, limits, quotas |
08-solutions/ | Real-time analytics, change feed, ML pipeline, Logic Apps integration |
09-monitoring/ | Service-specific monitoring runbooks |
10-devops/ | DevOps practices for analytics workloads |
tutorials/ | Step-by-step walkthroughs: Data Factory (19 lessons), Synapse (16), Stream Analytics (16), Power BI, code labs, certification prep, learning paths |
reference/ | KQL reference, Spark configuration, regional compliance, security checklist, glossary |
diagrams/ | Architecture diagrams in Mermaid + SVG |
solutions/ | Real-time analytics reference solution |
Relationship to the platform guides¶
The content in docs/guides/ at the top of this repo is the opinionated CSA-in-a-Box implementation: how this specific platform deploys, configures, and integrates each service. The learn/ reference library is service-agnostic — generic Azure analytics knowledge, patterns, and tutorials independent of CSA-in-a-Box's particular wiring.
Use the platform guides when you're working inside CSA-in-a-Box. Use the reference library when you're learning the underlying Azure service or hunting for a pattern to adapt.