sys.sp_adddistpublisher (Transact-SQL)

Dotyczy do:SQL ServerAzure SQL Managed Instance

Konfiguruje program Publisher do używania określonej bazy danych dystrybucji. Ta procedura składowana jest wykonywana w dystrybutorze w dowolnej bazie danych. Procedury składowane sp_adddistributor i sp_adddistributiondb muszą zostać uruchomione przed użyciem tej procedury składowanej.

Transact-SQL konwencje składniowe

Składnia

sys.sp_adddistpublisher
    [ @publisher = ] N'publisher'
    , [ @distribution_db = ] N'distribution_db'
    [ , [ @security_mode = ] security_mode ]
    [ , [ @login = ] N'login' ]
    [ , [ @password = ] N'password' ]
    [ , [ @working_directory = ] N'working_directory' ]
    [ , [ @trusted = ] N'trusted' ]
    [ , [ @encrypted_password = ] encrypted_password ]
    [ , [ @thirdparty_flag = ] thirdparty_flag ]
    [ , [ @publisher_type = ] N'publisher_type' ]
    [ , [ @storage_connection_string = ] N'storage_connection_string' ]
[ ; ]

Arguments

[ @publisher = ] N'publisher'

Nazwa wydawcy. @publisher to sysname, bez domyślnego ustawienia.

Uwaga / Notatka

Nazwę serwera można określić jako <Hostname>,<PortNumber> wystąpienie domyślne lub <Hostname>\<InstanceName>,<PortNumber> nazwane wystąpienie. Określ numer portu połączenia, gdy program SQL Server jest wdrożony w systemie Linux lub Windows z niestandardowym portem, a usługa przeglądarki jest wyłączona. Użycie niestandardowych numerów portów dla dystrybutora zdalnego dotyczy programu SQL Server 2019 (15.x) i nowszych wersji.

[ @distribution_db = ] N'distribution_db'

Nazwa bazy danych dystrybucji. @distribution_db to sysname, bez domyślnego ustawienia. Ten parametr jest używany przez agentów replikacji do nawiązywania połączenia z programem Publisher.

[ @security_mode = ] security_mode

Określa tryb uwierzytelniania, którego używają agenci replikacji do łączenia się z Publisher dla subskrypcji aktualizacji w kolejce, z replikacją nie-SQL Server Publisher lub transakcyjną między Azure SQL Managed Instance zasobami. @security_mode jest int i może być jedną z tych wartości.

Wartość Description
0 Agenci replikacji w dystrybutorze używają uwierzytelniania programu SQL Server w celu nawiązania połączenia z programem Publisher.
1 (domyślnie) Agenci replikacji w dystrybutorze używają uwierzytelniania systemu Windows do nawiązywania połączenia z wydawcą.
5 Agenci replikacji u dystrybutora używają uwierzytelniania Microsoft Entra z domyślną zarządzaną tożsamością dystrybutora. Dotyczy tylko sytuacji, gdy zarówno Distributor, jak i Publisher są zasobami Azure SQL Managed Instance.

[ @login = ] N'login'

Identyfikator logowania. Ten parametr jest wymagany, jeśli @security_mode jest .0 @login to sysname, z domyślnym parametrem NULL. Ten parametr jest używany przez agentów replikacji do nawiązywania połączenia z programem Publisher.

[ @password = ] N'password'

Hasło. @password to sysname, z domyślną wartością NULL. Ten parametr jest używany przez agentów replikacji do nawiązywania połączenia z programem Publisher.

Ważne

Nie używaj pustego hasła. Użyj silnego hasła.

[ @working_directory = ] N'working_directory'

Nazwa katalogu roboczego używanego do przechowywania plików danych i schematów publikacji. @working_directory to nvarchar(255) i domyślnie jest ustawiony na ReplData folder dla tej instancji SQL Server. Na przykład C:\Program Files\Microsoft SQL Server\MSSQL\MSSQL.1\ReplData. Nazwa powinna być określona w formacie UNC.

