sp_serveroption (Transact-SQL)sp_serveroption (Transact-SQL)

ОБЛАСТЬ ПРИМЕНЕНИЯ: даSQL Server (начиная с версии 2008) нетБаза данных SQL Azure нетХранилище данных SQL AzureнетParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2008) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Устанавливает параметры сервера для удаленных и связанных серверов.Sets server options for remote servers and linked servers.

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

СинтаксисSyntax

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

АргументыArguments

[ @server = ] 'server' — Имя сервера, для которого требуется задать параметр.[ @server = ] 'server' Is the name of the server for which to set the option. Аргументserver имеет тип sysnameи не имеет значения по умолчанию.server is sysname, with no default.

[ @optname = ] 'option_name' — Это возможность задать для указанного сервера.[ @optname = ] 'option_name' Is the option to set for the specified server. option_namevarchar ( 35 ), не имеет значения по умолчанию.option_name is varchar( 35 ), with no default. option_name может быть любым из следующих значений.option_name can be any of the following values.

ЗначениеValue ОписаниеDescription
совместимые параметры сортировкиcollation compatible Влияет на выполнение распределенных запросов на связанных серверах.Affects Distributed Query execution against linked servers. Если этот параметр имеет значение true, SQL ServerSQL Server предполагается, что все символы в связанном сервере совместимы с локальным сервером, в зависимости от символов и параметров сортировки (или порядка сортировки).If this option is set to true, SQL ServerSQL Server assumes that all characters in the linked server are compatible with the local server, with regard to character set and collation sequence (or sort order). Это позволяет SQL ServerSQL Server отправлять поставщику сравнения по символьным столбцам.This enables SQL ServerSQL Server to send comparisons on character columns to the provider. Если этот параметр не задан, SQL ServerSQL Server всегда выполняет сравнения по символьным столбцам локально.If this option is not set, SQL ServerSQL Server always evaluates comparisons on character columns locally.

Этот параметр необходимо задать только в том случае, если источник данных, соответствующий связанному серверу, имеет тот же набор символов и тот же порядок сортировки, что и локальный сервер.This option should be set only if it is certain that the data source corresponding to the linked server has the same character set and sort order as the local server.
Имя параметров сортировкиcollation name Указывает имя параметров сортировки, используемое удаленным источником данных, если использовать удаленные параметры сортировкиtrue и источник данных не является SQL ServerSQL Server источника данных.Specifies the name of the collation used by the remote data source if use remote collation is true and the data source is not a SQL ServerSQL Server data source. Этот имя должно быть одним из параметров сортировки, поддерживаемых SQL ServerSQL Server.The name must be one of the collations supported by SQL ServerSQL Server.

Этот параметр используется при доступе к источнику данных OLE DB, отличному от SQL ServerSQL Server, параметры сортировки которого совпадают с одним из параметров сортировки SQL ServerSQL Server .Use this option when accessing an OLE DB data source other than SQL ServerSQL Server, but whose collation matches one of the SQL ServerSQL Server collations.

Связанный сервер должен поддерживать использование единых параметров сортировки для всех столбцов на этом сервере.The linked server must support a single collation to be used for all columns in that server. Не задавайте этот параметр, если связанный сервер поддерживает несколько параметров сортировки для одного источника данных, или если невозможно определить, соответствуют ли параметры сортировки связанного сервера одному из параметров сортировки SQL ServerSQL Server .Do not set this option if the linked server supports multiple collations within a single data source, or if the linked server's collation cannot be determined to match one of the SQL ServerSQL Server collations.
время ожидания подключенияconnect timeout Время ожидания valuein секунд для подключения к связанному серверу.Time-out valuein seconds for connecting to a linked server.

Если 0, использовать sp_configure по умолчанию.If 0, use the sp_configure default.
доступ к даннымdata access Разрешает и запрещает доступ распределенных запросов к связанному серверу.Enables and disables a linked server for distributed query access. Может использоваться только для sys.server записи, добавленные с помощью sp_addlinkedserver.Can be used only for sys.server entries added through sp_addlinkedserver.
distdist Распространитель.Distributor.
Отложенная проверка схемыlazy schema validation Определяет, будет ли проверена схема удаленных таблиц.Determines whether the schema of remote tables will be checked.

Если true, пропустить проверка схемы удаленных таблиц в начале запроса.If true, skip schema checking of remote tables at the beginning of the query.
pubpub Издатель.Publisher.
время ожидания запросаquery timeout Значение времени ожидания для запросов к связанному серверу.Time-out value for queries against a linked server.

Если 0, использовать sp_configure по умолчанию.If 0, use the sp_configure default.
rpcrpc Включает вызов RPC с заданного сервера.Enables RPC from the given server.
RPC outrpc out Включает вызов RPC на заданный сервер.Enables RPC to the given server.
subsub Подписчик.Subscriber.
Системыsystem Указано только в ознакомительных целях.Identified for informational purposes only. Не поддерживается.Not supported. Совместимость с будущими версиями не гарантируется.Future compatibility is not guaranteed.
использовать удаленные параметры сортировкиuse remote collation Определяет, будут ли использоваться параметры сортировки удаленного столбца или локального сервера.Determines whether the collation of a remote column or of a local server will be used.

Если true, используются параметры сортировки удаленных столбцов для SQL ServerSQL Server источники данных и параметрами сортировки, указанными в имя параметров сортировки используется для отличныхSQL ServerSQL Server источников данных.If true, the collation of remote columns is used for SQL ServerSQL Server data sources, and the collation specified in collation name is used for non-SQL ServerSQL Server data sources.

