sp_help_proxy (Transact-SQL)
Se aplica a: SQL Server
Muestra información de uno o varios servidores proxy.
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_help_proxy
[ [ @proxy_id = ] proxy_id ]
[ , [ @proxy_name = ] N'proxy_name' ]
[ , [ @subsystem_name = ] N'subsystem_name' ]
[ , [ @name = ] N'name' ]
[ ; ]
Argumentos
[ @proxy_id = ] proxy_id
Número de identificación del proxy del que se muestra información. @proxy_id es int, con un valor predeterminado de NULL
. Se puede especificar el @proxy_id o el @proxy_name .
[ @proxy_name = ] N'proxy_name'
Nombre del proxy del que se va a mostrar información. @proxy_name es sysname, con un valor predeterminado de NULL
. Se puede especificar el @proxy_id o el @proxy_name .
[ @subsystem_name = ] N'subsystem_name'
Nombre del subsistema del que se van a mostrar los servidores proxy. @subsystem_name es sysname, con un valor predeterminado de NULL
. Cuando se especifica @subsystem_name , también se debe especificar @name .
En la tabla siguiente se muestran los valores disponibles para cada subsistema.
Valor | Descripción |
---|---|
ActiveScripting |
Script ActiveX |
CmdExec |
Sistema operativo (CmdExec ) |
Snapshot |
Replication Snapshot Agent |
LogReader |
Agente de registro del LOG de replicación |
Distribution |
Replication Distribution Agent |
Merge |
Replication Merge Agent |
QueueReader |
Agente de lectura de cola de replicación |
ANALYSISQUERY |
Comando de Analysis Services |
ANALYSISCOMMAND |
Consulta de Analysis Services |
Dts |
Ejecución de paquetes SSIS |
PowerShell |
Script de PowerShell |
[ @name = ] N'name'
Nombre de un inicio de sesión de SQL Server para el que se enumeran los servidores proxy. @name es nvarchar(256), con un valor predeterminado de NULL
. Cuando se especifica @name , también se debe especificar @subsystem_name .
Valores de código de retorno
0
(correcto) o 1
(erróneo).
Conjunto de resultados
Nombre de la columna | Tipo de datos | Descripción |
---|---|---|
proxy_id |
int | Número de identificación del proxy. |
name |
sysname | Nombre del proxy. |
credential_identity |
sysname | Nombre de dominio y nombre de usuario de Microsoft Windows para la credencial asociada con el proxy. |
enabled |
tinyint | Especifica si este proxy está habilitado. 0 = no habilitado, 1 = habilitado. |
description |
nvarchar(1024) | Descripción de este proxy. |
user_sid |
varbinary(85) | Identificador de seguridad de Windows del usuario de Windows para este proxy. |
credential_id |
int | Identificador de la credencial asociada con este proxy. |
credential_identity_exists |
int | Especifica si credential_identity existe . 0 = no existe, 1 = existe. |
Comentarios
Cuando no se proporcionan parámetros, sp_help_proxy
se muestra información de todos los servidores proxy de la instancia.
Para determinar qué servidores proxy puede usar un inicio de sesión para un subsistema determinado, especifique @name y @subsystem_name. Cuando se proporcionan estos argumentos, sp_help_proxy
se enumeran los servidores proxy a los que puede tener acceso el inicio de sesión especificado y que se pueden usar para el subsistema especificado.
Permisos
Este procedimiento almacenado es propiedad del rol db_owner . Puede conceder EXECUTE
permisos para cualquier usuario, pero estos permisos se pueden invalidar durante una actualización de SQL Server.
A otros usuarios se les debe conceder uno de los siguientes Agente SQL Server roles fijos de base de datos en la msdb
base de datos:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
Para detalles sobre los permisos de estos roles, consulte Roles fijos de base de datos del Agente SQL Server.
Las credential_identity
columnas y user_sid
solo se devuelven en el conjunto de resultados cuando los miembros de sysadmin ejecutan este procedimiento almacenado.
Ejemplos
A Información de lista para todos los servidores proxy
El ejemplo siguiente muestra información de todos los servidores proxy de la instancia.
USE msdb;
GO
EXEC dbo.sp_help_proxy;
GO
B. Enumeración de la información de un proxy específico
El ejemplo siguiente muestra información del proxy denominado Catalog application proxy
.
USE msdb;
GO
EXEC dbo.sp_help_proxy
@proxy_name = N'Catalog application proxy';
GO