sp_pdw_add_network_credentials （Azure Synapse Analytics）

發行項
12/22/2023

適用於：Azure Synapse Analytics Analytics Platform System (PDW)

這會在 Azure Synapse Analytics 中儲存網路認證，並將其與伺服器產生關聯。例如，使用此預存程式為 Azure Synapse Analytics 提供適當的讀取/寫入許可權，以在目標伺服器上執行資料庫備份和還原作業，或建立用於 TDE 的憑證備份。

Transact-SQL 語法慣例

Syntax

-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse  
  
sp_pdw_add_network_credentials 'target_server_name',  'user_name', 'password'

注意

Azure Synapse Analytics 的無伺服器 SQL 集區不支援此語法。

引數

'target_server_name'
指定目標伺服器主機名稱或IP位址。 Azure Synapse Analytics 會使用傳遞至此預存程式的使用者名稱和密碼認證來存取此伺服器。

若要透過 InfiniBand 網路連線，請使用目標伺服器的 InfiniBand IP 位址。

target_server_name定義為 nvarchar（337）。

'user_name'
指定有權存取目標伺服器的user_name。如果目標伺服器已有認證存在，則會更新為新的認證。

user_name定義為 nvarchar （513）。

'passwordꞌ
指定user_name的密碼。

傳回碼值

0 (成功) 或 1 (失敗)

權限

需要 ALTER SERVER STATE 許可權。

錯誤處理

如果在控制節點上和所有計算節點上新增認證不成功，就會發生錯誤。

一般備註

此預存程式會將網路認證新增至 Azure Synapse Analytics 的 NetworkService 帳戶。 NetworkService 帳戶會在控制節點上和計算節點上執行 SMP SQL Server 的每個實例。例如，當備份作業執行時，控制節點和每個計算節點都會使用NetworkService 帳戶認證來取得目標伺服器的讀取和寫入許可權。

範例：Azure Synapse Analytics 和 Analytics Platform System (PDW)

A. 新增用於執行資料庫備份的認證

下列範例會將網域使用者 seattle\david 的使用者名稱和密碼認證與 IP 位址為 10.172.63.255 的目標伺服器產生關聯。使用者 seattle\david 具有目標伺服器的讀取/寫入許可權。 Azure Synapse Analytics 會儲存這些認證，並視備份和還原作業的需要，使用這些認證來回讀取和寫入目標伺服器。

EXEC sp_pdw_add_network_credentials '10.172.63.255', 'seattle\david', '********';

備份命令需要輸入伺服器名稱作為IP位址。

注意

若要透過 InfiniBand 執行資料庫備份，請務必使用備份伺服器的 InfiniBand IP 位址。

另請參閱

sp_pdw_remove_network_credentials （Azure Synapse Analytics）