sp_addserver(Transact-SQL)

SQL Server의 로컬 인스턴스 이름을 정의합니다. SQL Server를 호스팅하는 컴퓨터의 이름이 바뀐 경우 sp_addserver를 사용하여 SQL Server 데이터베이스 엔진 인스턴스에 새 컴퓨터 이름을 알릴 수 있습니다. 이 프로시저는 해당 컴퓨터에서 호스팅되는 모든 데이터베이스 엔진 인스턴스에서 실행해야 합니다. 데이터베이스 엔진의 인스턴스 이름은 변경할 수 없습니다.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙

구문

sp_addserver [ @server = ] 'server' ,
     [ @local = ] 'local' 
     [ , [ @duplicate_ok = ] 'duplicate_OK' ]

인수

  • [ @server = ] 'server'
    서버 이름입니다. 서버 이름은 고유해야 하며 Microsoft Windows 컴퓨터 이름에 관한 규칙을 준수해야 합니다. 단, 공백은 사용할 수 없습니다. server는 sysname이며 기본값은 없습니다.

    컴퓨터에 SQL Server 인스턴스가 여러 개 설치되어 있으면 각 인스턴스는 별개의 서버에 있는 것처럼 작동합니다. 명명된 인스턴스를 지정하려면 server를 servername\instancename으로 참조합니다.

  • [ @local = ] 'LOCAL'
    로컬 서버로 추가할 서버를 지정합니다. **@local**은 varchar(10)이며 기본값은 NULL입니다. **@local**을 LOCAL로 지정하면 **@server**가 로컬 서버의 이름으로 정의되고 @@SERVERNAME 함수는 server의 값을 반환하게 됩니다.

    SQL Server 설치 프로그램은 설치 중에 이 변수를 컴퓨터 이름으로 설정합니다. 기본적으로 이 컴퓨터 이름을 사용하면 추가 구성 없이 SQL Server 인스턴스에 연결할 수 있습니다.

    로컬 정의는 데이터베이스 엔진을 다시 시작해야 적용됩니다. 각 데이터베이스 엔진 인스턴스에서 로컬 서버는 하나만 정의할 수 있습니다.

  • [ @duplicate\_ok = ] 'duplicate_OK'
    서버 이름 중복을 허용할지 여부를 지정합니다. **@duplicate\_OK**는 varchar(13)이며 기본값은 NULL입니다. **@duplicate\_OK**는 duplicate_OK 또는 NULL 값만 가질 수 있습니다. duplicate_OK가 지정된 경우에는 추가할 서버 이름이 이미 존재해도 오류가 발생하지 않습니다. 명명된 매개 변수가 사용되지 않는 경우에는 반드시 **@local**을 지정해야 합니다.

반환 코드 값

0(성공) 또는 1(실패)

주의

서버 옵션을 설정하거나 해제하려면 sp_serveroption을 사용합니다.

사용자 정의 트랜잭션 내에서는 sp_addserver를 사용할 수 없습니다.

더 이상 sp_addserver를 사용하여 원격 서버를 추가할 수 없습니다. 대신 sp_addlinkedserver를 사용합니다.

사용 권한

setupadmin 고정 서버 역할의 멤버 자격이 필요합니다.

다음 예에서는 SQL Server를 호스팅하는 컴퓨터 이름의 데이터베이스 엔진 항목을 ACCOUNTS로 변경합니다.

sp_addserver 'ACCOUNTS', 'local';

참고 항목

태스크

SQL Server의 독립 실행형 인스턴스를 호스팅하는 컴퓨터 이름 바꾸기

참조

sp_addlinkedserver(Transact-SQL)

sp_dropserver(Transact-SQL)

sp_helpserver(Transact-SQL)

시스템 저장 프로시저(Transact-SQL)

보안 저장 프로시저(Transact-SQL)