Desconectar as instâncias do SQL Server do Azure Arc

Artigo
04/23/2024

Aplica-se a:SQL Server

Este artigo descreve como você pode desconectar as instâncias do SQL Server habilitadas para Arc do Azure Arc usando portal do Azure ou o shell de comando.

Pré-requisitos

Sua conta do Azure está em uma função de Colaborador para a assinatura de instância e o grupo de recursos.

Importante

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 do Azure para SQL Server, adicione a seguinte marca e valor ao recurso Arc Server.

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 de extensão.

Desinstalar a extensão do Azure do SQL Server

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

Acesse o portal do 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)
Clique na guia Desinstalar
Confirme se você deseja desinstalar a extensão quando solicitado

Para remover os recursos do SQL Server – Azure Arc:

Acesse o portal do Azure Arc
Em instâncias do SQL Server, selecione as instâncias do SQL Server específicas que você deseja remover
Clique no botão Excluir
Confirme se você deseja excluir os recursos quando solicitado

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 os recursos 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 tiver recursos do Azure dependentes, como bancos de dados, esse comando poderá demorar bastante para ser concluído. Você pode adicionar o parâmetro -AsJob para retornar imediatamente e executar o comando como um trabalho em segundo plano.

Dica

Execute o script do Azure Cloud Shell, pois 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 os recursos 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 (banco de dados do SQL Server – Recurso do Azure Arc), 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 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

Esta seção explica os arquivos e objetos de banco de dados restantes após a desinstalação.

Arquivos

A desinstalação exclui os arquivos binários.

Logs de extensão e outros dados não podem ser excluídos.

A desativaçã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 com privilégios mínimos. Para obter detalhes sobre o modo de privilégio mínimo, consulte Operar o SQL Server habilitado pelo Azure Arc com privilégios mínimos (preview).

Share via