sp_pdw_add_network_credentials (Azure Synapse Analytics)

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

sp_pdw_add_network_credentials armazena credenciais de rede no Azure Synapse Analytics e as associa a um servidor. Por exemplo, use esse 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 (criptografia de dados transparente).

Convenções de sintaxe de Transact-SQL

Sintaxe

Sintaxe para Azure Synapse Analytics e PDW (Analytics Platform System).

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. target_server_name é nvarchar(337) sem padrão. O Azure Synapse Analytics acessa esse servidor com 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.

'user_name'

Especifica as user_name permissões para acessar o servidor de destino. user_name é nvarchar(513) sem padrão. Se as credenciais já existirem para o servidor de destino, elas serão atualizadas para as novas credenciais.

'senha

Especifica a senha para user_name.

Valores do código de retorno

0 (sucesso) 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

Esse procedimento armazenado adiciona credenciais de rede à conta do NetworkService Azure Synapse Analytics. A NetworkService conta executa cada instância do SQL Server do SMP no nó Controle e nos nós Computação. Por exemplo, quando uma operação de backup é executada, o nó Controle e cada nó de Computação usam as credenciais da NetworkService conta 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 do usuário seattle\david de domínio a um servidor de destino que é 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 armazena essas credenciais e as usa 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.