Azure SQL Managed Instance에 대한 관리 API 참조
적용 대상: 
Azure SQL Managed Instance
Azure Portal, PowerShell, Azure CLI, REST API 및 Transact-SQL을 사용하여 Azure SQL Managed Instance의 관리형 인스턴스를 만들고 구성할 수 있습니다. 이 문서에서는 관리형 인스턴스를 만들고 구성하는 데 사용할 수 있는 기능 및 API 개요를 제공합니다.
Azure Portal: 관리형 인스턴스 만들기
관리형 인스턴스를 만드는 방법을 보여 주는 빠른 시작은 빠른 시작: 관리형 인스턴스 만들기를 참조하세요.
PowerShell: 관리형 인스턴스 만들기 및 구성
참고 항목
이 문서에서는 Azure와 상호 작용하는 데 권장되는 PowerShell 모듈인 Azure Az PowerShell 모듈을 사용합니다. Az PowerShell 모듈을 시작하려면 Azure PowerShell 설치를 참조하세요. Az PowerShell 모듈로 마이그레이션하는 방법에 대한 자세한 내용은 Azure PowerShell을 AzureRM에서 Azure로 마이그레이션을 참조하세요.
중요
PowerShell Azure Resource Manager 모듈은 여전히 Azure SQL 데이터베이스에서 지원되지만 향후의 모든 개발은 Az.Sql 모듈을 위한 것입니다. 이러한 cmdlet은 AzureRM.Sql을 참조하세요. Az 모듈 및 AzureRM 모듈의 명령에 대한 인수는 사실상 동일합니다.
Azure PowerShell을 사용하여 관리형 인스턴스를 만들고 관리하려면 다음 PowerShell cmdlet을 사용합니다. PowerShell을 설치하거나 업그레이드해야 하는 경우 Azure PowerShell 모듈 설치를 참조하세요.
팁
PowerShell 예제 스크립트는 빠른 시작 스크립트: PowerShell 라이브러리를 사용하여 관리형 인스턴스 만들기를 참조하세요.
| cmdlet | 설명 |
|---|---|
| New-AzSqlInstance | 관리형 인스턴스를 생성합니다. |
| Get-AzSqlInstance | 관리형 인스턴스 관련 정보를 반환합니다. |
| Set-AzSqlInstance | 관리형 인스턴스에 대한 속성을 설정합니다. |
| Remove-AzSqlInstance | 관리형 인스턴스를 제거합니다. |
| Get-AzSqlInstanceOperation | 관리형 인스턴스에서 수행한 관리 작업 목록 또는 특정 작업을 가져옵니다. |
| Stop-AzSqlInstanceOperation | 관리형 인스턴스에서 수행되는 특정 관리 작업을 취소합니다. |
| New-AzSqlInstanceDatabase | SQL Managed Instance 데이터베이스를 만듭니다. |
| Get-AzSqlInstanceDatabase | SQL Managed Instance 데이터베이스 관련 정보를 반환합니다. |
| Remove-AzSqlInstanceDatabase | SQL Managed Instance 데이터베이스를 제거합니다. |
| Restore-AzSqlInstanceDatabase | SQL Managed Instance 데이터베이스를 복원합니다. |
Azure CLI: 관리형 인스턴스 만들기 및 구성
Azure CLI를 사용하여 관리형 인스턴스를 만들고 구성하려면 다음과 같은 SQL Managed Instance용 Azure CLI 명령을 사용합니다. Azure Cloud Shell을 사용하여 브라우저에서 Azure CLI를 실행하거나 macOS, Linux 또는 Windows에서 설치합니다.
팁
Azure CLI 빠른 시작은 Azure CLI를 사용하여 SQL Managed Instance 작업을 참조하세요.
| cmdlet | 설명 |
|---|---|
| az sql mi create | 관리형 인스턴스를 생성합니다. |
| az sql mi list | 사용 가능한 관리형 인스턴스를 나열합니다. |
| az sql mi show | 관리형 인스턴스 관련 세부 정보를 가져옵니다. |
| az sql mi update | 관리형 인스턴스를 업데이트합니다. |
| az sql mi delete | 관리형 인스턴스를 제거합니다. |
| az sql mi op list | 관리형 인스턴스에서 수행한 관리 작업 목록을 가져옵니다. |
| az sql mi op show | 관리형 인스턴스에서 수행되는 특정 관리 작업을 가져옵니다. |
| az sql mi op cancel | 관리형 인스턴스에서 수행되는 특정 관리 작업을 취소합니다. |
| az sql midb create | 관리형 데이터베이스를 만듭니다. |
| az sql midb list | 사용 가능한 관리형 데이터베이스를 나열합니다. |
| az sql midb restore | 관리형 데이터베이스를 복원합니다. |
| az sql midb delete | 관리형 데이터베이스를 제거합니다. |
Transact-SQL: 인스턴스 데이터베이스 만들기 및 구성
관리형 인스턴스를 만든 후에 인스턴스 데이터베이스를 만들고 구성하려면 다음 T-SQL 명령을 사용합니다. Azure Portal, SQL Server Management Studio, Azure Data Studio, Visual Studio Code 또는 서버에 연결하여 Transact-SQL 명령을 전달할 수 있는 다른 프로그램을 사용하여 이러한 명령을 실행할 수 있습니다.
팁
Microsoft Windows에서 SQL Server Management Studio를 사용하여 관리형 인스턴스를 구성하고 연결하는 방법을 보여 주는 빠른 시작은 빠른 시작: Azure SQL Managed Instance에 연결하도록 Azure VM 구성과 빠른 시작: 온-프레미스에서 Azure SQL Managed Instance로의 지점 및 사이트 간 연결 구성을 참조하세요.
Important
Transact-SQL을 사용하여 관리형 인스턴스를 만들거나 삭제할 수 없습니다.
| 명령 | 설명 |
|---|---|
| CREATE DATABASE | SQL Managed Instance에서 새 인스턴스 데이터베이스를 만듭니다. 새 데이터베이스를 만들려면 master 데이터베이스에 연결해야 합니다. |
| ALTER DATABASE | SQL Managed Instance에서 인스턴스 데이터베이스를 수정합니다. |
REST API: 관리형 인스턴스 만들기 및 구성
관리형 인스턴스를 만들고 구성하려면 다음 REST API 요청을 사용합니다.
| 명령 | 설명 |
|---|---|
| SQL Managed Instance - Create 또는 Update | 관리형 인스턴스를 만들거나 업데이트합니다. |
| SQL Managed Instance - Delete | 관리형 인스턴스를 삭제합니다. |
| SQL Managed Instance - Get | 관리형 인스턴스를 가져옵니다. |
| SQL Managed Instance - Stop | 관리형 인스턴스를 중지합니다. |
| SQL Managed Instance - Start | 관리형 인스턴스를 시작합니다. |
| SQL Managed Instance - List | 구독의 관리형 인스턴스 목록을 반환합니다. |
| SQL Managed Instance - List By Resource Group | 리소스 그룹에서 관리형 인스턴스 목록을 반환합니다. |
| SQL Managed Instance - Update | 관리형 인스턴스를 업데이트합니다. |
| SQL Managed Instance 작업 - List By Managed Instance | 관리형 인스턴스에서 수행한 관리 작업 목록을 가져옵니다. |
| SQL Managed Instance operations - Get | 관리형 인스턴스에서 수행되는 특정 관리 작업을 가져옵니다. |
| SQL Managed Instance 작업 - Cancel | 관리형 인스턴스에서 수행되는 특정 관리 작업을 취소합니다. |
| SQL Managed Instance - 시작/중지 일정 - Create 또는 Update | 관리형 인스턴스 시작 및 중지 일정을 만들거나 업데이트합니다. |
| SQL Managed Instance - 시작/중지 일정 - Get | 기존 관리형 인스턴스 시작 및 중지 일정을 가져옵니다. |
| SQL Managed Instance - 시작/중지 일정 - Delete 기존 관리형 인스턴스 시작 및 중지 일정을 삭제합니다. |
다음 단계
- SQL Server 데이터베이스를 Azure로 마이그레이션하는 방법에 대한 자세한 내용은 Azure SQL Database로 마이그레이션을 참조하세요.
- 지원되는 기능에 대한 자세한 내용은 기능을 참조하세요.