VECTORPROPERTY (Transact-SQL) (Vorschau)

2025-05-19

Gilt für: SQL Server 2025 (17.x) Vorschau der Azure SQL-Datenbank azureSQL Managed Instance SQL SQL-Datenbank in Microsoft Fabric

Die VECTORPROPERTY-Funktion gibt bestimmte Eigenschaften eines bestimmten Vektors zurück. Die Funktion erfordert zwei Argumente: den Vektor selbst und die abzurufende Eigenschaft.

Hinweis

Diese Funktion befindet sich in der Vorschau und kann geändert werden. Lesen Sie die Vorschaunutzungsbedingungen in Service Level Agreements (SLA) für Onlinedienste.

Syntax

Transact-SQL-Syntaxkonventionen

VECTORPROPERTY(vector, property)

Argumente

Vektor

Ein gültiger Vektor des Vektortyps . Dies kann ein Ausdruck sein, z. B. eine Variable oder ein Verweis auf eine Spalte.

Der Eingabevektor kann als [tablename].[colname] oder als gültige Variable des Vektortyps angegeben werden.

Eigentum

Ein Ausdruck, der den Namen der zurückzugebenden Datenbankeigenschaft angibt. Die Eigenschaft unterstützt einen der folgenden Werte:

Eigentum	BESCHREIBUNG	Zurückgegebener Wert
`Dimensions`	Anzahl der Dimensionen des Rückgabevektors	Ganzzahliger Wert mit Bemaßungsanzahl.
`BaseType`	Basistyp des Rückgabevektors	sysname mit dem Namen des Datentyps.

Der Standardbasistyp für Vektoren ist derzeit auf float (32-Bit) festgelegt.

Rückgabewert

Die Funktion gibt die spezifischen Eigenschaften eines bestimmten Vektors basierend auf der ausgewählten Eigenschaft zurück. Beispiel:

Wenn die Eigenschaft lautet Dimensions, gibt die Funktion einen ganzzahligen Wert zurück, der die Bemaßungsanzahl des Vektors darstellt.
Wenn die Eigenschaft lautet BaseType, gibt die Funktion den Namen des Datentyps (sysname) zurück.

Beispiele

Abrufen der Dimensionanzahl

Deklarieren Sie im folgenden Beispiel einen Vektor mit drei Dimensionen, und rufen Sie die Anzahl der Dimensionen ab. Die VECTORPROPERTY Funktion gibt den ganzzahligen Wert 3 zurück, der die Bemaßungsanzahl darstellt.

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

SELECT VECTORPROPERTY(@v, 'Dimensions');

Rückgabeanzahl von Dimensionen

Im folgenden Beispiel wird die Anzahl der Dimensionen einer Vektorspalte embeddings aus einer Tabelle mytableabgerufen.

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;

Rückgabewerte:

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

Freigeben über