Sdílet prostřednictvím


VECTORPROPERTY (Transact-SQL)

Platí pro: SQL Server 2025 (17.x) Azure SQL Database Azure SQLManaged InstanceSQL Database v Microsoft Fabric

Funkce VECTORPROPERTY vrátí specifické vlastnosti daného vektoru. Funkce vyžaduje dva argumenty: samotný vektor a vlastnost, která se má načíst.

Note

VECTORPROPERTYje k dispozici ve službě Azure SQL Managed Instance se zásadami aktualizaceSQL Serveru 2025 nebo Always-up-to-date.

Syntax

Transact-SQL konvence syntaxe

VECTORPROPERTY(vector , property)

Arguments

vektor

Platný vektor typu vektoru . Může to být výraz, například proměnná nebo odkaz na sloupec.

Vstupní vektor může být zadán jako [tablename].[colname] nebo jako platná proměnná typu vektoru .

vlastnost

Výraz určující název vlastnosti databáze, která se má vrátit. Vlastnost podporuje jednu z následujících hodnot:

Property Description Vrácená hodnota
Dimensions Počet dimenzí návratových vektorů Celočíselná hodnota s počtem dimenzí
BaseType Základní typ návratových vektorů sysname s názvem datového typu.

Výchozí základní typ vektorů je aktuálně nastavený na float (32bitová verze).

Návratová hodnota

Funkce vrátí specifické vlastnosti daného vektoru na základě vybrané vlastnosti. Například:

  • Pokud je Dimensionsvlastnost , vrátí funkce celočíselnou hodnotu představující počet dimenzí vektoru.
  • Pokud je BaseTypevlastnost , vrátí funkce název datového typu (sysname).

Examples

Načtení počtu dimenzí

V následujícím příkladu deklarujte vektor se třemi dimenzemi a načtěte počet jeho dimenzí. Funkce VECTORPROPERTY vrátí celočíselnou hodnotu 3 představující počet dimenzí.

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

SELECT VECTORPROPERTY(@v, 'Dimensions');

Návratový počet dimenzí

Následující příklad načte počet dimenzí vektorového sloupce embeddings z tabulky 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