適用於：
SQL Server 2025 （17.x） Azure SQL Database AzureSQL Managed InstanceSQL database in Microsoft Fabric
函數會 VECTORPROPERTY 傳回給定向量的特定屬性。 函式需要兩個自變數：要擷取向量本身和屬性。
Note
VECTORPROPERTY 可在 Azure SQL 受控執行個體中使用 SQL Server 2025 或 一律up-to日期更新原則。
Syntax
VECTORPROPERTY(vector , property)
Arguments
向量
向量型別的有效 向量 。 這可以是表達式，例如變數或數據行的參考。
輸入向量可以指定為 [tablename].[colname] 或 作為 向量 類型的有效變數。
屬性
指定要傳回之資料庫屬性名稱的運算式。 屬性支援下列其中一個值：
| Property | Description | 傳回的值 |
|---|---|---|
Dimensions |
傳回向量的維度計數 | 具有維度計數的整數值。 |
BaseType |
傳回向量的基底類型 | 具有數據類型名稱的 sysname。 |
向量的預設基底類型目前設定為 float （32 位）。
返回值
函式會根據選取的屬性，傳回指定向量的特定屬性。 例如：
- 如果 屬性為
Dimensions，則函式會傳回 整數值， 表示向量的維度計數。 - 如果 屬性為
BaseType，則函式會傳回數據類型的名稱 （sysname）。
Examples
擷取維度計數
在下列範例中，宣告具有三個維度的向量，並擷取其維度計數。 函 VECTORPROPERTY 式會傳回代表維度計數的整數值 3 。
DECLARE @v AS VECTOR(3) = '[1,2,3]';
SELECT VECTORPROPERTY(@v, 'Dimensions');
傳回維度計數
下列範例會從數據表 embeddings擷取向量數據行mytable的維度計數。
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;
Returns:
Dimensions
----------
3
3
3
3
3
3
3