Gerenciamento da referência de API para Instâncias Gerenciadas do Banco de Dados SQL do AzureManaged API reference for Azure SQL Database Managed Instances

É possível criar e gerenciar Instâncias Gerenciadas do Banco de Dados SQL do Azure usando o portal do Azure, o PowerShell, a CLI do Azure, a API REST e o Transact-SQL.You can create and manage Azure SQL Database Managed Instances using the Azure portal, PowerShell, Azure CLI, REST API, and Transact-SQL. Neste artigo, você encontra uma visão geral das funções e API que você pode usar para criar e configurar a instância gerenciada.In this article, you can find an overview of functions and API that you can use to create and configure Managed Instance.

Portal do Azure: Criar uma instância gerenciadaAzure portal: Create a managed instance

Para ver um início rápido mostrando como criar uma nova Instância Gerenciada do Banco de Dados SQL do Azure, consulte Início Rápido: Criar uma Instância Gerenciada do Banco de Dados SQL do Azure.For a quickstart showing you how to create an Azure SQL Database Managed Instance, see Quickstart: Create an Azure SQL Database Managed Instance.

PowerShell: Criar e gerenciar instâncias gerenciadasPowerShell: Create and manage managed instances

Observação

Este artigo foi atualizado para usar o novo módulo Az do Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Você ainda pode usar o módulo AzureRM, que continuará a receber as correções de bugs até pelo menos dezembro de 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Para saber mais sobre o novo módulo Az e a compatibilidade com o AzureRM, confira Apresentação do novo módulo Az do Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Para obter instruções de instalação do módulo Az, confira Instalar o Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

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.The PowerShell Azure Resource Manager module is still supported by Azure SQL Database, but all future development is for the Az.Sql module. Para esses cmdlets, consulte AzureRM. SQL.For these cmdlets, see AzureRM.Sql. Os argumentos para os comandos no módulo AZ e nos módulos AzureRm são substancialmente idênticos.The arguments for the commands in the Az module and in the AzureRm modules are substantially identical.

Para criar e gerenciar instâncias gerenciadas com o Azure PowerShell, use os seguintes cmdlets do PowerShell.To create and manage managed instances with Azure PowerShell, use the following PowerShell cmdlets. Se você precisa instalar ou atualizar o PowerShell, confira Instalar o módulo do Azure PowerShell.If you need to install or upgrade PowerShell, see Install Azure PowerShell module.

CmdletCmdlet DescriçãoDescription
New-AzSqlInstanceNew-AzSqlInstance Cria uma Instância Gerenciada do Banco de Dados SQL do AzureCreates an Azure SQL Database Managed Instance
Get-AzSqlInstanceGet-AzSqlInstance Retorna informações sobre a Instância Gerenciada do SQL do AzureReturns information about Azure SQL Managed Instance
Set-AzSqlInstanceSet-AzSqlInstance Define propriedades para uma Instância Gerenciada do Banco de Dados SQL do AzureSets properties for an Azure SQL Database Managed Instance
Remove-AzSqlInstanceRemove-AzSqlInstance Remove uma Instância Gerenciada do Banco de Dados SQL do AzureRemoves an Azure SQL Managed Database Instance
New-AzSqlInstanceDatabaseNew-AzSqlInstanceDatabase Cria um banco de dados de Instância Gerenciada do Banco de Dados SQL do AzureCreates an Azure SQL Database Managed Instance database
Get-AzSqlInstanceDatabaseGet-AzSqlInstanceDatabase Retorna informações sobre o banco de dados de Instância Gerenciada do SQL do AzureReturns information about Azure SQL Managed Instance database
Remove-AzSqlInstanceDatabaseRemove-AzSqlInstanceDatabase Remove um banco de dados de Instância Gerenciada do Banco de Dados SQL do AzureRemoves an Azure SQL Managed Database Instance database
Restore-AzSqlInstanceDatabaseRestore-AzSqlInstanceDatabase Restaura um banco de dados de Instância Gerenciada do Banco de Dados SQL do AzureRestores an Azure SQL Managed Database Instance database

CLI do Azure: Criar e gerenciar instâncias gerenciadasAzure CLI: Create and manage managed instances

Para criar e gerenciar instâncias gerenciadas com a CLI do Azure, use os seguintes comandos da Instância Gerenciada do SQL da CLI do Azure.To create and manage managed instances with Azure CLI, use the following Azure CLI SQL Managed Instance commands. Use o Cloud Shell para executar a CLI no seu navegador ou instale-o no macOS, Linux ou Windows.Use the Cloud Shell to run the CLI in your browser, or install it on macOS, Linux, or 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.For an Azure CLI quickstart, see Working with SQL Managed Instance using Azure CLI.

