Criar um grupo de disponibilidade Always On usando o T-SQL (Transact-SQL)

Aplica-se a: SQL Server

Este tópico descreve como usar Transact-SQL para criar e configurar um grupo de disponibilidade em instâncias de SQL Server no qual o recurso Grupos de Disponibilidade AlwaysOn é habilitado. Um grupo de disponibilidade define um conjunto de bancos de dados de usuários que realizará o failover como uma única unidade e um conjunto de parceiros de failover, conhecido como réplicas de disponibilidade, que oferece suporte a failover.

Observação

Para obter uma introdução aos grupos de disponibilidade, confira Visão geral dos grupos de disponibilidade Always On (SQL Server).

Observação

Como alternativa ao uso do Transact-SQL, você pode usar o assistente para Criar Grupo de Disponibilidade ou os cmdlets do SQL Server PowerShell. Para obter mais informações, confiraUsar o Assistente de Grupo de Disponibilidade (SQL Server Management Studio), Usar a Caixa de Diálogo Novo Grupo de Disponibilidade (SQL Server Management Studio)ou Criar um Grupo de Disponibilidade (SQL Server PowerShell).

Pré-requisitos, restrições e recomendações

  • Antes de criar um grupo de disponibilidade, verifique se as instâncias do SQL Server que hospedam réplicas de disponibilidade residem em um nó diferente do WSFC (Windows Server Failover Clustering), dentro do mesmo cluster de failover do WSFC. Também verifique se cada instância de servidor atende todos os outros pré-requisitos de Grupos de disponibilidade AlwaysOn . Para obter mais informações, é altamente recomendável que você leia Pré-requisitos, Restrições e Recomendações para Grupos de Disponibilidade AlwaysOn (SQL Server).

Permissões

Requer a associação na função de servidor fixa sysadmin e a permissão de servidor CREATE AVAILABILITY GROUP, a permissão ALTER ANY AVAILABILITY GROUP ou a permissão CONTROL SERVER.

Usando Transact-SQL para criar e configurar um grupo de disponibilidade

Resumo de tarefas e instruções Transact-SQL correspondentes

A tabela a seguir lista as tarefas básicas envolvidas na criação e configuração de um grupo de disponibilidade e indica quais instruções do Transact-SQL serão usadas nessas tarefas. As tarefas Grupos de disponibilidade AlwaysOn devem ser executadas na sequência em que são apresentadas na tabela.

Tarefa Instrução(ões) Transact-SQL Local de Execução da Tarefa*****
Criar ponto de extremidade de espelhamento de banco de dados (uma vez por instância do SQL Server ) CREATE ENDPOINT endpointName ... FOR DATABASE_MIRRORING Executar em cada instância de servidor que não tem ponto de extremidade de espelhamento de banco de dados.
Criar grupo de disponibilidade CRIAR GRUPO DE DISPONIBILIDADE Execute na instância de servidor que deve hospedar a réplica primária inicial.
Unir a réplica secundária ao grupo de disponibilidade ALTER AVAILABILITY GROUP group_name JOIN Execute em cada instância de servidor que hospeda uma réplica secundária.
Preparar os banco de dados secundários BACKUP e RESTORE. Crie backups na instância de servidor que hospeda a réplica primária.

Restaure backups em cada instância de servidor que hospeda uma réplica secundária, usando RESTORE WITH NORECOVERY.
Iniciar a sincronização de dados unindo cada banco de dados secundário ao grupo de disponibilidade ALTER DATABASE database_name SET HADR AVAILABILITY GROUP = group_name Execute em cada instância de servidor que hospeda uma réplica secundária.

*Para executar uma tarefa específica, conecte-se à instância ou instâncias de servidor indicadas.

Usando o Transact-SQL

Observação

