sp_serveroption (Transact-SQL)

適用対象: SQL Server

リモート サーバーとリンク サーバーのサーバー オプションを設定します。

Transact-SQL 構文表記規則

構文

sp_serveroption
    [ @server = ] N'server'
    , [ @optname = ] 'optname'
    , [ @optvalue = ] N'optvalue'
[ ; ]

引数

[ @server = ] N'server'

オプションを設定するサーバーの名前。 @server は sysname で、既定値はありません。

[ @optname = ] 'optname'

指定したサーバーに設定するオプション。 @optname は varchar(35)で、既定値はありません。 @optname には、次のいずれかの値を指定できます。

[ @optvalue = ] N'optvalue'

@optnameを有効にするか (trueまたはon)、無効にする (falseまたはoff) かを指定します。 @optvalue は nvarchar(128)で、既定値はありません。

• 接続タイムアウトおよび query timeout オプションの場合、@optvalueは負以外の整数である可能性があります。

• collation name オプションでは、照合順序名またはNULL@optvalueできます。

• name オプションの場合、@optvalueリンク サーバー接続の新しい名前を表す文字列を指定できます。

• provider 文字列 オプションの場合、リンク サーバー接続の新しい OLE DB ソースを表す文字列またはNULLを@optvalueできます。

リターン コードの値

0 (成功) または 1 (失敗)。

解説

collation compatible オプションが true に設定されている場合、collation name は自動的に NULL に設定されます。

collation nameが null 以外の値に設定されている場合、collation 互換は自動的にfalseに設定されます。

アクセス許可

サーバーに対する ALTER ANY LINKED SERVER 権限が必要です。

例

次の例では、SQL Server の別のインスタンス ( SEATTLE3) に対応するリンク サーバーを、SQL Server のローカル インスタンスと互換性のある照合順序に構成します。

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

次の例では、リンク サーバー接続の名前を PRODVM01\ProdSQL01 から LinkToProdSQL01 に変更します。

USE master;
GO
EXEC sp_serveroption
    @server = N'PRODVM01\ProdSQL01',
    @optname = 'name',
    @optvalue = N'LinkToProdSQL01';
GO

関連するコンテンツ

• 分散クエリ ストアド プロシージャ (Transact-SQL)
• sp_adddistpublisher (Transact-SQL)
• sp_addlinkedserver (Transact-SQL)
• sp_dropdistpublisher (Transact-SQL)
• sp_helpserver (Transact-SQL)
• システム ストアド プロシージャ (Transact-SQL)