创建或更新您的 Windows Azure SQL Database 实例的数据库级防火墙规则。 此存储过程在 master 数据库以及用户数据库中不可用。
适用范围:Windows Azure SQL Database(初始版本到当前版本)。 |
语法
sp_set_database_firewall_rule [@name = ] 'name'
, [@start_ip_address =] 'start_ip_address'
, [@end_ip_address =] 'end_ip_address'
参数
[@name = ] 'name'
用来描述和区分数据库级防火墙设置的名称。 name 的数据类型为 nvarchar(128),无默认值。[@start_ip_address =] 'start_ip_address'
数据库级防火墙设置范围内的最低 IP 地址。 等于或大于此值的 IP 地址可能尝试连接到 SQL Database 实例。 可能的最低 IP 地址为 0.0.0.0。 start_ip_address 的数据类型为 varchar(50),无默认值。[@end_ip_address =] 'end_ip_address'
数据库级防火墙设置范围内的最高 IP 地址。 等于或小于此值的 IP 地址可能尝试连接到 SQL Database 实例。 可能的最高 IP 地址为 255.255.255.255。 end_ip_address 的数据类型为 varchar(50),无默认值。
下表说明了 SQL Database 中支持的参数和选项。
备注
当此字段和 start_ip_address 字段都等于 0.0.0.0 时,允许 Windows Azure 连接尝试。
注释
数据库的数据库级防火墙设置的名称必须是唯一的。 如果为存储过程提供的数据库级防火墙设置的名称在数据库级防火墙设置表中已经存在,则将更新开始和结束 IP 地址。 否则,将创建新的数据库级防火墙设置。
如果您添加了一个数据库级防火墙设置,其中开始和结束 IP 地址等于 0.0.0.0,则应从 Windows Azure 中启用对 SQL Database 服务器中数据库的访问。 向可帮助您记住防火墙设置的目的的 name 参数提供一个值。
权限
只有由设置过程创建的服务器级主体登录名才可以创建或修改数据库级防火墙规则。
示例
以下代码创建一个名为 Allow Windows Azure 的数据库级防火墙设置,使您能够从 Windows Azure 访问您的数据库。
-- Enable Windows Azure connections.
EXECUTE sp_set_database_firewall_rule N'Allow Windows Azure','0.0.0.0','0.0.0.0';
以下代码仅为 IP 地址 0.0.0.4 创建一个称为 Example DB Setting 1 的数据库级防火墙设置。 然后,再次调用 sp_set_database firewall_rule 存储过程,以允许在该防火墙设置中加入另一个 IP 地址 0.0.0.5。
-- Create database-level firewall setting for only IP 0.0.0.4
EXECUTE sp_set_database_firewall_rule N'Example DB Setting 1','0.0.0.4','0.0.0.4';
-- Update database-level firewall setting to also allow IP 0.0.0.5
EXECUTE sp_set_database_firewall_rule N'Example DB Setting 1','0.0.0.4','0.0.0.5';