sp_helpdistributor (Transact-SQL)

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

Icono de vínculo a temasConvenciones 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=] 'distributor' OUTPUT
    Es el nombre del distribuidor. El distribuidor es de tipo sysname y su valor predeterminado es %, que es el único valor que devuelve un conjunto de resultados.

  • [ @distribdb=] 'distribdb' OUTPUT
    Es el nombre de la base de datos de distribución. distribdb es de tipo sysname y su valor predeterminado es %, que es el único valor que devuelve un conjunto de resultados.

  • [ @directory=] 'directory' OUTPUT
    Es el directorio de trabajo. directory es de tipo nvarchar(255) y su valor predeterminado es %, que es el único valor que devuelve un conjunto de resultados.

  • [ @account=] 'account' OUTPUT
    Es la cuenta de usuario de Microsoft Windows. accountes de tipo nvarchar(255) y su valor predeterminado es %, que es el único valor que devuelve un conjunto de resultados.

  • [ @min_distretention=] min_distretentionOUTPUT
    Es el período mínimo de retención de la distribución en horas. min_distretention es de tipo int y su valor predeterminado es -1.

  • [ @max_distretention=] max_distretentionOUTPUT
    Es el período máximo de retención de la distribución en horas. max_distretention es de tipo int y su valor predeterminado es -1.

  • [ @history_retention=] history_retentionOUTPUT
    Es el período mínimo de retención del historial. history_retention es de tipo int y su valor predeterminado es -1.

  • [ @history_cleanupagent=] 'history_cleanupagent' OUTPUT
    Es el nombre del agente de limpieza del historial. history_cleanupagent es de tipo nvarchar(100) y su valor predeterminado es %, que es el único valor que devuelve un conjunto de resultados.

  • [ @distrib_cleanupagent =] 'distrib_cleanupagent' OUTPUT
    Es el nombre del agente de limpieza de distribución. distrib_cleanupagent es de tipo nvarchar(100) y su valor predeterminado es %, que es el único valor que devuelve un conjunto de resultados.

  • [ @publisher=] 'publisher'
    Es el nombre del publicador. publisher es de tipo sysname y su valor predeterminado es NULL.

  • [ @local=] 'local'
    Indica si SQL Server debe obtener valores del servidor local. local es de tipo nvarchar(5) y su valor predeterminado es NULL.

  • [ @rpcsrvname=] 'rpcsrvname' OUTPUT
    Es el nombre del servidor que genera llamadas a procedimientos remotos. rpcsrvname es de tipo sysname y su valor predeterminado es %, que es el único valor que devuelve un conjunto de resultados.

  • [ @publisher_type= ] 'publisher_type' OUTPUT
    Es el tipo de publicador. publisher_type es de tipo sysname y su valor predeterminado es %, que es el único valor que devuelve un conjunto de resultados.

Conjuntos de resultados

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

El tipo de publicador puede ser uno de los siguientes:

MSSQLSERVER

ORACLE

ORACLE GATEWAY

Valores de código de retorno

0 (correcto) o 1 (error)

Notas

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

Si se especifican uno o más parámetros al ejecutar sp_helpdistributor, a todos los parámetros de salida establecidos en NULL se les 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 siguientes columnas de conjuntos de resultados o parámetros de salida se devuelven a los miembros de la función fija de servidor sysadmin en el publicador y la función fija de base de datos db_owner de la base de datos de publicaciones:

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

ninguno

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:

  • directory

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