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

Se aplica a:Applies to: síAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics síAlmacenamiento de datos paralelosParallel Data WarehouseyesAlmacenamiento de datos paralelosParallel Data WarehouseSe aplica a:Applies to: síAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics síAlmacenamiento de datos paralelosParallel Data WarehouseyesAlmacenamiento de datos paralelosParallel Data Warehouse

Esto almacena las credenciales de red en Azure Synapse AnalyticsAzure Synapse Analytics y las asocia a un servidor.This stores network credentials in Azure Synapse AnalyticsAzure Synapse Analytics and associates them with a server. Por ejemplo, utilice este procedimiento almacenado para proporcionar Azure Synapse AnalyticsAzure Synapse Analytics los 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.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.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL (Transact-SQL)Topic link icon Transact-SQL Syntax Conventions (Transact-SQL)

SintaxisSyntax

-- 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.This syntax is not supported by serverless SQL pool in Azure Synapse Analytics.

ArgumentosArguments

'target_server_name''target_server_name'
Especifica el nombre de host o la dirección IP del servidor de destino.Specifies the target server host name or IP address. Azure Synapse AnalyticsAzure Synapse Analytics tendrá acceso a este servidor mediante las credenciales de nombre de usuario y contraseña que se pasaron a este procedimiento almacenado.will access this server by using the username and password credentials passed to this stored procedure.

Para conectarse a través de la red InfiniBand, use la dirección IP InfiniBand del servidor de destino.To connect through the InfiniBand network, use the InfiniBand IP address of the target server.

target_server_name se define como nvarchar (337).target_server_name is defined as nvarchar(337).

'user_name''user_name'
Especifica el user_name que tiene permisos de acceso al servidor de destino.Specifies the user_name that has permissions to access the target server. Si ya existen credenciales para el servidor de destino, se actualizarán a las nuevas credenciales.If credentials already exist for the target server, they will be updated to the new credentials.

user_name se define como nvarchar (513).user_name is defined as nvarchar (513).

'password"'password
Especifica la contraseña de user_name.Specifies the password for user_name.

Valores de código de retornoReturn Code Values

0 (correcto) o 1 (error)0 (success) or 1 (failure)

PermisosPermissions

Requiere el permiso ALTER Server State .Requires ALTER SERVER STATE permission.

Tratamiento de erroresError Handling

Se produce un error si la adición de credenciales no se realiza correctamente en el nodo de control y en todos los nodos de proceso.An error occurs if adding credentials does not succeed on the Control node and all Compute nodes.

Notas generalesGeneral Remarks

Este procedimiento almacenado agrega credenciales de red a la cuenta NetworkService para Azure Synapse AnalyticsAzure Synapse Analytics .This stored procedure adds network credentials to the NetworkService account for Azure Synapse AnalyticsAzure Synapse Analytics. La cuenta NetworkService ejecuta cada instancia de SMP SQL ServerSQL Server en el nodo de control y los nodos de proceso.The NetworkService account runs each instance of SMP SQL ServerSQL Server on the Control node and the Compute nodes. Por ejemplo, cuando se ejecuta una operación de copia de seguridad, el nodo de control y cada nodo de proceso utilizarán las credenciales de la cuenta NetworkService para obtener permiso de lectura y escritura en el servidor de destino.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.

Ejemplos: Azure Synapse AnalyticsAzure Synapse Analytics y Almacenamiento de datos paralelosParallel Data WarehouseExamples: Azure Synapse AnalyticsAzure Synapse Analytics and Almacenamiento de datos paralelosParallel Data Warehouse

A.A. Agregar credenciales para realizar una copia de seguridad de base de datosAdd credentials for performing a database backup

En el ejemplo siguiente se asocian las credenciales de nombre de usuario y 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.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. El usuario seattle\david tiene permisos de lectura y escritura en el servidor de destino.The user seattle\david has read/write permissions to the target server. Azure Synapse AnalyticsAzure Synapse Analytics almacenará estas credenciales y las usará para leer y escribir en el servidor de destino, según sea necesario para las operaciones de copia de seguridad y restauración.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', '********';  

El comando backup requiere que el nombre del servidor se escriba como una dirección IP.The backup command requires that the server name be entered as an IP address.

Nota

Para realizar la copia de seguridad de base de datos a través de InfiniBand, asegúrese de usar la dirección IP InfiniBand del servidor de copia de seguridad.To perform the database backup over InfiniBand, be sure to use the InfiniBand IP address of the backup server.

Consulte tambiénSee Also

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