sys.sp_adddistpublisher (Transact-SQL)

Si applica a:SQL ServerIstanza gestita di SQL di Azure

Configura un server di pubblicazione per l'utilizzo del database di distribuzione specificato. Questa stored procedure viene eseguita in qualsiasi database del server di distribuzione. Le stored procedure sp_adddistributor e sp_adddistributiondb devono essere state eseguite prima di utilizzare questa stored procedure.

Transact-SQL Convenzioni sintattiche

Sintassi

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

Argomenti

[ @publisher = ] N'publisher'

Nome del server di pubblicazione. @publisher è sysname, senza impostazione predefinita.

Nota

Il nome del server può essere specificato come <Hostname>,<PortNumber> per un'istanza predefinita o <Hostname>\<InstanceName>,<PortNumber> per un'istanza denominata. Specificare il numero di porta per la connessione quando SQL Server viene distribuito in Linux o Windows con una porta personalizzata e il servizio browser è disabilitato. L'uso di numeri di porta personalizzati per il server di distribuzione remoto si applica a SQL Server 2019 (15.x) e versioni successive.

[ @distribution_db = ] N'distribution_db'

Nome del database di distribuzione. @distribution_db è sysname, senza impostazione predefinita. Questo parametro viene utilizzato dagli agenti di replica per la connessione al server di pubblicazione.

[ @security_mode = ] security_mode

Determina la modalità di autenticazione che gli agenti di replica utilizzano per connettersi al Publisher per abbonamenti di aggiornamento in coda, con replica non SQL Server Publisher o transazionale tra Istanza gestita di SQL di Azure risorse. @security_mode è int, e può essere uno di questi valori.

valore Descrizione
0 Gli agenti di replica nel server di distribuzione usano l'autenticazione di SQL Server per connettersi al server di pubblicazione.
1 (predefinito) Gli agenti di replica nel server di distribuzione si connettono al server di pubblicazione tramite l'autenticazione di Windows.
5 Gli agenti di replicazione presso il Distributore utilizzano l'autenticazione Microsoft Entra con l'identità gestita predefinita del Distributore. Applicabile solo quando sia Distributor che Publisher sono risorse Istanza gestita di SQL di Azure.

[ @login = ] N'login'

Account di accesso. Questo parametro è richiesto se @security_mode è 0. @login è sysname, con un valore predefinito di NULL. Questo parametro viene utilizzato dagli agenti di replica per la connessione al server di pubblicazione.

[ @password = ] N'password'

Password. @password è sysname, con valore predefinito .NULL Questo parametro viene utilizzato dagli agenti di replica per la connessione al server di pubblicazione.

Importante

Non usare una password vuota. Usare una password complessa.

[ @working_directory = ] N'working_directory'

Nome della directory di lavoro utilizzata per archiviare i file dei dati e di schema per la pubblicazione @working_directory è nvarchar(255) e predefinisce la ReplData cartella per questa istanza di SQL Server. Ad esempio: C:\Program Files\Microsoft SQL Server\MSSQL\MSSQL.1\ReplData. Il nome deve essere specificato in formato UNC.

Per database SQL di Azure, usare \\<storage_account>.file.core.windows.net\<share>.

[ @trusted = ] N'trusted'

@trusted è obsoleto ed è fornito esclusivamente per compatibilità retroattiva. @trusted è nvarchar(5), con un valore predefinito di false. L'impostazione di questo parametro su qualsiasi elemento, ma false genera un errore.

[ @encrypted_password = ] encrypted_password

L'impostazione di questo parametro non è più supportata. @encrypted_password è bit, con un valore predefinito di 0. L'impostazione di questo parametro su 1 genera un errore.

[ @thirdparty_flag = ] thirdparty_flag

Specifica quando il server di pubblicazione è SQL Server. @thirdparty_flag è bit e può essere uno dei seguenti valori.

valore Descrizione
0 (predefinito) Database di SQL Server.
1 Database diverso da SQL Server.

[ @publisher_type = ] N'publisher_type'

Specifica il tipo di server di pubblicazione quando il server di pubblicazione non è SQL Server. @publisher_type è sysname e può essere uno dei seguenti valori.

valore Descrizione
MSSQLSERVER (predefinito) Specifica un server di pubblicazione di SQL Server.
ORACLE Specifica un server di pubblicazione Oracle standard.
ORACLE GATEWAY Specifica un server di pubblicazione Oracle Gateway.

Per altre informazioni sulle differenze tra un server di pubblicazione Oracle e un server di pubblicazione Oracle Gateway, vedere Configurare un server di pubblicazione Oracle.

[ @storage_connection_string = ] N'storage_connection_string'

Obbligatorio per database SQL di Azure. @storage_connection_string è nvarchar(255), con un valore predefinito di NULL. Usare la chiave di accesso dal portale di Azure, in > di archiviazione.

Nota

I database del server di pubblicazione e del server di distribuzione in database SQL di Azure richiedono Istanza gestita di SQL. Per altre informazioni, vedere Replica nel database SQL di Azure.

Valori del codice restituito

0 (successo) oppure 1 (fallimento).

Osservazioni:

sp_adddistpublisher è utilizzato dalla replicazione snapshot, replica transazioniale e replica di unione.

Esempi

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

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire sp_adddistpublisher.