자습서: Azure Portal에서 쿼리 관리 - Azure Resource Graph

Azure Resource Graph Explorer를 사용하면 Azure Portal에서 직접 Resource Graph 쿼리를 저장할 수 있습니다. 두 가지 유형의 쿼리, 즉 프라이빗 및 공유 쿼리가 있습니다. 프라이빗 쿼리는 Azure Portal 설정에 저장됩니다. 반면 공유 쿼리는 Azure RBAC(Azure 역할 기반 액세스 제어)로 관리하고 리소스 잠금으로 보호할 수 있는 Azure Resource Manager 리소스입니다. 두 유형의 쿼리는 모두 미사용 시 암호화됩니다.

Azure Portal에 쿼리를 저장하면 즐겨찾기 또는 일반적으로 사용되는 쿼리를 찾는 데 소요될 수 있는 시간을 절약할 수 있습니다. 쿼리를 공유할 때 팀이 반복을 통해 일관성과 효율성의 목표를 실현할 수 있도록 도와줍니다.

이 자습서에서는 다음 작업을 완료합니다.

프라이빗 쿼리 만들기 및 삭제
공유 쿼리 만들기
공유 쿼리 검색
공유 쿼리 삭제

필수 조건

이 자습서를 완료하려면 Azure 구독이 필요합니다. 계정이 없으면 시작하기 전에 무료 계정을 만드세요.

프라이빗 쿼리 만들기 및 삭제

프라이빗 쿼리는 액세스할 수 있으며 해당 쿼리를 만드는 계정에서만 볼 수 있습니다. 계정의 Azure Portal 설정에 저장되므로 Azure Portal 내에서만 생성, 사용 및 삭제할 수 있습니다. 프라이빗 쿼리는 Resource Manager 리소스가 아닙니다. 새 프라이빗 쿼리를 만들려면 다음 단계를 수행합니다.

포털 메뉴에서 모든 서비스를 선택하거나 모든 페이지의 맨 위에 있는 Azure 검색 상자를 사용합니다. Resource Graph Explorer를 검색한 다음 선택합니다.
Azure Resource Graph Explorer 페이지의 쿼리 1 탭에서 다음 쿼리를 입력합니다.
```
Resources
| where type =~ 'Microsoft.Compute/virtualMachines'
| summarize count() by tostring(properties.storageProfile.osDisk.osType)
```
쿼리 실행을 선택하여 아래쪽 창에서 쿼리 결과를 확인합니다.

이 쿼리에 대한 자세한 내용은 샘플 - OS 유형별 가상 머신 개수를 참조하세요.
다른 이름으로 저장 또는 저장을 선택하고, OS별 VM 개수를 이름으로 입력하고, 형식을 프라이빗 쿼리로 그대로 두고, 쿼리 저장 창 아래쪽에서 저장을 선택합니다. 탭 제목이 쿼리 1 에서 OS별 VM 개수로 변경됩니다.
Azure Portal의 Azure Resource Graph Explorer에서 멀리 이동한 다음 다시 돌아갑니다. 저장된 쿼리가 더 이상 표시되지 않고 쿼리 1 탭이 반환되었습니다.
쿼리 열기를 선택합니다. 형식이 프라이빗 쿼리인지 확인합니다. 이제 저장된 이름 OS별로 VM 수 계산이 쿼리 이름 목록에 표시됩니다. 저장된 쿼리의 제목 링크를 선택하면 해당 쿼리 이름이 있는 새 탭에 로드됩니다.

비고

저장된 쿼리가 열려 있고 탭에 이름이 표시되면 저장 단추를 선택하면 변경 내용으로 업데이트됩니다. 이 열린 쿼리에서 저장된 새 쿼리를 만들려면 다른 이름으로 저장 을 선택하고 새 쿼리를 저장하는 것처럼 계속 진행합니다.
저장된 쿼리를 삭제하려면 쿼리 열기를 다시 선택하고 형식 필드가 프라이빗 쿼리로 설정되어 있는지 확인합니다. 저장된 Count VMs by OS 쿼리의 행에서 삭제 (휴지통 아이콘)를 선택합니다. 확인 대화 상자에서 예를 선택하여 쿼리 삭제를 완료합니다. 그런 다음 쿼리 열기 창을 닫습니다.

