sp_helpdistributor (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL Managed Instance

Muestra información sobre el distribuidor, la base de datos de distribución, el directorio de trabajo y Agente SQL Server cuenta de usuario. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicaciones o en cualquier base de datos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_helpdistributor [ [ @distributor = ] 'distributor' OUTPUT ]
    [ , [ @distribdb = ] 'distribdb' OUTPUT ]
    [ , [ @directory = ] 'directory' OUTPUT ]
    [ , [ @account = ] 'account' OUTPUT ]
    [ , [ @min_distretention = ] min_distretention OUTPUT ]
    [ , [ @max_distretention = ] max_distretention OUTPUT ]
    [ , [ @history_retention = ] history_retention OUTPUT ]
    [ , [ @history_cleanupagent = ] 'history_cleanupagent' OUTPUT ]
    [ , [ @distrib_cleanupagent = ] 'distrib_cleanupagent' OUTPUT ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @local = ] 'local' ]
    [ , [ @rpcsrvname = ] 'rpcsrvname' OUTPUT ]
    [ , [ @publisher_type = ] 'publisher_type' OUTPUT ]
[ ; ]

Argumentos

[ @distributor = ] SALIDA 'distribuidor'

Nombre del distribuidor. @distributor es sysname, con un valor predeterminado de %, que es el único valor que devuelve un conjunto de resultados.

[ @distribdb = ] 'distribdb' OUTPUT

El nombre de la base de datos de distribución. @distribdb es sysname, con un valor predeterminado de %, que es el único valor que devuelve un conjunto de resultados.

[ @directory = ] SALIDA 'directory'

El directorio de trabajo. @directory es nvarchar(255), con un valor predeterminado de %, que es el único valor que devuelve un conjunto de resultados.

[ @account = ] SALIDA de 'account'

La cuenta de usuario de Microsoft Windows. @account es nvarchar(255), con un valor predeterminado de %, que es el único valor que devuelve un conjunto de resultados.

[ @min_distretention = ] min_distretention OUTPUT

Período de retención de distribución mínimo, en horas. @min_distretention es int, con un valor predeterminado de -1.

[ @max_distretention = ] max_distretention OUTPUT

Período máximo de retención de distribución, en horas. @max_distretention es int, con un valor predeterminado de -1.

[ @history_retention = ] history_retention OUTPUT

Período de retención del historial, en horas. @history_retention es int, con un valor predeterminado de -1.

[ @history_cleanupagent = ] SALIDA 'history_cleanupagent'

Nombre del agente de limpieza del historial. @history_cleanupagent es nvarchar(100), con un valor predeterminado de %, que es el único valor que devuelve un conjunto de resultados.

[ @distrib_cleanupagent = ] SALIDA 'distrib_cleanupagent'

Nombre del agente de limpieza de distribución. @distrib_cleanupagent es nvarchar(100), con un valor predeterminado de %, que es el único valor que devuelve un conjunto de resultados.

[ @publisher = ] 'publisher'

El nombre del publicador. @publisher es sysname, con un valor predeterminado de NULL.

[ @local = ] 'local'

Si SQL Server debe obtener valores de servidor local. @local es nvarchar(5), con un valor predeterminado de NULL.

[ @rpcsrvname = ] 'rpcsrvname' OUTPUT

Nombre del servidor que emite llamadas a procedimientos remotos. @rpcsrvname es sysname, con un valor predeterminado de %, que es el único valor que devuelve un conjunto de resultados.

[ @publisher_type = ] SALIDA 'publisher_type'

Tipo de publicador del publicador. @publisher_type es sysname, con un valor predeterminado de %, que es el único valor que devuelve un conjunto de resultados.

Conjunto de resultados

Nombre de la columna Tipo de datos Descripción
distributor sysname Nombre del distribuidor.
distribution database sysname Nombre de la base de datos de distribución.
directory nvarchar(255) Nombre del directorio de trabajo.
account nvarchar(255) Nombre de la cuenta de usuario de Windows.
min distrib retention int Período mínimo de retención de la distribución.
max distrib retention int Período máximo de retención de la distribución.
history retention int Período de retención del historial.
history cleanup agent nvarchar(100) Nombre del Agente de limpieza del historial.
distribution cleanup agent nvarchar(100) Nombre del Agente de limpieza de distribución.
rpc server name sysname Nombre del distribuidor remoto o local.
rpc login name sysname Inicio de sesión utilizado por las llamadas a procedimientos remotos al distribuidor remoto.
publisher type sysname Tipo de publicador; puede ser uno de los siguientes:

-MSSQLSERVER
-ORACLE
- PUERTA DE ENLACE DE ORACLE

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_helpdistributor se usa en todos los tipos de replicación.

Si se especifican uno o varios parámetros de salida al ejecutar sp_helpdistributor, todos los parámetros de salida establecidos en NULL se asignan valores al salir y no se devuelve ningún conjunto de resultados. Si no se especifica ningún parámetro de salida, se devuelve un conjunto de resultados.

Permisos

Las columnas del conjunto de resultados o los parámetros de salida siguientes se devuelven a los miembros del rol fijo de servidor sysadmin en el publicador y el rol fijo de base de datos db_owner en la base de datos de publicación:

Columna del conjunto de resultados Parámetro de salida
account @account
min distrib retention @min_distretention
max distrib retention @max_distretention
history retention @history_retention
history cleanup agent @history_cleanupagent
distribution cleanup agent @distrib_cleanupagent
rpc login name None

La siguiente columna de conjuntos de resultados se devuelve a los usuarios de la lista de acceso a la publicación para una publicación en el distribuidor:

  • directorio

Las siguientes columnas de conjuntos de resultados se devuelven a todos los usuarios.

Columna del conjunto de resultados Parámetro de salida
distributor @distributor
distribution database @distribdb
rpc server name @rpcsrvname
publisher type @publisher_type

Contenido relacionado