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 Microsoft SQL Server. 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=] '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

Notas

sp_helpdistributor se utiliza en todos los tipos de réplica.

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

Valores de código de retorno

0 (correcto) o 1 (error)

Vea también

Referencia

sp_adddistpublisher (Transact-SQL)
sp_dropdistpublisher (Transact-SQL)

Otros recursos

How to: View and Modify Publisher and Distributor Properties (Replication Transact-SQL Programming)

Ayuda e información

Obtener ayuda sobre SQL Server 2005