공유 쿼리 만들기

프라이빗 쿼리와 달리 공유 쿼리는 Resource Manager 리소스입니다. 즉, 쿼리가 리소스 그룹에 저장되고, Azure RBAC를 사용하여 관리 및 제어할 수 있으며, 리소스 잠금으로 보호할 수도 있습니다. 리소스로서 적절한 권한이 있는 모든 사용자가 이를 보고 사용할 수 있습니다. 새 공유 쿼리를 만들려면 다음 단계를 수행합니다.

포털 메뉴에서 모든 서비스를 선택하거나 모든 페이지의 맨 위에 있는 Azure 검색 상자를 사용하여 Resource Graph Explorer를 검색하고 선택합니다.
Azure Resource Graph Explorer 페이지의 쿼리 1 탭에서 다음 쿼리를 입력합니다.
```
Resources
| where type =~ 'Microsoft.Compute/virtualMachines'
| summarize count() by tostring(properties.storageProfile.osDisk.osType)
```
쿼리 실행을 선택하여 아래쪽 창에서 쿼리 결과를 확인합니다.

이 쿼리에 대한 자세한 내용은 샘플 - OS 유형별 가상 머신 개수를 참조하세요.
저장 또는 다른 이름으로 저장을 선택합니다.
쿼리 저장 창에서 이름에 대한 OS별 VM 개수를 입력합니다.
형식을 공유 쿼리로 변경하고, 설명을 OS 유형별로 가상 머신 수로 설정하고, 구독 을 설정하여 쿼리 리소스가 만들어지는 위치를 지정합니다.
Resource-graph-queries 리소스 그룹에 게시 확인란을 선택하고 리소스 그룹 위치를미국 중서부로 설정합니다.
쿼리 저장 창 아래쪽에서 저장을 선택합니다. 탭 제목이 쿼리 1 에서 OS별 VM 개수로 변경됩니다. resource-graph-queries 리소스 그룹을 처음 사용할 때 리소스 그룹을 만들 때 저장 시간이 예상보다 오래 걸립니다.

비고

공유 쿼리를 저장할 기존 리소스 그룹의 이름을 제공하려는 경우 Resource-graph-querys 리소스 그룹에 게시 확인란의 선택을 취소할 수 있습니다. 쿼리에 명명된 기본 리소스 그룹을 사용하면 공유 쿼리를 더 쉽게 검색할 수 있습니다. 또한 해당 리소스 그룹의 용도를 더 명확하게 만듭니다. 그러나 기존 사용 권한에 따라 보안상의 이유로 기존 리소스 그룹을 선택하도록 선택할 수 있습니다.
Azure Portal의 Azure Resource Graph Explorer에서 멀리 이동한 다음 다시 돌아갑니다. 저장된 쿼리가 더 이상 표시되지 않고 쿼리 1 탭이 반환되었습니다.
쿼리 열기를 선택합니다. 형식이 공유 쿼리 로 설정되어 있는지 확인하고 쿼리를 저장한 구독 및 리소스 그룹의 조합이 일치하는지 확인합니다. 이제 저장된 OS별 VM 개수 항목이 쿼리 이름 목록에 표시됩니다. 저장된 쿼리의 제목 링크를 선택하여 해당 쿼리 이름이 있는 새 탭에 로드합니다. 공유 쿼리는 제목 옆에 있는 탭에 아이콘을 표시하여 공유됨으로 표시합니다.

비고

저장된 쿼리가 열려 있고 탭에 이름이 표시되면 저장 단추가 변경 내용으로 업데이트됩니다. 저장된 새 쿼리를 만들려면 다른 이름으로 저장 을 선택하고 새 쿼리를 저장하는 것처럼 계속 진행합니다.

