sp_addlinkedserver (Transact-SQL)

Dotyczy:SQL ServerAzure SQL Managed Instance

Tworzy połączony serwer. Połączony serwer zapewnia dostęp do rozproszonych, heterogenicznych zapytań względem źródeł danych OLE DB. Po utworzeniu serwera połączonego przy użyciu polecenia sp_addlinkedservermożna uruchamiać zapytania rozproszone na tym serwerze. Jeśli połączony serwer jest zdefiniowany jako wystąpienie programu SQL Server, można wykonać zdalne procedury składowane.

Transact-SQL konwencje składni

Składnia

sp_addlinkedserver
    [ @server = ] N'server'
    [ , [ @srvproduct = ] N'srvproduct' ]
    [ , [ @provider = ] N'provider' ]
    [ , [ @datasrc = ] N'datasrc' ]
    [ , [ @location = ] N'location' ]
    [ , [ @provstr = ] N'provstr' ]
    [ , [ @catalog = ] N'catalog' ]
    [ , [ @linkedstyle = ] linkedstyle ]
[ ; ]

Argumenty (w programowaniu)

[ @server = ] N'server'

Nazwa serwera połączonego do utworzenia. @server jest nazwą systemu bez wartości domyślnej.

[ @srvproduct = ] N'srvproduct'

Nazwa produktu źródła danych OLE DB, które ma zostać dodane jako serwer połączony. @srvproduct to nvarchar(128), z wartością domyślną NULL. Jeśli wartość to SQL Server, @provider, @datasrc, @location, @provstr i @catalog nie muszą być określone.

[ @provider = ] N'provider'

Unikatowy identyfikator programowy dostawcy OLE DB odpowiadający temu źródle danych. @provider musi być unikatowy dla określonego dostawcy OLE DB zainstalowanego na bieżącym komputerze. @provider to nvarchar(128), z wartością domyślną NULL.

• W programie SQL Server 2019 (15.x) i starszych wersjach, jeśli @provider zostanie pominięta, SQLNCLI jest używana. Użycie SQLNCLI spowoduje przekierowanie programu SQL Server do najnowszej wersji dostawcy OLE DB klienta natywnego programu SQL Server. Oczekuje się, że dostawca OLE DB zostanie zarejestrowany przy użyciu określonego identyfikatora PROGID w rejestrze. SQLNCLIZamiast , MSOLEDBSQL zaleca się.

• Począwszy od programu SQL Server 2022 (16.x), należy określić nazwę dostawcy. MSOLEDBSQL jest zalecany. Jeśli pominięto @provider, możesz wystąpić nieoczekiwane zachowanie.

[ @datasrc = ] N'datasrc'

Nazwa źródła danych interpretowana przez dostawcę OLE DB. @datasrc to nvarchar(4000), z wartością domyślną NULL. @datasrc jest przekazywana DBPROP_INIT_DATASOURCE jako właściwość inicjowania dostawcy OLE DB.

[ @location = ] N'location'

Lokalizacja bazy danych interpretowana przez dostawcę OLE DB. @location to nvarchar(4000), z wartością domyślną NULL. @location jest przekazywana DBPROP_INIT_LOCATION jako właściwość w celu zainicjowania dostawcy OLE DB.

[ @provstr = ] N'provstr'

Parametry połączenia specyficzne dla dostawcy OLE DB identyfikujące unikatowe źródło danych. @provstr to nvarchar(4000), z wartością domyślną NULL. Argument provstr jest przekazywany do interfejsu IDataInitialize lub ustawiany jako DBPROP_INIT_PROVIDERSTRING właściwość w celu zainicjowania dostawcy OLE DB.

Po utworzeniu serwera połączonego względem dostawcy OLE DB klienta natywnego programu SQL Server wystąpienie można określić za pomocą SERVER słowa kluczowego SERVER=servername\instancename w celu określenia określonego wystąpienia programu SQL Server. Nazwa serwera to nazwa komputera, na którym jest uruchomiony program SQL Server, a nazwa wystąpienia to nazwa określonego wystąpienia programu SQL Server, z którym użytkownik będzie połączony.

