CREATE AVAILABILITY GROUP (Transact-SQL)

Si applica a: SQL Server

Crea un nuovo gruppo di disponibilità, se l'istanza di SQL Server è abilitata per la funzionalità Gruppi di disponibilità Always On.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

  
CREATE AVAILABILITY GROUP group_name  
   WITH (<with_option_spec> [ ,...n ] )  
   FOR [ DATABASE database_name [ ,...n ] ]  
   REPLICA ON <add_replica_spec> [ ,...n ]  
   AVAILABILITY GROUP ON <add_availability_group_spec> [ ,...2 ]  
   [ LISTENER 'dns_name' ( <listener_option> ) ]  
[ ; ]  
  
<with_option_spec>::=   
    AUTOMATED_BACKUP_PREFERENCE = { PRIMARY | SECONDARY_ONLY| SECONDARY | NONE }  
  | FAILURE_CONDITION_LEVEL  = { 1 | 2 | 3 | 4 | 5 }   
  | HEALTH_CHECK_TIMEOUT = milliseconds  
  | DB_FAILOVER  = { ON | OFF }   
  | DTC_SUPPORT  = { PER_DB | NONE }  
  | [ BASIC | DISTRIBUTED | CONTAINED [ REUSE_SYSTEM_DATABASES ] ]
  | REQUIRED_SYNCHRONIZED_SECONDARIES_TO_COMMIT = { integer }
  | CLUSTER_TYPE = { WSFC | EXTERNAL | NONE }
 
  
