sp_pdw_add_network_credentials (Azure Synapse Analytics)

Artigo
12/22/2023

Aplica-se a:Azure Synapse Analytics Analytics Platform System (PDW)

Isso armazena credenciais de rede no Azure Synapse Analytics e as associa a um servidor. Por exemplo, use este procedimento armazenado para conceder ao Azure Synapse Analytics permissões de leitura/gravação apropriadas para executar operações de backup e restauração de banco de dados em um servidor de destino ou para criar um backup de um certificado usado para TDE.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Observação

Não há suporte a essa sintaxe para o pool de SQL sem servidor no Azure Synapse Analytics.

Argumentos

'target_server_name'
Especifica o nome do host do servidor de destino ou o endereço IP. O Azure Synapse Analytics acessará esse servidor usando as credenciais de nome de usuário e senha passadas para este procedimento armazenado.

Para se conectar por meio da rede InfiniBand, use o endereço IP InfiniBand do servidor de destino.

target_server_name é definido como nvarchar(337).

'user_name'
Especifica o user_name que tem permissões para acessar o servidor de destino. Se as credenciais já existirem para o servidor de destino, elas serão atualizadas para as novas credenciais.

user_name é definido como nvarchar (513).

'senhaꞌ
Especifica a senha para user_name.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Permissões

Requer permissão ALTER SERVER STATE .

Manipulação de Erro

Ocorrerá um erro se a adição de credenciais não for bem-sucedida no nó Controle e em todos os nós de Computação.

Comentários gerais

Este procedimento armazenado adiciona credenciais de rede à conta NetworkService para o Azure Synapse Analytics. A conta NetworkService executa cada instância do SMP SQL Server no nó Control e nos nós Compute. Por exemplo, quando uma operação de backup é executada, o nó Controle e cada nó Computação usarão as credenciais da conta NetworkService para obter permissão de leitura e gravação no servidor de destino.

Exemplos: Azure Synapse Analytics e PDW (Analytics Platform System)

R. Adicionar credenciais para executar um backup de banco de dados

O exemplo a seguir associa as credenciais de nome de usuário e senha do usuário de domínio seattle\david a um servidor de destino que tenha um endereço IP de 10.172.63.255. O usuário seattle\david tem permissões de leitura/gravação para o servidor de destino. O Azure Synapse Analytics armazenará essas credenciais e as usará para ler e gravar de e para o servidor de destino, conforme necessário para operações de backup e restauração.

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

O comando backup requer que o nome do servidor seja inserido como um endereço IP.