SQL_VARIANT_PROPERTY (Transact-SQL)

  • 發行項

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics Platform System (PDW)

傳回基底資料型別和 sql_variant 值的其他相關資訊。

Transact-SQL 語法慣例

Syntax

SQL_VARIANT_PROPERTY ( expression , property )

注意

Azure Synapse Analytics 的無伺服器 SQL 集區不支援此語法。

注意

若要檢視 SQL Server 2014 （12.x） 和舊版的 Transact-SQL 語法，請參閱 舊版檔。

引數

expression
為 sql_variant 類型的運算式。

property
包含要為其提供資訊的 sql_variant 屬性名稱。 property 為 varchar( 128 ) ，可以是下列值中的任何一個：

值 描述 傳回的 sql_variant 的基底類型
BaseType SQL Server 資料類型，例如：

bigint

binary

bit

char

date

datetime

datetime2

datetimeoffset

decimal

float

int

money

nchar

numeric

nvarchar

real

smalldatetime

smallint

smallmoney

time

tinyint

uniqueidentifier

varbinary

varchar		 sysname

NULL = 輸入無效。
有效位數 數值基底資料型別的位數：

date = 10

datetime = 23

datetime2 = 27

當 s = 0 時，datetime2 (s) = 19，否則 s + 20

datetimeoffset = 34

當 s = 0 時，datetimeoffset (s) = 26，否則 s + 27

smalldatetime = 16

time = 16

當 s = 0 時，time (s) = 8，否則 s + 9

float = 53

real = 24

decimal 和 numeric = 18

decimal (p,s) 和 numeric (p,s) = p

money = 19

smallmoney = 10

bigint = 19

int = 10

smallint = 5

tinyint = 3

bit = 1

其他所有類型 = 0		 int

NULL = 輸入無效。
調整 數值基底資料型別小數點右側的位數：

decimal 和 numeric = 0

decimal (p,s) 和 numeric (p,s) = s

money 和 smallmoney = 4

datetime = 3

datetime2 = 7

datetime2 (s) = s (0 - 7)

datetimeoffset = 7

datetimeoffset (s) = s (0 - 7)

time = 7

time (s) = s (0 - 7)

其他所有類型 = 0		 int

NULL = 輸入無效。
TotalBytes 存放值的中繼資料和資料所需要的位元組數。 在檢查 sql_variant 資料行中資料的最大值一端時，這項資訊非常有用。 如果值大於 900，建立索引會失敗。 int

NULL = 輸入無效。
定序 代表特定 sql_variant 值的定序。 sysname

NULL = 輸入無效。
MaxLength 最大資料類型長度 (以位元組為單位)。 例如，nvarchar( 50 ) 的 MaxLength 為 100，int 的 MaxLength 為 4。 int

NULL = 輸入無效。

傳回型別

sql_variant

範例

A. 在資料表中使用 sql_variant

下列範例會擷取有關 colA 值 46279.1 的 SQL_VARIANT_PROPERTY 資訊，其中 colB =1689 (若 tableA 有類型為 sql_variant 的 colA 及 colB)。

CREATE   TABLE tableA(colA sql_variant, colB int)  
INSERT INTO tableA values ( cast (46279.1 as decimal(8,2)), 1689)  
SELECT   SQL_VARIANT_PROPERTY(colA,'BaseType') AS 'Base Type',  
         SQL_VARIANT_PROPERTY(colA,'Precision') AS 'Precision',  
         SQL_VARIANT_PROPERTY(colA,'Scale') AS 'Scale'  
FROM      tableA  
WHERE      colB = 1689

以下為結果集。 請注意，這三個值的每一個都是 sql_variant。

Base Type    Precision    Scale  
---------    ---------    -----  
decimal      8           2  
  
(1 row(s) affected)

B. 使用 sql_variant 作為變數

下列範例會擷取名為 @v1 之變數的相關 SQL_VARIANT_PROPERTY 資訊。

DECLARE @v1 sql_variant;  
SET @v1 = 'ABC';  
SELECT @v1;  
SELECT SQL_VARIANT_PROPERTY(@v1, 'BaseType');  
SELECT SQL_VARIANT_PROPERTY(@v1, 'MaxLength');

另請參閱

sql_variant (Transact-SQL)