Para obter um procedimento de configuração de exemplo que contém exemplos de código de cada uma dessas instruções Transact-SQL, confira Exemplo: Configurar um Grupo de Disponibilidade que Usa a Autenticação do Windows.

  1. Conecte-se à instância de servidor que deve hospedar a réplica primária.

  2. Crie o grupo de disponibilidade usando a instrução Transact-SQLCREATE AVAILABILITY GROUP.

  3. Una a nova réplica secundária ao grupo de disponibilidade. Para obter mais informações, confira Unir uma Réplica Secundária a um Grupo de Disponibilidade (SQL Server).

  4. Para cada banco de dados do grupo de disponibilidade, crie um banco de dados secundário restaurando backups recentes do banco de dados primário, usando RESTORE WITH NORECOVERY. Para obter mais informações, confira Exemplo: configurando um grupo de disponibilidade usando a Autenticação do Windows (Transact-SQL), começando pela etapa que restaura o backup do banco de dados.

  5. Una cada novo banco de dados secundário ao grupo de disponibilidade. Para obter mais informações, confira Unir uma Réplica Secundária a um Grupo de Disponibilidade (SQL Server).

Exemplo: configurando um grupo de disponibilidade que usa a Autenticação do Windows

Esse exemplo cria um procedimento de configuração Grupos de Disponibilidade AlwaysOn de exemplo que usa o Transact-SQL para configurar pontos de extremidade de espelhamento de banco de dados que usam a Autenticação do Windows e para criar e configurar um grupo de disponibilidade e seus bancos de dados secundários.

Esse exemplo contém as seguintes seções:

Pré-requisitos para usar o procedimento de configuração de exemplo

Este procedimento de exemplo tem os seguintes requisitos:

  • As instâncias de servidor devem oferecer suporte ao Grupos de disponibilidade AlwaysOn. Para obter mais informações, confira Pré-requisitos, Restrições e Recomendações para Grupos de Disponibilidade Always On (SQL Server).

  • Dois bancos de dados de exemplo, MyDb1 e MyDb2, devem existir na instância de servidor que hospedará a réplica primária. Os exemplos de código a seguir criam e configuram esses dois bancos de dados, e criam um backup completo de cada um deles. Execute esses exemplos de código na instância de servidor na qual você pretende criar o grupo de disponibilidade de exemplo. Essa instância de servidor hospedará a réplica primária inicial do grupo de disponibilidade de exemplo.

    1. Este exemplo do Transact-SQL cria esses bancos de dados e os alteram para usar o modelo de recuperação completo:

      -- Create sample databases:  
      CREATE DATABASE MyDb1;  
      GO  
      ALTER DATABASE MyDb1 SET RECOVERY FULL;  
      GO  
      
      CREATE DATABASE MyDb2;  
      GO  
      ALTER DATABASE MyDb2 SET RECOVERY FULL;  
      GO  
      
    2. O exemplo de código a seguir cria um backup completo de banco de dados de MyDb1 e MyDb2. Este exemplo de código usa um compartilhamento de backup fictício, \\FILESERVER\SQLbackups.

      -- Backup sample databases:  
      BACKUP DATABASE MyDb1   
      TO DISK = N'\\FILESERVER\SQLbackups\MyDb1.bak'   
          WITH FORMAT;  
      GO  
      
      BACKUP DATABASE MyDb2   
      TO DISK = N'\\FILESERVER\SQLbackups\MyDb2.bak'   
          WITH FORMAT;  
      GO  
      

[Início do exemplo]

Procedimento de configuração de exemplo

Nesta configuração de exemplo, a réplica de disponibilidade será criada em duas instâncias de servidor autônomas cujas contas de serviço são executadas em domínios diferentes, porém confiáveis (DOMAIN1 e DOMAIN2).

A tabela a seguir resume os valores usados nesta configuração de exemplo.