W przypadku usługi Azure SQL Database użyj polecenia \\<storage_account>.file.core.windows.net\<share>.

[ @trusted = ] N'trusted'

@trusted jest przestarzała i przeznaczona wyłącznie na kompatybilność wsteczną. @trusted to nvarchar(5), z domyślnym .false Ustawienie tego parametru na dowolne elementy, ale false powoduje wystąpienie błędu.

[ @encrypted_password = ] encrypted_password

Ustawienie tego parametru nie jest już obsługiwane. @encrypted_password jest bit, z domyślnym parametrem 0. Ustawienie tego parametru w taki sposób, aby 1 powoduje wystąpienie błędu.

[ @thirdparty_flag = ] thirdparty_flag

Określa, kiedy wydawca jest programem SQL Server. @thirdparty_flag jest bitem i może być jedną z następujących wartości.

Wartość Description
0 (domyślnie) Baza danych programu SQL Server.
1 Baza danych inna niż SQL Server.

[ @publisher_type = ] N'publisher_type'

Określa typ wydawcy, gdy program Publisher nie jest programem SQL Server. @publisher_type to sysname i może być jedną z następujących wartości.

Wartość Description
MSSQLSERVER (domyślnie) Określa program SQL Server Publisher.
ORACLE Określa standardowy program Oracle Publisher.
ORACLE GATEWAY Określa wydawcę bramy Oracle Gateway.

Aby uzyskać więcej informacji na temat różnic między programem Oracle Publisher i programem Oracle Gateway Publisher, zobacz Konfigurowanie programu Oracle Publisher.

[ @storage_connection_string = ] N'storage_connection_string'

Wymagane dla usługi Azure SQL Database. @storage_connection_string to nvarchar(255), z domyślnym wartością NULL. Użyj klucza dostępu z witryny Azure Portal w obszarze Ustawienia magazynu>.

Uwaga / Notatka

Bazy danych wydawcy i dystrybutora w usłudze Azure SQL Database wymagają wystąpienia zarządzanego SQL. Aby uzyskać więcej informacji, zobacz Replikacja do usługi Azure SQL Database.

Zwracanie wartości kodu

0 (sukces) lub 1 (porażka).

Uwagi

sp_adddistpublisher jest wykorzystywany przez replikację migawkową, replikację transakcyjną oraz replikację scalania.

Przykłady

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- Install the Distributor and the distribution database.
DECLARE @distributor AS sysname;
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
DECLARE @directory AS nvarchar(500);
DECLARE @publicationDB AS sysname;
-- Specify the Distributor name.
SET @distributor = $(DistPubServer);
-- Specify the distribution database.
SET @distributionDB = N'distribution';
-- Specify the Publisher name.
SET @publisher = $(DistPubServer);
-- Specify the replication working directory.
SET @directory = N'\\' + $(DistPubServer) + '\repldata';
-- Specify the publication database.
SET @publicationDB = N'AdventureWorks2022'; 

-- Install the server MYDISTPUB as a Distributor using the defaults,
-- including autogenerating the distributor password.
USE master
EXEC sp_adddistributor @distributor = @distributor;

-- Create a new distribution database using the defaults, including
-- using Windows Authentication.
USE master
EXEC sp_adddistributiondb @database = @distributionDB, 
    @security_mode = 1;
GO

-- Create a Publisher and enable AdventureWorks2022 for replication.
-- Add MYDISTPUB as a publisher with MYDISTPUB as a local distributor
-- and use Windows Authentication.
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
-- Specify the distribution database.
SET @distributionDB = N'distribution';
-- Specify the Publisher name.
SET @publisher = $(DistPubServer);

USE [distribution]
EXEC sp_adddistpublisher @publisher=@publisher, 
    @distribution_db=@distributionDB, 
    @security_mode = 1;
GO

Permissions

Tylko członkowie stałej roli serwera sysadmin mogą wykonywać polecenie sp_adddistpublisher.