VECTORPROPERTY （Transact-SQL） （预览版）

适用于：SQL Server 2025 （17.x） 在Microsoft Fabric 中预览 Azure SQL 数据库Azure SQL 托管实例 SQL 数据库

VECTORPROPERTY 函数返回给定向量的特定属性。 该函数需要两个参数：矢量本身和要检索的属性。

语法

Transact-SQL 语法约定

VECTORPROPERTY(vector, property)

论据

向量

矢量类型的有效向 量 。 这可以是表达式，例如变量或对列的引用。

输入向量可以指定为 [tablename].[colname] 或指定为 矢量 类型的有效变量。

财产

一个表达式，用于指定要返回的数据库属性的名称。 该属性支持以下值之一：

矢量的默认基类型当前设置为 float （32 位）。

返回值

该函数根据所选属性返回给定向量的特定属性。 例如：

• 如果该属性为 Dimensions，则函数返回一个 整数 值，表示矢量的维度计数。
• 如果该属性为 BaseType，则函数返回数据类型的名称（sysname）。

例子

检索维度计数

在以下示例中，声明具有三个维度的向量并检索其维度计数。 该 VECTORPROPERTY 函数返回表示维度计数的整数值 3 。

DECLARE @v AS VECTOR(3) = '[1,2,3]';

SELECT VECTORPROPERTY(@v, 'Dimensions');

返回维度计数

以下示例从表中mytable检索矢量列embeddings的维度计数。

CREATE TABLE mytable
(
    id INT IDENTITY NOT NULL PRIMARY KEY,
    embeddings VECTOR(3) NOT NULL
);

INSERT INTO mytable (embeddings)
VALUES ('[4, -2, -1]'),
       ('[1, 3, -5]'),
       ('[7, -8, -10]'),
       ('[4.0, 0.2, -1.1]'),
       ('[0, 0, 0]'),
       ('[10, 10, 10]'),
       ('[-0.1, -0.2, -0.3]');

SELECT VECTORPROPERTY(t.embeddings, 'dimensions')
FROM mytable AS t;

返回：

Dimensions
----------
3
3
3
3
3
3
3

相关内容

• SQL 数据库引擎中的矢量概述
• Azure SQL 数据库矢量搜索示例