Статья
04/01/2012

sp_ActiveDirectory_Obj (Transact-SQL)

Управляет регистрацией базы данных Microsoft SQL Server в службе каталогов Microsoft Windows Active Directory.

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

Синтаксис

sp_ActiveDirectory_Obj [ @Action = N'action'
     [ , [@ObjType = ] N'database' ]
          , [ @ObjName = ] N'database_name'

Аргументы

[ @Action = ] N'action'
Указывает, должен ли объект службы каталогов Active Directory, регистрирующий базу данных SQL Server, быть создан, обновлен или удален. Аргумент action имеет тип nvarchar(20) и значение по умолчанию N'create'.

Значение	Описание
create	Регистрирует базу данных SQL Server в службе каталогов Active Directory путем создания объекта MS-SQL-SQLDatabaseв этом каталоге. Объект MS-SQL-SQLDatabase записывает атрибуты базы данных в момент выполнения действия. Если при указании этого значения база данных уже зарегистрирована, то объект обновляется.
update	Обновляет атрибуты, зарегистрированные для базы данных в службе каталогов Active Directory, путем обновления соответствующих записей в объекте MS-SQL-SQLDatabase службы каталогов.
delete	Удаляет регистрацию базы данных в службе каталогов Active Directory путем удаления объекта MS-SQL_SQLDatabase из службы каталогов.

[ @ObjType = ] N'database'
Указывает, что sp_ActiveDirectory_Obj выполняет требуемое действие с объектом базы данных в службе каталогов Active Directory. Аргумент N'database' имеет тип nvarchar(15) и значение по умолчанию N'database'. Это единственное поддерживаемое значение.
[ @ObjName = ] N'database_name'
Указывает имя базы данных, для которой выполняется регистрация. Аргумент database_name имеет тип sysname и является обязательным. Аргумент database_name должен указывать имя базы данных, существующей в экземпляре SQL Server, в котором выполняется процедура sp_ActiveDirectory_Obj. Значение аргумента database_name должно соответствовать правилам именования идентификаторов.

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

0 (успешное завершение) или 1 (неуспешное завершение)

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

Нет

Замечания

Текущий экземпляр SQL Server должен быть зарегистрирован в службе каталогов Active Directory перед регистрацией баз данных в этом экземпляре. При удалении регистрации экземпляра из службы каталогов Active Directory удаляются также все регистрации баз данных в этом экземпляре.

База данных — это единственная сущность, которую можно непосредственно зарегистрировать в службе каталогов Active Directory при помощи процедуры sp_ActiveDirectory_Obj. Управление регистрацией экземпляров SQL Server в службе каталогов Active Directory осуществляется при помощи хранимой процедуры sp_ActiveDirectory_SCP.

Примечание
Данные регистрации в службе каталогов Active Directory могут быть изменены только при помощи той учетной записи, которая использовалась при создании регистрации. При изменении учетной записи безопасности, используемой службой SQL Server, удалите данные регистрации в службе Active Directory, измените учетную запись службы и заново создайте регистрацию в службе Active Directory.

Данные регистрации в службе каталогов Active Directory могут быть изменены только при помощи той учетной записи, которая использовалась при создании регистрации. При изменении учетной записи безопасности, используемой службой SQL Server, удалите данные регистрации в службе Active Directory, измените учетную запись службы и заново создайте регистрацию в службе Active Directory.

Разрешения

Необходимо быть членом предопределенной роли сервера sysadmin или предопределенной роли базы данных db_owner.

Примеры

В следующем примере база данных База данных AdventureWorks2008R2 из текущего экземпляра SQL Server регистрируется в службе каталогов Active Directory.

DECLARE @RetCode INT

EXEC @RetCode = sp_ActiveDirectory_Obj @Action = N'create',
     @ObjType = N'database',
     @ObjName = N'AdventureWorks2008R2';

PRINT 'Return code = ' + CAST(@RetCode AS VARCHAR);