sp_pdw_add_network_credentials (Azure Synapse Analytics)sp_pdw_add_network_credentials (Azure Synapse Analytics)

適用対象:Applies to: はいAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics はいParallel Data WarehouseParallel Data WarehouseyesParallel Data WarehouseParallel Data Warehouse適用対象:Applies to: はいAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics はいParallel Data WarehouseParallel Data WarehouseyesParallel Data WarehouseParallel Data Warehouse

これにより、にネットワーク資格情報が格納さ Azure Synapse AnalyticsAzure Synapse Analytics れ、サーバーに関連付けられます。This stores network credentials in Azure Synapse AnalyticsAzure Synapse Analytics and associates them with a server. たとえば、このストアドプロシージャを使用して、 Azure Synapse AnalyticsAzure Synapse Analytics 対象サーバーでデータベースのバックアップと復元操作を実行したり、TDE に使用する証明書のバックアップを作成したりするための適切な読み取り/書き込み権限を付与します。For example, use this stored procedure to give Azure Synapse AnalyticsAzure Synapse Analytics appropriate read/write permissions to perform database backup and restore operations on a target server, or to create a backup of a certificate used for TDE.

トピック リンク アイコン Transact-SQL 構文表記規則 (Transact-SQL)Topic link icon Transact-SQL Syntax Conventions (Transact-SQL)

構文Syntax

-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse  
  
sp_pdw_add_network_credentials 'target_server_name',  'user_name', 'password'  

注意

この構文は、Azure Synapse Analytics のサーバーレス SQL プールでサポートされていません。This syntax is not supported by serverless SQL pool in Azure Synapse Analytics.

引数Arguments

'target_server_name''target_server_name'
対象サーバーのホスト名または IP アドレスを指定します。Specifies the target server host name or IP address. Azure Synapse AnalyticsAzure Synapse Analytics は、このストアドプロシージャに渡されたユーザー名とパスワードの資格情報を使用して、このサーバーにアクセスします。will access this server by using the username and password credentials passed to this stored procedure.

InfiniBand ネットワーク経由で接続するには、対象サーバーの InfiniBand IP アドレスを使用します。To connect through the InfiniBand network, use the InfiniBand IP address of the target server.

target_server_name は nvarchar (]) として定義されています。target_server_name is defined as nvarchar(337).

'user_name''user_name'
対象サーバーにアクセスする権限を持つ user_name を指定します。Specifies the user_name that has permissions to access the target server. 対象サーバーの資格情報が既に存在する場合は、新しい資格情報に更新されます。If credentials already exist for the target server, they will be updated to the new credentials.

user_name は nvarchar (513) として定義されています。user_name is defined as nvarchar (513).

'password'password
User_name のパスワードを指定します。Specifies the password for user_name.

リターン コードの値Return Code Values

0 (成功) または 1 (失敗)0 (success) or 1 (failure)

アクセス許可Permissions

ALTER SERVER STATE 権限が必要です。Requires ALTER SERVER STATE permission.

エラー処理Error Handling

[制御] ノードおよびすべての計算ノードで資格情報を追加できない場合、エラーが発生します。An error occurs if adding credentials does not succeed on the Control node and all Compute nodes.

全般的な解説General Remarks

このストアドプロシージャは、の NetworkService アカウントにネットワーク資格情報を追加し Azure Synapse AnalyticsAzure Synapse Analytics ます。This stored procedure adds network credentials to the NetworkService account for Azure Synapse AnalyticsAzure Synapse Analytics. NetworkService アカウントは、 SQL ServerSQL Server 制御ノードとコンピューティングノードで SMP の各インスタンスを実行します。The NetworkService account runs each instance of SMP SQL ServerSQL Server on the Control node and the Compute nodes. たとえば、バックアップ操作を実行すると、制御ノードと各コンピューティングノードは NetworkService アカウントの資格情報を使用して、対象サーバーに対する読み取りと書き込みのアクセス許可を取得します。For example, when a backup operation runs, the Control node and each Compute node will use the NetworkService account credentials to gain read and write permission to the target server.

例: Azure Synapse AnalyticsAzure Synapse AnalyticsParallel Data WarehouseParallel Data WarehouseExamples: Azure Synapse AnalyticsAzure Synapse Analytics and Parallel Data WarehouseParallel Data Warehouse

A.A. データベースバックアップを実行するための資格情報を追加するAdd credentials for performing a database backup

次の例では、ドメインユーザーのユーザー名とパスワードの資格情報を、10.172.63.255 という IP アドレスを持つ対象サーバーに関連付けます。The following example associates the user name and password credentials for the domain user seattle\david with a target server that has an IP address of 10.172.63.255. ユーザーは、対象サーバーに対する読み取り/書き込み権限を持っています。The user seattle\david has read/write permissions to the target server. Azure Synapse AnalyticsAzure Synapse Analytics は、これらの資格情報を格納し、バックアップ操作と復元操作に必要な場合に、対象サーバーとの間での読み書きに使用します。will store these credentials and use them to read and write to and from the target server, as necessary for backup and restore operations.

EXEC sp_pdw_add_network_credentials '10.172.63.255', 'seattle\david', '********';  

Backup コマンドでは、サーバー名を IP アドレスとして入力する必要があります。The backup command requires that the server name be entered as an IP address.

注意

InfiniBand でデータベースのバックアップを実行するには、必ずバックアップサーバーの InfiniBand IP アドレスを使用してください。To perform the database backup over InfiniBand, be sure to use the InfiniBand IP address of the backup server.

参照See Also

sp_pdw_remove_network_credentials (Azure Synapse Analytics)sp_pdw_remove_network_credentials (Azure Synapse Analytics)