sp_addlinkedserver (Transact-SQL)

Sintassi

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

Argomenti

• [ @server= ] 'server'
  Nome del server collegato da creare. server è di tipo sysname e non prevede alcun valore predefinito.

• [ @srvproduct= ] 'product_name'
  Nome del prodotto dell'origine dati OLE DB che si desidera aggiungere come server collegato. product_name è di tipo nvarchar(128) e il valore predefinito è NULL. Se è SQL Server, non è necessario specificare provider_name, data_source, location, provider_string e catalog.

• [ @provider= ] 'provider_name'
  PROGID (Unique Programmatic Identifier) del provider OLE DB corrispondente a questa origine dati. provider_name deve essere univoco per il provider OLE DB specificato installato nel computer corrente. provider_name è di tipo nvarchar(128) e il valore predefinito è NULL. Tuttavia se provider_name viene omesso, viene utilizzato SQLNCLI. L'utilizzo di SQLNCLI e SQL Server comporta il reindirizzamento alla versione più recente del provider OLE DB per SQL Server Native Client. Il provider OLE DB deve essere registrato nel Registro di sistema con il valore PROGID specificato.

• [ @datasrc= ] 'data_source'
  Nome dell'origine dati interpretato dal provider OLE DB. data_source è di tipo nvarchar(4000). data_source viene passato come proprietà DBPROP_INIT_DATASOURCE per inizializzare il provider OLE DB.

• [ @location= ] 'location'
  Percorso del database interpretato dal provider OLE DB. location è di tipo nvarchar(4000) e il valore predefinito è NULL. location viene passato come proprietà DBPROP_INIT_LOCATION per inizializzare il provider OLE DB.

• [ @provstr= ] 'provider_string'
  Stringa di connessione specifica per il provider OLE DB che identifica un'origine dati univoca. provider_string è di tipo nvarchar(4000) e il valore predefinito è NULL. provstr viene passato a IDataInitialize o impostato come proprietà DBPROP_INIT_PROVIDERSTRING per inizializzare il provider OLE DB.

  Quando il server collegato viene creato mediante il provider OLE DB per SQL Server Native Client, è possibile utilizzare la parola chiave SERVER nel formato SERVER==servername\instancename per specificare un'istanza specifica di SQL Server. servername è il nome del computer che esegue SQL Server e instancename è il nome dell'istanza specifica di SQL Server a cui verrà connesso l'utente.

  Nota

  Per accedere a un database con mirroring, è necessario che la stringa di connessione contenga il nome del database, al fine di consentire i tentativi di failover da parte del provider di accesso ai dati. È possibile specificare il database nel parametro @provstr o @catalog. Facoltativamente, la stringa di connessione può specificare anche il nome di un partner di failover. Per ulteriori informazioni, vedere Creazione della connessione iniziale a una sessione di mirroring del database.

• [ @catalog= ] 'catalog'
  Catalogo che si desidera utilizzare per una connessione al provider OLE DB. catalog è di tipo sysname e il valore predefinito è NULL. catalog viene passato come proprietà DBPROP_INIT_CATALOG per inizializzare il provider OLE DB. Quando il server collegato viene definito in un'istanza di SQL Server, il catalogo si riferisce al database predefinito a cui è mappato il server collegato.

Valori di codice restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nessuno

Osservazioni

Nella tabella seguente vengono descritte le possibili configurazioni di un server collegato per origini dati accessibili tramite OLE DB. Un server collegato può essere configurato in modi diversi per un'origine dati specifica. Per un tipo di origine dati possono essere disponibili più righe. Nella tabella vengono descritti inoltre i valori di parametro della stored procedure sp_addlinkedserver da utilizzare per la configurazione del server collegato.

1 Questo metodo di configurazione di un server collegato impone che il nome del server corrisponda al nome di rete dell'istanza remota di SQL Server. Utilizzare data_source per specificare il server.

2 "Qualsiasi prodotto" indica che è possibile specificare qualsiasi nome.

Il provider OLE DB per Microsoft SQL Server Native Client (SQLNCLI) viene utilizzato con SQL Server se non viene specificato alcun nome di provider o se come nome di prodotto viene specificato SQL Server. Anche se si specifica il nome del provider meno recente, SQLOLEDB, verrà modificato in SQLNCLI se persiste nel catalogo.

I parametri data_source, location, provider_string e catalog identificano il database o i database a cui punta il server collegato. Se uno di questi parametri è NULL, la proprietà di inizializzazione OLE DB corrispondente non viene impostata.

In un ambiente cluster, quando si specificano nomi di file che puntano a origini dati OLE DB, la posizione deve essere specificata nel formato UNC oppure deve corrispondere a un'unità condivisa.

La stored procedure sp_addlinkedserver non può essere eseguita all'interno di una transazione definita dall'utente.

Nota sulla sicurezza

Quando si crea un server collegato tramite sp_addlinkedserver, viene aggiunto un mapping automatico predefinito per tutti gli account di accesso locali. Per i provider non SQL Server, gli account di accesso autenticati di SQL Server potrebbero essere in grado di accedere al provider con l'account del servizio SQL Server. Si consiglia agli amministratori di considerare l'utilizzo di sp_droplinkedsrvlogin <linkedserver_name>, NULL per rimuovere il mapping globale.

Autorizzazioni

È richiesta l'autorizzazione ALTER ANY LINKED SERVER.

Esempi

A. Utilizzo del provider OLE DB per Microsoft SQL Server Native Client

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';

B. Utilizzo del provider Microsoft OLE DB per 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. Utilizzo del provider Microsoft OLE DB per ODBC con il parametro data_source

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

D. Utilizzo del provider Microsoft OLE DB per un foglio di calcolo di Excel

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. Utilizzo del provider Microsoft OLE DB per Jet per accedere a un file di testo

--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. Utilizzo del provider Microsoft OLE DB per 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;';

Vedere anche

Riferimento

Concetti