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) に使用される証明書のバックアップを作成したりできます。

Transact-SQL 構文表記規則

構文

Azure Synapse Analytics および Analytics Platform System (PDW) の構文。

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

引数

'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 アドレスとして入力する必要があります。

関連するコンテンツ

• sp_pdw_remove_network_credentials (Azure Synapse Analytics)