sp_pdw_add_network_credentials (Azure Synapse Analytics)

S’applique à: Azure Synapse Analytics Analytics Platform System (PDW)

sp_pdw_add_network_credentials stocke les informations d’identification réseau dans Azure Synapse Analytique et les associe à un serveur. Par exemple, utilisez cette procédure stockée pour donner à Azure Synapse Analytique autorisations de lecture/écriture appropriées pour effectuer des opérations de sauvegarde et de restauration de base de données sur un serveur cible, ou pour créer une sauvegarde d’un certificat utilisé pour le chiffrement transparent des données (TDE).

Conventions de la syntaxe Transact-SQL

Syntaxe

Syntaxe pour Azure Synapse Analytique et Analytique Platform System (PDW).

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

Remarque

Cette syntaxe n’est pas prise en charge par le pool SQL serverless dans Azure Synapse Analytics.

Arguments

'target_server_name'

Spécifie le nom d’hôte du serveur cible ou l’adresse IP. target_server_name est nvarchar(337) sans valeur par défaut. Azure Synapse Analytique accède à ce serveur avec les informations d’identification de nom d’utilisateur et de mot de passe passées à cette procédure stockée.

Pour vous connecter via le réseau InfiniBand, utilisez l’adresse IP InfiniBand du serveur cible.

'user_name'

Spécifie le user_name qui est autorisé à accéder au serveur cible. user_name est nvarchar(513) sans valeur par défaut. Si les informations d’identification existent déjà pour le serveur cible, elles sont mises à jour vers les nouvelles informations d’identification.

'password

Spécifie le mot de passe de user_name.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

autorisations

Nécessite l'autorisation ALTER SERVER STATE.

Gestion des erreurs

Une erreur se produit si l’ajout d’informations d’identification ne réussit pas sur le nœud Contrôle et tous les nœuds de calcul.

Notes

Cette procédure stockée ajoute des informations d’identification réseau au NetworkService compte d’Azure Synapse Analytique. Le NetworkService compte exécute chaque instance de SMP SQL Server sur le nœud Contrôle et les nœuds de calcul. Par exemple, lorsqu’une opération de sauvegarde s’exécute, le nœud Contrôle et chaque nœud de calcul utilisent les NetworkService informations d’identification du compte pour obtenir l’autorisation de lecture et d’écriture sur le serveur cible.

Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)

A. Ajouter des informations d’identification pour effectuer une sauvegarde de base de données

L’exemple suivant associe le nom d’utilisateur et les informations d’identification de mot de passe pour l’utilisateur seattle\david du domaine à un serveur cible qui est une adresse IP de 10.172.63.255. L’utilisateur dispose d’autorisations seattle\david en lecture/écriture sur le serveur cible. Azure Synapse Analytique stocke ces informations d’identification et les utilise pour lire et écrire dans et depuis le serveur cible, si nécessaire pour les opérations de sauvegarde et de restauration.

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

La commande de sauvegarde nécessite que le nom du serveur soit entré en tant qu’adresse IP.

Remarque

Pour effectuer la sauvegarde de base de données sur InfiniBand, veillez à utiliser l’adresse IP InfiniBand du serveur de sauvegarde.