Skip to content

Commit 45d92cf

Browse files
20250724 update vector product applicability, edit pass
1 parent 74d67d1 commit 45d92cf

File tree

5 files changed

+78
-76
lines changed

5 files changed

+78
-76
lines changed
Lines changed: 36 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: "sys.vector_indexes (Transact-SQL)"
33
description: "sys.vector_indexes contains a row per vector index."
4-
author: damauri
5-
ms.author: damauri
4+
author: WilliamDAssafMSFT
5+
ms.author: wiassaf
66
ms.reviewer: damauri, pookam
7-
ms.date: 06/11/2025
8-
ms.topic: reference
7+
ms.date: 07/24/2025
98
ms.service: sql
109
ms.subservice: system-objects
10+
ms.topic: reference
1111
f1_keywords:
1212
- "sys.vector_indexes"
1313
- "vector_indexes"
@@ -21,45 +21,46 @@ monikerRange: "=sql-server-ver17 || =sql-server-linux-ver17"
2121
---
2222
# sys.vector_indexes (Transact-SQL)
2323

24-
[!INCLUDE [SQL Server 2025](../../includes/applies-to-version/_ss2025.md)]
24+
[!INCLUDE [SQL Server 2025](../../includes/applies-to-version/sqlserver2025.md)]
25+
26+
The `sys.vector_indexes` system catalog view contains one row per vector index.
2527

26-
Contains a row per vector index.
27-
2828
|Column name|Data type|Description|
2929
|-----------------|---------------|-----------------|
30-
|**object_id**|int|Reference to sys.indexes|
31-
|**index_id**|int|Reference to sys.indexes|
32-
|**metric**|varchar(20)|Type of vector index (DiskANN only for now)|
33-
|**type_desc**|varchar(20)|Metric used to create the vector index|
34-
|**build_parameters**|nvarchar(max)|Internal usage only|
30+
|`object_id`|**int**|Reference to `sys.indexes`.|
31+
|`index_id`|**int**|Reference to `sys.indexes`.|
32+
|`metric`|**varchar(20)**|Type of vector index (Currently, DiskANN only).|
33+
|`type_desc`|**varchar(20)**|Metric used to create the vector index.|
34+
|`build_parameters`|**nvarchar(max)**|Internal usage only.|
3535

36+
## Permissions
3637

37-
## Permissions
38+
[!INCLUDE[ssCatViewPerm](../../includes/sscatviewperm-md.md)] For more information, see [Metadata Visibility Configuration](../security/metadata-visibility-configuration.md).
3839

39-
[!INCLUDE[ssCatViewPerm](../../includes/sscatviewperm-md.md)] For more information, see [Metadata Visibility Configuration](../../relational-databases/security/metadata-visibility-configuration.md).
40-
41-
## Examples
40+
## Examples
4241

