Bagikan melalui


VECTORPROPERTY (Transact-SQL)

Berlaku untuk: Database SQL SQL Server 2025 (17.x) Azure SQL DatabaseAzure SQL Managed Instancedi Microsoft Fabric

Fungsi mengembalikan VECTORPROPERTY properti tertentu dari vektor tertentu. Fungsi ini memerlukan dua argumen: vektor itu sendiri dan properti yang akan diambil.

Note

VECTORPROPERTYtersedia di Azure SQL Managed Instance dengan kebijakan pembaruanSQL Server 2025 atau Always-up-to-date.

Syntax

Konvensi sintaks Transact-SQL

VECTORPROPERTY(vector , property)

Arguments

vektor

Vektor yang valid dari jenis vektor . Ini bisa menjadi ekspresi, seperti variabel atau referensi ke kolom.

Vektor input mungkin ditentukan sebagai [tablename].[colname] atau sebagai variabel yang valid dari jenis vektor .

properti

Ekspresi yang menentukan nama properti database yang akan dikembalikan. Properti mendukung salah satu nilai berikut:

Property Description Nilai yang Dikembalikan
Dimensions Mengembalikan jumlah dimensi vektor Nilai bilangan bulat dengan jumlah dimensi.
BaseType Mengembalikan jenis dasar vektor sysname dengan nama jenis data.

Jenis dasar default untuk vektor saat ini diatur ke float (32-bit).

Mengembalikan nilai

Fungsi mengembalikan properti tertentu dari vektor tertentu berdasarkan properti yang dipilih. Contohnya:

  • Jika properti adalah Dimensions, fungsi mengembalikan nilai bilangan bulat yang mewakili jumlah dimensi vektor.
  • Jika properti adalah BaseType, fungsi mengembalikan nama jenis data (sysname).

Examples

Mengambil jumlah dimensi

Dalam contoh berikut, deklarasikan vektor dengan tiga dimensi dan ambil jumlah dimensinya. Fungsi VECTORPROPERTY mengembalikan nilai 3 bilangan bulat yang mewakili jumlah dimensi.

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

SELECT VECTORPROPERTY(@v, 'Dimensions');

Jumlah pengembalian dimensi

Contoh berikut mengambil jumlah dimensi kolom embeddings vektor dari tabel 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