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

Se aplica a:Applies to: SíAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database SíInstancia administrada de Azure SQLAzure SQL Managed InstanceYesInstancia administrada de Azure SQLAzure SQL Managed InstanceSe aplica a:Applies to: SíAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database SíInstancia administrada de Azure SQLAzure SQL Managed InstanceYesInstancia administrada de Azure SQLAzure SQL Managed Instance

Crea o actualiza las reglas de Firewall de nivel de base de datos para Azure SQL DatabaseAzure SQL Database .Creates or updates the database-level firewall rules for your Azure SQL DatabaseAzure SQL Database. Las reglas de Firewall de base de datos se pueden configurar para la base de datos maestra 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 se usan usuarios de bases de datos independientes.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]'name'El nombre que se usa para describir y distinguir la configuración de Firewall de nivel de base de datos.[ @name = ] [N]'name' The name used to describe and distinguish the database-level firewall setting. Name es de tipo nvarchar (128) y no tiene ningún valor predeterminado.name is nvarchar(128) with no default value. El identificador Unicode N es opcional para SQL DatabaseSQL Database .The Unicode identifier N is optional for SQL DatabaseSQL Database.

[ @start_ip_address = ] 'start_ip_address'La dirección IP más baja en el intervalo de la configuración de Firewall de nivel de base de datos.[ @start_ip_address = ] 'start_ip_address' 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 de tipo VARCHAR (50) y no tiene ningún valor predeterminado.start_ip_address is varchar(50) with no default value.

[ @end_ip_address = ] 'end_ip_address'La dirección IP más alta en el intervalo de la configuración de Firewall de nivel de base de datos.[ @end_ip_address = ] 'end_ip_address' 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 de tipo VARCHAR (50) y no tiene ningún valor predeterminado.end_ip_address is varchar(50) with no default value.

En la tabla siguiente se muestran los argumentos y las opciones admitidos 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 campo start_ip_address es igual a 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 las direcciones IP inicial y final son iguales a 0.0.0.0 , se habilita 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 al parámetro Name que le ayude a recordar para qué sirve la configuración de Firewall.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

En el código siguiente se crea una configuración de firewall de nivel de base de datos denominada Allow Azure que habilita el acceso a la base de datos desde 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, sp_set_database firewall_rule se llama de nuevo al procedimiento almacenado para actualizar la dirección IP final a 0.0.0.6 , en esa 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 que las direcciones IP 0.0.0.4 , 0.0.0.5 y 0.0.0.6 tengan 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';  
  

Consulte tambiénSee Also

Firewall de Azure SQL Database Azure SQL Database Firewall
Cómo configurar los valores del 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)