sp_set_database_firewall_rule (Banco de Dados SQL do Azure)

Aplica-se a: Banco de Dados SQL do Azure

Cria ou atualiza as regras de firewall no nível do banco de dados para o Banco de Dados SQL do Azure. As regras de firewall do banco de dados podem ser configuradas para o banco de dados master e para bancos de dados de usuário no Banco de Dados SQL. As regras de firewall de banco de dados podem ser úteis ao usar usuários de banco de dados independente. Para obter mais informações, consulte Tornar seu banco de dados portátil usando bancos de dados independentes.

Sintaxe

sp_set_database_firewall_rule
    [ @name = ] N'name'
    , [ @start_ip_address = ] 'start_ip_address'
    , [ @end_ip_address = ] 'end_ip_address'
[ ; ]

Argumentos

@name [ = ] N'nome'

O nome usado para descrever e distinguir a configuração de firewall de nível de banco de dados. @name é nvarchar(128) sem padrão.

@start_ip_address [ = ] 'start_ip_address'

O endereço IP mais baixo no intervalo da configuração do firewall em nível de banco de dados. Endereços IP iguais ou maiores que esse valor podem tentar se conectar à instância do Banco de Dados SQL. O endereço IP mais baixo possível é 0.0.0.0. @start_ip_address é varchar(50) sem padrão.

@end_ip_address [ = ] 'end_ip_address'

O endereço IP mais alto no intervalo da configuração do firewall em nível de banco de dados. Endereços IP iguais ou menores que esse valor podem tentar se conectar à instância do Banco de Dados SQL. O endereço IP mais alto possível é 255.255.255.255. @end_ip_address é varchar(50) sem padrão.

A tabela a seguir demonstra os argumentos e as opções com suporte no Banco de Dados SQL.

Observação

As tentativas de conexão do Azure são permitidas quando esse campo e o campo @start_ip_address são 0.0.0.0iguais.

Comentários

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

Ao adicionar uma configuração de firewall no nível do banco de dados em que os endereços IP inicial e final são iguais a 0.0.0.0, você habilita o acesso ao banco de dados no servidor do Banco de Dados SQL de qualquer recurso do Azure. Forneça um valor para o parâmetro @name que ajude você a lembrar para que serve a configuração do firewall.

Permissões

Requer a permissão CONTROL no banco de dados.

Exemplos

O código a seguir cria uma configuração de firewall no nível do banco de dados chamada Allow Azure que permite o acesso ao banco de dados do Azure.

EXECUTE sp_set_database_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 banco de dados chamada Example DB Setting 1 somente para o endereço IP 0.0.0.4. Em seguida, o procedimento armazenado sp_set_database firewall_rule é chamado novamente para atualizar o endereço IP final para 0.0.0.6, nessa configuração de firewall. Este exemplo cria um intervalo que permite que os endereços 0.0.0.4IP , 0.0.0.5, e 0.0.0.6 acessem o banco de dados.

  • Crie uma configuração de firewall no nível do banco de dados apenas para o IP 0.0.0.4:

    EXECUTE sp_set_database_firewall_rule N'Example DB Setting 1', '0.0.0.4', '0.0.0.4';
    
  • Atualize a configuração do firewall no nível do banco de dados para criar um intervalo de endereços IP permitidos:

    EXECUTE sp_set_database_firewall_rule N'Example DB Setting 1', '0.0.0.4', '0.0.0.6';