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 Database에서 지원되지만 향후의 모든 개발은 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 - 만들기 또는 업데이트 관리되는 인스턴스를 만들거나 업데이트합니다.
SQL Managed Instance - 삭제 관리되는 인스턴스를 삭제합니다.
SQL Managed Instance - 가져오기 관리되는 인스턴스를 가져옵니다.
SQL Managed Instance - 중지 관리되는 인스턴스를 중지합니다.
SQL Managed Instance - 시작 관리되는 인스턴스 시작
SQL Managed Instance - 목록 구독의 관리되는 인스턴스 목록을 반환합니다.
SQL Managed Instance - 리소스 그룹별 목록 리소스 그룹의 관리되는 인스턴스 목록을 반환합니다.
SQL Managed Instance - 업데이트 관리되는 인스턴스를 업데이트.
SQL Managed Instance 작업 - Managed Instance별 목록 관리형 인스턴스에서 수행한 관리 작업 목록을 가져옵니다.
SQL Managed Instance 작업 - 가져오기 관리형 인스턴스에서 수행되는 특정 관리 작업을 가져옵니다.
SQL Managed Instance 작업 - 취소 관리되는 인스턴스에서 수행되는 특정 관리 작업을 취소합니다.
SQL Managed Instance - 시작/중지 일정 - 만들기 또는 업데이트 시작 및 중지 관리되는 인스턴스 일정을 만들거나 업데이트합니다.
SQL Managed Instance - 시작/중지 일정 - 가져오기 기존 시작 및 중지 관리되는 인스턴스 일정을 가져옵니다.
SQL Managed Instance - 시작/중지 일정 - 삭제 하면 기존 시작 및 중지 관리되는 인스턴스 일정이 삭제됩니다.

다음 단계

  • SQL Server 데이터베이스를 Azure로 마이그레이션하는 방법에 대한 자세한 내용은 Azure SQL Database로 마이그레이션을 참조하세요.
  • 지원되는 기능에 대한 자세한 내용은 기능을 참조하세요.