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)