sp_set_firewall_rule (Banco de Dados SQL do Azure)

Aplica-se a: SimBanco de Dados SQL do Azure simAzure Synapse Analytics

Cria ou atualiza as configurações de firewall em nível de servidor para seu servidor do Banco de Dados SQL. Esse procedimento armazenado só está disponível no banco de dados mestre para o logon principal no nível do servidor ou atribuído Azure Active Directory principal.

Sintaxe

sp_set_firewall_rule [@name =] 'name', 
    [@start_ip_address =] 'start_ip_address', 
    [@end_ip_address =] 'end_ip_address'
[ ; ]  

Argumentos

A tabela a seguir demonstra os argumentos e opções com suporte em Microsoft Banco de Dados SQL do Azure .

Nome Datatype Descrição
[ @name =] 'name' NVARCHAR(128) O nome usado para descrever e distinguir a configuração de firewall de nível de servidor. O valor passado deve corresponder ao tipo de dados desse parâmetro (NVARCHAR).
[ @start_ip_address =] 'start_ip_address' VARCHAR(50) O endereço IP mais baixo no intervalo da configuração do firewall em nível de servidor. Os endereços IP iguais a ou maiores que esse podem tentar se conectar ao servidor do Banco de Dados SQL. O endereço IP mais baixo possível é 0.0.0.0.
[ @end_ip_address =] 'end_ip_address' VARCHAR(50) O endereço IP mais alto no intervalo da configuração do firewall em nível de servidor. Os endereços IP iguais a ou menores que esse podem tentar se conectar ao servidor do Banco de Dados SQL. O endereço IP mais alto possível é 255.255.255.255.

Observação: as tentativas de conexão do Azure são permitidas quando esse campo e o campo start_ip_address é igual a 0.0.0.0 .

Comentários

Os nomes das configurações de firewall de nível de servidor devem ser exclusivos. Se o nome da configuração fornecida para o procedimento armazenado já existir na tabela de configurações de firewall, os endereços IP inicial e final serão atualizados. Caso contrário, uma nova configuração de firewall de nível de servidor será criada.

Ao adicionar uma configuração de firewall no nível de servidor em que os endereços IP inicial e final são iguais a 0.0.0.0, você habilita o acesso ao seu servidor do Banco de Dados SQL a partir do Azure. Forneça um valor para o parâmetro name que ajudará você a se lembrar do que é a configuração de firewall no nível do servidor.

Em Banco de Dados SQL, dados de logon necessários para autenticar uma conexão e as regras de firewall no nível de servidor são armazenados em cache temporariamente em cada banco de dados. Esse cache é atualizado periodicamente. Para forçar uma atualização do cache de autenticação e garantir que um banco de dados tenha a versão mais recente da tabela de logons, execute DBCC FLUSHAUTHCACHE (Transact-SQL).

Esse é um procedimento armazenado estendido, portanto, o tipo de dados do valor passado para cada parâmetro deve corresponder à definição do parâmetro.

Permissões

Somente o logon principal no nível do servidor criado pelo processo de provisionamento ou uma entidade Azure Active Directory entidade de segurança atribuída como administrador pode criar ou modificar regras de firewall no nível do servidor. O usuário deve estar conectado ao banco de dados mestre para executar sp_set_firewall_rule.

Exemplos

O código a seguir cria uma configuração de firewall no nível de servidor chamada Allow Azure que habilita o acesso a partir do Azure. Execute o seguinte no banco de dados mestre virtual.

-- Enable Azure connections.  
exec sp_set_firewall_rule N'Allow Azure', '0.0.0.0', '0.0.0.0';  
  

O código a seguir cria uma configuração de firewall de nível de servidor chamada Example setting 1 somente para o endereço IP 0.0.0.2. Em seguida, o sp_set_firewall_rule procedimento armazenado é chamado novamente para atualizar o endereço IP final para , nessa 0.0.0.4 configuração de firewall. Isso cria um intervalo que permite que endereços IP 0.0.0.2 0.0.0.3 , e 0.0.0.4 acessem o servidor.

-- Create server-level firewall setting for only IP 0.0.0.2  
exec sp_set_firewall_rule N'Example setting 1', '0.0.0.2', '0.0.0.2';  
  
-- Update server-level firewall setting to create a range of allowed IP addresses
exec sp_set_firewall_rule N'Example setting 1', '0.0.0.2', '0.0.0.4';  
  

Consulte Também

Banco de Dados SQL do Azure firewall
Como configurar o firewall Configurações (Banco de Dados SQL do Azure)
sys.firewall_rules (Banco de Dados SQL do Azure)