sp_serveroption (Transact-SQL)

Применимо к: SQL Server (все поддерживаемые версии)

Устанавливает параметры сервера для удаленных и связанных серверов.

Topic link iconСинтаксические обозначения в Transact-SQL

Синтаксис

sp_serveroption [@server = ] 'server'   
      ,[@optname = ] 'option_name'       
      ,[@optvalue = ] 'option_value' ;  

Аргументы

[ @server = ] 'server' Имя сервера, для которого необходимо задать параметр. Аргументserver имеет тип sysnameи не имеет значения по умолчанию.

[ @optname = ] 'option_name' Параметр, заданный для указанного сервера. option_namevarchar(35) без значения по умолчанию. option_name может быть любым из следующих значений.

Значение Описание
Совместимые параметры сортировки Влияет на выполнение распределенных запросов на связанных серверах. Если для этого параметра задано значение true, SQL Server предполагает, что все символы связанного сервера совместимы с локальным сервером в отношении набора символов и последовательности сортировки (или порядка сортировки). Это позволяет SQL Server отправлять поставщику сравнения по символьным столбцам. Если этот параметр не задан, SQL Server всегда выполняет сравнения по символьным столбцам локально.

Этот параметр необходимо задать только в том случае, если источник данных, соответствующий связанному серверу, имеет тот же набор символов и тот же порядок сортировки, что и локальный сервер.
Имя параметров сортировки Указывает имя параметров сортировки, используемых удаленным источником данных, если используется удаленная сортировкаtrue, а источник данных не является SQL Server источником данных. Этот имя должно быть одним из параметров сортировки, поддерживаемых SQL Server.

Этот параметр используется при доступе к источнику данных OLE DB, отличному от SQL Server, параметры сортировки которого совпадают с одним из параметров сортировки SQL Server .

Связанный сервер должен поддерживать использование единых параметров сортировки для всех столбцов на этом сервере. Не задавайте этот параметр, если связанный сервер поддерживает несколько параметров сортировки для одного источника данных, или если невозможно определить, соответствуют ли параметры сортировки связанного сервера одному из параметров сортировки SQL Server .
Время ожидания подключения Время ожидания в секундах для подключения к связанному серверу.

Если значение 0, используйте sp_configure по умолчанию.
доступ к данным Разрешает и запрещает доступ распределенных запросов к связанному серверу. Можно использовать только для записей sys.server , добавленных через sp_addlinkedserver.
dist Распространитель.
lazy schema validation Определяет, будет ли проверена схема удаленных таблиц.

Если значение равно true, пропустите проверку схемы удаленных таблиц в начале запроса.
паб Издатель.
время ожидания запроса Значение времени ожидания для запросов к связанному серверу.

Если значение 0, используйте sp_configure по умолчанию.
Rpc Включает вызов RPC с заданного сервера.
rpc out Включает вызов RPC на заданный сервер.
sub Подписчик.
система Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.
использование удаленных параметров сортировки Определяет, будут ли использоваться параметры сортировки удаленного столбца или локального сервера.

Если значение равно true, параметры сортировки удаленных столбцов используются для SQL Server источников данных, а параметры сортировки, указанные в имени параметров сортировки, используются для источников данных, отличных от SQL Server. Это значение по умолчанию.

Если значение равно false, распределенные запросы всегда будут использовать параметры сортировки по умолчанию локального сервера, а имена параметров сортировки и параметры сортировки удаленных столбцов игнорируются.
remote proc transaction promotion Используйте этот параметр, чтобы защитить действия процедуры между серверами посредством транзакции координатора распределенных транзакций (Майкрософт) ( Microsoft DTC). Если этот параметр имеет значение TRUE (или ON), то вызов удаленной хранимой процедуры приводит к запуску распределенной транзакции и прикрепляется к выполнению транзакции MS DTC. Экземпляр SQL Server, вызывающий удаленную хранимую процедуру, является инициатором транзакции и контролирует ее завершение. Когда последующая инструкция COMMIT TRANSACTION или ROLLBACK TRANSACTION выдается для соединения, контролирующий экземпляр предписывает MS DTC управлять завершением распределенной транзакции на всех вовлеченных компьютерах.

После запуска распределенной транзакции Transact-SQL удаленные вызовы хранимых процедур можно выполнять к другим экземплярам SQL Server, которые были определены как связанные серверы. Все связанные серверы включены в распределенную транзакцию Transact-SQL, и MS DTC гарантирует, что транзакция завершена на каждом связанном сервере.

Если этот параметр имеет значение FALSE (или OFF), локальная транзакция не станет распределенной при удаленном вызове процедуры на связанном сервере.

Если до выполнения вызова процедуры сервер-сервер транзакция уже является распределенной, этот параметр не действует. Вызов процедуры на связанном сервере будет выполняться в одной распределенной транзакции.

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

Значение по умолчанию для данного параметра равно TRUE (или ON).

[ @optvalue = ] 'option_value' Указывает, должна ли option_name быть включена (TRUE или включено) или отключена (FALSE или отключена). option_valuevarchar(10) без значения по умолчанию.

option_value может быть неотрицательным целым числом для параметров времени ожидания подключения и времени ожидания запроса . Для параметра имени параметров сортировкиoption_value может быть именем параметров сортировки или NULL.

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

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

Remarks

Если для параметра , совместимого с параметрами сортировки задано значение TRUE, автоматически будет задано значение NULL. Если для имени параметров сортировки задано ненулевое значение, параметры сортировки, совместимые автоматически, будут иметь значение FALSE.

Разрешения

Необходимо разрешение ALTER ANY LINKED SERVER на сервере.

Примеры

Следующий пример настраивает связанный сервер, соответствующий другому экземпляру SQL Server, SEATTLE3для совместимости параметров сортировки с локальным экземпляром SQL Server.

USE master;  
EXEC sp_serveroption 'SEATTLE3', 'collation compatible', 'true';  

См. также:

Хранимые процедуры распределенных запросов (Transact-SQL)
sp_adddistpublisher (Transact-SQL)
sp_addlinkedserver (Transact-SQL)
sp_dropdistpublisher (Transact-SQL)
sp_helpserver (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)