COL_LENGTH (Transact-SQL)

Artikel
10/31/2024

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' )

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 sehen Sie das Ergebnis.

VarChar     NVarChar  
40          80

Siehe auch

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

Teilen über