sp_pdw_add_network_credentials (Analitica di Azure Synapse)

Si applica a: Azure Synapse Analytics Piattaforma di strumenti analitici (PDW)

sp_pdw_add_network_credentials archivia le credenziali di rete in Azure Synapse Analitica e le associa a un server. Ad esempio, usare questa stored procedure per concedere ad Azure Synapse Analitica autorizzazioni di lettura/scrittura appropriate per eseguire operazioni di backup e ripristino del database in un server di destinazione o per creare un backup di un certificato usato per Transparent Data Encryption (TDE).

Convenzioni relative alla sintassi Transact-SQL

Sintassi

Sintassi per azure Synapse Analitica e Analitica Platform System (PDW).

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

Nota

Questa sintassi non è supportata da pool SQL serverless in Azure Synapse Analytics.

Argomenti

'target_server_name'

Specifica il nome host o l'indirizzo IP del server di destinazione. target_server_name è nvarchar(337) senza impostazione predefinita. Azure Synapse Analitica accede a questo server con le credenziali di nome utente e password passate a questa stored procedure.

Per connettersi tramite la rete InfiniBand, usare l'indirizzo IP InfiniBand del server di destinazione.

'user_name'

Specifica il user_name che è autorizzato ad accedere al server di destinazione. user_name è nvarchar(513) senza impostazione predefinita. Se le credenziali esistono già per il server di destinazione, vengono aggiornate alle nuove credenziali.

'password

Specifica la password per user_name.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Autorizzazioni

È richiesta l'autorizzazione ALTER SERVER STATE.

Gestione errori

Si verifica un errore se l'aggiunta di credenziali non riesce nel nodo Di controllo e in tutti i nodi di calcolo.

Osservazioni:

Questa stored procedure aggiunge le credenziali di rete all'account NetworkService per Azure Synapse Analitica. L'account NetworkService esegue ogni istanza di SMP SQL Server nel nodo Controllo e nei nodi di calcolo. Ad esempio, quando viene eseguita un'operazione di backup, il nodo Controllo e ogni nodo di calcolo usano le credenziali dell'account per ottenere l'autorizzazione NetworkService di lettura e scrittura per il server di destinazione.

Esempi: Azure Synapse Analytics e Piattaforma di strumenti analitici (PDW)

R. Aggiungere credenziali per l'esecuzione di un backup del database

Nell'esempio seguente vengono associate le credenziali di nome utente e password per l'utente seattle\david di dominio a un server di destinazione che rappresenta un indirizzo IP di 10.172.63.255. L'utente seattle\david dispone di autorizzazioni di lettura/scrittura per il server di destinazione. Azure Synapse Analitica archivia queste credenziali e le usa per leggere e scrivere dal server di destinazione, se necessario per le operazioni di backup e ripristino.

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

Il comando di backup richiede che il nome del server venga immesso come indirizzo IP.

Nota

Per eseguire il backup del database su InfiniBand, assicurarsi di usare l'indirizzo IP InfiniBand del server di backup.