sp_pdw_add_network_credentials (Azure Synapse Analytics)
適用対象: 
Azure Synapse Analytics Analytics Platform System (PDW)
sp_pdw_add_network_credentials では、ネットワーク資格情報が Azure Synapse Analytics に格納され、サーバーに関連付けられます。 たとえば、このストアド プロシージャを使用して、Azure Synapse Analytics に適切な読み取り/書き込みアクセス許可を付与して、ターゲット サーバーでデータベースのバックアップと復元操作を実行したり、透過的なデータ暗号化 (TDE) に使用される証明書のバックアップを作成したりできます。
構文
Azure Synapse Analytics および Analytics Platform System (PDW) の構文。
sp_pdw_add_network_credentials
'target_server_name'
, 'user_name'
, 'password'
[ ; ]
Note
この構文は、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 権限が必要です。
エラー処理
コントロール ノードとすべてのコンピューティング ノードで資格情報の追加が成功しない場合、エラーが発生します。
解説
このストアド プロシージャは、Azure Synapse Analytics の NetworkService アカウントにネットワーク資格情報を追加します。 NetworkService アカウントは、制御ノードとコンピューティング ノードで SMP SQL Server の各インスタンスを実行します。 たとえば、バックアップ操作が実行されると、制御ノードと各コンピューティング ノードは、 NetworkService アカウントの資格情報を使用して、ターゲット サーバーに対する読み取りと書き込みのアクセス許可を取得します。
例: Azure Synapse Analytics、Analytics Platform System (PDW)
A. データベース バックアップを実行するための資格情報を追加する
次の例では、ドメイン ユーザー seattle\david のユーザー名とパスワードの資格情報を、 10.172.63.255の IP アドレスであるターゲット サーバーに関連付けます。 ユーザー seattle\david には、ターゲット サーバーに対する読み取り/書き込みアクセス許可があります。 Azure Synapse Analytics では、これらの資格情報が格納され、バックアップと復元の操作に必要に応じて、これらの資格情報を使用してターゲット サーバーとの間で読み取りと書き込みを行います。
EXEC sp_pdw_add_network_credentials
'10.172.63.255',
'seattle\david',
'********';
バックアップ コマンドでは、サーバー名を IP アドレスとして入力する必要があります。
Note
InfiniBand 経由でデータベース バックアップを実行するには、バックアップ サーバーの InfiniBand IP アドレスを必ず使用してください。