COL_LENGTH (Transact-SQL)

Artikel
12/22/2023

Gilt für:SQL Server Azure SQL-Datenbank Azure SQL Managed Instance

Diese Funktion gibt die definierte Länge einer Spalte in Bytes zurück.

Syntax

COL_LENGTH ( 'table' , 'column' )

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

'table'
Der Name der Tabelle, für die die Spaltenlängeninformationen bestimmt werden sollen. table: Ein Ausdruck vom Typ nvarchar.

'column'
Der Name der Spalte, für die die Länge bestimmt werden soll. column: Ein Ausdruck vom Typ nvarchar.

Rückgabetyp

smallint

Ausnahmen

Gibt NULL zurück bei einem Fehler oder wenn ein Aufrufer nicht über die korrekte Berechtigung zum Anzeigen des Objekts verfügt.

In SQL Server kann ein Benutzer nur die Metadaten sicherungsfähiger Elemente anzeigen, bei denen der Benutzer entweder der Besitzer ist oder für die dem Benutzer eine Berechtigung erteilt wurde. Dies bedeutet, dass Metadaten ausgebende integrierte Funktionen, z.B. COL_LENGTH, möglicherweise NULL zurückgeben, wenn dem Benutzer für das Objekt nicht die korrekte Berechtigung erteilt wurde. Weitere Informationen finden Sie unter Konfigurieren der Sichtbarkeit von Metadaten.

Bemerkungen

Für varchar-Spalten, die mit dem Bezeichner max deklariert wurden (varchar(max)), gibt COL_LENGTH den Wert –1 zurück.

Beispiele

Dieses Beispiel zeigt die Rückgabewerte für eine Spalte vom Typ varchar(40) und eine Spalte vom Typ nvarchar(40):

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;

Hier ist das Resultset.

VarChar     NVarChar  
40          80

Weitere Informationen

Ausdrücke (Transact-SQL)
Metadatenfunktionen (Transact-SQL)
COL_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)