COL_LENGTH (Transact-SQL)

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiMicrosoft Fabric'te SQL veritabanı

Bu fonksiyon, bir sütunun tanımlanmış uzunluğunu, bayt cinsinden döndürür.

Transact-SQL söz dizimi kuralları

Sözdizimi

COL_LENGTH ( 'table' , 'column' )   

Arguments

'masa'
Sütun uzunluğu bilgisini belirlemek istediğimiz tablonun adı. tablo , nvarchar tipinin bir ifadesidir.

'Sütun'
Uzunluğunu belirlemek istediğimiz sütun adı. sütun , nvarchar tipinin bir ifadesidir.

Dönüş türü

smallint

Exceptions

Hata durumunda veya bir arayan nesneyi görüntüleme için doğru izne sahip değilse NULL döner.

SQL Server'da bir kullanıcı, yalnızca kullanıcının sahip olduğu veya izni verilen güvenlik varlıklarının meta verilerini görebilir. Bu, COL_LENGTH gibi meta veri yayan, yerleşik fonksiyonların, kullanıcının nesne üzerinde doğru iznine sahip olmaması halinde NULL döndürebileceği anlamına gelir. Daha fazla bilgi için Meta Veri Görünürlüğü Konfigürasyonu'na bakınız.

Açıklamalar

Maksimum belirtici (varchar(max)) ile ilan edilen varchar sütunları için, COL_LENGTH -1 değerini döndürür.

Örnekler

Bu örnek, tip varchar(40) bir sütun ve tipte nvarchar(40)bir sütun için dönüş değerlerini gösterir:

USE AdventureWorks2022;  
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;  

Sonuç kümesi aşağıdadır.

VarChar     NVarChar  
40          80  

Ayrıca bakınız

İfadeler (Transact-SQL)
Meta Veri İşlevleri (Transact-SQL)
COL_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)