Skip to content

Commit 6ced605

Browse files
committed
Refactor deployment and change handling descriptions for clarity and consistency across module documentation
1 parent 702df4c commit 6ced605

7 files changed

Lines changed: 32 additions & 37 deletions

File tree

learn-pr/wwl-data-ai/integrate-sql-solutions-azure-services/5-deploy-data-api-builder-azure-services.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
### YamlMime:ModuleUnit
22
uid: learn.integrate-sql-solutions-azure-services.deploy-data-api-builder-azure-services
3-
title: Deploy Data API Builder to Azure services
3+
title: Explore deployment options for Data API Builder
44
metadata:
5-
title: Deploy Data API Builder to Azure services
5+
title: Explore deployment options for Data API Builder
66
description: Learn how to deploy Data API Builder to Azure Container Apps, App Service, and Static Web Apps with CI/CD automation.
77
ms.date: 02/05/2026
88
author: JulianePadrao

learn-pr/wwl-data-ai/integrate-sql-solutions-azure-services/7-handle-changes-event-driven-patterns.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ uid: learn.integrate-sql-solutions-azure-services.handle-changes-event-driven-pa
33
title: Handle changes with event-driven patterns
44
metadata:
55
title: Handle changes with event-driven patterns
6-
description: Learn how to handle database changes using Change Data Capture, Change Tracking, Azure Functions SQL triggers, and Azure Logic Apps.
6+
description: Learn how to handle database changes using Change Data Capture, Change Tracking, Azure Functions SQL triggers, and Change Event Streaming.
77
ms.date: 02/05/2026
88
author: JulianePadrao
99
ms.author: jupadrao

learn-pr/wwl-data-ai/integrate-sql-solutions-azure-services/includes/1-introduction.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,9 @@ In this module, you learn how to:
99
- Define entities with field mappings, caching, pagination, and filtering
1010
- Configure REST and GraphQL endpoints for different client needs
1111
- Expose views, stored procedures, and define GraphQL relationships
12-
- Deploy Data API Builder to Azure Container Apps, App Service, or Static Web Apps
12+
- Explore deployment options for Data API Builder, including Azure Container Apps, App Service, and Static Web Apps
1313
- Set up Azure Monitor with Application Insights for API observability
14-
- Handle database changes using Change Data Capture, Azure Functions, and Logic Apps
14+
- Handle database changes using Change Data Capture, Azure Functions, and Change Event Streaming
1515

1616
## Prerequisites
1717

learn-pr/wwl-data-ai/integrate-sql-solutions-azure-services/includes/10-summary.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@ In this module, you learned how to:
44
- Define entities for tables with field mappings, caching, pagination, and filtering capabilities
55
- Configure REST and GraphQL endpoints with customized paths and enabled operations
66
- Expose views as read-only entities and stored procedures for custom operations
7-
- Deploy Data API Builder to Azure Container Apps, App Service, and Static Web Apps
7+
- Explore deployment options for Data API Builder, including Azure Container Apps, App Service, and Static Web Apps
88
- Set up Azure Monitor with Application Insights for request telemetry and database performance tracking
9-
- Implement change capture patterns using CDC, Change Tracking, Azure Functions triggers, and Logic Apps
9+
- Implement change capture patterns using CDC, Change Tracking, Azure Functions triggers, and Change Event Streaming
1010

1111
## Key takeaways
1212

learn-pr/wwl-data-ai/integrate-sql-solutions-azure-services/includes/3-define-entities-rest-graphql.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,23 @@ Entities are the core building blocks of Data API Builder. Each entity maps to a
22

33
Building on the configuration file you created, the `entities` section is where you specify the tables, views, and other database objects that DAB exposes. You configure each entity with source mappings, field customizations, and relationship definitions that shape your API surface.
44

5+
The examples throughout this unit use the following sample database tables. Keep these definitions in mind as you work through each configuration:
6+
7+
```sql
8+
CREATE TABLE dbo.Categories (
9+
CategoryID INT PRIMARY KEY,
10+
CategoryName NVARCHAR(50) NOT NULL
11+
);
12+
13+
CREATE TABLE dbo.Products (
14+
ProductID INT PRIMARY KEY,
15+
ProductName NVARCHAR(100) NOT NULL,
16+
UnitPrice DECIMAL(10, 2) NOT NULL,
17+
UnitsInStock INT NOT NULL,
18+
CategoryID INT FOREIGN KEY REFERENCES dbo.Categories(CategoryID)
19+
);
20+
```
21+
522
## Map database objects to entities
623

