Azure MCP Server를 사용하면 자연어 프롬프트를 사용하여 데이터베이스 만들기, 삭제, 업데이트 및 나열을 비롯한 Azure SQL Database 리소스를 관리할 수 있습니다.
Azure SQL Database 고가용성, 확장성 및 보안을 제공하는 Microsoft Azure 클라우드의 관계형 데이터베이스 서비스입니다. 자세한 내용은 Azure SQL Database 설명서 참조하세요.
Note
도구 매개 변수: Azure MCP 서버 도구는 작업을 완료하는 데 필요한 데이터에 대한 매개 변수를 정의합니다. 이러한 매개 변수 중 일부는 각 도구와 관련이 있으며 아래에 설명되어 있습니다. 다른 매개 변수는 전역이며 모든 도구에서 공유됩니다. 자세한 내용은 도구 매개 변수를 참조하세요.
SQL Database 만들기
기존의 SQL Server에서 새로운 Azure SQL Database를 만드십시오. 구성 가능한 성능 계층, 크기 제한 및 기타 설정을 사용하여 데이터베이스를 만듭니다. 구성 세부 정보를 포함하여 새로 만든 데이터베이스 정보를 반환합니다.
예 프롬프트는 다음과 같습니다.
- "서버 'my-sql-server'에서 SKU 계층 프리미엄을 사용하여 'my-database'라는 SQL 데이터베이스를 만듭니다."
- "서버 'my-sql-server'의 리소스 그룹 'my-resource-group'에 'products-db'라는 새 SQL 데이터베이스를 만듭니다."
- "서버 'my-sql-server'에서 최대 크기가 2GB인 SQL 데이터베이스 'reports-db'를 만듭니다."
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 데이터베이스 이름 | Required | Azure SQL Database 이름입니다. |
| 리소스 그룹 | Required | Azure 리소스 그룹의 이름입니다. Azure 리소스에 대한 논리적 컨테이너입니다. |
| 서버 이름 | Required | Azure SQL Server 이름입니다. |
| Collation | 선택적 | 데이터베이스에 대한 데이터 정렬(예: SQL_Latin1_General_CP1_CI_AS |
| 엘라스틱 풀 이름 | 선택적 | 데이터베이스를 할당할 탄력적 풀의 이름입니다. |
| 최대 크기 바이트 | 선택적 | 데이터베이스의 최대 크기(바이트)입니다. |
| 읽기 크기 조정 | 선택적 | 데이터베이스에 대한 크기 조정 옵션 읽기(사용 또는 사용 안 함). |
| SKU 용량 | 선택적 | 데이터베이스에 대한 SKU 용량(DTU 또는 vCore 수)입니다. |
| SKU 이름 | 선택적 | 데이터베이스의 SKU 이름(예: Basic, , S0P1) GP_Gen5_2 |
| SKU 계층 | 선택적 | 데이터베이스에 대한 SKU 계층(예: Basic, , StandardPremiumGeneralPurpose) |
| 영역 중복 | 선택적 | 데이터베이스가 영역 중복성이어야 하는지 여부를 나타냅니다. |
파괴: ✅ | 멱등성: ❌ | 오픈 월드: ❌ | 읽기 전용: ❌ | 비밀: ❌ | 로컬 필수: ❌
SQL Server 만들기
지정된 리소스 그룹 및 위치에 새 Azure SQL 서버를 만듭니다. 서버는 제공된 관리자 자격 증명 및 선택적 설정으로 구성됩니다. 이 명령은 정규화된 도메인 이름을 포함하여 생성된 서버를 해당 속성과 함께 반환합니다.
예 프롬프트는 다음과 같습니다.
- "관리자 로그인 'sqladmin'을 사용하여 'eastus' 위치에 'my-sql-server'라는 Azure SQL 서버를 만듭니다."
- "관리자 암호를 사용하여 리소스 그룹 'my-resource-group'에서 'prod-sql-server'라는 새 SQL Server를 설정합니다."
- "'westus2'에 있는 리소스 그룹 'dev-resource-group'에서 이름이 'dev-sql-server'인 SQL Server를 만듭니다."
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 관리자 로그인 | Required | SQL Server의 관리자 로그인 이름입니다. |
| 관리자 암호 | Required | SQL Server의 관리자 암호입니다. |
| 위치 | Required | SQL Server를 만들 Azure 지역입니다. |
| 리소스 그룹 | Required | Azure 리소스에 대한 논리적 컨테이너인 Azure 리소스 그룹의 이름입니다. |
| 서버 이름 | Required | Azure SQL Server 이름입니다. |
| 공용 네트워크 액세스 | 선택적 | SQL Server(Enabled 또는 Disabled)에 대해 공용 네트워크 액세스를 사용할 수 있는지 여부입니다. |
| 버전 | 선택적 | 만들 SQL Server 버전입니다(현재 12.0만 지원됨). |
파괴: ✅ | 멱등성: ❌ | 오픈 월드: ❌ | 읽기 전용: ❌ | 비밀: ❌ | 로컬 필수: ❌
SQL Server 방화벽 규칙 만들기
Azure SQL Server 대한 방화벽 규칙을 만듭니다. 방화벽 규칙은 SQL Server 연결할 수 있는 IP 주소를 제어합니다. 시작 및 끝 IP를 동일한 값으로 설정하여 단일 IP 주소 또는 IP 주소 범위를 지정할 수 있습니다. 이 명령은 해당 속성을 사용하여 만든 방화벽 규칙을 반환합니다.
예 프롬프트는 다음과 같습니다.
- "리소스 그룹 'my-resource-group'에서 SQL Server 'my-sql-server'에 대해 'allow-office-ip'라는 방화벽 규칙을 만듭니다."
- "IP 범위 '203.0.113.0'에서 '203.0.113.255'로 허용하는 SQL Server 'my-sql-server'에 대한 방화벽 규칙을 추가합니다."
- "IP 제한이 '198.51.100.0'에서 '198.51.100.255'로 제한되는 Azure SQL Server 'prod-sql-server'에 대한 새 방화벽 규칙을 만듭니다."
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 끝 IP 주소 | Required | 방화벽 규칙 범위의 끝 IP 주소입니다. |
| 방화벽 규칙 이름 | Required | 방화벽 규칙의 이름입니다. |
| 리소스 그룹 | Required | Azure 리소스 그룹의 이름입니다. Azure 리소스에 대한 논리적 컨테이너입니다. |
| 서버 이름 | Required | Azure SQL Server 이름입니다. |
| IP 주소 시작 | Required | 방화벽 규칙 범위의 시작 IP 주소입니다. |
파괴: ✅ | 멱등성: ❌ | 오픈 월드: ❌ | 읽기 전용: ❌ | 비밀: ❌ | 로컬 필수: ❌
SQL 데이터베이스 삭제
Azure SQL Server 데이터베이스를 삭제합니다. 이 idempotent 작업은 지정된 데이터베이스를 서버에서 제거하여 Deleted = false 데이터베이스가 존재하지 Deleted = true 않거나 성공적으로 제거되었는지를 반환합니다.
예 프롬프트는 다음과 같습니다.
- "서버 'my-sql-server'에서 SQL 데이터베이스 'my-database'를 삭제합니다."
- "서버 'my-sql-server'의 리소스 그룹 'my-resource-group'에서 데이터베이스 'old-database'를 제거합니다."
- "SQL Server 'dev-sql-server'에서 데이터베이스 'test-database'를 삭제합니다."
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 데이터베이스 이름 | Required | Azure SQL Database 이름입니다. |
| 리소스 그룹 | Required | Azure 리소스 그룹의 이름입니다. Azure 리소스에 대한 논리적 컨테이너입니다. |
| 서버 이름 | Required | Azure SQL Server 이름입니다. |
파괴: ✅ | 멱등성: ✅ | 오픈 월드: ❌ | 읽기 전용: ❌ | 비밀: ❌ | 로컬 필수: ❌
SQL Server 삭제
연결된 모든 데이터베이스를 포함하여 Azure 구독에서 지정된 Azure SQL 서버를 제거합니다. 이 작업은 모든 서버 데이터를 영구적으로 삭제하며 되돌릴 수 없습니다. 확인을 넘어가는 데 force를 사용합니다.
예 프롬프트는 다음과 같습니다.
- "리소스 그룹 'my-resource-group'에서 SQL Server 'my-sql-server'를 삭제합니다."
- "Azure SQL 서버 'old-sql-server'를 리소스 그룹에서 제거합니다."
- "확인 없이 SQL Server 'test-sql-server'를 영구적으로 삭제합니다."
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 리소스 그룹 | Required | Azure 리소스 그룹의 이름입니다. Azure 리소스에 대한 논리적 컨테이너입니다. |
| 서버 이름 | Required | Azure SQL Server 이름입니다. |
| 강제 | 선택적 | 확인 프롬프트 없이 서버를 강제로 삭제합니다. |
파괴: ✅ | 멱등성: ✅ | 오픈 월드: ❌ | 읽기 전용: ❌ | 비밀: ❌ | 로컬 필수: ❌
SQL Server 방화벽 규칙 삭제
Azure SQL Server 방화벽 규칙을 삭제합니다. 이 작업은 지정된 방화벽 규칙을 제거합니다. 이 규칙은 이전에 이 규칙에서 허용한 IP 주소에 대한 액세스를 제한할 수 있습니다. 작업은 idempotent입니다. 규칙이 없으면 오류가 반환되지 않습니다.
예 프롬프트는 다음과 같습니다.
- "SQL Server 'my-sql-server'의 리소스 그룹 'my-resource-group'에서 방화벽 규칙 'allow-office-ip'를 삭제합니다."
- "리소스 그룹 'my-resource-group'에서 SQL Server 'my-sql-server'에 대한 방화벽 규칙 'temp-access-rule'을 제거합니다."
- "내 SQL Server 'dev-sql-server'에서 방화벽 규칙 'old-firewall-rule'을 삭제합니다."
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 방화벽 규칙 이름 | Required | 방화벽 규칙의 이름입니다. |
| 리소스 그룹 | Required | Azure 리소스 그룹의 이름입니다. Azure 리소스에 대한 논리적 컨테이너입니다. |
| 서버 이름 | Required | Azure SQL Server 이름입니다. |
파괴: ✅ | 멱등성: ✅ | 오픈 월드: ❌ | 읽기 전용: ❌ | 비밀: ❌ | 로컬 필수: ❌
Azure SQL Database 세부 정보 가져오기
SQL Server의 Azure SQL 데이터베이스에 대한 정보를 검색합니다. 이름으로 특정 Azure SQL 데이터베이스에 대한 세부 정보를 표시하거나 지정된 SQL Server 내의 모든 Azure SQL 데이터베이스를 나열할 수 있습니다. 이 도구는 구성 세부 정보 및 현재 상태를 포함한 데이터베이스 정보를 제공합니다.
예 프롬프트는 다음과 같습니다.
- "서버 'my-server'에 대한 리소스 그룹 'my-rg'의 모든 데이터베이스를 나열합니다."
- "리소스 그룹 'my-rg' 및 서버 'my-server'에서 Azure SQL 데이터베이스 'my-database'에 대한 세부 정보를 가져옵니다."
- "'my-server' 서버 내 'my-rg' 리소스 그룹의 모든 Azure SQL 데이터베이스를 표시합니다."
- "'my-server' 서버의 리소스 그룹 'my-rg'에서 Azure SQL 데이터베이스 'my-database'를 검색합니다."
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 리소스 그룹 | Required | Azure 리소스 그룹의 이름입니다. Azure 리소스에 대한 논리적 컨테이너입니다. |
| 서버 이름 | Required | Azure SQL Server 이름입니다. |
| 데이터베이스 이름 | 선택적 | Azure SQL Database 이름입니다. |
파괴: ❌ | 멱등성: ✅ | 오픈 월드: ❌ | 읽기 전용: ✅ | 비밀: ❌ | 로컬 필수: ❌
탄력적 풀 목록 가져오기
SKU, 용량, 상태 및 데이터베이스 제한을 포함하여 Azure SQL Server 모든 SQL 탄력적 풀을 나열합니다. 탄력적 풀 인벤토리를 보거나, 풀 사용률을 확인하거나, 풀 구성을 비교하거나, 데이터베이스 배치에 사용할 수 있는 풀을 찾을 수 있습니다. 이 도구는 전체 구성 세부 정보가 포함된 탄력적 풀의 JSON 배열을 반환합니다.
예 프롬프트는 다음과 같습니다.
- "SQL Server 'my-sql-server'에 대한 리소스 그룹 'my-resource-group'의 모든 탄력적 풀을 나열합니다."
- SQL Server 'prod-sql-server'의 리소스 그룹 'prod-resource-group'에 있는 탄력적 풀을 보여 주세요.
- 리소스 그룹 'dev-resource-group'에 있는 SQL Server 'dev-sql-server'에는 어떤 '탄력적 풀'이 있나요?
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 리소스 그룹 | Required | Azure 리소스 그룹의 이름입니다. Azure 리소스에 대한 논리적 컨테이너입니다. |
| 서버 이름 | Required | Azure SQL Server 이름입니다. |
파괴: ❌ | 멱등성: ✅ | 오픈 월드: ❌ | 읽기 전용: ✅ | 비밀: ❌ | 로컬 필수: ❌
방화벽 규칙 목록 가져오기
Azure SQL Server 대한 방화벽 규칙 목록을 검색합니다. 이 명령은 IP 주소 범위 및 규칙 이름을 포함하여 지정된 SQL 서버에 대해 구성된 모든 방화벽 규칙을 검색합니다. 속성이 있는 방화벽 규칙 개체의 배열을 반환합니다.
예 프롬프트는 다음과 같습니다.
- "SQL Server 'my-sql-server'에 대한 리소스 그룹 'my-resource-group'의 모든 방화벽 규칙을 나열합니다."
- "SQL Server 'prod-sql-server'에 대한 리소스 그룹 'prod-resource-group'의 방화벽 규칙을 표시합니다."
- "리소스 그룹 'dev-resource-group'에서 SQL Server 'dev-sql-server'에 대해 어떤 방화벽 규칙이 설정됩니까?"
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 리소스 그룹 | Required | Azure 리소스 그룹의 이름입니다. Azure 리소스에 대한 논리적 컨테이너입니다. |
| 서버 이름 | Required | Azure SQL Server 이름입니다. |
파괴: ❌ | 멱등성: ✅ | 오픈 월드: ❌ | 읽기 전용: ✅ | 비밀: ❌ | 로컬 필수: ❌
SQL Server 정보 가져오기
리소스 그룹의 Azure SQL 서버에 대한 세부 정보를 검색합니다. 이름으로 특정 Azure SQL 서버에 대한 정보를 표시하거나 지정된 리소스 그룹 내의 모든 Azure SQL 서버를 나열합니다. 구성 세부 정보 및 현재 상태를 포함하여 포괄적인 서버 정보를 반환합니다.
예 프롬프트는 다음과 같습니다.
- "리소스 그룹 'my-resource-group'의 모든 Azure SQL 서버를 나열합니다."
- "리소스 그룹 'prod-resource-group'의 모든 Azure SQL 서버를 표시합니다."
- "Azure SQL 서버 'my-sql-server'의 세부 정보를 표시합니다."
- "Azure SQL 서버 'prod-sql-server'에 대한 정보를 가져옵니다."
- "Azure SQL 서버 'dev-sql-server'의 속성을 표시합니다."
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 리소스 그룹 | Required | Azure 리소스 그룹의 이름입니다. Azure 리소스에 대한 논리적 컨테이너입니다. |
| 서버 이름 | 선택적 | Azure SQL 서버 이름입니다. |
파괴: ❌ | 멱등성: ✅ | 오픈 월드: ❌ | 읽기 전용: ✅ | 비밀: ❌ | 로컬 필수: ❌
Microsoft Entra ID 관리자 목록
SQL 서버에 대해 구성된 Microsoft Entra ID 관리자를 나열합니다. 이 명령은 표시 이름, 개체 ID 및 테넌트 정보를 포함하여 모든 Entra ID 관리자를 검색합니다.
예 프롬프트는 다음과 같습니다.
- "리소스 그룹 'prod-resource-group'에서 SQL Server 'prod-sql-server'에 대한 Microsoft Entra ID 관리자를 나열합니다."
- 리소스 그룹 'dev-resource-group'의 SQL 서버 'dev-sql-server'에 대해 구성된 Entra ID 관리자를 보여주세요.
- 리소스 그룹 'data-resource-group'에서 내 SQL 서버 'analytics-sql-server'에 설정된 Microsoft Entra ID 관리자는 누구입니까?
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 리소스 그룹 | Required | Azure 리소스 그룹의 이름입니다. |
| 서버 이름 | Required | Azure SQL Server 이름(예: prod-sql-server)입니다. |
파괴: ❌ | 멱등성: ✅ | 오픈 월드: ❌ | 읽기 전용: ✅ | 비밀: ❌ | 로컬 필수: ❌
SQL Database 이름 바꾸기
기존 Azure SQL Database 동일한 SQL Server 내의 새 이름으로 바꿉니다. 이 명령은 구성 및 데이터를 유지하면서 데이터베이스 리소스의 식별자를 변경합니다. 업데이트된 데이터베이스 정보를 새 이름으로 반환합니다.
예 프롬프트는 다음과 같습니다.
- "서버 'my-sql-server'의 데이터베이스 'my-database'를 리소스 그룹 'my-resource-group'의 'my-database-v2'로 바꿉니다."
- "서버 'prod-sql-server'에서 SQL 데이터베이스 'old-database'의 이름을 'new-database'로 바꿉니다."
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 데이터베이스 이름 | Required | Azure SQL Database 이름입니다. |
| 새 데이터베이스 이름 | Required | Azure SQL Database 새 이름입니다. |
| 리소스 그룹 | Required | Azure 리소스 그룹의 이름입니다. Azure 리소스에 대한 논리적 컨테이너입니다. |
| 서버 이름 | Required | Azure SQL Server 이름입니다. |
파괴: ✅ | 멱등성: ❌ | 오픈 월드: ❌ | 읽기 전용: ❌ | 비밀: ❌ | 로컬 필수: ❌
SQL Database 업데이트
Azure SQL Database 성능 설정의 크기를 조정하고 구성합니다. 변화하는 성능 요구 사항을 충족하도록 기존 데이터베이스의 SKU, 컴퓨팅 계층, 스토리지 용량 또는 중복성 옵션을 업데이트합니다. 이 명령은 적용된 크기 조정 변경 내용을 포함하여 업데이트된 데이터베이스 구성을 반환합니다.
예 프롬프트는 다음과 같습니다.
- "리소스 그룹 'my-resource-group'의 서버 'my-sql-server'에서 SQL 데이터베이스 'my-database'의 데이터 정렬을 변경합니다."
- "서버 'my-sql-server'에서 SQL 데이터베이스 'my-database'를 업데이트하여 최대 크기는 2GB입니다."
| Parameter | 필수 또는 선택 사항 | Description |
|---|---|---|
| 데이터베이스 이름 | Required | Azure SQL Database 이름입니다. |
| 리소스 그룹 | Required | Azure 리소스 그룹의 이름입니다. Azure 리소스에 대한 논리적 컨테이너입니다. |
| 서버 이름 | Required | Azure SQL Server 이름입니다. |
| Collation | 선택적 | 데이터베이스에 대한 데이터 정렬(예: SQL_Latin1_General_CP1_CI_AS |
| 엘라스틱 풀 이름 | 선택적 | 데이터베이스를 할당할 탄력적 풀의 이름입니다. |
| 최대 크기 바이트 | 선택적 | 데이터베이스의 최대 크기(바이트)입니다. |
| 읽기 크기 조정 | 선택적 | 데이터베이스에 대한 크기 조정 옵션 읽기(사용 또는 사용 안 함). |
| SKU 용량 | 선택적 | 데이터베이스에 대한 SKU 용량(DTU 또는 vCore 수)입니다. |
| SKU 이름 | 선택적 | 데이터베이스의 SKU 이름(예: Basic, , S0P1) GP_Gen5_2 |
| SKU 계층 | 선택적 | 데이터베이스에 대한 SKU 계층(예: Basic, , StandardPremiumGeneralPurpose) |
| 영역 중복 | 선택적 | 데이터베이스가 지역 중복성을 가져야 하는지 여부입니다. |
파괴: ✅ | 멱등성: ✅ | 오픈 월드: ❌ | 읽기 전용: ❌ | 비밀: ❌ | 로컬 필수: ❌