Referência da API gerenciada para a Instância Gerenciada SQL do Azure
Aplica-se a:
de 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
Observação
Este artigo usa o módulo Azure Az PowerShell, que é o módulo PowerShell recomendado para interagir com o Azure. Para começar a usar o módulo Az PowerShell, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo Az PowerShell, consulte Migrar o Azure PowerShell do AzureRM para o Az.
Importante
O módulo Az substitui AzureRM. Todo o desenvolvimento futuro é para o módulo Az.Sql.
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.
Dica
Para scripts de exemplo do PowerShell, consulte 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 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 da CLI do Azure, use os seguintes comandos da CLI do Azure para a Instância Gerenciada do SQL. Use do Azure Cloud Shell para executar a CLI do Azure em seu navegador ou instalar ele no macOS, Linux ou Windows.
Dica
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 | 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 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, SQL Server Management Studio, Azure Data Studio, Visual Studio Codeou qualquer outro programa que possa se conectar a um servidor e passar comandos Transact-SQL.
Dica
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 ao da 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 a partir delocais.
Importante
Não é possível criar ou excluir uma instância gerenciada usando Transact-SQL.
| Comando | Descrição |
|---|---|
| CRIAR BANCO DE DADOS | Cria um novo banco de dados de instância na Instância Gerenciada SQL. Você deve estar conectado ao banco de dados master para criar um novo banco de dados. |
| BANCO DE DADOS ALTER | 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 | Descrição |
|---|---|
| SQL Managed Instance - Criar ou atualizar | Cria ou atualiza uma instância gerenciada. |
| SQL Managed Instance - Excluir | Exclui uma instância gerenciada. |
| SQL Managed Instance - Obtenha | Obtém uma instância gerenciada. |
| SQL Managed Instance - Parar | Interrompe uma instância gerenciada. |
| Instância Gerenciada SQL - Iniciar | Inicia uma instância gerenciada |
| SQL Managed Instance - 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. |
| SQL Managed Instance - 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 - Obtenha | 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. |
| SQL Managed Instance - Start/Stop schedule- Criar ou atualizar | Cria ou atualiza uma agenda de instâncias gerenciadas de início e parada. |
| SQL Managed Instance - Agenda de início/parada - Get | Obtém um agendamento de instância gerenciada de início e interrupção existente. |
| SQL Managed Instance - Start/Stop schedule - Delete Exclui um agendamento de instância gerenciada de início e interrupção existente. |
Próximos passos
- Para saber mais sobre como migrar um banco de dados do SQL Server para o Azure, consulte Migrar para o Banco de Dados SQL do Azure.
- Para obter informações sobre os recursos suportados, consulte Recursos.