sp_addserver(Transact-SQL)

적용 대상: 예SQL Server(지원되는 모든 버전)

SQL Server의 로컬 인스턴스 이름을 정의합니다. 를 호스팅하는 컴퓨터의 SQL Server 이름이 변경 되 면 sp_addserver 를 사용 하 여 SQL Server 데이터베이스 엔진 새 컴퓨터 이름에 대 한 인스턴스를 알립니다. 이 프로시저는 해당 컴퓨터에서 호스팅되는 모든 데이터베이스 엔진 인스턴스에서 실행해야 합니다. 데이터베이스 엔진 의 인스턴스 이름은 변경할 수 없습니다. 명명된 인스턴스의 인스턴스 이름을 변경하려면 원하는 이름의 새 인스턴스를 설치하고 이전 인스턴스에서 데이터베이스 파일을 분리한 다음 새 인스턴스에 데이터베이스를 연결하고 이전 인스턴스를 삭제합니다. 또는 클라이언트 별칭 이름을 클라이언트 컴퓨터에서 만들어 서버 컴퓨터에서 인스턴스의 이름을 변경하지 않고 다른 서버 및 인스턴스 이름 또는 서버:포트 조합으로 연결을 리디렉션할 수 있습니다.

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

구문


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

인수

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

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

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

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

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

[ @duplicate_ok = ] 'duplicate_OK' 중복 된 서버 이름을 사용할 수 있는지 여부를 지정 합니다. @ duplicate_OKvarchar (13) 이며 기본값은 NULL입니다. @ duplicate_OKduplicate_OK 또는 NULL 값만 가질 수 있습니다. Duplicate_OK 를 지정 하 고 추가 하려는 서버 이름이 이미 있는 경우 오류가 발생 하지 않습니다. 명명 된 매개 변수가 사용 되지 않는 경우 @ local 을 지정 해야 합니다.

반환 코드 값

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

설명

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

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

원격 서버를 추가 하기 위해 sp_addserver 를 사용 하는 것은 중단 되지 않습니다. sp_addlinkedserver를 대신 사용하세요.

가용성 그룹 또는 복제를 사용 하는 경우 sp_addserver 를 사용 하 여 로컬 서버 이름을 변경 하면 원치 않는 영향이 나 지원 되지 않는 구성이 발생할 수 있습니다.

사용 권한

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

예제

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

sp_addserver 'ACCOUNTS', 'local';

참고 항목

sp_addlinkedserver SQL Server Stand-Alone 인스턴스를 호스트 하는 컴퓨터의 이름을 ( SQL)sp_dropserver (SQL)sp_helpserver 시스템 저장 프로시저 (SQL) (SQL)(SQL)