sp_dropserver (Transact-SQL)

  • [アーティクル]

適用対象: SQL Server Azure SQL Managed Instance

SQL Server のローカル インスタンス上の既知のリモート サーバーとリンク サーバーの一覧からサーバーを削除します。

Transact-SQL 構文表記規則

構文

sp_dropserver
    [ @server = ] N'server'
    [ , [ @droplogins = ] 'droplogins' ]
[ ; ]

引数

[ @server = ] N'server'

削除するサーバー。 @server は sysname で、既定値はありません。 @server が存在する必要があります。

[ @droplogins = ] 'droplogins'

@droploginsが指定されている場合、@serverの関連するリモート およびリンク サーバー ログインも削除する必要があることを示します。 @droplogins は char(10) で、既定値は NULL です。

リターン コードの値

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

解説

リモート ログイン エントリとリンク サーバー ログイン エントリが関連付けられているサーバーで sp_dropserver を実行した場合、またはレプリケーション パブリッシャーとして構成されている場合は、エラーが返されます。 サーバーを削除するときに、サーバーのすべてのリモート およびリンク サーバー ログインを削除するには、 @droplogins 引数を使用します。

sp_dropserver は、ユーザー定義トランザクション内では実行できません。

sp_dropserverを使用してローカル サーバー名を変更すると、意図しない影響やサポートされていない構成が発生する可能性があります。

アクセス許可

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

例

次の例では、リモート サーバー ACCOUNTS と、関連付けられているすべてのリモート ログインを SQL Server のローカル インスタンスから削除します。

EXEC sp_dropserver 'ACCOUNTS', 'droplogins';

関連するコンテンツ