CmdletCmdlet DescriçãoDescription
az sql mi createaz sql mi create Cria uma instância gerenciadaCreates a Managed Instance
az sql mi listaz sql mi list Lista as instâncias gerenciadas disponíveisLists available Managed Instances
az sql mi showaz sql mi show Obtém os detalhes de uma instância gerenciadaGet the details for a Managed Instance
az sql mi updateaz sql mi update Atualiza uma instância gerenciadaUpdates a Managed Instance
az sql mi deleteaz sql mi delete Remove uma instância gerenciadaRemoves a Managed Instance
az sql midb createaz sql midb create Cria um banco de dados gerenciadoCreates a managed database
az sql midb listaz sql midb list Lista os bancos de dados gerenciados disponíveisLists available managed databases
az sql midb restoreaz sql midb restore Restaura um banco de dados gerenciadoRestore a managed database
az sql midb deleteaz sql midb delete Remove um banco de dados gerenciadoRemoves a managed database

Transact-SQL: Criar e gerenciar bancos de dados de instânciaTransact-SQL: Create and manage instance databases

Para criar e gerenciar o banco de dados de instância após a criação da Instância Gerenciada, use os seguintes comandos T-SQL.To create and manage instance database after the Managed Instance is created, use the following T-SQL commands. É possível emitir esses comandos usando o portal do Azure, SQL Server Management Studio, Azure Data Studio.You can issue these commands using the Azure portal, SQL Server Management Studio, Azure Data Studio. Visual Studio Code, ou qualquer outro programa que possa conectar a um servidor do Banco de Dados SQL do Azure e passar comandos Transact-SQL.Visual Studio Code, or any other program that can connect to an Azure SQL Database server and pass Transact-SQL commands.

Dica

Para ver inícios rápidos mostrando que você precisa configurar e conectar a uma instância gerenciada usando o SQL Server Management Studio no Microsoft Windows, consulte Início Rápido: Configurar a VM do Azure para conectar a uma Instância Gerenciada do Banco de Dados SQL do Azure e Início Rápido: Configurar uma conexão ponto a site para uma Instância Gerenciada do Banco de Dados SQL do Azure do local.For quickstarts showing you have to configure and connect to a Managed Instance using SQL Server Management Studio on Microsoft Windows, see Quickstart: Configure Azure VM to connect to an Azure SQL Database Managed Instance and Quickstart: Configure a point-to-site connection to an Azure SQL Database Managed Instance from on-premises.

Importante

Não é possível criar ou excluir uma instância gerenciada usando o Transact-SQL.You cannot create or delete a Managed Instance using Transact-SQL.

ComandoCommand DescriçãoDescription
CREATE DATABASECREATE DATABASE Cria um novo banco de dados de instância gerenciada.Creates a new Managed Instance database. Você deve estar conectado ao banco de dados mestre para criar um novo banco de dados.You must be connected to the master database to create a new database.
ALTER DATABASEALTER DATABASE Modifica o banco de dados de Instância Gerenciada do SQL do Azure.Modifies an Azure SQL Managed Instance database.

API REST: Criar e gerenciar instâncias gerenciadasREST API: Create and manage managed instances

Para criar e gerenciar Instâncias Gerenciadas, use estas solicitações de API REST.To create and manage Managed Instances, use these REST API requests.

ComandoCommand DescriçãoDescription
Managed Instances - Create Or UpdateManaged Instances - Create Or Update Cria ou atualiza uma instância gerenciada.Creates or updates a Managed Instance.
Managed Instances - DeleteManaged Instances - Delete Exclui uma instância gerenciada.Deletes a Managed Instance.
Managed Instances - GetManaged Instances - Get Obtém uma instância gerenciada.Gets a Managed Instance.
Managed Instances - ListManaged Instances - List Retorna uma lista de instâncias gerenciadas em uma assinatura.Returns a list of Managed Instances in a subscription.
Managed Instances - List By Resource GroupManaged Instances - List By Resource Group Retorna uma lista de instâncias gerenciadas em um grupo de recursos.Returns a list of Managed Instances in a resource group.
Managed Instances - UpdateManaged Instances - Update Atualiza uma instância gerenciada.Updates a Managed Instance.

Próximas etapasNext steps