적용 대상:
SQL Server 2025(17.x)Microsoft Fabric에서Azure SQL DatabaseAzure SQL Managed Instance SQL 데이터베이스 미리 보기
VECTORPROPERTY 함수는 지정된 벡터의 특정 속성을 반환합니다. 함수에는 벡터 자체와 검색할 속성의 두 인수가 필요합니다.
비고
이 함수는 미리 보기 상태이며 변경될 수 있습니다. 온라인 서비스에 대한 SLA(서비스 수준 계약)에서 미리 보기 사용 약관을 읽어야 합니다.
문법
VECTORPROPERTY(vector, property)
주장들
벡터
벡터 형식의 유효한 벡터 입니다. 변수 또는 열에 대한 참조와 같은 식일 수 있습니다.
입력 벡터는 벡[tablename].[colname] 형식의 유효한 변수로 또는 유효한 변수로 지정될 수 있습니다.
재산
반환할 데이터베이스 속성의 이름을 나타내는 식입니다. 속성은 다음 값 중 하나를 지원합니다.
| 재산 | 설명 | 반환된 값 |
|---|---|---|
Dimensions |
반환 벡터의 차원 수 | 차원 수가 있는 정수 값입니다. |
BaseType |
반환 벡터의 기본 형식 | 데이터 형식의 이름을 가진 sysname입니다. |
벡터의 기본 기본 형식은 현재 부동 소수점으로 설정됩니다(32비트).
반환 값
이 함수는 선택한 속성에 따라 지정된 벡터의 특정 속성을 반환합니다. 다음은 그 예입니다.
- 속성이면 함수는
Dimensions벡터의 차원 수를 나타내는 정 수 값을 반환합니다. - 속성이면 함수는
BaseType데이터 형식의 이름(sysname)을 반환합니다.
예시
차원 수 검색
다음 예제에서는 3차원으로 벡터를 선언하고 해당 차원 수를 검색합니다. 이 함수는 VECTORPROPERTY 차원 수를 나타내는 정수 값을 3 반환합니다.
DECLARE @v AS VECTOR(3) = '[1,2,3]';
SELECT VECTORPROPERTY(@v, 'Dimensions');
차원의 반환 수
다음 예제에서는 테이블에서 embeddings벡터 열 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;
반환 값:
Dimensions
----------
3
3
3
3
3
3
3