Função inicial Sistema Instância do SQL Server host
Primária COMPUTER01 AgHostInstance
Secundário COMPUTER02 Instância padrão.
  1. Crie um ponto de extremidade de espelhamento de banco de dados chamado dbm_endpoint na instância de servidor em que você pretende criar o grupo de disponibilidade (uma instância denominada AgHostInstance em COMPUTER01). Esse ponto de extremidade usa a porta 7022. Observe que a instância de servidor na qual você cria o grupo de disponibilidade hospedará a réplica primária.

    -- Create endpoint on server instance that hosts the primary replica:  
    CREATE ENDPOINT dbm_endpoint  
        STATE=STARTED   
        AS TCP (LISTENER_PORT=7022)   
        FOR DATABASE_MIRRORING (ROLE=ALL);  
    GO  
    
  2. Crie um ponto de extremidade dbm_endpoint na instância de servidor que hospedará a réplica secundária (a instância de servidor padrão em COMPUTER02). Esse ponto de extremidade usa a porta 5022.

    -- Create endpoint on server instance that hosts the secondary replica:   
    CREATE ENDPOINT dbm_endpoint  
        STATE=STARTED   
        AS TCP (LISTENER_PORT=5022)   
        FOR DATABASE_MIRRORING (ROLE=ALL);  
    GO  
    
  3. Observação

    Se as contas de serviço das instâncias de servidor que devem hospedar suas réplicas de disponibilidade forem executadas na mesma conta de domínio, esta etapa é desnecessária. Ignore-a e vá diretamente para a próxima etapa.

    Se as contas de serviço das instâncias de servidor forem executadas em usuários de domínio diferentes, em cada instância de servidor, crie um logon para a outra instância de servidor e conceda essa permissão de logon para acessar o ponto de extremidade de espelhamento de banco de dados local.

    O exemplo de código a seguir mostra as instruções do Transact-SQL para criar um logon e conceder a ele a permissão em um ponto de extremidade. A conta de domínio da instância de servidor remoto é representada aqui como domain_name\user_name.

    -- If necessary, create a login for the service account, domain_name\user_name  
    -- of the server instance that will host the other replica:  
    USE master;  
    GO  
    CREATE LOGIN [domain_name\user_name] FROM WINDOWS;  
    GO  
    -- And Grant this login connect permissions on the endpoint:  
    GRANT CONNECT ON ENDPOINT::dbm_endpoint   
       TO [domain_name\user_name];  
    GO  
    
  4. Na instância de servidor onde os bancos de dados de usuário residem, crie o grupo de disponibilidade.

    O exemplo de código a seguir cria um grupo de disponibilidade chamado MyAG na instância de servidor em que os bancos de dados de exemplo, MyDb1 e MyDb2, foram criados. Na AgHostInstanceCOMPUTER01 , a instância de servidor local é especificada primeiro. Essa instância hospedará a réplica primária inicial. Uma instância de servidor remota, a instância de servidor padrão em COMPUTER02, é especificada para hospedar uma réplica secundária. Ambas as réplicas de disponibilidade são configuradas para usar o modo de confirmação assíncrona com failover manual (para réplicas de confirmação assíncrona, failover manual significa failover forçado com possível perda de dados).

    -- Create the availability group, MyAG:   
    CREATE AVAILABILITY GROUP MyAG   
       FOR   
          DATABASE MyDB1, MyDB2   
       REPLICA ON   
          'COMPUTER01\AgHostInstance' WITH   
             (  
             ENDPOINT_URL = 'TCP://COMPUTER01.Adventure-Works.com:7022',   
             AVAILABILITY_MODE = ASYNCHRONOUS_COMMIT,  
             FAILOVER_MODE = MANUAL  
             ),  
          'COMPUTER02' WITH   
             (  
             ENDPOINT_URL = 'TCP://COMPUTER02.Adventure-Works.com:5022',  
             AVAILABILITY_MODE = ASYNCHRONOUS_COMMIT,  
             FAILOVER_MODE = MANUAL  
             );   
    GO  
    

    Para obter mais códigos de exemplo de criação de um grupo de disponibilidade, confira CREATE AVAILABILITY GROUP (Transact-SQL).

  5. Na instância de servidor que hospeda a réplica secundária, una a réplica secundária ao grupo de disponibilidade.

    O exemplo de código a seguir une a réplica secundária de COMPUTER02 ao grupo de disponibilidade MyAG .

    -- On the server instance that hosts the secondary replica,   
    -- join the secondary replica to the availability group:  
    ALTER AVAILABILITY GROUP MyAG JOIN;  
    GO  
    
  6. Na instância de servidor que hospeda a réplica secundária, crie os bancos de dados secundários.

    O exemplo de código a seguir cria os bancos de dados secundários MyDb1 e MyDb2 restaurando backups de banco de dados que usam RESTORE WITH NORECOVERY.

    -- On the server instance that hosts the secondary replica,   
    -- Restore database backups using the WITH NORECOVERY option:  
    RESTORE DATABASE MyDb1   
        FROM DISK = N'\\FILESERVER\SQLbackups\MyDb1.bak'   
        WITH NORECOVERY;  
    GO  
    
    RESTORE DATABASE MyDb2   
        FROM DISK = N'\\FILESERVER\SQLbackups\MyDb2.bak'   
        WITH NORECOVERY;  
    GO 
    
  7. Na instância de servidor que hospeda a réplica primária, faça backup do log de transações em cada banco de dados primário.

    Importante

    Quando você estiver configurando um grupo de disponibilidade real, é recomendável que, antes de fazer esse backup de log, você suspenda as tarefas de backup de log em seus bancos de dados primários até que tenha unido os bancos de dados secundários correspondentes ao grupo de disponibilidade.

    O exemplo de código a seguir cria um backup de log de transações em MyDb1 e MyDb2.

    -- On the server instance that hosts the primary replica,   
    -- Backup the transaction log on each primary database:  
    BACKUP LOG MyDb1   
    TO DISK = N'\\FILESERVER\SQLbackups\MyDb1.bak'   
        WITH NOFORMAT;  
    GO  
    
    BACKUP LOG MyDb2   
    TO DISK = N'\\FILESERVER\SQLbackups\MyDb2.bak'   
        WITH NOFORMAT;  
    GO
    

    Dica

    Normalmente, um backup de log deve ser feito em cada banco de dados primário e restaurado no banco de dados secundário correspondente (usando WITH NORECOVERY). Porém, esse backup de log pode ser desnecessário caso o banco de dados tenha acabado de ser criado e nenhum backup tenha sido feito ou caso o modelo de recuperação tenha sido alterado de SIMPLE para FULL.

  8. Na instância de servidor que hospeda a réplica secundária, aplique backups de log aos bancos de dados secundários.

    O exemplo de código a seguir aplica backups aos bancos de dados secundários MyDb1 e MyDb2 restaurando backups de banco de dados que usam RESTORE WITH NORECOVERY.

    Importante

    Quando você estiver preparando um banco de dados secundário real, precisará aplicar cada backup de log feito desde o backup de banco de dados do qual criou o banco de dados secundário, começando pelo mais antigo e sempre usando RESTORE WITH NORECOVERY. É claro que, se você restaurar os backups de banco de dados completo e diferencial, precisará apenas aplicar os backups de log feitos após o backup diferencial.

    -- Restore the transaction log on each secondary database,  
    -- using the WITH NORECOVERY option:  
    RESTORE LOG MyDb1   
        FROM DISK = N'\\FILESERVER\SQLbackups\MyDb1.bak'   
        WITH FILE=1, NORECOVERY;  
    GO  
    RESTORE LOG MyDb2   
        FROM DISK = N'\\FILESERVER\SQLbackups\MyDb2.bak'   
        WITH FILE=1, NORECOVERY;  
    GO  
    
  9. Na instância de servidor que hospeda a réplica secundária, una os novos bancos de dados secundários ao grupo de disponibilidade.

    O exemplo de código a seguir une o banco de dados secundário MyDb1 e, em seguida, os bancos de dados secundários MyDb2 ao grupo de disponibilidade MyAG .

    -- On the server instance that hosts the secondary replica,   
    -- join each secondary database to the availability group:  
    ALTER DATABASE MyDb1 SET HADR AVAILABILITY GROUP = MyAG;  
    GO  
    
    ALTER DATABASE MyDb2 SET HADR AVAILABILITY GROUP = MyAG;  
    GO  
    

