sp_pdw_add_network_credentials (Azure Synapse Analytics)
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 esse procedimento armazenado para fornecer 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 esse 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 a 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
Esse procedimento armazenado adiciona credenciais de rede à conta NetworkService do Azure Synapse Analytics. A conta NetworkService executa cada instância do SMP SQL Server no nó Controle e nos nós de Computação. Por exemplo, quando uma operação de backup é executada, o nó Controle e cada nó de Computação usarão as credenciais da conta NetworkService para obter permissão de leitura e gravação para o 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 para o usuário de domínio seattle\david a um servidor de destino que tem 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.
Observação
Para executar o backup do banco de dados no InfiniBand, certifique-se de usar o endereço IP do InfiniBand do servidor de backup.