Referência de API gerida para o Azure SQL Managed Instance

  • Artigo

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

Você pode criar e configurar instâncias gerenciadas da Instância Gerenciada SQL do Azure usando o portal do Azure, PowerShell, CLI do Azure, API REST e Transact-SQL. Neste artigo, você pode encontrar uma visão geral das funções e da API que você pode usar para criar e configurar instâncias gerenciadas.

Portal do Azure: Criar uma instância gerenciada

Para obter um guia de início rápido mostrando como criar uma instância gerenciada, consulte Guia de início rápido: criar uma instância gerenciada.

PowerShell: Criar e configurar instâncias gerenciadas

Nota

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

Importante

O módulo PowerShell Azure Resource Manager ainda é suportado pelo Banco de Dados SQL do Azure, mas todo o desenvolvimento futuro é para o módulo Az.Sql. Para esses cmdlets, consulte 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ê precisar instalar ou atualizar o PowerShell, consulte Instalar o módulo do Azure PowerShell.

Gorjeta

Para scripts de exemplo do PowerShell, consulte Script de início rápido: criar uma instância gerenciada usando uma biblioteca do PowerShell.

Cmdlet Description
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 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 SQL.
Get-AzSqlInstanceDatabase Retorna informações sobre um banco de dados de Instância Gerenciada SQL.
Remove-AzSqlInstanceDatabase Remove um banco de dados de Instância Gerenciada SQL.
Restore-AzSqlInstanceDatabase Restaura um banco de dados de instância gerenciada SQL.

CLI do Azure: Criar e configurar instâncias gerenciadas

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

Gorjeta

Para obter um início rápido da CLI do Azure, consulte Trabalhando com a instância gerenciada do SQL usando a CLI do Azure.

Cmdlet Description
az sql mi criar Cria uma instância gerenciada.
az sql mi lista Lista as instâncias gerenciadas disponíveis.
az sql mi show Obtém os detalhes de uma instância gerenciada.
az sql mi atualização Atualiza uma instância gerenciada.
az sql mi excluir Remove uma instância gerenciada.
lista de operações do az sql mi 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 cancelar Cancela a operação de gerenciamento específica executada na instância gerenciada.
az sql midb criar Cria um banco de dados gerenciado.
lista az sql midb Lista os bancos de dados gerenciados disponíveis.
az sql midb restore Restaura um banco de dados gerenciado.
az sql midb excluir Remove um banco de dados gerenciado.

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

Para criar e configurar bancos de dados de instância após a instância gerenciada ser criada, use os seguintes comandos T-SQL. 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.

Gorjeta

Para obter guias de início rápido mostrando como configurar e conectar-se a uma instância gerenciada usando o SQL Server Management Studio no Microsoft Windows, consulte Guia de início rápido: configurar a VM do Azure para se conectar à Instância Gerenciada SQL do Azure e Guia de início rápido: configurar uma conexão ponto a site com a Instância Gerenciada SQL do Azure local.

Importante

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

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

API REST: crie e configure instâncias gerenciadas

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

Comando Description
Instância gerenciada SQL - Criar ou atualizar Cria ou atualiza uma instância gerenciada.
Instância gerenciada SQL - Excluir Exclui uma instância gerenciada.
Instância gerenciada SQL - Obter Obtém uma instância gerenciada.
Instância gerenciada SQL - Parar Interrompe uma instância gerenciada.
Instância gerenciada SQL - Iniciar Inicia uma instância gerenciada
Instância gerenciada SQL - Lista Retorna uma lista de instâncias gerenciadas em uma assinatura.
Instância gerenciada SQL - Lista por grupo de recursos Retorna uma lista de instâncias gerenciadas em um grupo de recursos.
Instância gerenciada SQL - Atualização Atualiza uma instância gerenciada.
Operações de instância gerenciada SQL - Lista por instância gerenciada Obtém uma lista de operações de gerenciamento executadas na instância gerenciada.
Operações de instância gerenciada SQL - Obter Obtém a operação de gerenciamento específica executada na instância gerenciada.
Operações de instância gerenciada SQL - Cancelar Cancela a operação de gerenciamento específica executada na instância gerenciada.
Instância gerenciada SQL - Agendamento de início/parada - Criar ou atualizar Cria ou atualiza uma agenda de instâncias gerenciadas de início e parada.
Instância gerenciada SQL - Agenda de início/parada - Obter Obtém um agendamento de instância gerenciada de início e interrupção existente.
SQL Managed Instance - Start/Stop schedule - Delete Exclui uma agenda de instância gerenciada de início e parada existente.

Próximos passos