sp_addlinkedserver(Transact-SQL)

구문

sp_addlinkedserver [ @server= ] 'server' [ , [ @srvproduct= ] 'product_name' ] 
     [ , [ @provider= ] 'provider_name' ]
     [ , [ @datasrc= ] 'data_source' ] 
     [ , [ @location= ] 'location' ] 
     [ , [ @provstr= ] 'provider_string' ] 
     [ , [ @catalog= ] 'catalog' ] 

인수

• [ @server= ] 'server'
  만들려고 하는 연결된 서버의 이름입니다. server는 sysname이며 기본값은 없습니다.

• [ @srvproduct= ] 'product_name'
  연결된 서버로 추가할 OLE DB 데이터 원본의 제품 이름입니다. product_name은 nvarchar(128)이며 기본값은 NULL입니다. SQL Server의 경우 provider_name, data_source, location, provider_string, catalog를 지정할 필요가 없습니다.

• [ @provider= ] 'provider_name'
  이 데이터 원본에 해당하는 OLE DB 공급자의 고유 PROGID(프로그래밍 ID)입니다. provider_name은 현재 컴퓨터에 설치된 지정된 OLE DB 공급자에 대해 고유해야 합니다. provider_name은 nvarchar(128)이며 기본값은 NULL입니다. provider_name을 생략하면 SQLNCLI가 사용됩니다. (SQLNCLI 및 SQL Server를 사용하면 SQL Server Native Client OLE DB 공급자의 최신 버전으로 리디렉션됩니다. OLE DB 공급자는 레지스트리에서 지정된 PROGID를 사용하여 등록해야 합니다.

• [ @datasrc= ] 'data_source'
  OLE DB 공급자가 해석하는 데이터 원본의 이름입니다. data_source는 nvarchar(4000)입니다. data_source는 OLE DB 공급자를 초기화하기 위해 DBPROP_INIT_DATASOURCE 속성으로 전달됩니다.

• [ @location= ] 'location'
  OLE DB 공급자에 의해 해석된 데이터베이스의 위치입니다. location은 nvarchar(4000)이며 기본값은 NULL입니다. location은 DBPROP_INIT_LOCATION 속성으로 전달되어 OLE DB 공급자를 초기화합니다.

• [ @provstr= ] 'provider_string'
  고유한 데이터 원본을 나타내는 OLE DB 공급자의 연결 문자열입니다. provider_string은 nvarchar(4000)이며 기본값은 NULL입니다. provstr은 IDataInitialize로 전달되거나 DBPROP_INIT_PROVIDERSTRING 속성으로 설정되어 OLE DB 공급자를 초기화합니다.

  SQL Server Native Client OLE DB 공급자에 대해 연결된 서버를 만들 때는 SERVER 키워드를 SERVER=servername\instancename으로 사용하여 SQL Server의 특정 인스턴스를 지정함으로써 인스턴스를 지정할 수 있습니다. servername은 SQL Server가 실행되는 컴퓨터의 이름이고 instancename은 사용자가 연결할 SQL Server의 인스턴스입니다.

  [!참고]

  미러된 데이터베이스에 액세스하려면 연결 문자열이 데이터베이스 이름을 포함해야 합니다. 이 이름은 데이터 액세스 공급자의 장애 조치(Failover) 시도를 지원하는 데 필요합니다. 데이터베이스를 @provstr 또는 @catalog 매개 변수에 지정할 수 있습니다. 필요에 따라 연결 문자열이 장애 조치(Failover) 파트너 이름을 제공할 수도 있습니다. 자세한 내용은 데이터베이스 미러링 세션에 대한 초기 연결 설정을 참조하십시오.

• [ @catalog= ] 'catalog'
  OLE DB 공급자에 연결할 때 사용되는 카탈로그입니다. catalog는 sysname이며 기본값은 NULL입니다. catalog는 DBPROP_INIT_CATALOG 속성으로 전달되어 OLE DB 공급자를 초기화합니다. SQL Server 인스턴스에 대해 연결된 서버를 정의한 경우 카탈로그는 연결된 서버가 매핑된 기본 데이터베이스를 참조합니다.

반환 코드 값

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

결과 집합

없음

주의

다음 표에서는 OLE DB를 통해 액세스할 수 있는 데이터 원본에 대해 연결된 서버를 설정하는 방법을 보여 줍니다. 특정 데이터 원본에 대해 여러 가지 방법을 사용하여 연결된 서버를 설정할 수 있습니다. 따라서 데이터 원본 유형에 대한 행이 여러 개 있을 수 있습니다. 또한 이 표에서는 연결된 서버를 설정하는 데 사용되는 sp_addlinkedserver 매개 변수 값을 보여 줍니다.

1 연결된 서버를 이 방법으로 설정하면 연결된 서버의 이름이 SQL Server 원격 인스턴스의 네트워크 이름과 동일하게 됩니다. 서버를 지정하려면 data_source를 사용하십시오.

2 "임의의 값"은 제품 이름으로 어떤 것이든 사용할 수 있음을 나타냅니다.

Microsoft SQL Server Native Client OLE DB 공급자는 공급자 이름을 지정하지 않은 경우 또는 제품 이름으로 SQL Server를 지정한 경우 SQL Server에 사용되는 공급자입니다. 이 공급자의 이전 이름인 SQLOLEDB를 지정하더라도 카탈로그에 보관될 때는 SQLNCLI로 변경됩니다.

data_source, location, provider_string, catalog 매개 변수는 연결된 서버가 가리키는 데이터베이스를 나타냅니다. 이러한 매개 변수 중 하나가 NULL이면 해당되는 OLE DB 초기화 속성이 설정되지 않습니다.

클러스터형 환경에서 OLE DB 데이터 원본을 가리키는 파일 이름을 지정할 때는 UNC(Universal Naming Convention) 이름이나 공유 드라이브를 사용하여 위치를 지정하십시오.

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

보안 정보
sp_addlinkedserver를 사용하여 연결된 서버를 만들면 기본 자체 매핑이 모든 로컬 로그인에 대해 추가됩니다. SQL Server 이외 공급자를 사용하는 경우에는 SQL Server 인증 로그인이 SQL Server 서비스 계정으로 공급자에 액세스할 수도 있습니다. 이와 같은 경우 관리자는 sp_droplinkedsrvlogin <linkedserver_name>, NULL을 사용하여 전역 매핑을 제거해야 합니다.

사용 권한

ALTER ANY LINKED SERVER 권한이 필요합니다.

예

1. Microsoft SQL Server Native Client OLE DB 공급자 사용

USE master;
GO
EXEC sp_addlinkedserver 
   N'SEATTLESales',
   N'SQL Server';
GO

EXEC sp_addlinkedserver   
   @server=N'S1_instance1', 
   @srvproduct=N'',
   @provider=N'SQLNCLI', 
   @datasrc=N'S1\instance1';

2. Microsoft OLE DB Provider for Microsoft Access 사용

EXEC sp_addlinkedserver 
   @server = N'SEATTLE Mktg', 
   @provider = N'Microsoft.Jet.OLEDB.4.0', 
   @srvproduct = N'OLE DB Provider for Jet',
   @datasrc = N'C:\MSOffice\Access\Samples\Northwind.mdb';
GO

EXEC sp_addlinkedserver 
   @server = N'SEATTLE Mktg', 
   @provider = N'Microsoft.ACE.OLEDB.12.0', 
   @srvproduct = N'OLE DB Provider for ACE',
   @datasrc = N'C:\MSOffice\Access\Samples\Northwind.accdb';
GO

C. data_source 매개 변수와 함께 Microsoft OLE DB Provider for ODBC 사용

EXEC sp_addlinkedserver 
   @server = N'SEATTLE Payroll', 
   @srvproduct = N'',
   @provider = N'MSDASQL', 
   @datasrc = N'LocalServer';
GO

D. Excel 스프레드시트에서 Microsoft OLE DB 공급자 사용

EXEC sp_addlinkedserver 'ExcelSource',
   'Jet 4.0',
   'Microsoft.Jet.OLEDB.4.0',
   'c:\MyData\DistExcl.xls',
   NULL,
   'Excel 5.0';
GO

SELECT *
   FROM ExcelSource...SalesData;
GO

EXEC sp_addlinkedserver 'ExcelShare',
   'Jet 4.0',
   'Microsoft.Jet.OLEDB.4.0',
   '\\MyServer\MyShare\Spreadsheets\DistExcl.xls',
   NULL,
   'Excel 5.0';

EXEC sp_addlinkedserver @server = N'ExcelDataSource', 
@srvproduct=N'ExcelData', @provider=N'Microsoft.ACE.OLEDB.12.0', 
@datasrc=N'C:\DataFolder\People.xlsx',
@provstr=N'EXCEL 12.0' ;

E. Microsoft OLE DB Provider for Jet을 사용하여 텍스트 파일 액세스

--Create a linked server.
EXEC sp_addlinkedserver txtsrv, N'Jet 4.0', 
   N'Microsoft.Jet.OLEDB.4.0',
   N'c:\data\distqry',
   NULL,
   N'Text';
GO

--Set up login mappings.
EXEC sp_addlinkedsrvlogin txtsrv, FALSE, Admin, NULL;
GO

--List the tables in the linked server.
EXEC sp_tables_ex txtsrv;
GO

--Query one of the tables: file1#txt
--using a four-part name. 
SELECT * 
FROM txtsrv...[file1#txt];

F. Microsoft OLE DB Provider for DB2 사용

EXEC sp_addlinkedserver
   @server=N'DB2',
   @srvproduct=N'Microsoft OLE DB Provider for DB2',
   @catalog=N'DB2',
   @provider=N'DB2OLEDB',
   @provstr=N'Initial Catalog=PUBS;
       Data Source=DB2;
       HostCCSID=1252;
       Network Address=XYZ;
       Network Port=50000;
       Package Collection=admin;
       Default Schema=admin;';

참고 항목

참조

개념