sp_adddistpublisher (Transact-SQL)

Si applica a: SQL Server Istanza 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.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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.

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

Modalità di sicurezza implementata. Questo parametro viene usato solo dagli agenti di replica per connettersi al server di pubblicazione per le sottoscrizioni ad aggiornamento in coda o con un server di pubblicazione non SQL Server. @security_mode è int e può essere uno di questi valori.

[ @login = ] N'login'

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

[ @password = ] N'password'

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

[ @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 per impostazione predefinita viene 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 è deprecato e viene fornito solo per la compatibilità con le versioni precedenti. @trusted è nvarchar(5), con il valore predefinito 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 .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 valori seguenti.

[ @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 valori seguenti.

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 il valore predefinito NULL. Usare la chiave di accesso dal portale di Azure, in Impostazioni di archiviazione>.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_adddistpublisher viene usato dalla replica snapshot, dalla replica transazionale e dalla replica di tipo merge.

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.

Contenuto correlato

• Configurare la pubblicazione e la distribuzione
• sp_changedistpublisher (Transact-SQL)
• sp_dropdistpublisher (Transact-SQL)
• sp_helpdistpublisher (Transact-SQL)
• Stored procedure di sistema (Transact-SQL)
• Configurare la distribuzione