Если false, распределенные запросы всегда будут использовать параметры сортировки по умолчанию локального сервера, хотя имя параметров сортировки и параметры сортировки удаленных столбцов игнорируются.If false, distributed queries will always use the default collation of the local server, while collation name and the collation of remote columns are ignored. Значение по умолчанию — false.The default is false. ( False значение совместимо с семантикой параметров сортировки, используемых в SQL ServerSQL Server 7.0.)(The false value is compatible with the collation semantics used in SQL ServerSQL Server 7.0.)
Повышение уровня транзакции удаленного процессаremote proc transaction promotion Используйте этот параметр, чтобы защитить действия процедуры между серверами посредством транзакции координатора распределенных транзакций (Майкрософт) ( MicrosoftMicrosoft DTC).Use this option to protect the actions of a server-to-server procedure through a MicrosoftMicrosoft Distributed Transaction Coordinator (MS DTC) transaction. Если этот параметр имеет значение TRUE (или на) вызов удаленной хранимой процедуры запускает распределенную транзакцию и прикрепляет к выполнению транзакции MS DTC.When this option is TRUE (or ON) calling a remote stored procedure starts a distributed transaction and enlists the transaction with MS DTC. Экземпляр SQL ServerSQL Server, вызывающий удаленную хранимую процедуру, является инициатором транзакции и контролирует ее завершение.The instance of SQL ServerSQL Server making the remote stored procedure call is the transaction originator and controls the completion of the transaction. Когда последующая инструкция COMMIT TRANSACTION или ROLLBACK TRANSACTION выдается для соединения, контролирующий экземпляр предписывает MS DTC управлять завершением распределенной транзакции на всех вовлеченных компьютерах.When a subsequent COMMIT TRANSACTION or ROLLBACK TRANSACTION statement is issued for the connection, the controlling instance requests that MS DTC manage the completion of the distributed transaction across the computers involved.

После запуска распределенной транзакции Transact-SQLTransact-SQL вызовы удаленных хранимых процедур могут выполняться к другим экземплярам SQL ServerSQL Server, определенным в качестве связанных серверов.After a Transact-SQLTransact-SQL distributed transaction has been started, remote stored procedure calls can be made to other instances of SQL ServerSQL Server that have been defined as linked servers. Все связанные серверы перечислены в распределенной транзакции Transact-SQLTransact-SQL, а координатор распределенных транзакций (Майкрософт) обеспечивает завершение транзакции на каждом из связанных серверов.The linked servers are all enlisted in the Transact-SQLTransact-SQL distributed transaction, and MS DTC ensures that the transaction is completed against each linked server.

Если этот параметр имеет значение FALSE (или OFF), локальная транзакция не станет распределенной при удаленном вызове процедуры на связанном сервере.If this option is set to FALSE (or OFF), a local transaction will not be promoted to a distributed transaction while calling a remote procedure call on a linked server.

Если до выполнения вызова процедуры сервер-сервер транзакция уже является распределенной, этот параметр не действует.If before making a server-to-server procedure call, the transaction is already a distributed transaction, then this option does not have effect. Вызов процедуры на связанном сервере будет выполняться в одной распределенной транзакции.The procedure call against linked server will run under the same distributed transaction.

Если до вызова процедуры сервер-сервер у соединения нет активной транзакции, этот параметр не действует.If before making a server-to-server procedure call, there is no transaction active in the connection, then this option does not have effect. Процедура выполняется на связанном сервере без активных транзакций.The procedure then runs against linked server without active transactions.

Значение по умолчанию для данного параметра равно TRUE (или ON).The default value for this option is TRUE (or ON).

[ @optvalue = ] 'option_value' Указывает ли option_name должен быть включен (TRUE или на) или отключена (FALSE или off).[ @optvalue = ] 'option_value' Specifies whether or not the option_name should be enabled (TRUE or on) or disabled (FALSE or off). option_valuevarchar ( 10 ), не имеет значения по умолчанию.option_value is varchar( 10 ), with no default.

option_value может быть неотрицательное целое число для время ожидания подключения и время ожидания запроса параметры.option_value may be a nonnegative integer for the connect timeout and query timeout options. Для имя параметров сортировки параметр, option_value может быть именем параметров сортировки или NULL.For the collation name option, option_value may be a collation name or NULL.

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

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

ПримечанияRemarks

Если совместимые параметры сортировки параметр имеет значение TRUE, имя параметров сортировки автоматически будет иметь значение NULL.If the collation compatible option is set to TRUE, collation name automatically will be set to NULL. Если имя параметров сортировки присваивается значение, отличное от NULL, совместимые параметры сортировки автоматически устанавливается в значение FALSE.If collation name is set to a nonnull value, collation compatible automatically will be set to FALSE.

РазрешенияPermissions

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

ПримерыExamples

В следующем примере связанный сервер настраивается в соответствии с другим экземпляром сервера SQL ServerSQL Server, SEATTLE3, чтобы тот был совместим по параметрам сортировки с локальным экземпляром SQL ServerSQL Server.The following example configures a linked server corresponding to another instance of SQL ServerSQL Server, SEATTLE3, to be collation compatible with the local instance of SQL ServerSQL Server.

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

См. такжеSee Also

Распределенные запросы, хранимые процедуры (Transact-SQL) Distributed Queries Stored Procedures (Transact-SQL)
sp_adddistpublisher (Transact-SQL) sp_adddistpublisher (Transact-SQL)
sp_addlinkedserver (Transact-SQL) sp_addlinkedserver (Transact-SQL)
sp_dropdistpublisher (Transact-SQL) sp_dropdistpublisher (Transact-SQL)
sp_helpserver (Transact-SQL) sp_helpserver (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)System Stored Procedures (Transact-SQL)