4342
The following example returns all indexes for the table `[dbo].[[wikipedia_articles_embeddings]` used in the [DiskANN sample](https://github.com/Azure-Samples/azure-sql-db-vector-search/tree/main/DiskANN/Wikipedia) available in the [https://github.com/Azure-Samples/azure-sql-db-vector-search](https://github.com/Azure-Samples/azure-sql-db-vector-search) GitHub sample repo.
44-
43+
4544
```sql
46-
select
47-
vi.obj_id,
48-
vi.index_id,
49-
vi.index_type,
50-
vi.dist_metric,
51-
vi.build_parameters
52-
from
53-
sys.indexes i
54-
inner join
55-
sys.vector_indexes as vi on vi.obj_id = i.object_id and vi.index_id = i.index_id
56-
where
57-
obj_id = object_id('[dbo].[wikipedia_articles_embeddings]')
45+
SELECT
46+
vi.obj_id,
47+
vi.index_id,
48+
vi.index_type,
49+
vi.dist_metric,
50+
vi.build_parameters
51+
FROM
52+
sys.indexes AS i
53+
INNER JOIN
54+
sys.vector_indexes AS vi
55+
ON vi.obj_id = i.object_id
56+
AND vi.index_id = i.index_id
57+
WHERE
58+
obj_id = object_id('[dbo].[wikipedia_articles_embeddings]');
5859
```
59-
60-
## Next steps
6160

62-
[Object Catalog Views (Transact-SQL)](../../relational-databases/system-catalog-views/object-catalog-views-transact-sql.md)
63-
[Catalog Views (Transact-SQL)](../../relational-databases/system-catalog-views/catalog-views-transact-sql.md)
64-
[sys.indexes (Transact-SQL)](../../relational-databases/system-catalog-views/sys-indexes-transact-sql.md)
65-
[CREATE VECTOR INDEX (Transact-SQL)](../../t-sql/statements/create-vector-index-transact-sql.md)
61+
## Related content
62+
63+
- [Object catalog views (Transact-SQL)](object-catalog-views-transact-sql.md)
64+
- [System catalog views (Transact-SQL)](catalog-views-transact-sql.md)
65+
- [sys.indexes (Transact-SQL)](sys-indexes-transact-sql.md)
66+
- [CREATE VECTOR INDEX (Transact-SQL)](../../t-sql/statements/create-vector-index-transact-sql.md)

docs/relational-databases/vectors/vectors-sql-server.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,8 @@ Vectors are ordered arrays of numbers (typically floats) that can represent info
2626

2727
> [!NOTE]
2828
> - Vector support in preview and is subject to change. Make sure to read preview usage terms in [Service Level Agreements (SLA) for Online Services](https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services).
29-
> - Vector features are available in Azure SQL Managed Instance configured with the [Always-up-to-date](/azure/azure-sql/managed-instance/update-policy#always-up-to-date-update-policy) policy.
29+
30+
Vector features are available in Azure SQL Managed Instance configured with the [Always-up-to-date](/azure/azure-sql/managed-instance/update-policy#always-up-to-date-update-policy) policy.
3031

3132
## Embeddings
3233

docs/t-sql/functions/vector-norm-transact-sql.md

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,15 @@ description: "VECTOR_NORM takes a vector as an input and returns the norm of the
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
66
ms.reviewer: damauri, pookam
7-
ms.date: 02/18/2025
8-
ms.update-cycle: 180-days
7+
ms.date: 07/24/2025
98
ms.service: sql
109
ms.subservice: t-sql
1110
ms.topic: reference
11+
ms.collection:
12+
- ce-skilling-ai-copilot
13+
ms.update-cycle: 180-days
14+
ms.custom:
15+
- build-2025
1216
f1_keywords:
1317
- "VECTOR_NORM"
1418
- "VECTOR_NORM_TSQL"
@@ -17,32 +21,31 @@ helpviewer_keywords:
1721
- "vector, norm calculation"
1822
dev_langs:
1923
- "TSQL"
20-
monikerRange: "= azuresqldb-current"
21-
ms.collection: ce-skilling-ai-copilot
22-
ms.custom:
23-
- build-2025
24+
monikerRange: "=sql-server-ver17 || =sql-server-linux-ver17 || =azuresqldb-current || =azuresqldb-mi-current || =fabric"
2425
---
2526
# VECTOR_NORM (Transact-SQL) (Preview)
2627

27-
[!INCLUDE [Azure SQL Database](../../includes/applies-to-version/asdb.md)]
28+
[!INCLUDE [sqlserver2025-asdb-asmi-fabricsqldb](../../includes/applies-to-version/sqlserver2025-asdb-asmi-fabricsqldb.md)]
2829

29-
> [!NOTE]
30-
> This data type is in preview and is subject to change. Make sure to read preview usage terms in the [Service Level Agreements (SLA) for Online Services](https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services) document.
31-
32-
Takes a vector as an input and returns the norm of the vector (which is a measure of its length or magnitude) in a given [norm type](https://mathworld.wolfram.com/VectorNorm.html).
30+
Use `VECTOR_NORM` to take a vector as an input and return the norm of the vector (which is a measure of its length or magnitude) in a given [norm type](https://mathworld.wolfram.com/VectorNorm.html).
3331

3432
For example, if you want to calculate the Euclidean norm (which is the most common norm type), you can use:
3533

3634
```sql
3735
SELECT VECTOR_NORM ( vector, 'norm2' )
3836
FROM ...
3937
```
40-
41-
## Syntax
42-
38+
39+
> [!NOTE]
40+
> This data type is in preview and is subject to change. Make sure to read preview usage terms in the [Service Level Agreements (SLA) for Online Services](https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services) document.
41+
42+
`VECTOR_NORM` is available in Azure SQL Managed Instance configured with the [Always-up-to-date](/azure/azure-sql/managed-instance/update-policy#always-up-to-date-update-policy) update policy.
43+
44+
## Syntax
45+
4346
:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: [Transact-SQL syntax conventions](../../t-sql/language-elements/transact-sql-syntax-conventions-transact-sql.md)
4447

45-
```syntaxsql
48+
```syntaxsql
4649
VECTOR_NORM ( vector, norm_type )
4750
```
4851

@@ -64,7 +67,7 @@ A string with the name of the norm type to use to calculate the norm of the give
6467

6568
The function returns a **float** value that represents the norm of the vector using the specified norm type.
6669

67-
An error is returned if *norm_type* isn't a valid norm type and if the vector is not of the [vector data type](../../t-sql/data-types/vector-data-type.md).
70+
An error is returned if *norm_type* isn't a valid norm type and if the vector is not of the [vector data type](../data-types/vector-data-type.md).
6871

6972
## Examples
7073

docs/t-sql/functions/vector-normalize-transact-sql.md

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,13 @@ description: "VECTOR_NORMALIZE takes a vector as an input and returns the normal
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
66
ms.reviewer: damauri, pookam
7-
ms.date: 02/18/2025
8-
ms.update-cycle: 180-days
7+
ms.date: 07/24/2025
98
ms.service: sql
109
ms.subservice: t-sql
1110
ms.topic: reference
11+
ms.collection:
12+
- ce-skilling-ai-copilot
13+
ms.update-cycle: 180-days
1214
f1_keywords:
1315
- "VECTOR_NORMALIZE"
1416
- "VECTOR_NORMALIZE_TSQL"
@@ -17,17 +19,13 @@ helpviewer_keywords:
1719
- "vector, normalize calculation"
1820
dev_langs:
1921
- "TSQL"
20-
monikerRange: "= azuresqldb-current"
21-
ms.collection: ce-skilling-ai-copilot
22+
monikerRange: "=sql-server-ver17 || =sql-server-linux-ver17 || =azuresqldb-current || =azuresqldb-mi-current || =fabric"
2223
---
2324
# VECTOR_NORMALIZE (Transact-SQL) (Preview)
2425

25-
[!INCLUDE [Azure SQL Database](../../includes/applies-to-version/asdb-asdbmi.md)]
26+
[!INCLUDE [sqlserver2025-asdb-asmi-fabricsqldb](../../includes/applies-to-version/sqlserver2025-asdb-asmi-fabricsqldb.md)]
2627

27-
> [!NOTE]
28-
> This data type is in preview and is subject to change. Make sure to read preview usage terms in the [Service Level Agreements (SLA) for Online Services](https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services) document.
29-
30-
`VECTOR_NORMALIZE` takes a vector as an input and returns the normalized vector, which is a vector scaled to have a length of 1 in a given [norm type](https://mathworld.wolfram.com/VectorNorm.html).
28+
Use `VECTOR_NORMALIZE` to take a vector as an input and return the normalized vector, which is a vector scaled to have a length of 1 in a given [norm type](https://mathworld.wolfram.com/VectorNorm.html).
3129

3230
This standardization is crucial in various artificial intelligence applications where vectors represent different forms of data, such as visual content, textual information, or audio signals. By normalizing vectors, we ensure uniformity in their scale, which is particularly useful for operations that rely on measuring vector distances or for grouping and distinguishing data points.
3331

@@ -46,7 +44,8 @@ FROM ...
4644

4745
> [!NOTE]
4846
> - This function is in preview and is subject to change. Make sure to read preview usage terms in [Service Level Agreements (SLA) for Online Services](https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services).
49-
> - `VECTOR_NORMALIZE` is available in Azure SQL Managed Instance configured with the [Always-up-to-date](/azure/azure-sql/managed-instance/update-policy#always-up-to-date-update-policy) update policy.
47+
48+
`VECTOR_NORMALIZE` is available in Azure SQL Managed Instance configured with the [Always-up-to-date](/azure/azure-sql/managed-instance/update-policy#always-up-to-date-update-policy) update policy.
5049

5150
## Syntax
5251

@@ -76,7 +75,7 @@ The result is a vector with the same direction as the input vector but with a le
7675

7776
If the input is `NULL`, the returned result will also be `NULL`.
7877

79-
An error is returned if *norm_type* isn't a valid norm type and if the *vector* is not of the [vector](../../t-sql/data-types/vector-data-type.md) data type.
78+
An error is returned if *norm_type* isn't a valid norm type and if the *vector* is not of the [vector](../data-types/vector-data-type.md) data type.
8079

8180
## Examples
8281

@@ -108,6 +107,6 @@ SELECT VECTOR_NORMALIZE(@v, 'norm1'), VECTOR_NORMALIZE(@v, 'norminf');
108107

109108
## Related content
110109

111-
- [Vector functions (Transact SQL)](../..//t-sql/functions/vector-functions-transact-sql.md)
112-
- [Vector data type](../../t-sql/data-types/vector-data-type.md)
110+
- [Vector functions (preview)](vector-functions-transact-sql.md)
111+
- [Vector data type](../data-types/vector-data-type.md)
113112
- [Intelligent applications with Azure SQL Database](/azure/azure-sql/database/ai-artificial-intelligence-intelligent-applications)

docs/t-sql/functions/vector-search-transact-sql.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,12 @@ description: "VECTOR_SEARCH search for vectors similar to a given query vectors
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
66
ms.reviewer: damauri
7-
ms.date: 05/01/2025
7+
ms.date: 07/24/2025
88
ms.service: sql
99
ms.subservice: t-sql
1010
ms.topic: reference
11+
ms.custom:
12+
- build-2025
1113
f1_keywords:
1214
- "VECTOR_SEARCH"
1315
- "VECTOR_SEARCH_TSQL"
@@ -16,20 +18,16 @@ helpviewer_keywords:
1618
- "vector, search"
1719
dev_langs:
1820
- "TSQL"
19-
monikerRange: "=sql-server-ver17 || =sql-server-linux-ver17"
20-
ms.custom:
21-
- build-2025
21+
monikerRange: "=sql-server-ver17 || =sql-server-linux-ver17 || =azuresqldb-mi-current "
2222
---
2323

2424
# VECTOR_SEARCH (Transact-SQL) (Preview)
2525

26-
[!INCLUDE [sqlserver2025-asdb-asmi-fabricsqldb](../../includes/applies-to-version/sqlserver2025-asdb-asmi-fabricsqldb.md)]
27-
28-
Search for vectors similar to a given query vectors using an approximate nearest neighbors vector search algorithm. To learn more about how vector indexing and vector search works, and the differences between exact and approximate search, refer to [Vectors in the SQL Database Engine](../../relational-databases/vectors/vectors-sql-server.md).
26+
[!INCLUDE [sqlserver2025-asmi](../../includes/applies-to-version/sqlserver2025-asmi.md)]
2927

30-
> [!NOTE]
31-
> `VECTOR_SEARCH` is available in Azure SQL Managed Instance configured with the [Always-up-to-date](/azure/azure-sql/managed-instance/update-policy#always-up-to-date-update-policy) update policy.
28+
Use `VECTOR_SEARCH` to search for vectors similar to a given query vectors using an approximate nearest neighbors vector search algorithm. To learn more about how vector indexing and vector search works, and the differences between exact and approximate search, refer to [Overview of vector search and vector indexes in the SQL Database Engine](../../relational-databases/vectors/vectors-sql-server.md).
3229

30+
`VECTOR_SEARCH` is available in Azure SQL Managed Instance configured with the [Always-up-to-date](/azure/azure-sql/managed-instance/update-policy#always-up-to-date-update-policy) update policy.
3331

3432
## Preview feature
3533

@@ -181,7 +179,7 @@ ORDER BY
181179

182180
### Example 3
183181

184-
A basic end-to-end example using `CREATE VECTOR INDEX` and the related `VECTOR_SEARCH` function. The embeddings are mocked. In a real world scenario, embeddings are generated using an embedding model and [AI_GENERATE_EMBEDDINGS](../functions/ai-generate-embeddings-transact-sql.md), or an external library such as [OpenAI SDK](https://github.com/openai/openai-dotnet?tab=readme-ov-file#how-to-generate-text-embeddings).
182+
A basic end-to-end example using `CREATE VECTOR INDEX` and the related `VECTOR_SEARCH` function. The embeddings are mocked. In a real world scenario, embeddings are generated using an embedding model and [AI_GENERATE_EMBEDDINGS](ai-generate-embeddings-transact-sql.md), or an external library such as [OpenAI SDK](https://github.com/openai/openai-dotnet?tab=readme-ov-file#how-to-generate-text-embeddings).
185183

186184
The following code block demonstrates the `VECTOR_SEARCH` function with mock embeddings:
187185

@@ -238,7 +236,7 @@ ORDER BY s.distance, t.title;
238236

239237
## Related content
240238

241-
- [Overview of vectors in the SQL Database Engine](../../relational-databases/vectors/vectors-sql-server.md)
239+
- [Overview of vector search and vector indexes in the SQL Database Engine](../../relational-databases/vectors/vectors-sql-server.md)
242240
- [Vector data type](../data-types/vector-data-type.md)
243241
- [CREATE VECTOR INDEX (Transact-SQL)](../statements/create-vector-index-transact-sql.md)
244242
- [Azure SQL Database Vector Search Samples](https://github.com/Azure-Samples/azure-sql-db-vector-search)

0 commit comments

Comments
 (0)