Concluir o exemplo de código para procedimento de configuração de exemplo

O exemplo a seguir mescla os exemplos de código de todas as etapas do procedimento de configuração de exemplo. A tabela a seguir resumiu os valores de espaço reservado usados neste exemplo de código. Para obter mais informações sobre as etapas deste exemplo de código, consulte Pré-requisitos para usar o procedimento de configuração de exemplo e Procedimento de configuração de exemplo, anteriormente neste tópico.

Espaço reservado Descrição
\\FILESERVER\SQLbackups Compartilhamento de backup ficcional.
\\FILESERVER\SQLbackups\MyDb1.bak Arquivo de backup de MyDb1.
\\FILESERVER\SQLbackups\MyDb2.bak Arquivo de backup de MyDb2.
7022 Número de porta atribuído a cada ponto de extremidade de espelhamento de banco de dados.
COMPUTER01\AgHostInstance Instância de servidor que hospeda a réplica primária inicial.
COMPUTER02 Instância de servidor que hospeda a réplica secundária inicial. Essa é a instância de servidor padrão em COMPUTER02.
dbm_endpoint Nome especificado para cada ponto de extremidade de espelhamento de banco de dados.
MyAG Nome do grupo de disponibilidade de exemplo.
MyDb1 Nome do primeiro banco de dados de exemplo.
MyDb2 Nome do segundo banco de dados de exemplo.
DOMAIN1\user1 Conta de serviço da instância de servidor que deve hospedar a réplica primária inicial.
DOMAIN2\user2 Conta de serviço da instância de servidor que deve hospedar a réplica secundária inicial.
TCP://COMPUTER01.Adventure-Works.com:7022 URL de ponto de extremidade da instância AgHostInstance do SQL Server em COMPUTER01.
TCP://COMPUTER02.Adventure-Works.com:5022 URL de ponto de extremidade da instância padrão do SQL Server em COMPUTER02.

