sp_pdw_add_network_credentials (Azure Synapse Analytics)
适用于:Azure Synapse Analytics Analytics 平台系统(PDW)
这会在 Azure Synapse Analytics 中存储网络凭据并将其与服务器相关联。 例如,使用此存储过程为 Azure Synapse Analytics 提供适当的读/写权限,以便在目标服务器上执行数据库备份和还原操作,或创建用于 TDE 的证书的备份。
语法
-- 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 地址。