Azure Data Studio 문제 해결
중요하다
Azure Data Studio는 2026년 2월 28일에 사용 중지됩니다. Visual Studio Code사용하는 것을 권장합니다. Visual Studio Code로 마이그레이션하는 방법에 대한 자세한 내용은 Azure Data Studio에 무슨 일이 일어나고 있는지 확인하세요.
Azure Data Studio는 저장소의 azuredatastudio
를 사용하여 문제 및 기능 요청을 추적합니다.
발생한 문제 보고
GitHub 문제 추적기에서 문제를 보고하고 오류를 재현하는 데 도움이 되는 세부 정보를 알려주세요. 로그 파일의 로그 정보를 포함합니다.
버그 보고서 및 기능 요청을 잘 작성하기
문제 및 기능 요청 시 단 하나의 문제에 대해서만 제출합니다.
- 동일한 문제의 여러 버그 또는 기능 요청을 열거하지 마세요.
- 동일한 의견에 해당하지 않는 한 이슈를 댓글로 기존 이슈에 추가하지 마세요. 많은 문제는 비슷하지만 다른 원인이 있습니다.
더 많은 정보를 제공할수록 누군가가 문제를 성공적으로 재현하고 수정 사항을 찾을 가능성이 높아질 수 있습니다.
각 문제에 대해 다음과 같은 정보를 포함하십시오.
- Azure Data Studio 버전
- 재현 가능한 단계(1... 2... 3...) 및 예상했던 것과 실제 경험한 것.
- 이미지, 애니메이션 또는 비디오 링크. 이미지와 애니메이션은 재현 단계를 설명하지만 대체하지 ‘않습니다’.
- 이슈를 설명하는 코드 조각 또는 손쉽게 머신으로 끌어와 이슈를 다시 생성할 수 있는 코드 리포지토리의 링크
참고 항목
코드 조각을 복사하여 붙여넣어야 하기 때문에 단순히 코드 조각을 미디어 파일로, 즉 .gif
로 포함하는 것은 충분하지 않습니다.
- 개발자 도구 콘솔의 오류(개발자 도구 토글 도움말 >)
다음 단계를 수행해야 합니다.
- 문제 리포지토리를 검색하여 동일한 문제가 이미 있는지 확인합니다.
- 이슈에 관한 코드를 단순화하여 Microsoft에서 문제를 더욱 효과적으로 파악하도록 돕습니다.
문제를 재현하고 자세한 정보를 요청할 수 없다고 해도 속상해 하지 마세요!
로깅 수준을 설정하는 방법
Azure Data Studio
명령 팔레트(Ctrl/Cmd + Shift + P)에서 Developer: Set Log Level... 명령을 실행하여 현재 세션의 로그 수준을 선택합니다. 이 값은 여러 세션에 걸쳐 유지되지 않습니다. Azure Data Studio를 다시 시작하면 기본 Info
수준으로 되돌아갑니다.
시작에 디버그 로깅을 사용하도록 설정하려면 로그 수준을 Debug
로 설정하고 Developer: Reload Window 명령을 실행합니다.
MSSQL (기본 제공 확장 프로그램)
Mssql: Log Debug Info
사용자 설정이 true로 설정된 경우 디버그 로그 정보가 MSSQL
출력 채널로 전송됩니다.
Mssql: Tracing Level
사용자 설정은 로깅의 세부 정보를 제어하는 데 사용됩니다.
Azure Data Studio 로그 및 위치
명령 팔레트(Ctrl/Cmd + Shift + P)에서 Developer: Open Logs Folder 명령을 실행하여 로그 경로를 엽니다. 거기에 저장되는 로그 파일의 다양한 유형이 있습니다. 일반적으로 사용되는 것 중 일부는 다음과 같습니다.
-
renderer#.log
(예:renderer1.log
): 이 파일은 주 프로세스의 로그 파일입니다. -
telemetry.log
: 로그 수준이Trace
로 설정되면 이 파일에는 Azure Data Studio에서 보낸 원격 분석 이벤트가 포함됩니다. -
exthost#/exthost.log
: 확장 호스트 프로세스에 대한 로그 파일(이 파일은 프로세스 자체에만 해당하며 내부에서 실행되는 확장은 아님) -
exthost#/Microsoft.mssql
: MSSQL 관련 기능에 대한 핵심 논리의 대부분을 포함하는 mssql 확장에 대한 로그-
sqltools.log
는 SQL Tools 서비스의 로그입니다.
-
-
exthost#/output_logging_#######
: 이러한 폴더는 Azure Data Studio의Output
패널에 표시되는 메시지를 포함합니다. 파일의 이름은#-<Channel Name>
입니다. 예를 들어Notebooks
출력 채널은 이름이3-Notebooks.log
로 지정된 파일로 출력할 수 있습니다.
로그를 제공하라는 메시지가 표시되면 전체 폴더를 압축하여 올바른 로그가 포함되어 있는지 확인합니다.
충돌 후 편집기 파일 복구
Azure Data Studio가 예기치 않게 충돌하는 경우 Azure Data Studio를 다시 시작하면 저장되지 않은 편집기 파일도 다시 열어야 합니다. 그렇지 않은 경우 다시 여는 동안 오류가 발생할 수 있습니다. 이 경우 다음 단계에 따라 백업을 포함하는 폴더로 이동하여 수동으로 열어 콘텐츠를 복구할 수 있습니다.
- 명령 팔레트(Ctrl/Cmd + Shift + P)에서 Developer: Open User Data Folder 명령을 실행합니다.
- 열린 폴더에서
Backups
폴더로 이동합니다.
여기에는 임의로 생성된 이름의 폴더가 포함됩니다. 이러한 폴더 내에는 편집기 백업이 포함된 파일(텍스트 내용과 함께 일부 추가 메타데이터 포함)이 있습니다.