• 發行項

COL_LENGTH (Transact-SQL)

傳回資料行的定義長度 (以位元組為單位)。

主題連結圖示Transact-SQL 語法慣例

語法

COL_LENGTH ( 'table' , 'column' )

引數

  • 'table'
    這是要判斷資料行長度資訊的資料表名稱。table 是 nvarchar 類型的運算式。

  • 'column'
    這是要判斷長度的資料行名稱。column 是 nvarchar 類型的運算式。

傳回類型

smallint

例外

當發生錯誤，或呼叫者沒有檢視物件的權限時，便會傳回 NULL。

在 SQL Server 中，使用者只能檢視使用者擁有或被授與某些權限之安全性實體的中繼資料。這表示發出中繼資料的內建函數 (例如，COL_LENGTH) 會在使用者不具有該物件任何權限時傳回 NULL。如需詳細資訊，請參閱＜中繼資料可見性組態＞和＜中繼資料可見性疑難排解＞。

備註

對於利用 max 規範 (varchar(max)) 來宣告的 varchar 類型的資料行，COL_LENGTH 會傳回 -1。

範例

下列範例會顯示 varchar(40) 類型之資料行和 nvarchar(40) 類型之資料行的傳回值。

USE AdventureWorks;
GO
CREATE TABLE t1
   (c1 varchar(40),
    c2 nvarchar(40)
   );
GO
SELECT COL_LENGTH('t1','c1')AS 'VarChar',
      COL_LENGTH('t1','c2')AS 'NVarChar';
GO
DROP TABLE t1;

以下為結果集：

VarChar     NVarChar
40          80