sp_pdw_add_network_credentials (Azure Synapse Analytics)

Artículo
12/22/2023

Se aplica a:Azure Synapse Analytics Analytics Platform System (PDW)

Esto almacena las credenciales de red en Azure Synapse Analytics y las asocia a un servidor. Por ejemplo, use este procedimiento almacenado para conceder a Azure Synapse Analytics permisos de lectura y escritura adecuados para realizar operaciones de copia de seguridad y restauración de bases de datos en un servidor de destino, o para crear una copia de seguridad de un certificado usado para TDE.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Nota:

El grupo de SQL sin servidor no admite esta sintaxis en Azure Synapse Analytics.

Argumentos

"target_server_name"
Especifica el nombre de host del servidor de destino o la dirección IP. Azure Synapse Analytics accederá a este servidor mediante las credenciales de nombre de usuario y contraseña que se pasan a este procedimiento almacenado.

Para conectarse a través de la red InfiniBand, use la dirección IP infiniBand del servidor de destino.

target_server_name se define como nvarchar(337).

'user_name'
Especifica el user_name que tiene permisos para acceder al servidor de destino. Si ya existen credenciales para el servidor de destino, se actualizarán a las nuevas credenciales.

user_name se define como nvarchar (513).

'passwordꞌ
Especifica la contraseña de user_name.

Valores de código de retorno

0 (correcto) o 1 (error)

Permisos

Requiere el permiso ALTER SERVER STATE .

Tratamiento de errores

Se produce un error si la adición de credenciales no se realiza correctamente en el nodo Control y en todos los nodos de proceso.

Notas generales

Este procedimiento almacenado agrega credenciales de red a la cuenta networkService para Azure Synapse Analytics. La cuenta networkService ejecuta cada instancia de SMP SQL Server en el nodo Control y los nodos de proceso. Por ejemplo, cuando se ejecuta una operación de copia de seguridad, el nodo Control y cada nodo de proceso usarán las credenciales de la cuenta networkService para obtener permiso de lectura y escritura en el servidor de destino.

Ejemplos: Azure Synapse Analytics y Sistema de la plataforma de análisis (PDW)

A Adición de credenciales para realizar una copia de seguridad de base de datos

En el ejemplo siguiente se asocian el nombre de usuario y las credenciales de contraseña para el usuario de dominio seattle\david con un servidor de destino que tiene una dirección IP de 10.172.63.255. El usuario seattle\david tiene permisos de lectura y escritura en el servidor de destino. Azure Synapse Analytics almacenará estas credenciales y las usará para leer y escribir en y desde el servidor de destino, según sea necesario para las operaciones de copia de seguridad y restauración.

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

El comando de copia de seguridad requiere que el nombre del servidor se escriba como una dirección IP.