sp_special_columns (Transact-SQL)

Статья
12/15/2008

Изменения: 14 апреля 2006 г.

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

Значок ссылки на раздел Соглашения о синтаксисе в 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

Замечания

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

Разрешения

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

Примеры

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

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

См. также

Справочник

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

Справка и поддержка

Получение помощи по SQL Server 2005

Журнал изменений

Версия	Журнал
14 апреля 2006 г.	Измененное содержимое Исправлены значения PSEUDO_COLUMN.

Поделиться через