sys.columns (Transact-SQL)

Применимо к:SQL ServerБаза данных Azure SQLУправляемый экземпляр Azure SQLAzure Synapse AnalyticsСистема платформы аналитики (PDW)Конечная точка SQL аналитики в Microsoft FabricХранилище в Microsoft FabricБаза данных SQL в Microsoft Fabric

Возвращает строку для каждого столбца объекта, имеющего столбцы, например представления или таблицы. В следующем списке содержатся типы объектов, имеющие столбцы:

• возвращающие табличное значение функции сборки (FT);
• встроенные возвращающие табличное значение функции SQL (IF);
• внутренние таблицы (IT);
• системные таблицы (S);
• возвращающие табличное значение функции SQL (TF);
• пользовательские таблицы (U);
• представления (V).

Имя столбца	Тип данных	Описание
object_id	int	Идентификатор объекта, которому принадлежит этот столбец.
name	sysname	Имя столбца. Уникален в пределах объекта.
column_id	int	Идентификатор столбца. Уникален в пределах объекта. Идентификаторы столбца могут быть непоследовательными.
system_type_id	tinyint	Идентификатор системного типа столбца.
user_type_id	int	Идентификатор определенного пользователем типа столбца. Чтобы вернуть имя типа, присоедините к представлению каталога sys.types в этом столбце.
max_length	смолинт	Максимальная длина столбца (в байтах). -1= тип данных столбца — varchar(max), nvarchar(max), varbinary(max)или xml. Для столбцов текста, ntext
precision	tinyint	Точность столбца, если числовое значение; 0в противном случае .
scale	tinyint	Масштабирование столбца, если числовое значение; 0в противном случае .
collation_name	sysname	Имя параметров сортировки столбца, если он символьный; в противном случае — значение NULL.
is_nullable	бит	1 = столбец имеет значение NULL 0 = столбец не допускает значение NULL
is_ansi_padded	бит	1 = столбец использует ANSI_PADDING ON поведение, если символ, двоичный или вариант 0 = столбец не является символом, двоичным или вариантом
is_rowguidcol	бит	1 = столбец объявлен ROWGUIDCOL
is_identity	бит	1 = столбец имеет значения идентификаторов
is_computed	бит	1 = столбец — вычисляемый столбец
is_filestream	бит	1 = столбец FILESTREAM — это столбец FILESTREAM
is_replicated	бит	1 = реплицируется столбец
is_non_sql_subscribed	бит	1 = Столбец имеет подписчик, отличный от SQL Server
is_merge_published	бит	1 = столбец опубликован слиянием
is_dts_replicated	бит	1 = столбец реплицируется с помощью служб SSIS
is_xml_document	бит	1 = содержимое — полный XML-документ 0 = содержимое является фрагментом документа, или тип данных столбца не является xml
xml_collection_id	int	Ненулевое значение, если тип столбца — xml, а XML типизирован. Значением является идентификатор коллекции, содержащей проверяющее пространство имен схемы XML столбца. 0 = нет коллекции схем XML
default_object_id	int	Идентификатор объекта по умолчанию независимо от того, является ли он автономным объектом sp_bindefault или встроенным ограничением на уровне DEFAULT столбцов. parent_object_id Столбец объекта по умолчанию на уровне встроенного столбца является ссылкой обратно на саму таблицу. 0 = нет по умолчанию
rule_object_id	int	ID отдельного правила, привязанного к столбцу с помощью sys.sp_bindrule. 0 = нет автономного правила. Ограничения на уровне CHECK столбцов см. в sys.check_constraints.
is_sparse	бит	1 = столбец является разреженным столбцом. Дополнительные сведения см. в разделе "Использование разреженных столбцов".
is_column_set	бит	1 = столбец — это набор столбцов. Дополнительные сведения см. в разделе "Использование разреженных столбцов".
generated_always_type	tinyint	Определяет, когда создается значение столбца (всегда 0 используется для столбцов в системных таблицах). Область применения: SQL Server 2016 (13.x) и более поздних версий и База данных SQL. 0 = NOT_APPLICABLE 1 = AS_ROW_START 2 = AS_ROW_END Область применения: SQL Server 2022 (16.x) и более поздних версий и База данных SQL. 5 = AS_TRANSACTION_ID_START 6 = AS_TRANSACTION_ID_END 7 = AS_SEQUENCE_NUMBER_START 8 = AS_SEQUENCE_NUMBER_END Дополнительные сведения см. в разделе Темпоральные таблицы.
generated_always_type_desc	nvarchar(60)	Текстовое описание generated_always_type значения (всегда NOT_APPLICABLE для столбцов в системных таблицах) Область применения: SQL Server 2016 (13.x) и более поздних версий и База данных SQL. NOT_APPLICABLE AS_ROW_START AS_ROW_END Область применения: SQL Server 2022 (16.x) и более поздних версий и База данных SQL. AS_TRANSACTION_ID_START AS_TRANSACTION_ID_END AS_SEQUENCE_NUMBER_START AS_SEQUENCE_NUMBER_END
encryption_type	int	Тип шифрования: 1 = детерминированное шифрование 2 = случайное шифрование Область применения: SQL Server 2016 (13.x) и более поздних версий и База данных SQL
encryption_type_desc	nvarchar(64)	Описание типа шифрования: RANDOMIZED DETERMINISTIC Область применения: SQL Server 2016 (13.x) и более поздних версий и База данных SQL
encryption_algorithm_name	sysname	Имя алгоритма шифрования. Поддерживается только AEAD_AES_256_CBC_HMAC_SHA_512. Область применения: SQL Server 2016 (13.x) и более поздних версий и База данных SQL
column_encryption_key_id	int	Идентификатор ключа шифрования столбца (CEK). Область применения: SQL Server 2016 (13.x) и более поздних версий и База данных SQL
column_encryption_key_database_name	sysname	Имя базы данных, в которой существует ключ шифрования столбца, если отличается от базы данных столбца. NULL, если ключ существует в той же базе данных, что и столбец. Область применения: SQL Server 2016 (13.x) и более поздних версий и База данных SQL
is_hidden	бит	Указывает, если столбец скрыт: 0 = обычный, не скрытый, видимый столбец 1 = скрытый столбец Область применения: SQL Server 2016 (13.x) и более поздних версий и База данных SQL
is_masked	бит	Указывает, маскируется ли столбец динамическим маскированием данных: 0 = обычный, не маскированные столбцы 1 = столбец маскируется Область применения: SQL Server 2016 (13.x) и более поздних версий и База данных SQL
graph_type	int	Внутренний столбец с набором значений. Значения находятся между 1 столбцами графа и 8NULL другими.
graph_type_desc	nvarchar(60)	Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.
is_data_deletion_filter_column	бит	Указывает, является ли столбец столбцом фильтра хранения данных для таблицы. Область применения: SQL Azure для пограничных вычислений
ledger_view_column_type	int	Если нет NULL, указывает тип столбца в представлении реестра: 1 = TRANSACTION_ID 2 = SEQUENCE_NUMBER 3 = OPERATION_TYPE 4 = OPERATION_TYPE_DESC Дополнительные сведения см. в обзоре реестра. Область применения: SQL Server 2022 (16.x) и более поздних версий и База данных SQL
ledger_view_column_type_desc	nvarchar(60)	Если нет NULL, содержит текстовое описание типа столбца в представлении реестра: TRANSACTION_ID SEQUENCE_NUMBER OPERATION_TYPE OPERATION_TYPE_DESC Область применения: SQL Server 2022 (16.x) и более поздних версий и База данных SQL
is_dropped_ledger_column	бит	Указывает столбец таблицы реестра, который был удален. Область применения: SQL Server 2022 (16.x) и более поздних версий и База данных SQL
vector_dimensions	int	Показывает, сколько измерений имеет вектор. Применимо к: SQL Server 2025 (17.x) и более поздних версий, а также SQL Database
vector_base_type	tinyint	Указывает тип данных, используемый для хранения значений векторных измерений. 0 = 32-битный (одноточный) плавающий 1 = 16-битный (половинная точность) плавающий 1 Применимо к: SQL Server 2025 (17.x) и более поздних версий, а также SQL Database
vector_base_type_desc	nvarchar(10)	Содержит текстовое описание типа данных, используемого для хранения значений векторных измерений. Применимо к: SQL Server 2025 (17.x) и более поздних версий, а также SQL Database

¹ Для получения дополнительной информации см. Формат с плавающей запятой с половинной точностью.

Разрешения

Видимость метаданных в представлениях каталога ограничена защищаемыми объектами, которыми владеет пользователь или которым пользователь получил некоторое разрешение. Дополнительные сведения см. в разделе "Конфигурация видимости метаданных".

Примеры использования

Получение сведений о столбце для таблицы

Чтобы получить метаданные для столбцов в таблице, используйте следующий код:

CREATE TABLE dbo.[sample]
(
    id INT NOT NULL,
    col1 VARBINARY (10) NULL
);

SELECT c.[name] AS column_name,
       t.[name] AS [type_name],
       c.[max_length],
       c.[precision],
       c.[scale]
FROM sys.columns AS c
     INNER JOIN sys.types AS t
         ON c.user_type_id = t.user_type_id
WHERE object_id = object_id('dbo.sample');

Связанный контент

• Представления каталога объектов (Transact-SQL)
• Представления системного каталога (Transact-SQL)
• Часто задаваемые вопросы о запросах к системному каталогу SQL Server
• sys.all_columns (Transact-SQL)
• sys.system_columns (Transact-SQL)
• sys.types (Transact-SQL)