# microsoft/microsoft-sql architecture

> Architecture diagram of the GitHub repository microsoft/microsoft-sql, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/microsoft-sql
- Repository: https://github.com/microsoft/microsoft-sql

## Overview

This repository is a catalog of installable Microsoft SQL agent plugins, not an application that executes database workflows. An engineer asks a supported agent host for a task; the host discovers and loads relevant skill guidance, which supports work such as developing Azure SQL apps, operating databases, or planning migrations. The graph groups documented skill capabilities by workflow and includes the separate Fabric Database Hub and container plugins. Relationships reflect README-described packaging and guidance, not runtime calls; skill internals were not sampled.

Main entry points: [`plugins/microsoft-sql`](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql) (SQL marketplace), [`plugins/microsoft-sql-migration`](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-migration) (Migration plugin), [`plugins/microsoft-sql-fdh`](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-fdh) (Fabric Hub plugin), [`plugins/microsoft-sql/skills/build-app-on-azure-sql`](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/build-app-on-azure-sql) (Build applications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application development"]
  node_appbuild["Build applications"]
  node_connect["Drivers and auth"]
  node_schema["Schema and ORMs"]
  node_safety["SQL safety"]
  node_integration["App integrations"]
  node_rag["Vectors and RAG"]
end

subgraph group_ops["Database operations"]
  node_provision["Provision databases"]
  node_local["Local containers"]
  node_diagnose["Diagnose performance"]
  node_recover["Import and recovery"]
end

subgraph group_migration["Migration workflows"]
  node_migrationplugin["Migration plugin"]
  node_assess["Assess readiness"]
  node_plan["Plan migration"]
  node_methods["Migration methods"]
  node_validate["Validate migration"]
end

subgraph group_plugins["Specialized plugins"]
  node_marketplace["SQL marketplace"]
  node_containerplugin["Container plugin"]
  node_vscode["VS Code plugin"]
  node_fdh["Fabric Hub plugin"]
  node_inventory["Estate inventory"]
end

node_engineer(("Engineer"))
node_agent["Agent host"]

node_engineer -->|"asks for guidance"| node_agent
node_agent -->|"loads plugin skills"| node_marketplace
node_marketplace -->|"provides guidance"| node_appbuild
node_marketplace -->|"provides guidance"| node_connect
node_marketplace -->|"provides guidance"| node_schema
node_marketplace -->|"provides guidance"| node_safety
node_marketplace -->|"provides guidance"| node_integration
node_marketplace -->|"provides guidance"| node_rag
node_marketplace -->|"provides guidance"| node_provision
node_marketplace -->|"provides guidance"| node_local
node_marketplace -->|"provides guidance"| node_diagnose
node_marketplace -->|"provides guidance"| node_recover
node_marketplace -->|"offers workflow plugin"| node_migrationplugin
node_migrationplugin -->|"provides guidance"| node_assess
node_migrationplugin -->|"provides guidance"| node_plan
node_migrationplugin -->|"provides guidance"| node_methods
node_migrationplugin -->|"provides guidance"| node_validate
node_marketplace -->|"offers local workflow plugin"| node_containerplugin
node_marketplace -->|"offers editor plugin"| node_vscode
node_marketplace -->|"offers estate plugin"| node_fdh
node_fdh -->|"provides guidance"| node_inventory

click node_marketplace "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql"
click node_appbuild "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/build-app-on-azure-sql"
click node_connect "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/connect-from-dotnet"
click node_schema "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/design-azure-sql-schema"
click node_safety "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/prevent-sql-injection"
click node_integration "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/azure-functions-sql-bindings"
click node_rag "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/rag-on-azure-sql"
click node_provision "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/provision-azure-sql-db"
click node_local "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/azuresql-db-container"
click node_diagnose "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/diagnose-slow-query"
click node_recover "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/sqlpackage-import-export"
click node_migrationplugin "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-migration"
click node_assess "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-migration/skills/evaluate-azure-migration-assessment"
click node_plan "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-migration/skills/generate-migration-prerequisite-plan"
click node_methods "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-migration/skills/sql-bacpac-to-azure-sql-db-migration"
click node_validate "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-migration/skills/validate-post-migration-data"
click node_containerplugin "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-azuresqldb-container"
click node_vscode "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-vscode"
click node_fdh "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-fdh"
click node_inventory "https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-fdh/skills/databasehub-cli"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_appbuild,node_connect,node_schema,node_safety,node_integration,node_rag toneBlue
class node_provision,node_local,node_diagnose,node_recover toneAmber
class node_migrationplugin,node_assess,node_plan,node_methods,node_validate toneMint
class node_marketplace,node_containerplugin,node_vscode,node_fdh,node_inventory toneRose
class node_engineer,node_agent toneIndigo
```

## Components

### Application development

- [Build applications](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/build-app-on-azure-sql): `plugins/microsoft-sql/skills/build-app-on-azure-sql`
- [Drivers and auth](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/connect-from-dotnet): `plugins/microsoft-sql/skills/connect-from-dotnet`
- [Schema and ORMs](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/design-azure-sql-schema): `plugins/microsoft-sql/skills/design-azure-sql-schema`
- [SQL safety](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/prevent-sql-injection): `plugins/microsoft-sql/skills/prevent-sql-injection`
- [App integrations](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/azure-functions-sql-bindings): `plugins/microsoft-sql/skills/azure-functions-sql-bindings`
- [Vectors and RAG](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/rag-on-azure-sql): `plugins/microsoft-sql/skills/rag-on-azure-sql`

### Database operations

- [Provision databases](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/provision-azure-sql-db): `plugins/microsoft-sql/skills/provision-azure-sql-db`
- [Local containers](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/azuresql-db-container): `plugins/microsoft-sql/skills/azuresql-db-container`
- [Diagnose performance](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/diagnose-slow-query): `plugins/microsoft-sql/skills/diagnose-slow-query`
- [Import and recovery](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql/skills/sqlpackage-import-export): `plugins/microsoft-sql/skills/sqlpackage-import-export`

### Migration workflows

- [Migration plugin](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-migration): `plugins/microsoft-sql-migration`
- [Assess readiness](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-migration/skills/evaluate-azure-migration-assessment): `plugins/microsoft-sql-migration/skills/evaluate-azure-migration-assessment`
- [Plan migration](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-migration/skills/generate-migration-prerequisite-plan): `plugins/microsoft-sql-migration/skills/generate-migration-prerequisite-plan`
- [Migration methods](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-migration/skills/sql-bacpac-to-azure-sql-db-migration): `plugins/microsoft-sql-migration/skills/sql-bacpac-to-azure-sql-db-migration`
- [Validate migration](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-migration/skills/validate-post-migration-data): `plugins/microsoft-sql-migration/skills/validate-post-migration-data`

### Specialized plugins

- [SQL marketplace](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql): `plugins/microsoft-sql`
- [Container plugin](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-azuresqldb-container): `plugins/microsoft-azuresqldb-container`
- [VS Code plugin](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-vscode): `plugins/microsoft-sql-vscode`
- [Fabric Hub plugin](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-fdh): `plugins/microsoft-sql-fdh`
- [Estate inventory](https://github.com/microsoft/microsoft-sql/tree/main/plugins/microsoft-sql-fdh/skills/databasehub-cli): `plugins/microsoft-sql-fdh/skills/databasehub-cli`

### Other components

- **Engineer**
- **Agent host**

## Connections

- Engineer → Agent host: asks for guidance (evidence: `README.md`)
- Agent host → SQL marketplace: loads plugin skills (evidence: `README.md`)
- SQL marketplace → Build applications: provides guidance (evidence: `README.md`)
- SQL marketplace → Drivers and auth: provides guidance (evidence: `README.md`)
- SQL marketplace → Schema and ORMs: provides guidance (evidence: `README.md`)
- SQL marketplace → SQL safety: provides guidance (evidence: `README.md`)
- SQL marketplace → App integrations: provides guidance (evidence: `README.md`)
- SQL marketplace → Vectors and RAG: provides guidance (evidence: `README.md`)
- SQL marketplace → Provision databases: provides guidance (evidence: `README.md`)
- SQL marketplace → Local containers: provides guidance (evidence: `README.md`)
- SQL marketplace → Diagnose performance: provides guidance (evidence: `README.md`)
- SQL marketplace → Import and recovery: provides guidance (evidence: `README.md`)
- SQL marketplace → Migration plugin: offers workflow plugin (evidence: `README.md`)
- Migration plugin → Assess readiness: provides guidance (evidence: `README.md`)
- Migration plugin → Plan migration: provides guidance (evidence: `README.md`)
- Migration plugin → Migration methods: provides guidance (evidence: `README.md`)
- Migration plugin → Validate migration: provides guidance (evidence: `README.md`)
- SQL marketplace → Container plugin: offers local workflow plugin (evidence: `README.md`)
- SQL marketplace → VS Code plugin: offers editor plugin (evidence: `README.md`)
- SQL marketplace → Fabric Hub plugin: offers estate plugin (evidence: `README.md`)
- Fabric Hub plugin → Estate inventory: provides guidance (evidence: `README.md`)
