sp_pdw_add_network_credentials (Azure Synapse Analytics)

适用于: Azure Synapse Analytics 分析平台系统 (PDW)

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

Transact-SQL 语法约定

语法

Azure Synapse Analytics 和分析平台系统的语法(PDW)。

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

注意

Azure Synapse Analytics 中的无服务器 SQL 池不支持此语法。

参数

target_server_name

指定目标服务器主机名或 IP 地址。 target_server_name为 nvarchar(337),没有默认值。 Azure Synapse Analytics 使用传递给此存储过程的用户名和密码凭据访问此服务器。

若要通过 InfiniBand 网络进行连接,请使用目标服务器的 InfiniBand IP 地址。

'user_name'

指定有权访问目标服务器的user_name。 user_name为 nvarchar(513),没有默认值。 如果目标服务器已存在凭据,则会更新为新凭据。

password

指定user_name的密码

返回代码值

0(成功)或 1(失败)。

权限

需要 ALTER SERVER STATE 权限。

错误处理

如果在控制节点上和所有计算节点上添加凭据不成功,则会发生错误。

注解

此存储过程将网络凭据添加到 NetworkService Azure Synapse Analytics 的帐户。 该 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 地址。