Dela via

VECTORPROPERTY (Transact-SQL)

Gäller för: SQL Server 2025 (17.x) Förhandsversion Azure SQL DatabaseAzure SQL Managed InstanceFörhandsversion av SQL-databas för Microsoft Fabric

Funktionen VECTORPROPERTY returnerar specifika egenskaper för en viss vektor. Funktionen kräver två argument: själva vektorn och egenskapen som ska hämtas.

Note

VECTORPROPERTYär tillgängligt i Azure SQL Managed Instance med sql Server 2025- eller always-up-to-date update-principen.

Syntax

Transact-SQL syntaxkonventioner

VECTORPROPERTY(vector , property)

Arguments

vector

En giltig vektor av vektortypen . Det kan vara ett uttryck, till exempel en variabel eller en referens till en kolumn.

Indatavektorn kan anges som [tablename].[colname] eller som en giltig variabel av vektortypen .

property

Ett uttryck som anger namnet på den databasegenskap som ska returneras. Egenskapen stöder något av följande värden:

Property Description Returnerat värde
Dimensions Antal returnerade vektormått Heltalsvärde med dimensionsantal.
BaseType Returnera vektorns bastyp sysname med namnet på datatypen.

Standardbastypen för vektorer är för närvarande inställd på float (32-bitars).

Returvärde

Funktionen returnerar de specifika egenskaperna för en viss vektor baserat på den valda egenskapen. Till exempel:

  • Om egenskapen är Dimensionsreturnerar funktionen ett heltalsvärde som representerar dimensionsantalet för vektorn.
  • Om egenskapen är BaseTypereturnerar funktionen namnet på datatypen (sysname).

Examples

Hämta dimensionsantal

I följande exempel deklarerar du en vektor med tre dimensioner och hämtar antalet dimensioner. Funktionen VECTORPROPERTY returnerar heltalsvärdet 3 som representerar dimensionsantalet.

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

SELECT VECTORPROPERTY(@v, 'Dimensions');

Returnera antal dimensioner

I följande exempel hämtas dimensionsantalet för en vektorkolumn embeddings från en tabell 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

Relaterat innehåll