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.

Разрешения

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

Примеры

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

DECLARE @RetCode INT

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

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

См. также

Справочник

sp_ActiveDirectory_SCP (Transact-SQL)
sp_addmergepublication (Transact-SQL)
sp_addpublication (Transact-SQL)
sp_changemergepublication (Transact-SQL)
sp_changepublication (Transact-SQL)

Другие ресурсы

Регистрация основного имени службы

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

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