sp_pdw_add_network_credentials (Azure Synapse Analytics)

2025-06-28

platí pro: Azure Synapse AnalyticsAnalytics Platform System (PDW)

sp_pdw_add_network_credentials ukládá síťové přihlašovací údaje ve službě Azure Synapse Analytics a přidruží je k serveru. Pomocí této uložené procedury můžete například službě Azure Synapse Analytics udělit příslušná oprávnění ke čtení a zápisu k provádění operací zálohování a obnovení databáze na cílovém serveru nebo k vytvoření zálohy certifikátu použitého k transparentnímu šifrování dat .TDE.

Transact-SQL konvence syntaxe

Syntaxe

Syntaxe pro Azure Synapse Analytics a Platform Platform System (PDW).

sp_pdw_add_network_credentials
    'target_server_name'
    , 'user_name'
    , 'password'
[ ; ]

Poznámka:

Tato syntaxe není podporována bezserverovým fondem SQL ve službě Azure Synapse Analytics.

Argumenty

"target_server_name"

Určuje název hostitele cílového serveru nebo IP adresu. target_server_name je nvarchar(337) bez výchozího nastavení. Azure Synapse Analytics přistupuje k tomuto serveru pomocí přihlašovacích údajů pro uživatelské jméno a heslo předané této uložené proceduře.

Pokud se chcete připojit přes síť InfiniBand, použijte IP adresu InfiniBand cílového serveru.

User_name

Určuje user_name, která mají oprávnění pro přístup k cílovému serveru. user_name je nvarchar(513) bez výchozího nastavení. Pokud už přihlašovací údaje pro cílový server existují, aktualizují se na nové přihlašovací údaje.

'passwordꞌ

Určuje heslo pro user_name.

Hodnoty návratového kódu

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

Povolení

Vyžaduje oprávnění ALTER SERVER STATE.

Zpracování chyb

Pokud přidání přihlašovacích údajů na řídicím uzlu a všech výpočetních uzlech nebude úspěšné, dojde k chybě.

Poznámky

Tato uložená procedura přidá do NetworkService účtu služby Azure Synapse Analytics síťové přihlašovací údaje. Tento NetworkService účet spouští každou instanci SQL Serveru SMP na řídicím uzlu a výpočetních uzlech. Například když se spustí operace zálohování, řídicí uzel a každý výpočetní uzel používají NetworkService přihlašovací údaje účtu k získání oprávnění ke čtení a zápisu cílovému serveru.

Příklady: Azure Synapse Analytics a Analytický platformový systém (PDW)

A. Přidání přihlašovacích údajů pro zálohování databáze

Následující příklad přidruží uživatelské jméno a heslo pro uživatele seattle\david domény k cílovému serveru, který je IP adresou 10.172.63.255. Uživatel seattle\david má oprávnění ke čtení a zápisu k cílovému serveru. Azure Synapse Analytics tyto přihlašovací údaje ukládá a používá k čtení a zápisu na cílový server podle potřeby pro operace zálohování a obnovení. Nahraďte <password> silným heslem.

EXECUTE sp_pdw_add_network_credentials
    '10.172.63.255',
    'seattle\david',
    '<password>';

Příkaz zálohování vyžaduje, aby název serveru byl zadán jako IP adresa.