이 문서는 데이터베이스를 관리하는 모든 사람이 성능 문제를 이해하고 승인된 수동 조치를 결정하는 데 도움을 줍니다.
Important
데이터베이스 에이전트는 미리보기 상태입니다. 모든 시나리오는 수동 대응을 위한 조사와 지침을 제공합니다. 이슈에서 데이터베이스 변경을 직접 승인하거나 실행할 수 없습니다.
Prerequisites
- 영향을 받는 데이터베이스 또는 서버에 대해 데이터베이스 에이전트가 사용 설정되어야 합니다. 자세한 내용은 데이터베이스 에이전트 사용 설정 및 활성화를 참조하세요.
- 문제를 보려면 데이터베이스 또는 서버에 대한 읽기 권한이 필요합니다.
- 수동 응답을 수행하려면 해당 데이터베이스 작업에 필요한 권한이 필요합니다. 이슈를 본다고 해서 그런 권한이 부여되는 것은 아닙니다.
- CPU 사용량이 높거나 장기간 진행되는 쿼리 문제에서 선택적 컨텍스트 AI 지원을 받으려면, 기존 데이터베이스 에이전트 설정 및 접근 요구 사항 외에 관리자가 할당한 Copilot 용량과 해당 Copilot 테넌트 및 용량 설정이 활성화되어 있어야 합니다.
- Visual Studio Code와 Visual Studio Code용 PostgreSQL 확장 기능(버전 1.32.0 이상)을 설치하세요. 제한 미리보기 기간 동안 Visual Studio Code에 PostgreSQL 데이터베이스 에이전트 문제가 나타나며, 곧 Fabric Database Hub에서의 지원이 제공될 예정입니다.
성능 문제 검토
- 데이터베이스 허브에서 문제 목록을 엽니다.
- 검토하고자 하는 이슈를 찾으세요. 검색 또는 사용 가능한 필터를 사용하여 문제 목록을 좁히세요.
- 문제를 선택하여 세부 정보를 엽니다.
- 문제 헤더에서 영향을 받은 데이터베이스, 심각도, 현재 상태 및 캡처 시간을 검토하세요. 이슈 상태에 대한 설명은 '이슈 상태 이해하기'를 참조하세요.
- 요약, 권고사항 및 분석을 검토하세요. 모든 이슈에는 이 정보가 포함되어 있지만, 세부 내용과 제공되는 문의는 이슈 유형에 따라 다릅니다.
- 차단 쿼리 문제의 경우, 요약에서 보고된 근본 원인과 캡처된 쿼리 세부 정보를 검토하세요. 헤드 블로커와 대표적인 차단 세션의 양 쪽 블로킹 결과를 검토하고, 진단 스냅샷과 차단된 프로세스 이력에 대한 분석을 검토하세요. 포착된 증거는 진단 당시의 상태를 반영하며, 반드시 현재의 차단 상황을 반영할 수는 없습니다.
- 데이터베이스를 변경하기 전에 권장되는 수동 대응, 예상 효과 및 필요한 점검을 검토하십시오. 차단 쿼리 문제의 경우, 세션을 종료하면 커밋되지 않은 작업이 롤백되어 되돌릴 수 없습니다. 수동 대응을 결정하기 전에 라이브 상태를 다시 확인하고 의도한 대상을 확인하세요.
- Visual Studio Code에서 PostgreSQL 보기를 열고, 연결>서버 아래의 연결된 유연 서버를 마우스 오른쪽 버튼으로 클릭한 후 Dashboard(또는 Database Agent)를 선택합니다.
- 대시보드 상단에 조사 배너가 나타나면 N개 문제 중 첫 번째 보기를 선택하거나 데이터베이스 에이전트 문제 섹션으로 스크롤하여 검토하려는 문제를 확장하세요.
- 문제 상태(예: DETECTED 또는 DIAGNOSED), 탐지 시간, AI 생성 요약 및 이를 뒷받침하는 증거를 검토하세요. 캡처된 증거는 진단 당시의 상태를 반영하며, 반드시 서버의 현재 상태를 반영하는 것은 아닙니다.
- 권장 조치(권장 변경, 이것이 안전한 이유, 롤백 포함, 각 SQL 블록에는 편집기에서 열기 및 복사 포함) 및 예상 결과를 검토하세요.
- (선택 사항) RECOMMENDED ACTION 또는 EXPECTED OUTCOME 옆의 반짝이 아이콘(Copilot에게 질문하기 about this section)을 선택하여, 이슈 세부 정보가 미리 로드된 GitHub Copilot Chat을 엽니다.
- 조치를 취하기 전에 실시간 서버에 대해 진단을 검증하세요. AI가 생성한 결과는 불완전하거나 부정확할 수 있습니다. 잠금 경쟁 문제나 트랜잭션 중 유휴 문제의 경우, 현재 세션을 다시 점검하세요. 예를 들어
pg_stat_activity및pg_locks를 쿼리하여 의도한 대상을 확인하세요.pg_terminate_backend()로 세션을 종료하면 커밋되지 않은 작업이 롤백되며 되돌릴 수 없습니다.
스크린샷과 함께 전체 Visual Studio Code 워크스루를 보려면 Visual Studio Code에서 데이터베이스 에이전트 사용하기를 참조하세요.
컨텍스트 AI로 조사하기
CPU 사용량이 많고 장기간 진행되는 쿼리 이슈의 경우, 맥락형 AI 지원을 활용해 문제를 이해하고, 추천 사항을 탐색하며, 캡처한 쿼리를 분석한 후 수동 응답을 결정하세요. 이러한 환경은 문제나 문의의 맥락에서 설명과 제안을 생성하는 데 추가적인 기술을 활용합니다.
질문에 맞는 경험을 선택하세요:
| 이해하고 싶은 것들 | 선택할 항목 | 응답이 나타나는 곳 |
|---|---|---|
| 문제의 근본 원인 또는 가능한 트리거 | 권장 작업의 프롬프트 버튼 | 문제를 맥락으로 한 Copilot 창 |
| 왜 이 조치가 권장되는지에 대한 이유 | 이유 설명하기권장 조치에서 | 이슈 내 인라인 |
| 캡처된 쿼리의 성능 및 가능한 개선 사항 | 쿼리 텍스트 아래에서 느린 쿼리 분석하기 | 쿼리 아래에 인라인으로 |
Copilot 창에서 질문하기
- 권장 조치에서 근본 원인을 좀 더 자세히 이해하도록 도와줘 또는 이 문제를 유발했을 수 있는 원인은 무엇일까와 같은 프롬프트 버튼을 선택하세요.
- Copilot 창은 해당 문제와 관련된 맥락에서 열립니다. 선택한 버튼 텍스트가 프롬프트로 사용됩니다.
- 다음 단계를 결정하기 전에 문제 증거와 대비하여 응답을 검토하세요.
추천 내용을 인라인에서 이해하기
- 권장 조치에서 '이유 설명'을 선택하세요.
- 이슈 내에서 생성된 설명을 직접 검토하세요. 프롬프트 버튼과 달리, 이 컨트롤은 Copilot 창을 열지 않고 인라인으로 설명을 표시합니다.
캡처된 쿼리 분석
- 조사하려는 캡처된 쿼리 텍스트를 찾으세요.
- 해당 쿼리 아래의 느린 쿼리 분석을 선택하세요.
- 해당 쿼리의 맥락에서 인라인 분석과 제안을 검토하세요. 추가 조사나 튜닝 변경이 적절한지 결정하기 전에 이를 뒷받침하는 증거와 명시된 제한 사항을 반드시 확인하세요.
Important
Copilot도 실수할 수 있습니다. 생성된 설명 및 제안은 검증된 근본 원인을 규명하거나, 쿼리가 여전히 실행 중임을 확인하거나, 워크로드 복구를 입증하지 않습니다. 뒷받침 증거가 없으면 분석이 불완전할 수 있습니다. 이 기능들은 데이터베이스 변경 사항을 적용하지 않습니다; 승인된 수동 대응 워크플로우를 따르십시오.
수동으로 응답하여 조건을 확인하십시오
지원되는 모든 시나리오에 동일한 응답 경로가 적용됩니다.
- 허가된 데이터베이스 도구를 사용하여 실시간 상태를 다시 확인하세요. 포착된 조사에만 의존하지 마세요.
- 권한이나 전문성이 없으면 데이터베이스 관리자와 함께 권장 사항을 검토하십시오. 조직의 승인 및 변경 관리 요구 사항을 준수하십시오.
- 해당 문제 처리 범위 밖에서 적절한 대응을 수동으로 수행하십시오. 데이터베이스 에이전트들은 데이터베이스 또는 서버 변경을 실행하지 않습니다.
- 응답 후 실시간 상태와 작업 부하를 다시 확인하세요. 감지된 상태가 해제되었는지, 그리고 워크로드가 복구되었는지 확인합니다.
- 이슈 상태와 이력을 검토하세요. Azure SQL Database용 데이터베이스 허브에서, 응답을 완료하고 확인한 후에도 문제가 열려 있으면 해당 문제를 닫으십시오. 조건은 자동으로 해제될 수도 있으며, 최종 상태는 닫힘(Closed) 입니다. Visual Studio Code의 PostgreSQL에서 복구를 완료하고 확인한 후 수동으로 적용됨 표시를 선택하거나 변경이 필요하지 않으면 문제 해제를 선택하세요. 문제를 업데이트하거나 종료해도 워크로드 복구가 확인되지 않습니다.
결과를 확인해
- 어떤 데이터베이스나 서버와 문제 유형에 주의가 필요한지 이해하고 있는지 확인하세요.
- 차단 쿼리 또는 잠금 충돌 문제의 경우, 문제 세부 정보에서 차단 세션, 영향을 받는 세션, 캡처 시간, 권장 대응 방법을 식별할 수 있는지 확인하세요. 이 단계는 캡처한 증거를 검토했음을 확인하는 것입니다; 실제 상태가 해결되었는지 확인해 주지는 않습니다.
- 다른 문제 유형의 경우, 요약, 권고 및 분석을 검토하고 권장 다음 단계를 이해했는지 확인하세요. 세부 내용과 제공되는 쿼리는 문제 유형에 따라 다릅니다.
높은 CPU 사용량이나 장시간 실행되는 쿼리 문제에 컨텍스트 AI를 사용했다면, 응답을 예상한 위치에서 검토했는지 확인하세요. 프롬프트 버튼의 경우 Copilot 창에서, 이유 설명 또는 느린 쿼리 분석의 경우 인라인에서 확인하세요. 생성된 응답은 데이터베이스 상태가 개선되었다는 것이 아니라 지침이 제공됨을 확인합니다.
제한 사항 및 알려진 문제
- 지원되는 모든 시나리오는 수동 응답이 필요합니다. 권고는 해당 이슈에서 실행 가능한 조치가 아닙니다.
- 캡처된 증거는 실제 데이터베이스나 서버 상태를 반영하지 않을 수 있습니다.
- 실패는 조사가 성공적으로 완료되지 않았다는 의미이며, 데이터베이스 에이전트가 데이터베이스나 서버 변경을 시도했다는 의미가 아닙니다.
- 조사 세부 정보는 실패 또는 조사 완료 후 자동으로 생성되지 않습니다. 기다리거나 새로 고침하거나 다시 열어도 누락된 세부 정보는 해결되지 않습니다.
- 컨텍스트 기반 AI 지원은 높은 CPU 사용량 및 장기간 실행되는 쿼리 문제에만 제공되며 관리자가 할당한 Copilot 용량을 사용합니다. 제안은 이용 가능한 증거에 따라 달라지며 불완전할 수 있습니다.
- PostgreSQL 데이터베이스 에이전트는 현재 Visual Studio Code에서만 제공되며, Fabric Database Hub에서의 지원도 곧 제공될 예정입니다.
- 모든 PostgreSQL 조사 작업은 AI의 지원을 받아 수행됩니다. 발견과 제안은 이용 가능한 증거에 의존하며, 불완전하거나 부정확할 수 있습니다.
Troubleshoot
조사가 실패했거나 완료된 후 문제 세부 정보가 누락된 경우, 데이터베이스 또는 서버에 대한 읽기 권한을 확인하고 Microsoft 지원에 문의하십시오. 조사 재시도 동작에 대해서는 문제 세부 정보가 불완전함을(를) 참조하세요.
컨텍스트 기반 AI 프롬프트 버튼 Explain why 또는 Analyze slow query를 사용할 수 없거나 작동하지 않으면 관리자에게 문의하십시오.
현재 점검 내용은 데이터베이스 에이전트 제한 사항 및 문제 해결을 참조하세요.