sp_add_proxy (Transact-SQL)

platí pro:SQL Server

Přidává specifikovaný SQL Server Agent proxy.

Transact-SQL konvence syntaxe

Syntax

dbo.sp_add_proxy
    [ @proxy_name = ] N'proxy_name'
    [ , [ @enabled = ] enabled ]
    [ , [ @description = ] N'description' ]
    , { [ @credential_name = ] N'credential_name'
        | [ @credential_id = ] credential_id }
    [ , [ @proxy_id = ] proxy_id OUTPUT ]
[ ; ]

Arguments

[ @proxy_name = ] N'proxy_name'

Název zástupce tvořit. @proxy_name je sysname, s výchozím nastavením NULL. Když jeNULL @proxy_name nebo prázdný řetězec, název proxy se automaticky používá na @credential_name nebo @credential_id dodán.

[ @enabled = ] povoleno

Specifikuje, zda je proxy povoleno. Vlajka @enabled je tinyint, s výchozím nastavením 1. Když @enabled , 0proxy není povoleno a nelze jej použít v kroku práce.

[ @description = ] N'popis"

Popis zástupce. Popis je nvarchar(512), s výchozím nastavením NULL. Popis umožňuje dokumentovat proxy, ale SQL Server Agent ho jinak nepoužívá. Proto je tento argument volitelný.

[ @credential_name = ] N'credential_name'

Název kvalifikace pro zmocněného zástupce. @credential_name je sysname, s výchozím nastavením NULL. Musí být specifikováno buď @credential_name , nebo @credential_id .

[ @credential_id = ] credential_id

Identifikační číslo kvalifikace pro proxy. @credential_id je int, s výchozím hodnotou NULL. Musí být specifikováno buď @credential_name , nebo @credential_id .

[ @proxy_id = ] proxy_id VÝSTUP

Identifikační číslo proxy přiřazené proxy v případě úspěšného vytvoření.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Žádné.

Remarks

Tato uložená procedura musí být spuštěna v databázi msdb .

Proxy SQL Server Agent spravuje bezpečnost pro kroky práce, které zahrnují subsystémy jiné než Transact-SQL subsystém. Každý proxy server odpovídá přihlašovacím údajům zabezpečení. Proxy může mít přístup k libovolnému počtu podsystémů.

Permissions

Na tomto postupu můžete udělit EXECUTE oprávnění, ale tato oprávnění mohou být během upgradu SQL Serveru přepsána.

Členové role fixní bezpečnosti správce systému mohou vytvářet kroky úlohy, které využívají jakýkoli proxy. Použijte uloženou proceduru sp_grant_login_to_proxy k udělení přístupu k proxy dalším přihlašovacím osobám.

Examples

Tento příklad vytváří proxy pro přihlasovací údaje CatalogApplicationCredential. Kód předpokládá, že oprávnění již existuje. Pro více informací o kvalifikacích viz CREATE CREDENTIAL.

USE msdb;
GO

EXECUTE dbo.sp_add_proxy
    @proxy_name = 'Catalog application proxy',
    @enabled = 1,
    @description = 'Maintenance tasks on catalog application.',
    @credential_name = 'CatalogApplicationCredential';
GO