Skip to content

Commit 9bb4420

Browse files
authored
pull base content,head:MicrosoftDocs:main,into:wwlpublishsync
2 parents 0caac7f + 983f956 commit 9bb4420

19 files changed

+253
-230
lines changed
Lines changed: 17 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.introduction
3-
title: Introduction
4-
metadata:
5-
title: Introduction
6-
description: Introduction
7-
author: wwlpublish
8-
ms.author: calopez
9-
ms.date: 11/24/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
durationInMinutes: 2
14-
content: |
15-
[!include[](includes/1-introduction.md)]
16-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.introduction
3+
title: Introduction
4+
metadata:
5+
adobe-target: true
6+
prefetch-feature-rollout: true
7+
title: Introduction
8+
description: "Introduction"
9+
ms.date: 04/23/2025
10+
author: wwlpublish
11+
ms.author: calopez
12+
ms.topic: unit
13+
ms.custom:
14+
- N/A
15+
durationInMinutes: 2
16+
content: |
17+
[!include[](includes/1-introduction.md)]
Lines changed: 17 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.understand-semantic-search
3-
title: Understand semantic search
4-
metadata:
5-
title: Understand semantic search
6-
description: Understand semantic search
7-
author: wwlpublish
8-
ms.author: calopez
9-
ms.date: 11/24/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
durationInMinutes: 5
14-
content: |
15-
[!include[](includes/2-understand-semantic-search.md)]
16-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.understand-semantic-search
3+
title: Understand semantic search
4+
metadata:
5+
adobe-target: true
6+
prefetch-feature-rollout: true
7+
title: Understand semantic search
8+
description: "Understand semantic search"
9+
ms.date: 04/23/2025
10+
author: wwlpublish
11+
ms.author: calopez
12+
ms.topic: unit
13+
ms.custom:
14+
- N/A
15+
durationInMinutes: 5
16+
content: |
17+
[!include[](includes/2-understand-semantic-search.md)]
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.store-vectors-azure-database-postgresql-flexible-server
3-
title: Store vectors in Azure Database for PostgreSQL
4-
metadata:
5-
title: Store vectors in Azure Database for PostgreSQL
6-
description: Store vectors in Azure Database for PostgreSQL
7-
author: wwlpublish
8-
ms.author: calopez
9-
ms.date: 11/24/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
durationInMinutes: 4
14-
content: |
15-
[!include[](includes/3-store-vectors-azure-database-postgresql-flexible-server.md)]
16-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.store-vectors-azure-database-postgresql-flexible-server
3+
title: Store vectors in Azure Database for PostgreSQL
4+
metadata:
5+
adobe-target: true
6+
prefetch-feature-rollout: true
7+
title: Store vectors in Azure Database for PostgreSQL
8+
description: "Store vectors in Azure Database for PostgreSQL"
9+
ms.date: 04/23/2025
10+
author: wwlpublish
11+
ms.author: calopez
12+
ms.topic: unit
13+
ms.custom:
14+
- N/A
15+
durationInMinutes: 4
16+
content: |
17+
[!include[](includes/3-store-vectors-azure-database-postgresql-flexible-server.md)]
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.create-embeddings-with-azure-ai-extension
3-
title: Create embeddings with the Azure AI extension
4-
metadata:
5-
title: Create embeddings with the Azure AI extension
6-
description: Create embeddings with the Azure AI extension
7-
author: wwlpublish
8-
ms.author: calopez
9-
ms.date: 11/24/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
durationInMinutes: 4
14-
content: |
15-
[!include[](includes/4-create-embeddings-with-azure-ai-extension.md)]
16-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.create-embeddings-with-azure-ai-extension
3+
title: Create embeddings with the Azure AI extension
4+
metadata:
5+
adobe-target: true
6+
prefetch-feature-rollout: true
7+
title: Create embeddings with the Azure AI extension
8+
description: "Create embeddings with the Azure AI extension"
9+
ms.date: 04/23/2025
10+
author: wwlpublish
11+
ms.author: calopez
12+
ms.topic: unit
13+
ms.custom:
14+
- N/A
15+
durationInMinutes: 4
16+
content: |
17+
[!include[](includes/4-create-embeddings-with-azure-ai-extension.md)]
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.exercise-generate-vector-embeddings-with-azure-openai
3-
title: Exercise - Generate vector embeddings with Azure OpenAI
4-
metadata:
5-
title: Exercise - Generate vector embeddings with Azure OpenAI
6-
description: Exercise - Generate vector embeddings with Azure OpenAI
7-
author: wwlpublish
8-
ms.author: calopez
9-
ms.date: 11/24/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
durationInMinutes: 1
14-
content: |
15-
[!include[](includes/5-exercise-generate-vector-embeddings-with-azure-openai.md)]
16-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.exercise-generate-vector-embeddings-with-azure-openai
3+
title: Exercise - Generate vector embeddings with Azure OpenAI
4+
metadata:
5+
adobe-target: true
6+
prefetch-feature-rollout: true
7+
title: Exercise - Generate vector embeddings with Azure OpenAI
8+
description: "Exercise - Generate vector embeddings with Azure OpenAI"
9+
ms.date: 04/23/2025
10+
author: wwlpublish
11+
ms.author: calopez
12+
ms.topic: unit
13+
ms.custom:
14+
- N/A
15+
durationInMinutes: 1
16+
content: |
17+
[!include[](includes/5-exercise-generate-vector-embeddings-with-azure-openai.md)]
Lines changed: 17 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.explore-semantic-search-use-cases
3-
title: Explore semantic search use cases
4-
metadata:
5-
title: Explore semantic search use cases
6-
description: Explore semantic search use cases
7-
author: wwlpublish
8-
ms.author: calopez
9-
ms.date: 11/24/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
durationInMinutes: 2
14-
content: |
15-
[!include[](includes/6-explore-semantic-search-use-cases.md)]
16-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.explore-semantic-search-use-cases
3+
title: Explore semantic search use cases
4+
metadata:
5+
adobe-target: true
6+
prefetch-feature-rollout: true
7+
title: Explore semantic search use cases
8+
description: "Explore semantic search use cases"
9+
ms.date: 04/23/2025
10+
author: wwlpublish
11+
ms.author: calopez
12+
ms.topic: unit
13+
ms.custom:
14+
- N/A
15+
durationInMinutes: 2
16+
content: |
17+
[!include[](includes/6-explore-semantic-search-use-cases.md)]
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.exercise-create-search-function-recommendation-system
3-
title: Exercise - Create a search function for a recommendation system
4-
metadata:
5-
title: Exercise - Create a search function for a recommendation system
6-
description: Exercise - Create a search function for a recommendation system
7-
author: wwlpublish
8-
ms.author: calopez
9-
ms.date: 11/24/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
durationInMinutes: 1
14-
content: |
15-
[!include[](includes/7-exercise-create-search-function-recommendation-system.md)]
16-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.exercise-create-search-function-recommendation-system
3+
title: Exercise - Create a search function for a recommendation system
4+
metadata:
5+
adobe-target: true
6+
prefetch-feature-rollout: true
7+
title: Exercise - Create a search function for a recommendation system
8+
description: "Exercise - Create a search function for a recommendation system"
9+
ms.date: 04/23/2025
10+
author: wwlpublish
11+
ms.author: calopez
12+
ms.topic: unit
13+
ms.custom:
14+
- N/A
15+
durationInMinutes: 1
16+
content: |
17+
[!include[](includes/7-exercise-create-search-function-recommendation-system.md)]
Lines changed: 53 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,53 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.knowledge-check
3-
title: Module assessment
4-
metadata:
5-
title: Module assessment
6-
description: Knowledge check
7-
author: wwlpublish
8-
ms.author: calopez
9-
ms.date: 11/24/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
durationInMinutes: 3
14-
content: |
15-
[!include[](includes/8-knowledge-check.md)]
16-
quiz:
17-
title: "Check your knowledge"
18-
questions:
19-
- content: "Semantic search uses text embeddings to determine result relevance. What is an embedding vector?"
20-
choices:
21-
- content: "An array of n numbers that capture the text's meaning."
22-
isCorrect: true
23-
explanation: "Correct. Semantic search uses numeric vector distance to measure semantic distance. A vector of definition or topic words is like lexical search (augmenting a query with synonyms or searching by tag or topic)."
24-
- content: "An array of n words that summarize the text's meaning."
25-
isCorrect: false
26-
explanation: "Incorrect. Semantic search uses a quantitative representation of text meaning derived from a language model, not synonyms or definitions. The core of semantic search is to represent semantics quantitatively so that normal vector operations can be used to measure semantic distance."
27-
- content: "An array of n text strings embedded in the text."
28-
isCorrect: false
29-
explanation: "Incorrect. Semantic search uses a quantitative representation of text meaning derived from a language model, not a list of ideas or topics. The core of semantic search is to represent semantics quantitatively so that normal vector operations can be used to measure semantic distance."
30-
- content: "An application's text data is stored in an Azure Database for PostgreSQL flexible server. The application needs a vector database to store the text embeddings and perform a semantic search. What is the most straightforward database choice?"
31-
choices:
32-
- content: "Use Azure Database for PostgreSQL."
33-
isCorrect: true
34-
explanation: "Correct. PostgreSQL is a suitable storage layer for vectors with the `vector` extension installed. It doesn't require new services or data migration."
35-
- content: "Use Vector Database in Azure Cosmos DB for MongoDB."
36-
isCorrect: false
37-
explanation: "Incorrect. While the Vector Database in Azure Cosmos DB for MongoDB is a good choice for storing & querying vectors, it requires deploying & maintaining a separate service and performing ETL between the application database and Cosmos DB. The most straightforward option is to use the `vector` extension to handle vectors directly in the PostgreSQL database."
38-
- content: "Use Azure AI Search's vector store."
39-
isCorrect: false
40-
explanation: "Incorrect. While Azure AI Search's vector store is a good choice for storing & querying vectors, it requires deploying a separate service and performing ETL between the application database and Azure AI Search. The most straightforward choice is to use the `vector` extension to store vectors directly in the PostgreSQL database."
41-
- content: "An application has stored embedding vectors in a PostgreSQL flexible server database and is ready to query them. The user has supplied a query string. What is the simplest way to run a semantic search?"
42-
choices:
43-
- content: "The application calls a stored function to return ranked results."
44-
isCorrect: true
45-
explanation: "Correct. This approach requires minimal changes to the application code and encapsulates concepts like embedding vectors and cosine distance to application code."
46-
- content: "Use Azure OpenAI Embeddings API in the application, and use the result as a query parameter to rank cosine distance."
47-
isCorrect: false
48-
explanation: "Incorrect. While this would work, it isn't the simplest approach: it introduces new services to applications and requires application developers to understand at least the basics of vector search."
49-
- content: "Use Azure AI Search's integrated vectorization to generate the query embedding and use the SQL in-line."
50-
isCorrect: false
51-
explanation: "Incorrect. While this is a viable approach to running semantic search with Azure AI Search, it isn't the simplest approach for data already stored in a PostgreSQL flexible server."
52-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.knowledge-check
3+
title: Module assessment
4+
metadata:
5+
adobe-target: true
6+
prefetch-feature-rollout: true
7+
title: Module assessment
8+
description: "Knowledge check"
9+
ms.date: 04/23/2025
10+
author: wwlpublish
11+
ms.author: calopez
12+
ms.topic: unit
13+
ms.custom:
14+
- N/A
15+
durationInMinutes: 3
16+
content: |
17+
[!include[](includes/8-knowledge-check.md)]
18+
quiz:
19+
title: "Check your knowledge"
20+
questions:
21+
- content: "Semantic search uses text embeddings to determine result relevance. What is an embedding vector?"
22+
choices:
23+
- content: "An array of n numbers that capture the text's meaning."
24+
isCorrect: true
25+
explanation: "Correct. Semantic search uses numeric vector distance to measure semantic distance. A vector of definition or topic words is like lexical search (augmenting a query with synonyms or searching by tag or topic)."
26+
- content: "An array of n words that summarize the text's meaning."
27+
isCorrect: false
28+
explanation: "Incorrect. Semantic search uses a quantitative representation of text meaning derived from a language model, not synonyms or definitions. The core of semantic search is to represent semantics quantitatively so that normal vector operations can be used to measure semantic distance."
29+
- content: "An array of n text strings embedded in the text."
30+
isCorrect: false
31+
explanation: "Incorrect. Semantic search uses a quantitative representation of text meaning derived from a language model, not a list of ideas or topics. The core of semantic search is to represent semantics quantitatively so that normal vector operations can be used to measure semantic distance."
32+
- content: "An application's text data is stored in an Azure Database for PostgreSQL flexible server. The application needs a vector database to store the text embeddings and perform a semantic search. What is the most straightforward database choice?"
33+
choices:
34+
- content: "Use Azure Database for PostgreSQL."
35+
isCorrect: true
36+
explanation: "Correct. PostgreSQL is a suitable storage layer for vectors with the `vector` extension installed. It doesn't require new services or data migration."
37+
- content: "Use Vector Database in Azure Cosmos DB for MongoDB."
38+
isCorrect: false
39+
explanation: "Incorrect. While the Vector Database in Azure Cosmos DB for MongoDB is a good choice for storing & querying vectors, it requires deploying & maintaining a separate service and performing ETL between the application database and Cosmos DB. The most straightforward option is to use the `vector` extension to handle vectors directly in the PostgreSQL database."
40+
- content: "Use Azure AI Search's vector store."
41+
isCorrect: false
42+
explanation: "Incorrect. While Azure AI Search's vector store is a good choice for storing & querying vectors, it requires deploying a separate service and performing ETL between the application database and Azure AI Search. The most straightforward choice is to use the `vector` extension to store vectors directly in the PostgreSQL database."
43+
- content: "An application has stored embedding vectors in a PostgreSQL flexible server database and is ready to query them. The user has supplied a query string. What is the simplest way to run a semantic search?"
44+
choices:
45+
- content: "The application calls a stored function to return ranked results."
46+
isCorrect: true
47+
explanation: "Correct. This approach requires minimal changes to the application code and encapsulates concepts like embedding vectors and cosine distance to application code."
48+
- content: "Use Azure OpenAI Embeddings API in the application, and use the result as a query parameter to rank cosine distance."
49+
isCorrect: false
50+
explanation: "Incorrect. While this would work, it isn't the simplest approach: it introduces new services to applications and requires application developers to understand at least the basics of vector search."
51+
- content: "Use Azure AI Search's integrated vectorization to generate the query embedding and use the SQL in-line."
52+
isCorrect: false
53+
explanation: "Incorrect. While this is a viable approach to running semantic search with Azure AI Search, it isn't the simplest approach for data already stored in a PostgreSQL flexible server."
Lines changed: 17 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.summary
3-
title: Summary
4-
metadata:
5-
title: Summary
6-
description: Summary
7-
author: wwlpublish
8-
ms.author: calopez
9-
ms.date: 11/24/2024
10-
ms.topic: unit
11-
ms.collection:
12-
- wwl-ai-copilot
13-
durationInMinutes: 2
14-
content: |
15-
[!include[](includes/9-summary.md)]
16-
1+
### YamlMime:ModuleUnit
2+
uid: learn.wwl.enable-semantic-search-azure-database-postgresql.summary
3+
title: Summary
4+
metadata:
5+
adobe-target: true
6+
prefetch-feature-rollout: true
7+
title: Summary
8+
description: "Summary"
9+
ms.date: 04/23/2025
10+
author: wwlpublish
11+
ms.author: calopez
12+
ms.topic: unit
13+
ms.custom:
14+
- N/A
15+
durationInMinutes: 2
16+
content: |
17+
[!include[](includes/9-summary.md)]

0 commit comments

Comments
 (0)