Anmerkung
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: SQL Server 2025 (17.x)
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.
Note
VECTORPROPERTYist in azure SQL Managed Instance mit der SQL Server 2025- oder Always-up-to-Updaterichtlinie verfügbar.
Syntax
Transact-SQL-Syntaxkonventionen
VECTORPROPERTY(vector , property)
Arguments
vector
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.
property
Ein Ausdruck, der den Namen der zurückzugebenden Datenbankeigenschaft angibt. Die Eigenschaft unterstützt einen der folgenden Werte:
| Property | Description | 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.
Examples
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;
Returns:
Dimensions
----------
3
3
3
3
3
3
3