sp_set_database_firewall_rule (Azure SQL Database)sp_set_database_firewall_rule (Azure SQL Database)

SE APLICA A: noSQL Server síAzure SQL Database noAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: noSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Crea o actualiza las reglas de firewall de nivel de base de datos para su Base de datos SQL de AzureAzure SQL Database.Creates or updates the database-level firewall rules for your Base de datos SQL de AzureAzure SQL Database. Las reglas de firewall de base de datos se pueden configurar para la maestro base de datos y para las bases de datos de usuario en SQL DatabaseSQL Database.Database firewall rules can be configured for the master database, and for user databases on SQL DatabaseSQL Database. Las reglas de firewall de base de datos son especialmente útiles cuando utilizando los usuarios de base de datos de contenido.Database firewall rules are particularly useful when using contained database users. Para obtener más información, vea Usuarios de base de datos independiente: hacer que la base de datos sea portátil.For more information, see Contained Database Users - Making Your Database Portable.

SintaxisSyntax


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

ArgumentosArguments

[@name =] [N]'nombre'[@name = ] [N]'name'
El nombre utilizado para describir y distinguir la configuración del firewall de nivel de base de datos.The name used to describe and distinguish the database-level firewall setting. nombre es nvarchar (128) con ningún valor predeterminado.name is nvarchar(128) with no default value. El identificador de Unicode N es opcional para SQL DatabaseSQL Database.The Unicode identifier N is optional for SQL DatabaseSQL Database.

[@start_ip_address =] 'start_ip_address'[@start_ip_address =] 'start_ip_address'
La dirección IP más baja en el intervalo de la configuración del firewall de nivel de base de datos.The lowest IP address in the range of the database-level firewall setting. Las direcciones IP iguales o superiores a esta pueden intentar conectarse con la instancia de SQL DatabaseSQL Database.IP addresses equal to or greater than this can attempt to connect to the SQL DatabaseSQL Database instance. La dirección IP más baja posible es 0.0.0.0.The lowest possible IP address is 0.0.0.0. start_ip_address es varchar (50) con ningún valor predeterminado.start_ip_address is varchar(50) with no default value.

[@end_ip_address =] 'end_ip_address'[@end_ip_address =] 'end_ip_address'
La dirección IP más alta en el intervalo de la configuración del firewall de nivel de base de datos.The highest IP address in the range of the database-level firewall setting. Las direcciones IP iguales o inferiores a esta pueden intentar conectarse con la instancia de SQL DatabaseSQL Database.IP addresses equal to or less than this can attempt to connect to the SQL DatabaseSQL Database instance. La dirección IP más alta posible es 255.255.255.255.The highest possible IP address is 255.255.255.255. end_ip_address es varchar (50) con ningún valor predeterminado.end_ip_address is varchar(50) with no default value.

En la tabla siguiente se muestran los argumentos admitidos y opciones en SQL DatabaseSQL Database.The following table demonstrates the supported arguments and options in SQL DatabaseSQL Database.

Nota

Se permiten los intentos de conexión de Azure cuando este campo y el start_ip_address campo equals 0.0.0.0.Azure connection attempts are allowed when both this field and the start_ip_address field equals 0.0.0.0.

ComentariosRemarks

Los nombres de la configuración del firewall de nivel de base de datos para una base de datos deben ser únicos.The names of database-level firewall settings for a database must be unique. Si el nombre de la configuración del firewall de nivel de base de datos proporcionado para el procedimiento almacenado ya existe en la tabla de configuración del firewall de nivel de base de datos, las direcciones IP inicial y final se actualizarán.If the name of the database-level firewall setting provided for the stored procedure already exists in the database-level firewall settings table, the starting and ending IP addresses will be updated. De lo contrario, se creará una nueva configuración del firewall de nivel de base de datos.Otherwise, a new database-level firewall setting will be created.

Cuando se agrega una configuración de firewall de nivel de base de datos donde el principio y final de las direcciones IP son iguales a 0.0.0.0, habilitar el acceso a la base de datos en el SQL DatabaseSQL Database servidor desde cualquier recurso de Azure.When you add a database-level firewall setting where the beginning and ending IP addresses are equal to 0.0.0.0, you enable access to your database in the SQL DatabaseSQL Database server from any Azure resource. Proporcione un valor para el nombre parámetro que le ayudarán a recordar lo que es la configuración del firewall para.Provide a value to the name parameter that will help you remember what the firewall setting is for.

PermisosPermissions

Necesita el permiso CONTROL en la base de datos.Requires CONTROL permission on the database.

EjemplosExamples

El código siguiente crea un firewall de nivel de base de datos llamada Allow Azure que permite el acceso a la base de datos de Azure.The following code creates a database-level firewall setting called Allow Azure that enables access to your database from Azure.

-- Enable Azure connections.  
EXECUTE sp_set_database_firewall_rule N'Allow Azure', '0.0.0.0', '0.0.0.0';  

El código siguiente crea una configuración del firewall de nivel de base de datos denominada Example DB Setting 1 solo para la dirección IP 0.0.0.4.The following code creates a database-level firewall setting called Example DB Setting 1 for only the IP address 0.0.0.4. A continuación, la sp_set_database firewall_rule se llama al procedimiento almacenado nuevo para actualizar la dirección IP final 0.0.0.6, ya que la configuración de firewall.Then, the sp_set_database firewall_rule stored procedure is called again to update the end IP address to 0.0.0.6, in that firewall setting. Esto crea un intervalo que permite a las direcciones IP 0.0.0.4, 0.0.0.5, y 0.0.0.6 para tener acceso a la base de datos.This creates a range which allows IP addresses 0.0.0.4, 0.0.0.5, and 0.0.0.6 to access the database.

-- 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 create a range of allowed IP addresses
EXECUTE sp_set_database_firewall_rule N'Example DB Setting 1', '0.0.0.4', '0.0.0.6';  

Vea tambiénSee Also

Firewall de base de datos SQL Azure Azure SQL Database Firewall
Cómo: configurar el Firewall (Azure SQL Database) How to: Configure Firewall Settings (Azure SQL Database)
sp_set_firewall_rule (Azure SQL Database) sp_set_firewall_rule (Azure SQL Database)
sp_delete_database_firewall_rule (Azure SQL Database) sp_delete_database_firewall_rule (Azure SQL Database)
Sys.database_firewall_rules (Azure SQL Database)sys.database_firewall_rules (Azure SQL Database)