<add_replica_spec>::=  
  <server_instance> WITH  
    (  
       ENDPOINT_URL = 'TCP://system-address:port',  
       AVAILABILITY_MODE = { SYNCHRONOUS_COMMIT | ASYNCHRONOUS_COMMIT | CONFIGURATION_ONLY },  
       FAILOVER_MODE = { AUTOMATIC | MANUAL | EXTERNAL }  
       [ , <add_replica_option> [ ,...n ] ]  
    )   
  
  <add_replica_option>::=  
       SEEDING_MODE = { AUTOMATIC | MANUAL }  
     | BACKUP_PRIORITY = n  
     | SECONDARY_ROLE ( {   
            [ ALLOW_CONNECTIONS = { NO | READ_ONLY | ALL } ]   
        [,] [ READ_ONLY_ROUTING_URL = 'TCP://system-address:port' ]  
     } )  
     | PRIMARY_ROLE ( {   
            [ ALLOW_CONNECTIONS = { READ_WRITE | ALL } ]   
        [,] [ READ_ONLY_ROUTING_LIST = { ( '<server_instance>' [ ,...n ] ) | NONE } ]  
        [,] [ READ_WRITE_ROUTING_URL = { ( '<server_instance>' ) ] 
     } )  
     | SESSION_TIMEOUT = integer  
  
<add_availability_group_spec>::=  
 <ag_name> WITH  
    (  
       LISTENER_URL = 'TCP://system-address:port',  
       AVAILABILITY_MODE = { SYNCHRONOUS_COMMIT | ASYNCHRONOUS_COMMIT },  
       FAILOVER_MODE = MANUAL,  
       SEEDING_MODE = { AUTOMATIC | MANUAL }  
    )  
  
<listener_option> ::=  
   {  
      WITH DHCP [ ON ( <network_subnet_option> ) ]  
    | WITH IP ( { ( <ip_address_option> ) } [ , ...n ] ) [ , PORT = listener_port ]  
   }  
  
  <network_subnet_option> ::=  
     'ip4_address', 'four_part_ipv4_mask'    
  
  <ip_address_option> ::=  
     {   
        'ip4_address', 'pv4_mask'  
      | 'ipv6_address'  
     }  
  

Argomenti

group_name

Specifica il nome del nuovo gruppo di disponibilità. group_name deve essere un identificatore di SQL Server valido e deve essere univoco in tutti i gruppi di disponibilità nel cluster WSFC. La lunghezza massima consentita per il nome del gruppo di disponibilità è 128 caratteri.

AUTOMATED_BACKUP_PREFERENCE = { PRIMARY | SECONDARY_ONLY | SECONDARY | NONE }

Specifica le preferenze per la modalità di valutazione della replica primaria da parte di un processo di backup nella scelta della posizione in cui eseguire i backup. È possibile generare uno script affinché un processo di backup specifico prenda in considerazione le preferenze di backup automatico. È importante comprendere che la preferenza non viene applicata da SQL Server, di conseguenza non ha alcun impatto sui backup ad hoc.

I valori supportati sono i seguenti:

PRIMARY

Specifica che i backup devono essere sempre eseguiti sulla replica primaria. Questa opzione è utile se sono necessarie funzionalità di backup, ad esempio la creazione di backup differenziali, che non sono supportate quando il backup viene eseguito su una replica secondaria.

SECONDARY_ONLY

Specifica che i backup non devono mai essere eseguiti sulla replica primaria. Se la replica primaria è l'unica replica online, il backup non viene eseguito.

SECONDARY

Specifica che i backup devono essere eseguiti su una replica secondaria tranne quando la replica primaria è l'unica replica online. In tal caso il backup deve essere eseguito sulla replica primaria. Questo è il comportamento predefinito.

NONE

Specifica che si preferisce che i processi di backup ignorino il ruolo delle repliche di disponibilità nella scelta della replica per l'esecuzione dei backup. Si noti che i processi di backup potrebbero valutare altri fattori, ad esempio la priorità di backup di ogni replica di disponibilità in combinazione con lo stato operativo e lo stato connesso.

FAILURE_CONDITION_LEVEL = { 1 | 2 | 3 | 4 | 5 }

Specifica le condizioni di errore che attivano un failover automatico per il gruppo di disponibilità. FAILURE_CONDITION_LEVEL viene impostato a livello di gruppo ma è rilevante solo nelle repliche di disponibilità configurate per la modalità di disponibilità con commit sincrono (AVAILABILITY_MODE = SYNCHRONOUS_COMMIT). Le condizioni di errore possono attivare anche un failover automatico solo se entrambe le repliche, primaria e secondaria, sono configurate per la modalità di failover automatico (FAILOVER_MODE = AUTOMATIC) e la replica secondaria è attualmente sincronizzata con la replica primaria.

I livelli delle condizioni di errore (1-5) vanno dal livello 1, meno restrittivo, al livello 5, più restrittivo. Un livello di condizione specifico include tutti i livelli meno restrittivi. Il livello della condizione più restrittivo, ovvero il livello 5, include pertanto i quattro livelli della condizione meno restrittivi (1-4), il livello 4 include i livelli 1-3 e così via. Nella tabella seguente viene descritta la condizione di errore che corrisponde a ciascun livello.

Livello	Condizione di errore
1	Specifica che deve essere avviato un failover automatico quando si verifica una delle condizioni seguenti: - Il servizio SQL Server non è disponibile. - Il lease del gruppo di disponibilità per la connessione al cluster WSFC scade poiché non viene ricevuto alcun ACK dall'istanza del server. Per altre informazioni, vedere Funzionamento: timeout lease di SQL Server Always On.
2	Specifica che deve essere avviato un failover automatico quando si verifica una delle condizioni seguenti: - L'istanza di SQL Server non si connette al cluster e viene superata la soglia HEALTH_CHECK_TIMEOUT specificata dall'utente per il gruppo di disponibilità. - La replica di disponibilità si trova in uno stato di errore.
3	Specifica che deve essere avviato un failover automatico in caso di errori interni critici di SQL Server, ad esempio spinlock orfani, gravi violazioni dell'accesso in scrittura o dump eccessivo. Questo è il comportamento predefinito.
4	Specifica che deve essere avviato un failover automatico in caso di errori interni di SQL Server con gravità moderata, ad esempio una condizione persistente di memoria insufficiente nel pool di risorse interno di SQL Server.
5	Specifica che deve essere avviato un failover automatico in caso di qualsiasi condizione di errore qualificata, tra cui: - Esaurimento dei thread di lavoro del motore SQL. - Rilevamento di un deadlock irrisolvibile.

I valori FAILURE_CONDITION_LEVEL e HEALTH_CHECK_TIMEOUT definiscono criteri di failover flessibili per un gruppo specifico, fornendo un controllo granulare sulle condizioni che devono causare un failover automatico. Per altre informazioni, vedere Criteri di failover flessibili per failover automatico di un gruppo di disponibilità (SQL Server).

HEALTH_CHECK_TIMEOUT = milliseconds

Specifica il tempo di attesa in millisecondi per la restituzione delle informazioni sull'integrità del server da parte della stored procedure di sistema sp_server_diagnostics prima che il cluster WSFC presupponga che l'istanza del server sia lenta o non risponda. HEALTH_CHECK_TIMEOUT viene impostato a livello di gruppo ma è rilevante solo nelle repliche di disponibilità configurate per la modalità di disponibilità con commit sincrono che supportano il failover automatico (AVAILABILITY_MODE = SYNCHRONOUS_COMMIT). Un timeout del controllo di integrità può anche attivare un failover automatico solo se entrambe le repliche, primaria e secondaria, sono configurate per la modalità di failover automatico (FAILOVER_MODE = AUTOMATIC) e la replica secondaria è attualmente sincronizzata con la replica primaria.

Il valore predefinito di HEALTH_CHECK_TIMEOUT è 30000 millisecondi (30 secondi). Il valore minimo è 15000 millisecondi (15 secondi) e il valore massimo è 4294967295 millisecondi.

DB_FAILOVER = { ON | OFF }

Specifica la risposta da accettare quando un database nella replica primaria è offline. Se impostata su ON, qualsiasi stato diverso da ONLINE per un database del gruppo di disponibilità attiva un failover automatico. Se l'opzione è impostata su OFF, viene usata solo l'integrità dell'istanza per attivare il failover automatico.

Per altre informazioni su questa impostazione, vedere Opzione di failover di rilevamento dell'integrità a livello di database

DTC_SUPPORT = { PER_DB | NONE }

Si applica a: SQL Server, a partire da SQL Server 2016 (13.x)

Specifica se le transazioni tra database sono supportate usando il controllo DTC (Distributed Transaction Coordinator). Le transazioni tra database sono supportate solo a partire da SQL Server 2016 (13.x). PER_DB crea il gruppo di disponibilità con il supporto per queste transazioni. Per altre informazioni, vedere Transazioni tra database e transazioni distribuite per Gruppi di disponibilità Always On e mirroring del database (SQL Server).

BASIC

Si applica a: SQL Server, a partire da SQL Server 2016 (13.x)

Consente di creare un gruppo di disponibilità di base. I gruppi di disponibilità di base sono limitati a un database e due repliche: una replica primaria e una replica secondaria. Questa opzione sostituisce la funzionalità di mirroring del database di SQL Server Standard Edition ora deprecata. Per altre informazioni, vedere Gruppi di disponibilità di base (Gruppi di disponibilità Always On). I gruppi di disponibilità di base sono supportati a partire da SQL Server 2016 (13.x).

DISTRIBUTED

Si applica a: SQL Server, a partire da SQL Server 2016 (13.x)

Consente di creare un gruppo di disponibilità distribuito. Questa opzione viene usata con il parametro AVAILABILITY GROUP ON per la connessione di due gruppi di disponibilità in cluster di failover separati di Windows Server. Per altre informazioni, vedere Gruppi di disponibilità distribuiti (Gruppi di disponibilità Always On). I gruppi di disponibilità distribuiti sono supportati a partire da SQL Server 2016 (13.x).

CONTAINED [REUSE_SYSTEM_DATABASES]

Introdotto in SQL Server 2022 (16.x)

Crea un gruppo di disponibilità indipendente. Questa opzione consente di creare un gruppo di disponibilità con i relativi database master e msdb, che vengono mantenuti sincronizzati nel set di repliche nel gruppo di disponibilità.
L'opzione REUSE_SYSTEM_DATABASES fa in modo che i database master e msdb indipendenti di una versione precedente del gruppo di disponibilità vengano usati nella creazione di questo nuovo gruppo di disponibilità. Per altre informazioni sui gruppi di disponibilità indipendenti, vedere Panoramica dei gruppi di disponibilità indipendenti (Gruppi di disponibilità Always On).

REQUIRED_SYNCHRONIZED_SECONDARIES_TO_COMMIT

Si applica a: SQL Server, a partire da SQL Server 2017 (14.x)

REQUIRED_SYNCHRONIZED_SECONDARIES_TO_COMMIT

Introdotto in SQL Server 2017 (14.x). Imposta un numero minimo di repliche secondarie sincrone necessarie per il commit prima del commit della replica primaria. Garantisce che le transazioni di SQL Server attendano l'aggiornamento dei log delle transazioni sul numero minimo di repliche secondarie.

• Predefinito: 0. Fornisce lo stesso comportamento di SQL Server 2016 (13.x).
• Minimo: 0.
• Massimo: numero di repliche meno 1.

REQUIRED_SYNCHRONIZED_SECONDARIES_TO_COMMIT si riferisce alle repliche in modalità commit sincrono. Quando le repliche sono in modalità commit sincrono, le scritture nella replica primaria attendono fino a quando le scritture nelle repliche sincrone eseguono il commit nel log delle transazioni del database di replica. Se un'istanza di SQL Server che ospita una replica sincrona secondaria smette di rispondere, SQL Server che ospita la replica primaria contrassegna tale replica secondaria come NOT SYNCHRONIZED e procede. Quando il database non risponde torna online, si trova in uno stato "non sincronizzato" e la replica viene contrassegnata come non integra fino a quando il database primario non può eseguire di nuovo la sincronizzazione. Questa impostazione garantisce che la replica primaria non procede fino a quando non viene eseguito il commit del numero minimo di repliche di ogni transazione. Se il numero minimo di repliche non è disponibile, i commit nel database primario hanno esito negativo. Per il tipo di cluster EXTERNAL l'impostazione viene modificata quando il gruppo di disponibilità viene aggiunto a una risorsa cluster. Vedere Elevata disponibilità e protezione dei dati per le configurazioni di gruppo di disponibilità.

Non supportato per CREATE AVAILABILITY GROUP. A partire da SQL Server 2022 (16.x), è possibile usare ALTER AVAILABILITY GROUP per impostare REQUIRED_SYNCHRONIZED_SECONDARIES_TO_COMMIT in un gruppo di disponibilità distribuito. Vedere ALTER AVAILABILITY GROUP (Transact-SQL).

CLUSTER_TYPE

Si applica a: SQL Server, a partire da SQL Server 2017 (14.x).

Consente di verificare se il gruppo di disponibilità è in un cluster di failover di Windows Server (WSFC). Impostare su WSFC quando il gruppo di disponibilità si trova in un'istanza di failover in un cluster di failover di Windows Server. Impostare su EXTERNAL se il cluster è gestito da una soluzione di gestione cluster che non è un cluster di failover di Windows Server, ad esempio Linux Pacemaker. Impostare su NONE se il gruppo di disponibilità non usa WSFC per il coordinamento dei cluster. Ad esempio, quando un gruppo di disponibilità include i server Linux senza gestione dei cluster.

DATABASE database_name

Specifica un elenco di uno o più database utente nell'istanza di SQL Server locale, ovvero l'istanza del server in cui si sta creando il gruppo di disponibilità. È possibile specificare più database per un gruppo di disponibilità, ma ogni database può appartenere a un solo gruppo di disponibilità. Per informazioni sul tipo di database che un gruppo di disponibilità può supportare, vedere Prerequisiti, restrizioni e consigli per i gruppi di disponibilità Always On (SQL Server). Per individuare i database locali già appartenenti a un gruppo di disponibilità, vedere la colonna replica_id nella vista del catalogo sys.databases.

La clausola DATABASE è facoltativa. Se omessa, il nuovo gruppo di disponibilità è vuoto.

Dopo aver creato il gruppo di disponibilità, connettersi a ogni istanza del server in cui è ospitata una replica secondaria, quindi preparare ogni database secondario e aggiungerlo al gruppo di disponibilità. Per altre informazioni, vedere Avviare lo spostamento dati su un database secondario Always On (SQL Server).

REPLICA ON

Specifica da una a cinque istanze di SQL Server per ospitare repliche di disponibilità nel nuovo gruppo di disponibilità. Ogni replica viene specificata dall'indirizzo della relativa istanza del server seguito da una clausola WITH (...). È necessario specificare almeno l'istanza del server locale, che diventa la replica primaria iniziale. È eventualmente possibile specificare anche un massimo di quattro repliche secondarie.

È necessario creare un join di ogni replica secondaria al gruppo di disponibilità. Per altre informazioni, vedere ALTER AVAILABILITY GROUP (Transact-SQL).

server_instance

Specifica l'indirizzo dell'istanza di SQL Server in cui viene ospitata una replica. Il formato dell'indirizzo dipende dal fatto che l'istanza sia l'istanza predefinita o un'istanza denominata e se si tratti di un'istanza autonoma o un'istanza del cluster di failover (FCI), come segue:

{ '*system_name*[\\*instance_name*]' | '*FCI_network_name*[\\*instance_name*]' }

I componenti di questo indirizzo sono i seguenti:

_sistema

Nome NetBIOS del computer in cui si trova l'istanza di destinazione di SQL Server. Il computer deve essere un nodo WSFC.

nome_rete_FCI

Nome di rete usato per accedere a un cluster di failover di SQL Server. Usare questo nome se l'istanza del server partecipa come partner di failover di SQL Server. L'esecuzione di SELECT@@SERVERNAME in un'istanza del server FCI restituisce l'intera stringa "FCI_network_name[\instance_name]", che corrisponde al nome completo della replica.

instance_name

Nome di un'istanza di SQL Server ospitata da system_name o FCI_network_name e per la quale il servizio di disponibilità elevata e ripristino di emergenza (HADR) è abilitato. Per un'istanza del server predefinita, nome_istanza è facoltativo. Per il nome dell'istanza non viene fatta distinzione tra maiuscole e minuscole. In un'istanza denominata il nome del valore corrisponde al valore restituito dall'esecuzione di select ServerProperty(N'InstanceName');.

\

Separatore usato solo quando si specifica instance_name per separarlo da system_name o FCI_network_name.

Per informazioni sui prerequisiti per i nodi WSFC e le istanze del server, vedere Prerequisiti, restrizioni e consigli per i gruppi di disponibilità Always On (SQL Server).

ENDPOINT_URL ='TCP://system-address:port'

Specifica il percorso URL per l'endpoint di mirroring del database nell'istanza di SQL Server che ospita la replica di disponibilità che si sta definendo nella clausola REPLICA ON corrente.

La clausola ENDPOINT_URL è obbligatoria. Per altre informazioni, vedere Specificare l'URL dell'endpoint quando si aggiunge o si modifica una replica di disponibilità (SQL Server).

'TCP://system-address:port'

Specifica un URL per definire un URL di endpoint o un URL di routing di sola lettura. I parametri URL sono i seguenti:

system-address

Stringa, ad esempio un nome di sistema, un nome di dominio completo o un indirizzo IP, che identifica in modo univoco il computer di destinazione.

port

Numero di porta associato all'endpoint di mirroring dell'istanza del server partner (per l'opzione ENDPOINT_URL) o numero di porta usato dal motore di database dell'istanza del server (per l'opzione READ_ONLY_ROUTING_URL).

AVAILABILITY_MODE = {SYNCHRONOUS_COMMIT | ASYNCHRONOUS_COMMIT | CONFIGURATION_ONLY }

SYNCHRONOUS_COMMIT o ASYNCHRONOUS_COMMIT specifica se la replica primaria deve attendere la conferma della finalizzazione (scrittura) dei record del log su disco da parte della replica secondaria prima di poter eseguire il commit della transazione in un database primario specifico. Il commit delle transazioni in database diversi della stessa replica primaria può essere eseguito indipendentemente. SQL Server 2017 (14.x) CU1 introduce CONFIGURATION_ONLY. La replica CONFIGURATION_ONLY si applica solo ai gruppi di disponibilità con CLUSTER_TYPE = EXTERNAL o CLUSTER_TYPE = NONE.

SYNCHRONOUS_COMMIT

Specifica che la replica primaria esegue il commit delle transazioni solo dopo la finalizzazione nella replica secondaria (modalità con commit sincrono). È possibile specificare SYNCHRONOUS_COMMIT per un massimo di tre repliche, inclusa la replica primaria.

ASYNCHRONOUS_COMMIT

Specifica che la replica primaria esegue il commit delle transazioni senza attendere la finalizzazione del log da parte della replica secondaria (modalità di disponibilità con commit sincrono). È possibile specificare ASYNCHRONOUS_COMMIT per un massimo di cinque repliche di disponibilità, inclusa la replica primaria.

CONFIGURATION_ONLY

Specifica che la replica primaria esegue il commit in modo sincrono dei metadati di configurazione del gruppo di disponibilità nel database master in questa replica. La replica non conterrà dati utente. Questa opzione:

• Può essere ospitata in qualsiasi edizione di SQL Server, inclusa la versione Express Edition.

• È necessario che l'endpoint del mirroring dei dati della replica CONFIGURATION_ONLY sia di tipo WITNESS.

• Non può essere modificata.

• Non è valida se CLUSTER_TYPE = WSFC.

• Le opzioni failover_mode e seeding_mode non sono supportate quando l'impostazione di availability_mode per una replica è configuration_only. È disponibile un esempio qui.

  Per altre informazioni, vedere l'argomento relativo alla replica di sola configurazione.

La clausola AVAILABILITY_MODE è obbligatoria. Per altre informazioni, vedere Modalità di disponibilità (Gruppi di disponibilità Always On).

FAILOVER_MODE = { AUTOMATIC | MANUAL }

Specifica la modalità di failover della replica di disponibilità che si sta definendo.

AUTOMATIC

Abilita il failover automatico. Questa opzione è supportata solo se si specifica anche AVAILABILITY_MODE = SYNCHRONOUS_COMMIT. È possibile specificare AUTOMATIC per due repliche di disponibilità, inclusa la replica primaria.

MANUAL

Abilita il failover manuale pianificato o il failover manuale forzato (in genere denominato failover forzato) da parte dell'amministratore del database.

La clausola FAILOVER_MODE è obbligatoria. I due tipi di failover manuale, failover manuale senza perdita di dati e failover forzato (con possibile perdita di dati), sono supportati a seconda delle diverse condizioni. Per altre informazioni, vedere Failover e modalità di failover (Gruppi di disponibilità Always On).

SEEDING_MODE = { AUTOMATIC | MANUAL }

Specifica in che modo viene eseguito il seeding iniziale della replica secondaria.

AUTOMATIC

Abilita il seeding diretto. Questo metodo esegue il seeding della replica secondaria in rete. Non richiede l'esecuzione del backup e il ripristino di una copia del database primario nella replica.

MANUAL

Specifica il seeding manuale (impostazione predefinita). Questo metodo richiede la creazione di un backup del database nella replica primaria e il ripristino manuale del backup nella replica secondaria.

BACKUP_PRIORITY = n

Specifica la priorità di esecuzione dei backup nella replica rispetto alle altre repliche nello stesso gruppo di disponibilità. Il valore è un numero intero compreso nell'intervallo 0-100. I valori hanno il significato seguente:

• 1..100 indica che la replica di disponibilità potrebbe essere scelta per l'esecuzione dei backup. 1 indica la priorità più bassa e 100 indica la priorità più alta. Se BACKUP_PRIORITY = 1, la replica di disponibilità verrà scelta per l'esecuzione dei backup solo se non sono attualmente disponibili repliche di disponibilità con priorità più alta.

• 0 indica che questa replica di disponibilità non è destinata all'esecuzione dei backup. Ciò si rivela utile, ad esempio, per una replica di disponibilità remota in cui non si desidera eseguire mai il failover dei backup.

Per altre informazioni, vedere Repliche secondarie attive: backup in repliche secondarie (Gruppi di disponibilità Always On).

SECONDARY_ROLE ( ... )

Specifica le impostazioni specifiche del ruolo che vengono applicate se questa replica di disponibilità è attualmente proprietaria del ruolo secondario, ovvero ogni volta che è una replica secondaria. All'interno delle parentesi, specificare una o entrambe opzioni per il ruolo secondario. Se si specificano entrambe, usare un elenco delimitato da virgole.

Le opzioni per il ruolo secondario sono le seguenti:

ALLOW_CONNECTIONS = { NO | READ_ONLY | ALL }

Specifica se i database di una determinata replica di disponibilità che esegue il ruolo secondario, ovvero che funge da replica secondaria, possono accettare connessioni dai client, ovvero:

NO

Non sono consentite connessioni utente ai database secondari di questa replica. I database non sono disponibili per l'accesso in lettura. Questo è il comportamento predefinito.

READ_ONLY

Sono consentite solo connessioni ai database nella replica secondaria nei casi in cui la proprietà Finalità dell'applicazione è impostata su ReadOnly. Per altre informazioni su questa proprietà, vedere Uso di parole chiave per le stringhe di connessione con SQL Server Native Client.

ALL

Sono consentite tutte le connessioni ai database nella replica secondaria per l'accesso in sola lettura.

Per altre informazioni, vedere Repliche secondarie attive: repliche secondarie leggibili (Gruppi di disponibilità Always On).

READ_ONLY_ROUTING_URL ='TCP://system-address:port'

Specifica l'URL da usare per il routing delle richieste di connessione con finalità di lettura a questa replica di disponibilità. Si tratta dell'URL sul quale è in ascolto il motore di database. In genere, l'istanza predefinita di SQL Server è in ascolto sulla porta TCP 1433.

Per un'istanza denominata, è possibile ottenere il numero di porta eseguendo una query sulle colonne port e type_desc della DMV sys.dm_tcp_listener_states. L'istanza del server usa il listener Transact-SQL (type_desc='TSQL').

Per altre informazioni sul calcolo dell'URL di routing di sola lettura per una replica, vedere Calcolo di read_only_routing_url per AlwaysOn.

PRIMARY_ROLE ( ... )

Indica le impostazioni specifiche del ruolo che verranno applicate se questa replica di disponibilità è attualmente proprietaria del ruolo primario, ovvero ogni volta che è una replica primaria. All'interno delle parentesi, specificare una o entrambe opzioni per il ruolo primario. Se si specificano entrambe, usare un elenco delimitato da virgole.

Le opzioni per il ruolo primario sono le seguenti:

ALLOW_CONNECTIONS = { READ_WRITE | ALL }

Specifica il tipo di connessione che i database di una determinata replica di disponibilità che esegue il ruolo primario, ovvero che funge da replica primaria, possono accettare dai client, tra cui:

READ_WRITE

Non sono consentite le connessioni in cui la proprietà di connessione Finalità dell'applicazione è impostata su ReadOnly . Se la proprietà Finalità dell'applicazione è impostata su Lettura/Scrittura o se tale proprietà non è impostata, la connessione è consentita. Per altre informazioni sulla proprietà di connessione Finalità dell'applicazione, vedere Uso di parole chiave per le stringhe di connessione con SQL Server Native Client.

ALL

Sono consentite tutte le connessioni ai database nella replica primaria. Questo è il comportamento predefinito.

READ_ONLY_ROUTING_LIST = { ('_server_instance_' [ , ... n ] ) | NONE }

Specifica un elenco delimitato da virgole di istanze del server in cui sono ospitate repliche di disponibilità per questo gruppo di disponibilità che soddisfano i requisiti seguenti quando vengono eseguite nel ruolo secondario:

• Sono configurate per consentire tutte le connessioni o connessioni in sola lettura (vedere l'argomento ALLOW_CONNECTIONS dell'opzione SECONDARY_ROLE, sopra).

• Dispongono del proprio URL del routing di sola lettura (vedere l'argomento READ_ONLY_ROUTING_URL dell'opzione SECONDARY_ROLE, sopra).

I valori di READ_ONLY_ROUTING_LIST sono i seguenti:

server_instance

Specifica l'indirizzo dell'istanza di SQL Server che ospita una replica secondaria leggibile quando è in esecuzione nel ruolo secondario.

Utilizzare un elenco delimitato da virgole per specificare tutte le istanze del server che potrebbero ospitare una replica secondaria leggibile. Il routing di sola lettura segue l'ordine in cui le istanze del server vengono specificate nell'elenco. Se si include l'istanza del server host di una replica nell'elenco di routing di sola lettura della replica, il posizionamento di questa istanza del server alla fine dell'elenco costituisce in genere buona pratica, poiché le connessioni con finalità di lettura vengono indirizzate a una replica secondaria, se ne è disponibile una.

A partire da SQL Server 2016 (13.x), è possibile eseguire il bilanciamento del carico delle richieste con finalità di lettura tra le repliche secondarie leggibili. A questo scopo, inserire le repliche in un set annidato di parentesi all'interno dell'elenco di routing di sola lettura. Per altre informazioni ed esempi, vedere Configurare il bilanciamento del carico tra le repliche di sola lettura.

NONE

Specifica che quando questa replica di disponibilità è la replica primaria, il routing di sola lettura non è supportato. Questo è il comportamento predefinito.

READ_WRITE_ROUTING_URL = { ('server_instance') }

Si applica a: SQL Server, a partire da SQL Server 2019 (15.x)

Specifica istanze del server in cui sono ospitate repliche di disponibilità per questo gruppo di disponibilità che soddisfano i requisiti seguenti quando vengono eseguite nel ruolo principale:

• La specifica della replica PRIMARY_ROLE include READ_WRITE_ROUTING_URL.
• La stringa di connessione può essere impostata come ReadWrite definendo ApplicationIntent come ReadWrite o non impostando ApplicationIntent e consentendo che venga implementata l'impostazione predefinita (ReadWrite).

Per altre informazioni, vedere Reindirizzamento della connessione in lettura/scrittura dalla replica secondaria alla primaria (Gruppi di disponibilità Always On).

SESSION_TIMEOUT = integer

Specifica il periodo di timeout della sessione in secondi. Se non si specifica questa opzione, il periodo di timeout predefinito è di 10 secondi. Il valore minimo è 5 secondi.

Per altre informazioni sul periodo di timeout della sessione, vedere Panoramica di Gruppi di disponibilità Always On (SQL Server).

AVAILABILITY GROUP ON

Specifica due gruppi di disponibilità che costituiscono un gruppo di disponibilità distribuito. Ogni gruppo di disponibilità fa parte del proprio cluster di failover di Windows Server (WSFC). Quando si crea un gruppo di disponibilità distribuito, il gruppo di disponibilità nell'istanza di SQL Server corrente diventa il gruppo di disponibilità primario. Il secondo gruppo di disponibilità diventa il gruppo di disponibilità secondario.

Il gruppo di disponibilità secondario deve essere aggiunto al gruppo di disponibilità distribuito. Per altre informazioni, vedere ALTER AVAILABILITY GROUP (Transact-SQL).

ag_name

Specifica il nome del gruppo di disponibilità che costituisce una metà del gruppo di disponibilità distribuito.

LISTENER_URL ='TCP://system-address:port'

Specifica il percorso URL per il listener associato al gruppo di disponibilità.

La clausola LISTENER_URL è obbligatoria.

'TCP://system-address:port'

Specifica un URL per il listener associato al gruppo di disponibilità. I parametri URL sono i seguenti:

system-address

Stringa, ad esempio un nome di sistema, un nome di dominio completo o un indirizzo IP, che identifica in modo univoco il listener.

port

Numero di porta associato all'endpoint del mirroring del gruppo di disponibilità. Si noti che questa non è la porta del listener.

AVAILABILITY_MODE = { SYNCHRONOUS_COMMIT | ASYNCHRONOUS_COMMIT | CONFIGURATION_ONLY }

Specifica se la replica primaria deve attendere che il gruppo di disponibilità secondario confermi la finalizzazione (scrittura) dei record del log su disco prima che la replica primaria esegua il commit della transazione in un dato database primario.

SYNCHRONOUS_COMMIT

Specifica che la replica primaria esegue il commit delle transazioni solo dopo che sono state finalizzate nel gruppo di disponibilità secondario. È possibile specificare SYNCHRONOUS_COMMIT per un massimo di due gruppi di disponibilità, incluso il gruppo di disponibilità primario.

ASYNCHRONOUS_COMMIT

Specifica che la replica primaria esegue il commit delle transazioni senza attendere la finalizzazione del log da parte del gruppo di disponibilità secondario. È possibile specificare ASYNCHRONOUS_COMMIT per un massimo di due gruppi di disponibilità, incluso il gruppo di disponibilità primario.

La clausola AVAILABILITY_MODE è obbligatoria.

FAILOVER_MODE = { MANUAL }

Specifica la modalità di failover del gruppo di disponibilità distribuito.

MANUAL

Abilita il failover manuale pianificato o il failover manuale forzato (in genere denominato failover forzato) da parte dell'amministratore del database.

La clausola FAILOVER_MODE è obbligatoria e l'unica opzione è MANUAL. Il failover automatico sul gruppo di disponibilità secondario non è supportato.

SEEDING_MODE = { AUTOMATIC | MANUAL }

Specifica in che modo viene eseguito il seeding iniziale del gruppo di disponibilità secondario.

AUTOMATIC

Abilita il seeding diretto. Questo metodo esegue il seeding del gruppo di disponibilità secondario in rete. Non richiede l'esecuzione del backup e il ripristino di una copia del database primario nelle repliche del gruppo di disponibilità secondario.

MANUAL

Specifica il seeding manuale (impostazione predefinita). Questo metodo richiede la creazione di un backup del database nella replica primaria e il ripristino manuale del backup nelle repliche del gruppo di disponibilità secondario.

LISTENER 'dns_name'( listener_option )

Definisce un nuovo listener per il gruppo di disponibilità. LISTENER è un argomento facoltativo.

dns_name

Specifica il nome host DNS del listener del gruppo di disponibilità. È necessario che il nome DNS del listener sia univoco nel dominio e in NetBIOS.

dns_name è un valore di stringa. Può contenere solo caratteri alfanumerici, trattini (-) e caratteri di sottolineatura (_), in qualsiasi ordine. Per i nomi host DNS non viene fatta distinzione tra maiuscole e minuscole. La lunghezza massima è di 63 caratteri.

È consigliabile specificare una stringa significativa. Ad esempio, per un gruppo di disponibilità denominato AG1un nome host DNS significativo potrebbe essere ag1-listener.

listener_option

LISTENER accetta una delle opzioni <listener_option> seguenti:

WITH DHCP [ ON { ('four_part_ipv4_address','four_part_ipv4_mask') } ]

Specifica che il listener del gruppo di disponibilità deve usare il protocollo DHCP (Dynamic Host Configuration Protocol). Facoltativamente, usare la clausola ON per identificare la rete in cui viene creato il listener. DHCP è limitato a una sola subnet usata per ogni istanza del server che ospita una replica nel gruppo di disponibilità.

Ad esempio:

WITH DHCP ON ('10.120.19.0','255.255.254.0')

WITH IP ( { ('four_part_ipv4_address','four_part_ipv4_mask') | ('ipv6_address') } [ , ...n ] ) [ , PORT =listener_port ]

Specifica che, anziché usare DHCP, il listener del gruppo di disponibilità deve usare uno o più indirizzi IP statici. Per creare un gruppo di disponibilità tra più subnet, viene richiesto un indirizzo IP statico nella configurazione del listener per ogni subnet. Per una determinata subnet, l'indirizzo IP statico può essere un indirizzo IPv4 o IPv6. Contattare l'amministratore della rete per ottenere un indirizzo IP statico per ogni subnet in cui verrà ospitata una replica per il nuovo gruppo di disponibilità.

Ad esempio:

WITH IP ( ('10.120.19.155','255.255.254.0') )

ip4_address

Specifica un indirizzo IPv4 in quattro parti per un listener del gruppo di disponibilità, Ad esempio: 10.120.19.155.

ipv4_mask

Specifica una maschera IPv4 in quattro parti per un listener del gruppo di disponibilità, Ad esempio: 255.255.254.0.

ipv6_address

Specifica un indirizzo IPv6 per un listener del gruppo di disponibilità, Ad esempio: 2001::4898:23:1002:20f:1fff:feff:b3a3.

PORT = listener_port

Specifica il numero di porta, listener_port, che deve essere usato da un listener del gruppo di disponibilità specificato usando una clausola WITH IP. PORT è facoltativo.

È supportato il numero di porta predefinito, 1433. Tuttavia, per motivi di sicurezza, è consigliabile usare un numero di porta diverso.

Ad esempio: WITH IP ( ('2001::4898:23:1002:20f:1fff:feff:b3a3') ) , PORT = 7777

Prerequisiti e restrizioni

Per informazioni sui prerequisiti per la creazione di un gruppo di disponibilità, vedere Prerequisiti, restrizioni e consigli per i gruppi di disponibilità Always On (SQL Server).

Per informazioni sulle restrizioni relative alle istruzioni Transact-SQL AVAILABILITY GROUP, vedere Panoramica delle istruzioni Transact-SQL per i gruppi di disponibilità Always On (SQL Server).

Sicurezza

Autorizzazioni

Sono necessarie l'appartenenza al ruolo predefinito del server sysadmin e l'autorizzazione server CREATE AVAILABILITY GROUP oppure l'autorizzazione ALTER ANY AVAILABILITY GROUP o CONTROL SERVER.

Esempi

R. Configurare un backup nelle repliche secondarie, criteri di failover flessibili e accesso alla connessione

Nell'esempio seguente si crea un gruppo di disponibilità denominato MyAg per due database utente, ThisDatabase e ThatDatabase. Nella tabella seguente si riepilogano i valori specificati per le opzioni impostate per il gruppo di disponibilità.

Opzione del gruppo	Impostazione	Descrizione
AUTOMATED_BACKUP_PREFERENCE	SECONDARY	Con questa preferenza di backup automatico viene indicato che i backup devono essere eseguiti in una replica secondaria tranne quando la replica primaria è l'unica replica online (comportamento predefinito). Affinché l'impostazione AUTOMATED_BACKUP_PREFERENCE abbia effetto, è necessario generare script di processi di backup sui database di disponibilità per prendere in considerazione la preferenza di backup automatico.
FAILURE_CONDITION_LEVEL	3	Con questa impostazione del livello della condizione di errore viene specificato che deve essere avviato un failover automatico in caso di errori interni di SQL Server critici, ad esempio spinlock orfani, gravi violazioni dell'accesso in scrittura o dumping eccessivo.
HEALTH_CHECK_TIMEOUT	600000	Questo valore di timeout del controllo di integrità pari a 60 secondi specifica che il cluster WSFC attende 60000 millisecondi che la stored procedure di sistema sp_server_diagnostics restituisca informazioni sull'integrità del server relativamente a un'istanza del server in cui è ospitata una replica con commit sincrono prima che il cluster presupponga che l'istanza del server host sia lenta o bloccata. Il valore predefinito è 30000 millisecondi.

Tre repliche di disponibilità devono essere ospitate dalle istanze predefinite del server in computer denominati COMPUTER01, COMPUTER02 e COMPUTER03. Nella tabella seguente si riepilogano i valori specificati per le opzioni di ogni replica.

Opzione della replica	Impostazione su COMPUTER01	Impostazione su COMPUTER02	Impostazione su COMPUTER03	Descrizione
ENDPOINT_URL	TCP://COMPUTER01:5022	TCP://COMPUTER02:5022	TCP://COMPUTER03:5022	In questo esempio i sistemi si trovano nello stesso dominio, pertanto per gli URL dell'endpoint può essere usato il nome del sistema come relativo indirizzo.
AVAILABILITY_MODE	SYNCHRONOUS_COMMIT	SYNCHRONOUS_COMMIT	ASYNCHRONOUS_COMMIT	In due repliche viene utilizzata la modalità con commit sincrono. In caso di sincronizzazione, supportano il failover senza perdita di dati. Nella terza replica viene utilizzata la modalità di disponibilità con commit asincrono.
FAILOVER_MODE	AUTOMATIC	AUTOMATIC	MANUAL	Le repliche con commit sincrono supportano il failover automatico e il failover manuale pianificato. La replica in cui viene utilizzata la modalità di disponibilità con commit sincrono supporta solo il failover manuale forzato.
BACKUP_PRIORITY	30	30	90	Alla replica con commit asincrono viene assegnata una priorità più alta, pari a 90, rispetto alle repliche con commit sincrono. Generalmente i backup vengono eseguiti nell'istanza del server in cui è ospitata la replica con commit asincrono.
SECONDARY_ROLE	( ALLOW_CONNECTIONS = NO, READ_ONLY_ROUTING_URL = 'TCP://COMPUTER01:1433' )	( ALLOW_CONNECTIONS = NO, READ_ONLY_ROUTING_URL = 'TCP://COMPUTER02:1433' )	( ALLOW_CONNECTIONS = READ_ONLY, READ_ONLY_ROUTING_URL = 'TCP://COMPUTER03:1433' )	Solo la replica con commit asincrono viene utilizzata come replica secondaria leggibile. Specifica il nome del computer e il numero di porta predefinito del motore di database (1433). L'argomento è facoltativo.
PRIMARY_ROLE	( ALLOW_CONNECTIONS = READ_WRITE, READ_ONLY_ROUTING_LIST = (COMPUTER03) )	( ALLOW_CONNECTIONS = READ_WRITE, READ_ONLY_ROUTING_LIST = (COMPUTER03) )	( ALLOW_CONNECTIONS = READ_WRITE, READ_ONLY_ROUTING_LIST = NONE )	Nel ruolo primario tutte le repliche rifiutano i tentativi di connessione con finalità di lettura. Le richieste di connessione con finalità di lettura vengono indirizzate a COMPUTER03 se la replica locale è in esecuzione nel ruolo secondario. Quando tale replica è in esecuzione nel ruolo primario, il routing di sola lettura è disabilitato. L'argomento è facoltativo.
SESSION_TIMEOUT	10	10	10	In questo esempio si specifica il valore di timeout della sessione predefinito (10). L'argomento è facoltativo.

Infine, nell'esempio si specificano la clausola LISTENER facoltativa per creare un listener per il nuovo gruppo di disponibilità e un nome DNS univoco, MyAgListenerIvP6, per questo listener. Le due repliche si trovano in subnet diverse, pertanto per il listener devono essere usati indirizzi IP statici. Per ognuna delle due repliche di disponibilità, tramite la clausola WITH IP si specifica un indirizzo IP statico, 2001:4898:f0:f00f::cf3c e 2001:4898:e0:f213::4ce2, per il quale è utilizzato il formato IPv6. In questo esempio si specifica anche utilizza l'argomento PORT facoltativo per indicare la porta 60173 come porta del listener.

CREATE AVAILABILITY GROUP MyAg   
   WITH (  
      AUTOMATED_BACKUP_PREFERENCE = SECONDARY,  
      FAILURE_CONDITION_LEVEL  =  3,   
      HEALTH_CHECK_TIMEOUT = 600000  
       )  
  
   FOR   
      DATABASE  ThisDatabase, ThatDatabase   
   REPLICA ON   
      'COMPUTER01' WITH   
         (  
         ENDPOINT_URL = 'TCP://COMPUTER01:5022',  
         AVAILABILITY_MODE = SYNCHRONOUS_COMMIT,  
         FAILOVER_MODE = AUTOMATIC,  
         BACKUP_PRIORITY = 30,  
         SECONDARY_ROLE (ALLOW_CONNECTIONS = NO,   
            READ_ONLY_ROUTING_URL = 'TCP://COMPUTER01:1433' ),
         PRIMARY_ROLE (ALLOW_CONNECTIONS = READ_WRITE,   
            READ_ONLY_ROUTING_LIST = (COMPUTER03) ),  
         SESSION_TIMEOUT = 10  
         ),   
  
      'COMPUTER02' WITH   
         (  
         ENDPOINT_URL = 'TCP://COMPUTER02:5022',  
         AVAILABILITY_MODE = SYNCHRONOUS_COMMIT,  
         FAILOVER_MODE = AUTOMATIC,  
         BACKUP_PRIORITY = 30,  
         SECONDARY_ROLE (ALLOW_CONNECTIONS = NO,   
            READ_ONLY_ROUTING_URL = 'TCP://COMPUTER02:1433' ),  
         PRIMARY_ROLE (ALLOW_CONNECTIONS = READ_WRITE,   
            READ_ONLY_ROUTING_LIST = (COMPUTER03) ),  
         SESSION_TIMEOUT = 10  
         ),   
  
      'COMPUTER03' WITH   
         (  
         ENDPOINT_URL = 'TCP://COMPUTER03:5022',  
         AVAILABILITY_MODE = ASYNCHRONOUS_COMMIT,  
         FAILOVER_MODE =  MANUAL,  
         BACKUP_PRIORITY = 90,  
         SECONDARY_ROLE (ALLOW_CONNECTIONS = READ_ONLY,   
            READ_ONLY_ROUTING_URL = 'TCP://COMPUTER03:1433' ),  
         PRIMARY_ROLE (ALLOW_CONNECTIONS = READ_WRITE,   
            READ_ONLY_ROUTING_LIST = NONE ),  
         SESSION_TIMEOUT = 10  
         );
GO  
ALTER AVAILABILITY GROUP [MyAg]
  ADD LISTENER 'MyAgListenerIvP6' ( WITH IP ( ('2001:db88:f0:f00f::cf3c'),('2001:4898:e0:f213::4ce2') ) , PORT = 60173 );   
GO  

Attività correlate

• Creare un gruppo di disponibilità (Transact-SQL)

• Usare la Creazione guidata Gruppo di disponibilità (SQL Server Management Studio)

• Usare la finestra di dialogo Nuovo gruppo di disponibilità (SQL Server Management Studio)

• Usare la Creazione guidata Gruppo di disponibilità (SQL Server Management Studio)

Vedi anche

ALTER AVAILABILITY GROUP (Transact-SQL)
ALTER DATABASE SET HADR (Transact-SQL)
DROP AVAILABILITY GROUP (Transact-SQL)
Risolvere i problemi relativi alla configurazione di Gruppi di disponibilità Always On (SQL Server)
Panoramica di Gruppi di disponibilità Always On (SQL Server)
Listener del gruppo di disponibilità, connettività client e failover dell'applicazione (SQL Server)