Referência de API gerenciada para a Instância Gerenciada de SQL do Azure

  • Artigo

Aplica-se a: Instância Gerenciada de SQL do Azure

É possível criar e configurar instâncias gerenciadas da Instância Gerenciada de SQL do Azure por meio do portal do Azure, do PowerShell, da CLI do Azure, da API REST e do Transact-SQL. Neste artigo, você encontra uma visão geral das funções e da API que você pode usar para criar e configurar as instâncias gerenciadas.

Portal do Azure: criar uma instância gerenciada

Para obter um início rápido que mostra como criar uma instância gerenciada, confira Início Rápido: criar uma instância gerenciada.

PowerShell: criar e configurar instâncias gerenciadas

Observação

Este artigo usa o módulo do PowerShell Azure Az, que é o módulo do PowerShell recomendado para interagir com o Azure. Para começar a usar o módulo do Az PowerShell, confira Instalar o Azure PowerShell. Para saber como migrar para o módulo Az PowerShell, confira Migrar o Azure PowerShell do AzureRM para o Az.

Importante

O módulo Azure Resource Manager do PowerShell ainda tem suporte do Banco de Dados SQL do Azure, mas todo o desenvolvimento futuro é para o módulo Az.Sql. Para esses cmdlets, confira AzureRM.Sql. Os argumentos para os comandos no módulo Az e nos módulos AzureRM são substancialmente idênticos.

Para criar e gerenciar instâncias gerenciadas com o Azure PowerShell, use os seguintes cmdlets do PowerShell. Se você precisa instalar ou atualizar o PowerShell, confira Instalar o módulo do Azure PowerShell.

Dica

Para scripts de exemplo do PowerShell, confira Script de Início Rápido: criar uma instância gerenciada usando uma biblioteca do PowerShell.

Cmdlet Descrição
New-AzSqlInstance Cria uma instância gerenciada.
Get-AzSqlInstance Retorna informações sobre uma instância gerenciada.
Set-AzSqlInstance Define propriedades para uma instância gerenciada.
Remove-AzSqlInstance Remove uma instância gerenciada.
Get-AzSqlInstanceOperation Obtém uma lista de operações de gerenciamento executadas na instância gerenciada ou em uma operação específica.
Stop-AzSqlInstanceOperation Cancela a operação de gerenciamento específica executada na instância gerenciada.
New-AzSqlInstanceDatabase Cria um banco de dados de Instância Gerenciada de SQL.
Get-AzSqlInstanceDatabase Retorna informações sobre o banco de dados de Instância Gerenciada de SQL.
Remove-AzSqlInstanceDatabase Remove um banco de dados de Instância Gerenciada de SQL.
Restore-AzSqlInstanceDatabase Restaura um banco de dados de Instância Gerenciada de SQL.

CLI do Azure: criar e configurar instâncias gerenciadas

Para criar e configurar instâncias gerenciadas com a CLI do Azure, use os comandos da CLI do Azure para Instância Gerenciada de SQL mostrados a seguir. Use o Azure Cloud Shell para executar a CLI do Azure no seu navegador ou instale-o no macOS, Linux ou Windows.

Dica

Para ver um início rápido da CLI do Azure, consulte Trabalhar com a Instância Gerenciada do SQL usando a CLI do Azure.

Cmdlet Descrição
az sql mi create Cria uma instância gerenciada.
az sql mi list Lista as instâncias gerenciadas disponíveis.
az sql mi show Obtém os detalhes de uma instância gerenciada.
az sql mi update Atualiza uma instância gerenciada.
az sql mi delete Remove uma instância gerenciada.
az sql mi op list Obtém uma lista de operações de gerenciamento executadas na instância gerenciada.
az sql mi op show Obtém a operação de gerenciamento específica executada na instância gerenciada.
az sql mi op show Cancela a operação de gerenciamento específica executada na instância gerenciada.
az sql midb create Cria um banco de dados gerenciado.
az sql midb list Lista os bancos de dados gerenciados disponíveis.
az sql midb restore Restaura um banco de dados gerenciado.
az sql midb delete Remove um banco de dados gerenciado.

Transact-SQL: criar e configurar bancos de dados de instância

Para criar e gerenciar o banco de dados de instância após a criação da instância gerenciada, use os comandos T-SQL a seguir. Você pode emitir esses comandos usando o Portal do Azure, o SQL Server Management Studio, o Azure Data Studio, o Visual Studio Code ou qualquer outro programa que possa se conectar a um servidor e passar comandos Transact-SQL.

Dica

Para obter guias de início rápido que mostram como configurar e se conectar a uma instância gerenciada por meio do SQL Server Management Studio no Microsoft Windows, confira Início Rápido: configurar a VM do Azure para se conectar à Instância Gerenciada de SQL do Azure e Início Rápido: configurar uma conexão ponto a site com a Instância Gerenciada de SQL do Azure do local.

Importante

Não é possível criar nem excluir uma instância gerenciada usando o Transact-SQL.

Comando Descrição
CREATE DATABASE Cria um banco de dados de instância na Instância Gerenciada de SQL. Você deve estar conectado ao banco de dados master para criar um banco de dados.
ALTER DATABASE Modifica um banco de dados de instância na Instância Gerenciada de SQL.

API REST: criar e configurar instâncias gerenciadas

Para criar e gerenciar instâncias gerenciadas, use estas solicitações de API REST.

Comando Descrição
Instância Gerenciada de SQL - Criar ou atualizar Cria ou atualiza uma instância gerenciada.
Instância Gerenciada de SQL - Excluir Exclui uma instância gerenciada.
Instância Gerenciada de SQL - Obter Obtém uma instância gerenciada.
Instância Gerenciada de SQL - Parar Para uma instância gerenciada.
Instância Gerenciada de SQL - Iniciar Inicia uma instância gerenciada
Instância Gerenciada de SQL - Listar Retorna uma lista de instâncias gerenciadas em uma assinatura.
Instância Gerenciada de SQL - Listar por grupo de recursos Retorna uma lista de instâncias gerenciadas em um grupo de recursos.
Instância Gerenciada de SQL - Atualizar Atualiza uma instância gerenciada.
Operações de Instância Gerenciada de SQL – Listar por Instância Gerenciada Obtém uma lista de operações de gerenciamento executadas na instância gerenciada.
Operações de Instância Gerenciada de SQL – Obter Obtém a operação de gerenciamento específica executada na instância gerenciada.
Operações de Instância Gerenciada de SQL – Cancelar Cancela a operação de gerenciamento específica executada na instância gerenciada.
Instâncias Gerenciadas de SQL - Agendamento de início/parada - Criar ou atualizar Cria ou atualiza um agendamento de início e parada de instância gerenciada
Instância Gerenciada de SQL - Agendamento de início/parada - Obter Obtém um agendamento de instância gerenciada de início e parada existente.
Instância Gerenciada de SQL - Agendamento de início/parada - Excluir Exclui um agendamento de início/parada de instância gerenciada existente.

Próximas etapas