Azure SQL, built for AI workloads

Bring the idea. Build with Azure SQL.

Start with a prompt. Give your AI coding agent SQL skills, and make your next app yours.

Works with Claude Code, GitHub Copilot, Codex, and Cursor.

Power your next app with Azure SQL.

Choose your starting point: the cloud, local development, or your coding agent.

Create a free Azure SQL database.

Create it in the Azure portal with the free offer, then verify from any SQL editor. Prerequisites and offer limits are in the setup guide.

SELECT 1 AS connected;

Three steps, then you are live.

  1. 1
    Create the databaseYou need an Azure subscription with permission to create resources. Follow the free-offer guide and pick the free offer when prompted.
  2. 2
    Open accessAdd your IP to the firewall and sign in with Microsoft Entra.
  3. 3
    VerifyRun SELECT 1. A result of 1 means your connection works and you are ready for a build prompt.

Free offer: setup guide, prerequisites, and limits

Run the Azure SQL Database engine on your laptop.

Same engine as the cloud, in a container, offline. Preview today. Sign up and we send registry access.

Sign up for the Preview

What you get once you are in.

  1. 1
    One docker runSign in to the preview registry, pull the image, start the engine.
  2. 2
    Agent skills includedSkills teach your agent to provision, connect, migrate, seed, and ship, with you reviewing each step.
  3. 3
    Ship to Azure unchangedOnly the connection string changes.

Container quickstart

Install the skills, then ask in plain English.

One command teaches Claude Code, Copilot, Codex, or Cursor how Azure SQL works. You stay in the loop on every step.

npx skills add microsoft/microsoft-sql

Then say what you want.

  1. 1
    Create a free database firstProvisioning is still your step today. The agent takes it from there.
  2. 2
    Prompt your agent"Connect to my Azure SQL database and scaffold the schema, migrations, and data layer for my stack."
  3. 3
    VerifyThe agent runs the first query and shows you the result.

What the skills teach, per agent

Then:Local or free tier→Azure SQL DatabaseSame code, connection string changes, app goes live.

Bring your app idea to life

Start with a task app, an API, or search over your content. Choose a scenario and use its prompt with your coding agent to build on Azure SQL.

Each prompt works against a database you already have. No database yet? Get a database running takes three steps.

  1. Choose a scenario
  2. Copy the prompt
  3. Build and verify
JavaScript

Build a task-tracking app

Build a web app that displays tasks stored in Azure SQL. Start with sample data and make it your own.

View prompt
Python

Build an API for your app

Give your app a way to create, complete, and retrieve tasks. Build a Python API that connects to Azure SQL with Microsoft Entra, no passwords.

View prompt
Python / AI

Search your content by meaning

Find relevant text with vector search in Azure SQL. Build the retrieval layer for a RAG app using sample text and an embedding model you provide.

View prompt
.NET

Create a serverless task API

Read and save tasks through an Azure Functions API backed by Azure SQL. Build and test the functions locally.

View prompt
.NET

Respond to data changes

Extend the serverless API with a function that reacts when tasks change in Azure SQL. Log inserts, updates, and deletes as a starting point for automation.

View prompt
JavaScript

Separate each customer's data

Extend a task app for multiple customers. Add row-level security and test that one tenant cannot read another tenant's tasks.

View prompt

Built for AI workloads

The pieces an AI app needs, inside the engine.

Vector search

A native VECTOR type and VECTOR_DISTANCE. Store embeddings next to the rows they describe.

Vector docs
Embeddings in T-SQL

Generate and chunk from inside the database with external model calls. No separate pipeline.

AI_GENERATE_EMBEDDINGS
RAG, end to end

Chunk, embed, store, retrieve, ground. One skill walks your agent through all five.

Copy the RAG prompt
Safe for agents to write

Row-level security, Entra identity, and injection-safe patterns the skills enforce by default.

Row-level security docs

Microsoft SQL Agent Skills

Pick your agent. One install. The skills load themselves when the work matches.

claude plugin marketplace add microsoft/microsoft-sql claude plugin install microsoft-sql@microsoft-sql

Two commands: register the marketplace, then install the plugin with every skill. Or the portable form: gh skill install microsoft/microsoft-sql --all --agent claude-code.

Then just ask:

Click to copy. Paste into your agent.

Full catalog, every skill's source, and the feedback form at aka.ms/azuresql-skills. Skills teach your agent the engine; they do not grant access to the Preview container.

Already have Azure SQL data?

Point the prompts above at an existing development database. Review permissions and schema changes before you let an agent run them.

Prefer local development?Preview

The Azure SQL Database container runs the same engine offline. Sign up for the Preview.

Before you build

What do I need to get started?

An Azure account and a development database. The free offer covers everything on this page, within its limits. If you want to work offline, sign up for the container Preview.

Is it safe to let an agent write to my database?

Use a development database with least-privilege access. The skills default to parameterised queries, Entra identity over passwords, and row-level security for multi-tenant work. Review schema changes before they run against anything real.

Do I need the container?

No. Every prompt here targets Azure SQL Database in the cloud. The container is the local option, in Preview today.

What does this cost?

The free offer covers the database for every example here, within its limits; see the offer details for what those are. The RAG example needs an embedding service, priced by whoever provides it; the prompt asks which one you have before using it.

How is this different from SQL Server?

Same engine family, managed for you, with features that ship to Azure SQL Database first. The container runs the Azure SQL Database engine, not the SQL Server image.

Ready? Teach your agent, then ask

npx skills add microsoft/microsoft-sql
Get started