sp_helplinkedsrvlogin (Transact-SQL)

Предоставляет сведения о сопоставлениях имен входа, установленных для определенного связанного сервера, который используется для распределенных запросов и удаленных хранимых процедур.

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

Синтаксис

sp_helplinkedsrvlogin [ [ @rmtsrvname = ] 'rmtsrvname' ] 
     [ , [ @locallogin = ] 'locallogin' ]

Аргументы

  • [ @rmtsrvname=] 'rmtsrvname'
    Имя связанного сервера, для которого применяется сопоставление имен входа. Аргумент rmtsrvname имеет тип sysname и значение по умолчанию NULL. При значении NULL возвращаются все сопоставления имен входа, определенные для всех связанных серверов, определенных на локальном компьютере, где выполняется SQL Server.

  • [ @locallogin=] 'locallogin'
    Имя входа SQL Server на локальном сервере, имеющее сопоставление для связанного сервера rmtsrvname. Аргумент locallogin имеет тип sysname и значение по умолчанию NULL. При значении NULL возвращаются все сопоставления имен входа, определенные на сервере rmtsrvname. Если значение не равно NULL, сопоставление locallogin для сервера rmtsrvname должно уже существовать. Аргумент locallogin может быть именем входа SQL Server или пользователем Windows. В таком случае пользователь Windows должен иметь права на доступ к SQL Server, полученные напрямую или через членство в группе Windows, имеющей такие права.

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

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

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

Имя столбца

Тип данных

Описание

Linked Server

sysname

Имя связанного сервера.

Local Login

sysname

Локальное имя входа, для которого применяется сопоставление.

Is Self Mapping

smallint

0 = Локальное имя входа Local Login при подключении к связанному серверу Linked Server сопоставляется имени для удаленного входа Remote Login.

1 = Локальное имя входа Local Login при подключении к связанному серверу Linked Server сопоставляется тому же самому имени входа и паролю.

Remote Login

sysname

Имя входа на связанном сервере Linked Server, сопоставляемое локальному имени входа Local Login, когда параметр Is Self Mapping имеет значение 0. Если параметр Is Self Mapping имеет значение 1, удаленное имя входаRemote Login равно NULL.

Замечания

Перед удалением сопоставлений имен входа необходимо воспользоваться хранимой процедурой sp_helplinkedsrvlogin, чтобы определить, какие связанные серверы затронет эта операция.

Разрешения

Разрешения не проверяются.

Примеры

А. Вывод всех сопоставлений имен входа для всех связанных серверов

В следующем примере выводятся все сопоставления имен входа для всех связанных серверов, определенные на локальном компьютере, выполняющем SQL Server.

EXEC sp_helplinkedsrvlogin;
GO

Ниже приводится результирующий набор.

Linked Server    Local Login   Is Self Mapping Remote Login 
---------------- ------------- --------------- -------------- 
Accounts         NULL          1               NULL
Sales            NULL          1               NULL
Sales            Mary          0               sa
Marketing        NULL          1               NULL

(4 row(s) affected)

Б. Вывод всех сопоставлений имен входа для одного связанного сервера

В следующем примере выводятся все локально определенные сопоставления имен входа для связанного сервера Sales.

EXEC sp_helplinkedsrvlogin 'Sales';
GO

Ниже приводится результирующий набор.

Linked Server    Local Login   Is Self Mapping Remote Login 
---------------- ------------- --------------- -------------- 
Sales            NULL          1               NULL
Sales            Mary          0               sa

(2 row(s) affected)

В. Отображение всех сопоставлений имен входа для локального имени входа

В следующем примере выводятся все локально определенные сопоставления имен входа для имени входа Mary.

EXEC sp_helplinkedsrvlogin NULL, 'Mary';
GO

Ниже приводится результирующий набор.

Linked Server    Local Login   Is Self Mapping Remote Login 
---------------- ------------- --------------- -------------- 
Sales            NULL          1               NULL
Sales            Mary          0               sa

(2 row(s) affected)