Desconectar as instâncias do SQL Server do Azure Arc

Artigo
10/16/2024

Aplica-se: SQL Server

Este artigo descreve como você pode desconectar as instâncias do SQL Server do Azure Arc usando portal do Azure ou o shell de comando. Aplica-se a instâncias do SQL Server habilitado pelo Azure Arc.

Pré-requisitos

Sua conta do Azure deve ter uma Função de colaborador para a assinatura de instância e o grupo de recursos.

Observação

Você não precisa de acesso ao computador host para se desconectar do Azure Arc.

Descadastrar instalação automática

Antes de desinstalar a extensão do Azure para SQL Server, desative a instalação automática da extensão adicionando a seguinte marca e valor ao recurso do SQL Server habilitado para Azure Arc:

Marca	Valor
`ArcSQLServerExtensionDeployment`	`Disabled`

Como alternativa, você pode limitar as extensões que podem ser instaladas no servidor. Você pode configurar listas de extensões que deseja permitir e bloquear no servidor. Para saber mais, confira Listas de permissões e listas de bloqueio.

Desinstalar a extensão do Azure do SQL Server

Para desinstalar a extensão do Azure do SQL Server:

No portal do Azure, vá para o Azure Arc.
Em Computadores, selecione o servidor específico que hospeda a instância do SQL Server.
Em Extensões, selecione a extensão que você deseja desinstalar (WindowsAgent.SqlServer para computador Windows ou LinuxAgent.SqlServer para computador Linux).
Selecione Desinstalar.
Quando solicitado, confirme se você deseja desinstalar a extensão.

Para remover o recurso do SQL Server - Azure Arc:

No portal do Azure, vá para o Azure Arc.
Em instâncias do SQL Server, selecione as instâncias do SQL Server específicas que você deseja remover.
Selecione Excluir.
Quando solicitado, confirme que você deseja excluir o recurso.

Para desinstalar a extensão do Azure para SQL Server, execute:

Remove-AzConnectedMachineExtension -MachineName "{your machine name}" -ResourceGroup "{your resource group name}" -Name "{extension name}" -NoWait

Para computadores Windows, o nome da extensão é WindowsAgent.SqlServer. Para computadores Linux, o nome da extensão é LinuxAgent.SqlServer.

Para remover o recurso do SQL Server – Azure Arc, execute:

remove-azresource -ResourceGroup "{your resource group name}" -ResourceType Microsoft.AzureArcData/SqlServerInstances -Name "{full SQL instance name}" -Force

Se a instância (SQL Server – Recurso do Azure Arc) tiver recursos do Azure dependentes, como bancos de dados (banco de dados do SQL Server – Recurso do Azure Arc), esse comando poderá demorar bastante para ser concluído. Você pode adicionar um parâmetro -AsJob para retornar imediatamente e executar o comando como um trabalho em segundo plano.

Dica

Execute o script do Azure Cloud Shell. Ele tem os módulos Azure PowerShell necessários pré-instalados e você será autenticado automaticamente. Para obter detalhes, confira Executar o script usando Cloud Shell.

Para desinstalar a extensão do Azure para SQL Server, execute:

az connectedmachine extension delete --machine-name "{your machine name}" --resource-group "{your resource group name}" --name "{OS}Agent.SqlServer" --publisher "Microsoft.AzureData"

Para remover o recurso do SQL Server – Azure Arc, execute:

az resource delete --resource-group "{your resource group name}" --resource-type Microsoft.AzureArcData/SqlServerInstances --name "{full SQL instance name}"

Se a instância (SQL Server – Recurso do Azure Arc) tiver recursos do Azure dependentes, como bancos de dados do SQL Server, esse comando poderá demorar bastante para ser concluído. Você pode adicionar o parâmetro --No-Wait para retornar imediatamente e executar o comando como um trabalho em segundo plano.

Para desconectar todas as instâncias do SQL Server habilitadas para Azure Arc em um escopo maior (como um grupo de recursos, uma assinatura ou várias assinaturas) com um só comando, use o script Desinstalar a extensão do Azure para SQL Server. O script é uma amostra do SQL Server de código aberto e inclui as instruções passo a passo.

Arquivos e contas residuais

Depois de desinstalar a extensão do Azure para SQL Server, alguns arquivos e objetos de banco de dados permanecem.

Arquivos

A desinstalação da extensão exclui os arquivos binários, mas os logs de extensão e outros dados podem não ser excluídos.

Desabilitar a extensão não exclui nenhum arquivo ou pasta binária.

Tabelas

As tabelas criadas pelo agente permanecem após a desinstalação da extensão.

Contas

Se você não instalou a extensão no modo de privilégio mínimo, o agente usa a conta NTAUTHORITY\SYSTEM.

Desabilitar ou excluir a extensão não remove o login NTAUTHORITY\SYSTEM de nenhum banco de dados porque outros aplicativos podem exigir esse login. Você precisa remover manualmente a função de cada banco de dados do usuário.

A conta NTAUTHORITY\SYSTEM não se aplica a instalações que usam privilégios mínimos.

Para obter detalhes sobre o modo de privilégio mínimo, confira Operar o SQL Server habilitado pelo Azure Arc com privilégios mínimos.

Compartilhar via