• Aby uzyskać dostęp do dublowanej bazy danych, parametry połączenia muszą zawierać nazwę bazy danych. Ta nazwa jest niezbędna do włączenia prób przejścia w tryb failover przez dostawcę dostępu do danych. Bazę danych można określić w parametrze @provstr lub @catalog . Opcjonalnie parametry połączenia mogą również podać nazwę partnera trybu failover.

• Jeśli uruchomisz sp_addlinkedserver polecenie z lokalnego logowania lub identyfikator logowania, który nie jest częścią roli sysadmin , może zostać wyświetlony następujący błąd:

  Access to the remote server is denied because no login-mapping exists.
  

  Aby rozwiązać ten problem, dodaj parametr do parametrów User ID połączenia. W poniższym przykładzie myUser jest identyfikator użytkownika przekazany do parametrów połączenia:

  EXECUTE master.dbo.sp_addlinkedserver
      @server = N'LinkServerName',
      @provider = N'SQLNCLI',
      @srvproduct = 'MS SQL Server',
      @provstr = N'SERVER=serverName\InstanceName;User ID=myUser';
  
  EXECUTE master.dbo.sp_addlinkedsrvlogin
      @rmtsrvname = N'LinkServerName',
      @locallogin = NULL,
      @useself = N'False',
      @rmtuser = N'myUser',
      @rmtpassword = N'*****';
  

  Aby uzyskać więcej informacji, zobacz Odmowa dostępu do serwera zdalnego, ponieważ nie istnieje mapowanie logowania.

[ @catalog = ] N'catalog'

Wykaz, który ma być używany podczas nawiązywania połączenia z dostawcą OLE DB. @catalog to nazwa systemu z wartością domyślną NULL. @catalog jest przekazywana DBPROP_INIT_CATALOG jako właściwość w celu zainicjowania dostawcy OLE DB. Gdy serwer połączony jest zdefiniowany względem wystąpienia programu SQL Server, wykaz odwołuje się do domyślnej bazy danych, do której jest mapowany połączony serwer.

[ @linkedstyle = ] linkedstyle

Zidentyfikowane tylko do celów informacyjnych. Niewspierane. Zgodność w przyszłości nie jest gwarantowana.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Zestaw wyników

Żaden.

Uwagi

W poniższej tabeli przedstawiono sposoby konfigurowania serwera połączonego dla źródeł danych, do których można uzyskać dostęp za pośrednictwem ole DB. Serwer połączony można skonfigurować w więcej niż jeden sposób dla określonego źródła danych; może istnieć więcej niż jeden wiersz dla typu źródła danych. W tej tabeli przedstawiono również wartości parametrów sp_addlinkedserver , które mają być używane do konfigurowania serwera połączonego.

¹ W ten sposób skonfigurowania połączonego serwera wymusza, aby nazwa serwera połączonego był taka sama jak nazwa sieci zdalnego wystąpienia programu SQL Server. Użyj @datasrc , aby określić serwer.

² "Dowolne" oznacza, że nazwa produktu może być dowolna.

Dostawca OLE DB klienta natywnego programu SQL Server jest dostawcą używanym z programem SQL Server, jeśli nie określono nazwy dostawcy lub jeśli program SQL Server jest określony jako nazwa produktu. Nawet jeśli określisz starszą nazwę dostawcy, SQLOLEDB, zmieni się ona na SQLNCLI, gdy zostanie utrwalone w wykazie.

Parametry @datasrc, @location, @provstr i @catalog identyfikują bazę danych lub bazy danych, z których wskazuje połączony serwer. Jeśli którykolwiek z tych parametrów to NULL, odpowiednia właściwość inicjowania OLE DB nie jest ustawiona.

W środowisku klastrowanym podczas określania nazw plików do wskazywania źródeł danych OLE DB użyj uniwersalnej nazwy konwencji nazewnictwa (UNC) lub dysku udostępnionego, aby określić lokalizację.

Nie można wykonać procedury sp_addlinkedserver składowanej w ramach transakcji zdefiniowanej przez użytkownika.

Uprawnienia

Instrukcja sp_addlinkedserver wymaga ALTER ANY LINKED SERVER uprawnienia. (Okno dialogowe Nowy połączony serwer programu SQL Server Management Studio jest implementowane w sposób, który wymaga członkostwa w stałej roli serwera sysadmin ).