공유 쿼리 검색

공유 쿼리는 Resource Manager 리소스이므로 여러 가지 방법으로 찾을 수 있습니다.

Resource Graph Explorer에서. 쿼리 열기를 선택하고 형식을 공유 쿼리로 설정합니다.
Resource Graph 쿼리 포털 페이지에서.
공유 쿼리가 저장된 리소스 그룹에서.
Resource Graph에 대한 쿼리를 통해

Resource Graph 쿼리 보기

Azure Portal에서 Resource Graph 쿼리 페이지에는 로그인한 계정에 액세스할 수 있는 공유 쿼리가 표시됩니다. 이 페이지에서는 Resource Graph 쿼리의 이름, 구독, 리소스 그룹 및 기타 속성을 필터링할 수 있습니다. 이 인터페이스를 사용하여 Resource Graph 쿼리에 태그를 지정하고, 내보내고, 삭제할 수도 있습니다.

쿼리 중 하나를 선택하면 Resource Graph 쿼리 페이지가 열립니다. 다른 Resource Manager 리소스와 마찬가지로 이 페이지에서는 활동 로그, 액세스 제어 및 태그와 함께 대화형 개요를 제공합니다. 이 페이지에서 직접 리소스 잠금을 적용할 수도 있습니다.

모든 서비스를 선택하거나 모든 페이지의 맨 위에 있는 Azure 검색 상자를 사용하여 포털 메뉴에서 Resource Graph 쿼리 페이지로 이동합니다. Resource Graph Explorer를 검색하여 선택합니다.

리소스 그룹의 리소스 나열

Resource Graph 쿼리는 리소스 그룹의 일부인 다른 리소스와 함께 나열됩니다. Resource Graph 쿼리를 선택하면 해당 쿼리에 대한 페이지가 열립니다. 셀렉트 및 길게 누르기(또는 마우스 오른쪽 버튼 클릭)를 통해 트리거되는 줄임표 및 바로 가기 메뉴 옵션은 Resource Graph 쿼리 페이지에서 이용되는 것과 동일하게 작동합니다.

쿼리 리소스 그래프

Resource Graph 쿼리를 통해 Resource Graph 쿼리를 찾을 수 있습니다. 다음 Resource Graph 쿼리는 형식 Microsoft.ResourceGraph/queries별로 제한한 다음 이름, 수정된 시간 및 쿼리 자체만 나열하는 데 사용합니다 project .

Resources
| where type == "microsoft.resourcegraph/queries"
| project name, properties.timeModified, properties.query

공유 쿼리 실행

Resource Graph 공유 쿼리는 {{shared-query-uri}} 구문을 사용할 수 있습니다 (미리보기). 자세한 내용은 공유 쿼리 구문을 참조하세요.

공유 쿼리 삭제

공유 쿼리가 더 이상 필요하지 않은 경우 삭제합니다. 공유 쿼리를 삭제하여 해당 Resource Manager 리소스를 제거합니다. 결과 차트가 고정된 모든 대시보드에서 이제 오류 메시지가 표시됩니다. 해당 오류 메시지가 표시되면 대시보드에서 제거 단추를 사용하여 대시보드를 정리합니다.

다음 인터페이스를 통해 공유 쿼리를 삭제할 수 있습니다.

리소스 그래프 쿼리 페이지
Resource Graph 쿼리 페이지
Resource Graph Explorer에서 쿼리 열기 페이지
리소스 그룹 페이지

자원을 정리하세요

이 자습서를 마쳤으면 더 이상 원하지 않는 경우 만든 프라이빗 및 공유 쿼리를 삭제합니다.

다음 단계

이 자습서에서는 프라이빗 및 공유 쿼리를 만들었습니다. Resource Graph 언어에 대해 자세히 알아보려면 쿼리 언어 세부 정보 페이지로 계속 진행하세요.

쿼리 언어에 대한 자세한 정보 가져오기

피드백

이 페이지가 도움이 되었나요?

Last updated on 2025-10-08