sp-serveroption-transact-sql.md

title	sp_serveroption (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	09/11/2017
ms.prod	sql
ms.prod_service	database-engine
ms.component	system-stored-procedures
ms.reviewer
ms.suite	sql
ms.technology	system-objects
ms.tgt_pltfrm
ms.topic	language-reference
f1_keywords	sp_serveroption_TSQL sp_serveroption
dev_langs	TSQL
helpviewer_keywords	7343 (Database Engine error) sp_serveroption
ms.assetid	47d04a2b-dbf0-4f15-bd9b-81a2efc48131
caps.latest.revision	40
author	edmacauley
ms.author	edmaca
manager	craigg

sp_serveroption (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx-md]

Sets server options for remote servers and linked servers.

Transact-SQL Syntax Conventions

Syntax

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

Arguments

[ @server = ] 'server'
Is the name of the server for which to set the option. server is sysname, with no default.

[ @optname = ] 'option_name'
Is the option to set for the specified server. option_name is varchar(35), with no default. option_name can be any of the following values.

Value	Description
collation compatible	Affects Distributed Query execution against linked servers. If this option is set to true, [!INCLUDEssNoVersion] 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). This enables [!INCLUDEssNoVersion] to send comparisons on character columns to the provider. If this option is not set, [!INCLUDEssNoVersion] 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	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 [!INCLUDEssNoVersion] data source. The name must be one of the collations supported by [!INCLUDEssNoVersion]. Use this option when accessing an OLE DB data source other than [!INCLUDEssNoVersion], but whose collation matches one of the [!INCLUDEssNoVersion] collations. The linked server must support a single collation to be used for all columns in that 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 [!INCLUDEssNoVersion] collations.
connect timeout	Time-out valuein seconds for connecting to a linked server. If 0, use the sp_configure default.
data access	Enables and disables a linked server for distributed query access. Can be used only for sys.server entries added through sp_addlinkedserver.
dist	Distributor.
lazy schema validation	Determines whether the schema of remote tables will be checked. If true, skip schema checking of remote tables at the beginning of the query.
pub	Publisher.
query timeout	Time-out value for queries against a linked server. If 0, use the sp_configure default.
rpc	Enables RPC from the given server.
rpc out	Enables RPC to the given server.
sub	Subscriber.
system	[!INCLUDEssInternalOnly]
use remote collation	Determines whether the collation of a remote column or of a local server will be used. If true, the collation of remote columns is used for [!INCLUDEssNoVersion] data sources, and the collation specified in collation name is used for non-[!INCLUDEssNoVersion] data sources. 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. The default is false. (The false value is compatible with the collation semantics used in [!INCLUDEssNoVersion] 7.0.)
remote proc transaction promotion	Use this option to protect the actions of a server-to-server procedure through a [!INCLUDEmsCoName] Distributed Transaction Coordinator (MS DTC) transaction. When this option is TRUE (or ON) calling a remote stored procedure starts a distributed transaction and enlists the transaction with MS DTC. The instance of [!INCLUDEssNoVersion] making the remote stored procedure call is the transaction originator and controls the completion of the transaction. 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. After a [!INCLUDEtsql] distributed transaction has been started, remote stored procedure calls can be made to other instances of [!INCLUDEssNoVersion] that have been defined as linked servers. The linked servers are all enlisted in the [!INCLUDEtsql] distributed transaction, and MS DTC ensures that the transaction is completed against each linked server. 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. The default value for this option is TRUE (or ON).

[ @optvalue =] 'option_value'
Specifies whether or not the option_name should be enabled (TRUE or on) or disabled (FALSE or off). option_value is varchar(10), with no default.

option_value may be a nonnegative integer for the connect timeout and query timeout options. For the collation name option, option_value may be a collation name or NULL.

Return Code Values

0 (success) or 1 (failure)

Remarks

If the collation compatible option is set to TRUE, collation name automatically will be set to NULL. If collation name is set to a nonnull value, collation compatible automatically will be set to FALSE.

Permissions

Requires ALTER ANY LINKED SERVER permission on the server.

Examples

The following example configures a linked server corresponding to another instance of [!INCLUDEssNoVersion], SEATTLE3, to be collation compatible with the local instance of [!INCLUDEssNoVersion].

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

See Also

Distributed Queries Stored Procedures (Transact-SQL)
sp_adddistpublisher (Transact-SQL)
sp_addlinkedserver (Transact-SQL)
sp_dropdistpublisher (Transact-SQL)
sp_helpserver (Transact-SQL)
System Stored Procedures (Transact-SQL)