724
An entity definition starts with a name and a source reference. The entity name becomes the identifier used in API endpoints and GraphQL queries, while the source points to the actual database object.

learn-pr/wwl-data-ai/integrate-sql-solutions-azure-services/includes/7-handle-changes-event-driven-patterns.md

Lines changed: 6 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
Modern applications often need to respond to database changes in real time. When a customer places an order, updates their profile, or when inventory levels change, downstream systems need notification. SQL Server and Azure SQL provide several mechanisms for capturing and streaming these changes, each with different characteristics for latency, throughput, and implementation complexity.
22

3-
Data API Builder integrates with these change mechanisms through Azure Functions SQL trigger bindings and Azure Logic Apps connectors. Understanding when to use each approach helps you build responsive, event-driven architectures that react to data changes efficiently.
3+
Data API Builder integrates with these change mechanisms through Azure Functions SQL trigger bindings. Understanding when to use each approach helps you build responsive, event-driven architectures that react to data changes efficiently.
44

55
## Understand change capture mechanisms
66

@@ -115,26 +115,6 @@ Configure the connection string in your function app settings:
115115
> [!IMPORTANT]
116116
> The SQL trigger binding requires Change Tracking, not CDC. If you need CDC's historical capabilities alongside real-time triggers, enable both features on your tables.
117117
118-
## Implement Azure Logic Apps for workflow automation
119-
120-
[Azure Logic Apps SQL connector](/azure/connectors/connectors-create-api-sqlazure?azure-portal=true) provides low-code automation for database change scenarios. Logic Apps excel at orchestrating multi-step workflows that involve external systems like email, Teams, or other APIs.
121-
122-
Create a Logic App that triggers when rows are modified:
123-
124-
1. Add the **When an item is modified** trigger
125-
2. Configure the connection to your database
126-
3. Select the table to monitor
127-
4. Set the polling interval
128-
129-
The trigger checks for changes at your specified interval and starts a workflow run for each modified row. Add subsequent actions to:
130-
131-
- Send notification emails
132-
- Post messages to Teams channels
133-
- Call external APIs or webhooks
134-
- Update other databases or systems
135-
136-
Logic Apps handle retry logic and error handling automatically. For complex scenarios, use parallel branches to perform multiple actions simultaneously or conditional branches to route based on data values.
137-
138118
## Stream changes with Change Event Streaming
139119

140120
For high-throughput scenarios where polling latency is unacceptable, Change Event Streaming pushes changes directly to Azure Event Hubs. This approach eliminates polling delays and scales to millions of events per second.
@@ -168,22 +148,20 @@ The Event Hubs message contains:
168148

169149
Selecting the appropriate change mechanism depends on your requirements:
170150

171-
**Use CDC when:**
151+
Use **CDC** when:
152+
172153
- You need complete before-and-after values
173154
- Compliance requires historical change records
174155
- Batch synchronization is acceptable
175156

176-
**Use Change Tracking with Functions when:**
157+
Use **change tracking** with Functions when:
158+
177159
- You need real-time response to changes
178160
- You only need current values, not history
179161
- You're building event-driven microservices
180162

181-
**Use Azure Logic Apps when:**
182-
- Workflows involve multiple external systems
183-
- Low-code development is preferred
184-
- Polling latency of seconds to minutes is acceptable
163+
Use **change event streaming** when:
185164

186-
**Use Change Event Streaming when:**
187165
- You need sub-second latency
188166
- High transaction volumes require streaming
189167
- You're building real-time analytics pipelines

learn-pr/wwl-data-ai/integrate-sql-solutions-azure-services/index.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ abstract: |
1818
- Define entities for REST and GraphQL with field mappings, caching, and relationships
1919
- Configure REST and GraphQL endpoints with custom paths and operations
2020
- Expose database views, stored procedures, and GraphQL relationships
21-
- Deploy Data API Builder to Azure Container Apps, App Service, or Static Web Apps
21+
- Explore deployment options for Data API Builder, including Azure Container Apps, App Service, and Static Web Apps
2222
- Set up Azure Monitor configurations with Application Insights and Log Analytics
23-
- Handle database changes using Change Data Capture, Azure Functions, and Logic Apps
23+
- Handle database changes using Change Data Capture, Azure Functions, and Change Event Streaming
2424
prerequisites: |
2525
- Experience with SQL Server, Azure SQL Database, or SQL databases in Microsoft Fabric
2626
- Familiarity with T-SQL for creating tables, views, and stored procedures

0 commit comments

Comments
 (0)