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'  

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 (失敗)

アクセス許可

ALTER Standard Edition RVER STATE 権限が必要です。

エラー処理

コントロール ノードとすべてのコンピューティング ノードで資格情報の追加が成功しない場合、エラーが発生します。

全般的な解説

このストアド プロシージャは、Azure Synapse Analytics の NetworkService アカウントにネットワーク資格情報を追加します。 NetworkService アカウントは、コントロール ノードとコンピューティング ノードで SMP SQL Server の各インスタンスを実行します。 たとえば、バックアップ操作が実行されると、制御ノードと各コンピューティング ノードは NetworkService アカウントの資格情報を使用して、ターゲット サーバーに対する読み取りと書き込みのアクセス許可を取得します。

例: Azure Synapse Analytics、Analytics Platform System (PDW)

A. データベース バックアップを実行するための資格情報を追加する

次の例では、doメイン ユーザー 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 アドレスを必ず使用してください。

参照

sp_pdw_remove_network_credentials (Azure Synapse Analytics)