Przykłady

Odp. Korzystanie z dostawcy OLE DB programu Microsoft SQL Server

Poniższy przykład tworzy połączony serwer o nazwie SEATTLESales. Nazwa produktu to SQL Server, a nie jest używana żadna nazwa dostawcy.

USE master;
GO

EXECUTE sp_addlinkedserver N'SEATTLESales', N'SQL Server';
GO

Poniższy przykład tworzy serwer połączony S1_instance1 w wystąpieniu programu SQL Server przy użyciu sterownika OLE DB programu SQL Server.

EXECUTE sp_addlinkedserver
    @server = N'S1_instance1',
    @srvproduct = N'',
    @provider = N'MSOLEDBSQL',
    @datasrc = N'S1\instance1';

Poniższy przykład tworzy serwer połączony S1_instance1 w wystąpieniu programu SQL Server przy użyciu dostawcy OLE DB klienta natywnego programu SQL Server.

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

B. Używanie dostawcy Microsoft OLE DB dla programu Microsoft Access

Dostawca Microsoft.Jet.OLEDB.4.0 łączy się z bazami danych programu Microsoft Access, które używają formatu 2002-2003. Poniższy przykład tworzy połączony serwer o nazwie SEATTLE Mktg.

EXECUTE 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

C. Używanie dostawcy Microsoft OLE DB dla ODBC z parametrem datasrc

Poniższy przykład tworzy połączony serwer o nazwie SEATTLE Payroll , który używa dostawcy Microsoft OLE DB dla ODBC (MSDASQL) i parametru @datasrc .

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

D. Korzystanie z arkusza kalkulacyjnego microsoft OLE DB dla programu Excel

Aby utworzyć połączoną definicję serwera przy użyciu dostawcy Microsoft OLE DB dla jet w celu uzyskania dostępu do arkusza kalkulacyjnego programu Excel w formacie 1997–2003, najpierw utwórz nazwany zakres w programie Excel, określając kolumny i wiersze arkusza programu Excel do wybrania. Następnie nazwę zakresu można przywoływać jako nazwę tabeli w zapytaniu rozproszonym.

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

Aby uzyskać dostęp do danych z arkusza kalkulacyjnego programu Excel, skojarz zakres komórek z nazwą. Poniższe zapytanie może służyć do uzyskiwania dostępu do określonego nazwanego zakresu SalesData jako tabeli przy użyciu skonfigurowanego wcześniej serwera połączonego.

SELECT *
FROM ExcelSource...SalesData;
GO

Jeśli program SQL Server jest uruchomiony na koncie domeny, które ma dostęp do udziału zdalnego, można użyć ścieżki UNC zamiast zamapowanego dysku.

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

E. Uzyskiwanie dostępu do pliku tekstowego przy użyciu dostawcy Microsoft OLE DB dla jet

Poniższy przykład tworzy serwer połączony na potrzeby bezpośredniego uzyskiwania dostępu do plików tekstowych bez łączenia plików jako tabel w pliku .mdb programu Access. Dostawca to Microsoft.Jet.OLEDB.4.0 , a ciąg dostawcy to Text.

Źródło danych jest pełną ścieżką katalogu zawierającego pliki tekstowe. Plik schema.ini opisujący strukturę plików tekstowych musi istnieć w tym samym katalogu co pliki tekstowe. Aby uzyskać więcej informacji na temat tworzenia pliku schema.ini, zobacz dokumentację aparatu bazy danych Jet.

Najpierw utwórz połączony serwer.

EXECUTE sp_addlinkedserver txtsrv, N'Jet 4.0',
   N'Microsoft.Jet.OLEDB.4.0',
   N'c:\data\distqry',
   NULL,
   N'Text';

Konfigurowanie mapowań logowania.

EXECUTE sp_addlinkedsrvlogin txtsrv, FALSE, Admin, NULL;

Wyświetl listę tabel na serwerze połączonym.

EXECUTE sp_tables_ex txtsrv;

Wykonaj zapytanie o jedną z tabel, w tym przypadku file1#txt, używając czteroczęściowej nazwy.

