sp_pdw_add_network_credentials (Azure Synapse Analytics)

适用于：Azure Synapse AnalyticsAnalytics Platform System (PDW)

这会在 Azure Synapse Analytics 中存储网络凭据并将其与服务器相关联。 例如，使用此存储过程为 Azure Synapse Analytics 提供适当的读/写权限，以便在目标服务器上执行数据库备份和还原操作，或创建用于 TDE 的证书的备份。

Transact-SQL 语法约定

语法

-- 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 标准版RVER 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)