sp_pdw_add_network_credentials (Azure Synapse Analytics)
適用対象: Azure Synapse Analytics
Analytics Platform System (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'
Note
この構文は、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 (失敗)
アクセス許可
エラー処理
コントロール ノードとすべてのコンピューティング ノードで資格情報の追加が成功しない場合、エラーが発生します。
全般的な解説
このストアド プロシージャは、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 アドレスとして入力する必要があります。
Note
InfiniBand 経由でデータベース バックアップを実行するには、バックアップ サーバーの InfiniBand IP アドレスを必ず使用してください。