Observação

Para obter mais códigos de exemplo de criação de um grupo de disponibilidade, confira CREATE AVAILABILITY GROUP (Transact-SQL).

-- on the server instance that will host the primary replica,   
-- create sample databases:  
CREATE DATABASE MyDb1;  
GO  
ALTER DATABASE MyDb1 SET RECOVERY FULL;  
GO  
  
CREATE DATABASE MyDb2;  
GO  
ALTER DATABASE MyDb2 SET RECOVERY FULL;  
GO  
  
-- Backup sample databases:  
BACKUP DATABASE MyDb1   
TO DISK = N'\\FILESERVER\SQLbackups\MyDb1.bak'   
    WITH FORMAT;  
GO  
  
BACKUP DATABASE MyDb2   
TO DISK = N'\\FILESERVER\SQLbackups\MyDb2.bak'   
    WITH FORMAT;  
GO  
  
-- Create the endpoint on the server instance that will host the primary replica:  
CREATE ENDPOINT dbm_endpoint  
    STATE=STARTED   
    AS TCP (LISTENER_PORT=7022)   
    FOR DATABASE_MIRRORING (ROLE=ALL);  
GO  
  
-- Create the endpoint on the server instance that will host the secondary replica:   
CREATE ENDPOINT dbm_endpoint  
    STATE=STARTED   
    AS TCP (LISTENER_PORT=7022)   
    FOR DATABASE_MIRRORING (ROLE=ALL);  
GO  
  
-- If both service accounts run under the same domain account, skip this step. Otherwise,   
-- On the server instance that will host the primary replica,   
-- create a login for the service account   
-- of the server instance that will host the secondary replica, DOMAIN2\user2,   
-- and grant this login connect permissions on the endpoint:  
USE master;  
GO  
CREATE LOGIN [DOMAIN2\user2] FROM WINDOWS;  
GO  
GRANT CONNECT ON ENDPOINT::dbm_endpoint   
   TO [DOMAIN2\user2];  
GO  
  