SELECT * FROM txtsrv...[file1#txt];

F. Używanie dostawcy Microsoft OLE DB dla bazy danych DB2

W poniższym przykładzie tworzony jest połączony serwer o nazwie DB2 , który używa dostawcy Microsoft OLE DB dla bazy danych DB2.

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

G. Dodawanie bazy danych Azure SQL Database jako serwera połączonego do użycia z rozproszonymi zapytaniami w bazach danych w chmurze i lokalnych bazach danych

Bazę danych Azure SQL Database można dodać jako serwer połączony, a następnie użyć jej z zapytaniami rozproszonymi obejmującymi lokalne i w chmurze bazy danych. Jest to składnik rozwiązań hybrydowych baz danych obejmujących lokalne sieci firmowe i chmurę platformy Azure.

Produkt box programu SQL Server zawiera funkcję zapytań rozproszonych, która umożliwia pisanie zapytań w celu łączenia danych z lokalnych źródeł danych i danych ze źródeł zdalnych (w tym danych ze źródeł danych innych niż SQL Server) zdefiniowanych jako serwery połączone. Każda baza danych Azure SQL Database (z wyjątkiem bazy danych serwera master logicznego) może zostać dodana jako pojedynczy serwer połączony, a następnie używana bezpośrednio w aplikacjach bazy danych jako dowolna inna baza danych.

Zalety korzystania z usługi Azure SQL Database obejmują możliwość zarządzania, wysoką dostępność, skalowalność, pracę z znanym modelem programowania i modelem danych relacyjnych. Wymagania aplikacji bazy danych określają sposób używania usługi Azure SQL Database w chmurze. Wszystkie dane można przenosić jednocześnie do usługi Azure SQL Database lub stopniowo przenosić niektóre dane przy zachowaniu pozostałych danych w środowisku lokalnym. W przypadku takiej hybrydowej aplikacji bazy danych można teraz dodać usługę Azure SQL Database jako serwery połączone, a aplikacja bazy danych może wysyłać zapytania rozproszone w celu łączenia danych z usługi Azure SQL Database i lokalnych źródeł danych.

Oto przykład wyjaśniający sposób nawiązywania połączenia z bazą danych Azure SQL Database przy użyciu zapytań rozproszonych.

Najpierw dodaj jedną bazę danych Azure SQL Database jako serwer połączony przy użyciu programu SQL Server Native Client.

EXECUTE sp_addlinkedserver
    @server = 'LinkedServerName',
    @srvproduct = '',
    @provider = 'sqlncli',
    @datasrc = 'ServerName.database.windows.net',
    @location = '',
    @provstr = '',
    @catalog = 'DatabaseName';

Dodaj poświadczenia i opcje do tego połączonego serwera. Zastąp <password> prawidłowym hasłem.

EXECUTE sp_addlinkedsrvlogin
    @rmtsrvname = 'LinkedServerName',
    @useself = 'false',
    @rmtuser = 'LoginName',
    @rmtpassword = '<password>';

EXECUTE sp_serveroption 'LinkedServerName', 'rpc out', true;

Teraz użyj serwera połączonego do wykonywania zapytań przy użyciu czterech części nazw, nawet w celu utworzenia nowej tabeli i wstawienia danych.

EXECUTE ('CREATE TABLE SchemaName.TableName(col1 int not null CONSTRAINT PK_col1 PRIMARY KEY CLUSTERED (col1) )') AT LinkedServerName;

EXECUTE ('INSERT INTO SchemaName.TableName VALUES(1),(2),(3)') AT LinkedServerName;

Wykonywanie zapytań dotyczących danych przy użyciu czterech części nazw:

SELECT * FROM LinkedServerName.DatabaseName.SchemaName.TableName;

H. Tworzenie połączonego serwera usługi Azure SQL Managed Instance z uwierzytelnianiem tożsamości zarządzanej

Aby utworzyć serwer połączony z uwierzytelnianiem tożsamości zarządzanej, wykonaj następujące polecenie T-SQL, zastępując <managed_instance> element własnym wystąpieniem zarządzanym SQL. Metoda uwierzytelniania używa ActiveDirectoryMSI parametru @provstr . Rozważ opcjonalnie użycie polecenia @locallogin = NULL , aby zezwolić na wszystkie lokalne logowania.

EXECUTE master.dbo.sp_addlinkedserver
    @server = N'MyLinkedServer',
    @srvproduct = N'',
    @provider = N'MSOLEDBSQL',
    @provstr = N'Server=<mi_name>.<dns_zone>.database.windows.net,1433;Authentication=ActiveDirectoryMSI;';

EXECUTE master.dbo.sp_addlinkedsrvlogin
    @rmtsrvname = N'MyLinkedServer',
    @useself = N'False',
    @locallogin = N'user1@contoso.com';

Aby włączyć uwierzytelnianie przy użyciu tożsamości zarządzanych, tożsamość zarządzana przypisana do usługi Azure SQL Managed Instance musi zostać dodana jako identyfikator logowania do zdalnego wystąpienia zarządzanego. Obsługiwane są tożsamości zarządzane przypisane przez system i przypisane przez użytkownika.

Jeśli ustawiono tożsamość podstawową, jest używana, w przeciwnym razie jest używana tożsamość zarządzana przypisana przez system. Jeśli tożsamość zarządzana jest ponownie utworzona z taką samą nazwą, należy również ponownie utworzyć identyfikator logowania w wystąpieniu zdalnym, ponieważ nowy identyfikator aplikacji tożsamości zarządzanej i identyfikator SID jednostki usługi wystąpienia zarządzanego SQL nie są już zgodne. Aby sprawdzić, czy te dwie wartości są zgodne, przekonwertuj identyfikator SID na identyfikator aplikacji przy użyciu następującego zapytania.

SELECT CONVERT (UNIQUEIDENTIFIER, sid) AS MSEntraApplicationID
FROM sys.server_principals
WHERE name = '<managed_instance_name>';

Ja. Tworzenie połączonego serwera usługi SQL Managed Instance z przekazywaniem uwierzytelniania firmy Microsoft Entra

Aby utworzyć serwer połączony z uwierzytelnianiem przekazywanym, wykonaj następujące polecenie T-SQL, zastępując <managed_instance> element własnym serwerem wystąpienia zarządzanego SQL:

EXECUTE master.dbo.sp_addlinkedserver
    @server = N'MyLinkedServer',
    @srvproduct = N'',
    @provider = N'MSOLEDBSQL',
    @datasrc = N'<mi_name>.<dns_zone>.database.windows.net,1433';

W przypadku uwierzytelniania przekazywanego kontekst zabezpieczeń lokalnego logowania jest przenoszony do wystąpienia zdalnego. Uwierzytelnianie przekazywane wymaga dodania podmiotu zabezpieczeń firmy Microsoft jako identyfikatora logowania zarówno w lokalnym, jak i zdalnym wystąpieniu zarządzanym Azure SQL. Oba wystąpienia zarządzane muszą znajdować się w grupie zaufania serwera. Po spełnieniu wymagań użytkownik może zalogować się do wystąpienia lokalnego i wysłać zapytanie do wystąpienia zdalnego za pośrednictwem połączonego obiektu serwera.

J. Korzystanie z dostawcy OLE DB programu Microsoft SQL Server w wersji 19

W poniższym przykładzie tworzony jest połączony serwer o nazwie , przeznaczony dla programu SQL Server o nazwie SQLSaleso nazwie LABSQL2025SQL2025CTP2wystąpienia przy użyciu technologii OLE DB w wersji 19, szyfrowanie jest wyłączone.

EXECUTE sp_addlinkedserver
    @server = N'SQLSales',
    @srvproduct = N'',
    @provider = N'MSOLEDBSQL19',
    @datasrc = N'LABSQL2025\SQL2025CTP2',
    @provstr = N'Encrypt=No;';

Aby uzyskać więcej informacji, zobacz Sterownik OLE DB firmy Microsoft dla programu SQL Server (MSOLEDBSQL) (zalecane).

Treści powiązane

• Procedury składowane zapytań rozproszonych (Transact-SQL)
• sp_addlinkedsrvlogin (Transact-SQL)
• sp_addserver (Transact-SQL)
• sp_dropserver (Transact-SQL)
• sp_serveroption (Transact-SQL)
• sp_setnetname (Transact-SQL)
• System procedur składowanych (Transact-SQL)
• tabele systemu (Transact-SQL)