sp_set_firewall_rule (Database di SQL Azure)sp_set_firewall_rule (Azure SQL Database)

SI APPLICA A: noSQL Server sìDatabase SQL di Azure sìAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: noSQL Server yesAzure SQL Database yesAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Crea o aggiorna le impostazioni del firewall a livello di server per il server del Database SQLSQL Database.Creates or updates the server-level firewall settings for your Database SQLSQL Database server. Questa stored procedure è disponibile solo nel database master per l'account di accesso dell'entità di livello server o assegnata Azure Active Directory entità di protezione.This stored procedure is only available in the master database to the server-level principal login or assigned Azure Active Directory principal.

SintassiSyntax

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

ArgomentiArguments

Nella tabella seguente vengono illustrati gli argomenti e le opzioni supportati in MicrosoftMicrosoft Database SQL di AzureAzure SQL Database.The following table demonstrates the supported arguments and options in MicrosoftMicrosoft Database SQL di AzureAzure SQL Database.

NameName DatatypeDatatype DescrizioneDescription
[@name =] nome[@name =] 'name' NVARCHAR(128)NVARCHAR(128) Nome utilizzato per descrivere e distinguere l'impostazione del firewall a livello di server.The name used to describe and distinguish the server-level firewall setting.
[@start_ip_address =] ' start_ip_address '[@start_ip_address =] 'start_ip_address' VARCHAR(50)VARCHAR(50) L'indirizzo IP più basso nell'intervallo dell'impostazione del firewall a livello di server.The lowest IP address in the range of the server-level firewall setting. Gli indirizzi IP uguali o maggiori di questo possono tentare la connessione al server del Database SQLSQL Database.IP addresses equal to or greater than this can attempt to connect to the Database SQLSQL Database server. L'indirizzo IP più basso possibile è 0.0.0.0.The lowest possible IP address is 0.0.0.0.
[@end_ip_address =] ' end_ip_address '[@end_ip_address =] 'end_ip_address' VARCHAR(50)VARCHAR(50) L'indirizzo IP più alto nell'intervallo dell'impostazione del firewall a livello di server.The highest IP address in the range of the server-level firewall setting. Gli indirizzi IP uguali o minori di questo possono tentare la connessione al server del Database SQLSQL Database.IP addresses equal to or less than this can attempt to connect to the Database SQLSQL Database server. L'indirizzo IP più alto possibile è 255.255.255.255.The highest possible IP address is 255.255.255.255.

Nota: i tentativi di connessione di Azure sono consentiti quando sia questo campo che il campo start_ip_address sono uguali 0.0.0.0.Note: Azure connection attempts are allowed when both this field and the start_ip_address field equals 0.0.0.0.

OsservazioniRemarks

I nomi delle impostazioni del firewall a livello di server devono essere univoci.The names of server-level firewall settings must be unique. Se il nome dell'impostazione fornito per la stored procedure esiste già nella tabella delle impostazioni del firewall, gli indirizzi IP iniziale e finale verranno aggiornati.If the name of the setting provided for the stored procedure already exists in the firewall settings table, the starting and ending IP addresses will be updated. In caso contrario, verrà creata una nuova impostazione del firewall a livello di server.Otherwise, a new server-level firewall setting will be created.

Quando si aggiunge un'impostazione del firewall a livello di server in cui gli indirizzi IP iniziale e finale sono uguali a 0.0.0.0, si Abilita l'accesso al server Database SQLSQL Database da Azure.When you add a server-level firewall setting where the beginning and ending IP addresses are equal to 0.0.0.0, you enable access to your Database SQLSQL Database server from Azure. Fornire un valore al parametro Name che consenta di ricordare l'impostazione del firewall a livello di server.Provide a value to the name parameter that will help you remember what the server-level firewall setting is for.

In Database SQLSQL Database, i dati dell'account di accesso necessari per autenticare una connessione e le regole del firewall a livello di server vengono memorizzati temporaneamente nella cache in ogni database.In Database SQLSQL Database, login data required to authenticate a connection and server-level firewall rules are temporarily cached in each database. Questa cache viene aggiornata periodicamente.This cache is periodically refreshed. Per forzare un aggiornamento della cache di autenticazione e assicurarsi che un database disponga della versione più recente della tabella di account di accesso, eseguire DBCC FLUSHAUTHCACHE (Transact-SQL).To force a refresh of the authentication cache and make sure that a database has the latest version of the logins table, execute DBCC FLUSHAUTHCACHE (Transact-SQL).

AutorizzazioniPermissions

Solo l'account di accesso dell'entità di livello server creato dal processo di provisioning o un'entità Azure Active Directory assegnata come amministratore può creare o modificare le regole del firewall a livello di server.Only the server-level principal login created by the provisioning process or an Azure Active Directory principal assigned as admin can create or modify server level firewall rules. Per eseguire sp_set_firewall_rule, l'utente deve essere connesso al database master.The user must be connected to the master database to execute sp_set_firewall_rule.

EsempiExamples

Il codice seguente crea un'impostazione del firewall a livello di server denominata Allow Azure che consente l'accesso da Azure.The following code creates a server-level firewall setting called Allow Azure that enables access from Azure. Eseguire il comando seguente nel database master virtuale.Execute the following in the virtual master database.

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

Il codice seguente consente di creare un'impostazione del firewall a livello di server denominata Example setting 1 solo per l'indirizzo IP 0.0.0.2.The following code creates a server-level firewall setting called Example setting 1 for only the IP address 0.0.0.2. Quindi, il sp_set_firewall_rule stored procedure viene richiamato per aggiornare l'indirizzo IP finale a 0.0.0.4, in tale impostazione del firewall.Then, the sp_set_firewall_rule stored procedure is called again to update the end IP address to 0.0.0.4, in that firewall setting. Viene creato un intervallo che consente agli indirizzi IP 0.0.0.2, 0.0.0.3e 0.0.0.4 di accedere al server.This creates a range which allows IP addresses 0.0.0.2, 0.0.0.3, and 0.0.0.4 to access the server.

-- 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';  
  

Vedere ancheSee Also

del firewall del database SQL di AzureAzure SQL Database Firewall
Procedura: configurare le impostazioni del firewall (database SQL di Azure) How to: Configure Firewall Settings (Azure SQL Database)
sys. firewall_rules (database SQL di Azure)sys.firewall_rules (Azure SQL Database)