-- If both service accounts run under the same domain account, skip this step. Otherwise,   
-- On the server instance that will host the secondary replica,  
-- create a login for the service account   
-- of the server instance that will host the primary replica, DOMAIN1\user1,   
-- and grant this login connect permissions on the endpoint:  
USE master;  
GO  
  
CREATE LOGIN [DOMAIN1\user1] FROM WINDOWS;  
GO  
GRANT CONNECT ON ENDPOINT::dbm_endpoint   
   TO [DOMAIN1\user1];  
GO  
  
-- On the server instance that will host the primary replica,   
-- create the availability group, MyAG:  
CREATE AVAILABILITY GROUP MyAG   
   FOR   
      DATABASE MyDB1, MyDB2   
   REPLICA ON   
      'COMPUTER01\AgHostInstance' WITH   
         (  
         ENDPOINT_URL = 'TCP://COMPUTER01.Adventure-Works.com:7022',  
         AVAILABILITY_MODE = SYNCHRONOUS_COMMIT,  
         FAILOVER_MODE = AUTOMATIC  
         ),  
      'COMPUTER02' WITH   
         (  
         ENDPOINT_URL = 'TCP://COMPUTER02.Adventure-Works.com:7022',  
         AVAILABILITY_MODE = SYNCHRONOUS_COMMIT,  
         FAILOVER_MODE = AUTOMATIC  
         );   
GO  
  
-- On the server instance that hosts the secondary replica,   
-- join the secondary replica to the availability group:  
ALTER AVAILABILITY GROUP MyAG JOIN;  
GO  
  
-- Restore database backups onto this server instance, using RESTORE WITH NORECOVERY:  
RESTORE DATABASE MyDb1   
    FROM DISK = N'\\FILESERVER\SQLbackups\MyDb1.bak'   
    WITH NORECOVERY;  
GO  
  
RESTORE DATABASE MyDb2   
    FROM DISK = N'\\FILESERVER\SQLbackups\MyDb2.bak'   
    WITH NORECOVERY;  
GO  
  
-- Back up the transaction log on each primary database:  
BACKUP LOG MyDb1   
TO DISK = N'\\FILESERVER\SQLbackups\MyDb1.bak'   
    WITH NOFORMAT;  
GO  
  
BACKUP LOG MyDb2   
TO DISK = N'\\FILESERVER\SQLbackups\MyDb2.bak'   
    WITH NOFORMAT  
GO  
  
-- Restore the transaction log on each secondary database,  
-- using the WITH NORECOVERY option:  
RESTORE LOG MyDb1   
    FROM DISK = N'\\FILESERVER\SQLbackups\MyDb1.bak'   
    WITH FILE=1, NORECOVERY;  
GO  
RESTORE LOG MyDb2   
    FROM DISK = N'\\FILESERVER\SQLbackups\MyDb2.bak'   
    WITH FILE=1, NORECOVERY;  
GO  
  
-- On the server instance that hosts the secondary replica,   
-- join each secondary database to the availability group:  
ALTER DATABASE MyDb1 SET HADR AVAILABILITY GROUP = MyAG;  
GO  
  
ALTER DATABASE MyDb2 SET HADR AVAILABILITY GROUP = MyAG;  
GO  

Related Tasks

Para configurar um grupo de disponibilidade e propriedades de réplica

Para concluir a configuração do grupo de disponibilidade

Maneiras alternativas de criar um grupo de disponibilidade

Para habilitar os Grupos de Disponibilidade AlwaysOn

Para configurar um ponto de extremidade de espelhamento de banco de dados

Para solucionar problemas de configuração dos grupos de disponibilidade AlwaysOn

Conteúdo relacionado

Consulte Também

O ponto de extremidade de espelhamento de banco de dados (SQL Server)
Visão geral dos Grupos de Disponibilidade AlwaysOn (SQL Server)
Ouvintes do grupo de disponibilidade, conectividade de cliente e failover de aplicativo (SQL Server)
Pré-requisitos, restrições e recomendações para Grupos de Disponibilidade AlwaysOn (SQL Server)