Статья
04/01/2012

sp_special_columns (Transact-SQL)

Возвращает оптимальный набор столбцов, уникально идентифицирующих строку таблицы. Также возвращает столбцы, автоматически обновляемые, когда любое значение в строке обновляется транзакцией.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

sp_special_columns [ @table_name = ] 'table_name'   
     [ , [ @table_owner = ] 'table_owner' ] 
     [ , [ @qualifier = ] 'qualifier' ] 
     [ , [ @col_type = ] 'col_type' ] 
     [ , [ @scope = ] 'scope' ]
     [ , [ @nullable = ] 'nullable' ] 
     [ , [ @ODBCVer = ] 'ODBCVer' ] 
[ ; ]

Аргументы

[ @table_name =] 'table_name'
Имя таблицы, используемой для возврата данных о каталоге. Аргумент name имеет тип sysname и не имеет значения по умолчанию. Сопоставление по шаблону не поддерживается.
[ @table_owner =] 'table_owner'
Владелец таблицы, используемой для возврата данных о каталоге. Аргумент owner имеет тип sysname и значение по умолчанию NULL. Сопоставление по шаблону не поддерживается. Если аргумент owner не задан, то применяются правила видимости таблиц по умолчанию базовой СУБД.

В SQL Server, если текущий пользователь является владельцем таблицы с указанным именем, возвращаются ее столбцы. Если аргумент owner не указан, а текущий пользователь не является владельцем таблицы с указанным аргументом name, данная процедура производит поиск таблицы с указанным аргументом name, владельцем которой является владелец базы данных. Если таблица существует, возвращаются ее столбцы.
[ @qualifier =] 'qualifier'
Имя квалификатора таблицы. Аргумент qualifier имеет тип sysname и значение по умолчанию NULL. Некоторые СУБД поддерживают трехкомпонентные имена таблиц (qualifier.owner.name). В SQL Server этот столбец представляет имя базы данных. В некоторых СУБД он представляет имя сервера в среде базы данных, в которой находится таблица.
[ @col_type =] 'col_type'
Тип столбца. Аргумент col_type имеет тип char(1) и значение по умолчанию R. Тип R возвращает оптимальный столбец или набор столбцов, которые, получая значения из столбца или столбцов, позволяют уникально идентифицировать любую строку в указанной таблице. Столбец может быть либо псевдостолбцом, специально созданным для этой цели, либо столбцом или столбцами любого уникального индекса таблицы. Тип V возвращает столбец или столбцы в указанной таблице, которые источник данных обновляет автоматически, когда любое значение в строке обновляется транзакцией.
[ @scope =] 'scope'
Минимально требуемая область ROWID. Аргумент scope имеет тип char(1) и значение по умолчанию T. Область C указывает, что ROWID действителен только в случае, если располагается в этой строке. Область T указывает, что ROWID действителен для транзакции.
[ @nullable =] 'nullable'
Определяет, допускают ли специальные столбцы значение NULL. Аргумент nullable имеет тип char(1) и значение по умолчанию U. O указывает специальные столбцы, которые не допускают значения NULL. U указывает столбцы, частично допускающие значения NULL.
[ @ODBCVer =] 'ODBCVer'
Используемая версия ODBC. Аргумент ODBCVer имеет тип int(4) и значение 2 по умолчанию. Это значение соответствует версии ODBC 2.0. Дополнительные сведения о различиях между ODBC 2.0 и ODBC 3.0 см. в спецификации ODBC SQLSpecialColumns для ODBC 3.0.

Значения кода возврата

Нет

Результирующие наборы

Имя столбца	Тип данных	Описание
SCOPE	smallint	Фактическая область идентификатора строки. Может быть 0, 1 или 2. SQL Server всегда возвращает значение 0. Это поле всегда возвращает значение. 0 = SQL_SCOPE_CURROW. Идентификатор строки гарантированно действителен до тех пор, пока он расположен на этой строке. Проведенная позднее повторная выборка с использованием идентификатора строки может не вернуть строку, если строка была обновлена или удалена другой транзакцией. 1 = SQL_SCOPE_TRANSACTION. Идентификатор строки гарантированно действителен на протяжении текущей транзакции. 2 = SQL_SCOPE_SESSION. Идентификатор строки гарантированно действителен на протяжении сеанса (несмотря на границы транзакций).
COLUMN_NAME	sysname	Возвращается имя столбца для каждого столбца table. Это поле всегда возвращает значение.
DATA_TYPE	smallint	Тип данных ODBC SQL.
TYPE_NAME	sysname	Имя типа данных зависимых от источника данных; например char, varchar, money или text.
PRECISION	Int	Точность столбца на источнике данных. Это поле всегда возвращает значение.
LENGTH	Int	Длина в байтах, требуемая для типа данных в двоичной форме в источнике данных; например 10 для char(10), 4 для integer и 2 для smallint.
SCALE	smallint	Масштаб столбца в источнике данных. Для тех типов данных, для которых масштаб не применим, возвращается значение NULL.
PSEUDO_COLUMN	smallint	Указывает, является ли столбец псевдостолбцом. SQL Server всегда возвращает 1. 0 = SQL_PC_UNKNOWN 1 = SQL_PC_NOT_PSEUDO 2 = SQL_PC_PSEUDO

Замечания

Хранимая процедура sp_special_columns эквивалентна ODBC-функции SQLSpecialColumns. Возвращенные результаты сортируются по столбцу SCOPE.

Разрешения

Необходимо разрешение SELECT для схемы.

Примеры

Следующий пример возвращает данные о столбце, которые уникально идентифицируют строки в таблице HumanResources.Department.

USE AdventureWorks2008R2;
GO
EXEC sp_special_columns @table_name = 'Department' 
    ,@table_owner = 'HumanResources';

См. также

Справочник

Хранимые процедуры каталога (Transact-SQL)

Системные хранимые процедуры (Transact-SQL)

Share via