Visual Studio Code 대한 MSSQL 확장을 사용하여 데이터베이스에 연결

Visual Studio Code 대한 MSSQL 확장은 Microsoft Fabric SQL Server, Azure SQL 및 SQL 데이터베이스에 대한 연결을 중심으로 합니다. 이 문서에서는 연결 대화 상자를 사용하여 연결을 만드는 방법과 확장에서 지원하는 인증 유형을 보여 줍니다. 또한 개체 탐색기 저장된 연결을 구성하는 방법과 새 SQL 파일을 열 때 확장에서 사용하는 연결을 선택하는 방법을 설명합니다.

연결한 후 빠른 시작을 참조하세요. Visual Studio Code 대한 MSSQL 확장으로 첫 번째 쿼리를 실행하여 데이터베이스를 만들고, 데이터를 추가하고, Transact-SQL 문을 실행합니다.

연결 대화 상자

연결 대화 상자는 연결을 만들거나 편집하는 기본 방법입니다. 개체 탐색기 연결 추가를 선택하거나 명령 팔레트에서 MS SQL: 연결 추가 명령을 실행하여 엽니다.

대화 상자에는 세 가지 주요 영역이 있습니다.

연결 세부 정보를 입력하는 가운데에 있는 양식 영역 입니다.
오른쪽 에 저장된 연결 및 최근 연결 패널이 있으며, 빠르게 다시 열거나 편집할 수 있는 연결이 나열됩니다.
고급, 테스트 연결, 연결 없이 저장 및 연결 작업이 있는 바닥글입니다.

입력 형식

폼 맨 위에 있는 입력 형식 선택기는 연결 세부 정보를 입력하는 방법을 제어합니다. 대상 서버에 대해 이미 알고 있는 것과 가장 일치하는 입력 형식을 사용합니다.

매개 변수: 서버 이름, 데이터베이스 이름, 인증 유형, 사용자 이름 및 암호와 같은 개별 필드를 입력합니다. 이 입력 형식은 기본값이며 대부분의 시나리오에서 가장 쉬운 옵션입니다.
연결 문자열: 전체 ADO.NET 스타일 연결 문자열을 붙여 넣으세요. 이 입력 형식은 연결 문자열을 이미 제공받은 경우(예: Azure 포털이나 관리자에게서) 또는 매개 변수 보기에서 노출되지 않는 옵션을 구성해야 하는 경우에 유용합니다.
Azure 찾아보기: Azure 로그인하고 구독에서 서버 및 데이터베이스를 선택합니다. 구독 및 리소스 그룹별로 필터링하여 원하는 데이터베이스를 찾을 수 있습니다. 이 옵션은 Azure SQL Database 및 Azure SQL Managed Instance 작동합니다(프라이빗 엔드포인트와 퍼블릭 엔드포인트가 모두 나열됨). 즐겨찾기 구독이 목록의 맨 위에 표시되고 자동으로 로드되도록 할 수 있습니다.
Fabric 찾아보기: 로그인하여 Microsoft Fabric 작업 영역 중 하나에서 SQL 데이터베이스를 선택합니다. 대화 상자에는 액세스할 수 있는 작업 영역과 그 안에 있는 SQL 데이터베이스가 나열됩니다. Azure 탐색할 때와 마찬가지로 목록 맨 위에 표시되고 자동으로 로드되도록 작업 영역을 즐겨찾기할 수 있습니다.

Azure 찾아보기와 Fabric 찾아보기는 둘 다 Visual Studio Code에 로그인할 때 사용하는 Microsoft 계정을 사용합니다. 원하는 만큼 Microsoft 계정으로 로그인하고 찾아보기 패널 맨 위에 있는 드롭다운을 사용하여 계정과 테넌트 간에 전환할 수 있습니다. GitHub 계정은 Azure 및 Fabric 데이터베이스를 찾아보는 데 사용할 수 없습니다.

데이터베이스 선택

데이터베이스 필드를 사용하면 서버의 기본 데이터베이스 또는 특정 데이터베이스에 연결할 수 있습니다.

서버에서 로그인을 할당하는 <기본 데이터베이스에 연결하려면 필드를 기본> 값으로 설정합니다. 이 옵션은 가장 간단한 옵션이며 나중에 편집기에서 데이터베이스를 계속 전환할 수 있습니다.
드롭다운 목록에서 특정 데이터베이스를 선택합니다. 인증할 수 있는 충분한 세부 정보를 입력한 후 확장은 백그라운드에서 서버의 데이터베이스 목록을 가져오려고 시도합니다. 목록이 성공적으로 로드되면 목록에서 선택할 수 있습니다.
데이터베이스 목록을 로드할 수 없는 경우(예: 로그인에 서버의 데이터베이스를 열거할 수 있는 권한이 없는 경우) 데이터베이스 이름을 필드에 직접 입력할 수 있습니다.

고급 설정

바닥글에서 고급 을 선택하여 Always Encrypted, 명령 시간 제한 및 애플리케이션 의도 (읽기 전용 또는 읽기-쓰기)와 같은 추가 연결 옵션의 전체 집합이 있는 측면 패널을 엽니다. 이러한 옵션은 보안,연결 복원력 및 풀링과 같은 범주로 그룹화된 연결 문자열 동일한 옵션입니다. 패널 맨 위에 있는 검색 상자를 사용하여 특정 설정을 빠르게 찾을 수 있습니다.

바닥글의 단추는 양식 작성이 완료되면 어떻게 되는지 제어합니다.

연결: 데이터베이스에 연결하고 저장된 연결 목록에 연결을 추가합니다.
연결 테스트: 아무것도 저장하지 않고 현재 양식 값을 사용하여 연결을 시도합니다. 연결을 커밋하기 전에 서버, 자격 증명 및 기타 설정이 올바른지 확인하는 데 사용합니다.
연결하지 않고 저장: 연결 프로필을 저장된 연결 목록에 저장하지만 세션을 열지 않습니다. 이는 연결을 미리 설정하거나 연결하지 않고 기존 연결의 이름을 바꾸려는 경우에 유용합니다.

기존 연결 사용

대화 상자의 오른쪽에 있는 저장된 연결 및 최근 연결 목록을 사용하면 이미 있는 연결에서 쉽게 시작할 수 있습니다.

저장된 연결을 마우스로 가리키면 작업 메뉴가 표시됩니다. 여기에서 연결의 세부 정보를 편집 하거나, 기존 연결을 기반으로 새 연결을 만들 거나(여러 연결이 동일한 서버를 공유하지만 다른 데이터베이스 또는 자격 증명을 공유하는 경우 유용한 바로 가기) 목록에서 연결을 제거할 수 있습니다.
최근 연결은 동일한 방식으로 작동하지만 저장되지 않은 경우에도 최근에 사용한 연결로 제한됩니다.

지원되는 인증 형식

MSSQL 확장은 여러 인증 유형을 지원합니다. 서버 구성 방법과 일치하는 항목을 선택합니다.

SQL Server 자체에 정의된 사용자 이름 및 암호를 입력합니다. SQL 로그인은 SQL Server, Azure SQL Database 및 Azure SQL Managed Instance 작동합니다.

연결할 때마다 암호를 다시 입력할 필요가 없도록 필요에 따라 암호를 저장할 수 있습니다.

Windows 인증

현재 Windows 계정을 사용하여 사용자 이름이나 암호 없이 서버에 로그인합니다. Windows 인증은 일반적으로 도메인에 가입된 네트워크 또는 서버와 동일한 컴퓨터에서 허용하도록 구성된 SQL Server 인스턴스에 연결하는 경우에만 작동합니다.

이 옵션을 통합 인증이라고도 합니다. Azure SQL Database, Azure SQL Managed Instance 또는 Fabric의 SQL 데이터베이스에서는 사용할 수 없습니다.

Microsoft Entra ID - MFA 포함 유니버설

Microsoft Entra ID 계정으로 로그인합니다. 이 옵션은 MFA(다단계 인증), 조건부 액세스 정책 및 Microsoft Entra 테넌트에 있는 게스트인 개인 Microsoft 계정을 지원합니다.

이 옵션을 선택하면 Microsoft Entra ID 계정을 선택하거나 추가하고 계정에 둘 이상의 액세스 권한이 있는 경우 테넌트를 선택하라는 메시지가 대화 상자에 표시됩니다.

확장은 Visual Studio Code 로그인한 Microsoft 계정을 사용합니다(창의 왼쪽 아래 모서리에 있는 계정 메뉴에 표시된 것과 동일한 계정). 아직 Visual Studio Code 로그인하지 않았거나 MSSQL 확장 권한을 아직 부여하지 않은 경우 연결할 때 로그인하라는 메시지가 표시됩니다.

메모

이전에 확장의 자체 계정 시스템(MSSQL 1.42.2 이하에서 사용됨)을 사용하여 MSSQL 확장에 로그인한 경우 다음에 저장된 연결 중 하나를 사용하여 연결할 때 Visual Studio Code 로그인하라는 메시지가 표시됩니다.

Visual Studio Code 계정 시스템이 제대로 작동하지 않는다면 알려주세요. 로 설정 mssql.preview.useVscodeAccountsForEntraMFAfalse하여 이전 로그인 메커니즘으로 되돌릴 수 있습니다.

Microsoft Entra ID - 기본값

이 옵션은 Microsoft Entra ID 기본 인증을 사용합니다. Microsoft MDS(Data SQL) 드라이버는 시스템에 설치된 자격 증명 공급자에서 사용 가능한 Microsoft Entra ID ID를 자동으로 선택합니다. 이 인증 유형은 MSSQL 확장에서 직접 지원되지 않는 특정 인증 요구 사항이 있는 경우에 유용합니다.

ID는 로그인한 Azure CLI 세션(az login) 또는 환경 변수와 같은 여러 소스에서 제공될 수 있으며, 상자를 설정 User name 하여 사용할 특정 ID를 지정할 수 있습니다. 기본 인증에서 ID를 선택하는 방법에 대한 자세한 내용은 Azure ID 클라이언트 라이브러리의 DefaultAzureCredential을 참조하세요.

Microsoft Entra ID - 서비스 주체

Microsoft Entra ID 서비스 주체(사용자가 아닌 애플리케이션 ID)로 인증합니다. 자동화 시나리오, 공유 워크스테이션 또는 사용자가 아닌 애플리케이션 ID에 데이터베이스 액세스 권한을 부여하는 것이 바람직한 경우 이 옵션을 사용합니다.

이 옵션을 선택하면 사용자 이름 및 암호 필드의 용도가 변경됩니다.

서비스 주체의 애플리케이션(클라이언트) ID 를 사용자 이름으로 입력합니다.
서비스 주체의 클라이언트 암호를 암호로 입력합니다.

SQL에서 서비스 주체를 사용하는 방법에 대한 자세한 내용은 Azure ID 클라이언트 라이브러리의 서비스 주체를 참조하세요.

개체 탐색기의 연결

연결 대화 상자에서 만드는 모든 연결(연결 즉시 연결하든 연결하지 않고 저장하든)은 MSSQL 보기의 개체 탐색기 표시됩니다. 개체 탐색기 서버 콘텐츠를 찾아보고, 백업과 같은 작업을 실행하고, 이전에 사용한 데이터베이스에 다시 연결하는 위치입니다.

연결 그룹

연결을 연결 그룹으로 구성할 수 있습니다. 그룹은 폴더처럼 작동합니다. 이름을 지정하고, 색을 할당하고, 내부에 연결을 배치하여 환경을 시각적으로 구분된 상태로 유지할 수 있습니다(예: 프로덕션, 스테이징 및 로컬).

그룹 만들기: 새 연결 그룹 명령을 사용하거나 연결을 만들거나 편집하는 동안 새 그룹을 할당합니다.
드래그 앤 드롭으로 정리: 연결을 그룹 위로 드래그하면 해당 그룹으로 이동합니다. 그룹을 다른 그룹으로 끌어 중첩합니다. 여러 수준 깊이의 중첩된 그룹을 만들 수 있습니다.
확장 및 축소: 각 그룹 옆에 있는 펼침 단추를 사용하여 확장 및 축소하므로 현재 작업 중인 연결만 표시됩니다. Visual Studio Code가 시작될 때 항상 그룹이 축소된 상태로 시작하려면 mssql.collapseConnectionGroupsOnStartup 설정을 사용하도록 설정하세요.

개체 탐색기 서버 연결을 마우스 오른쪽 단추로 클릭하여 연결 자체에 적용되는 작업을 확인합니다. 가장 일반적으로 사용되는 연결 관련 옵션은 다음과 같습니다.

연결 / 연결 끊기: 서버에 대한 세션을 시작하거나 종료합니다.
연결 편집: 연결 프로필이 로드된 연결 대화 상자를 열어 해당 매개 변수를 편집합니다.
연결 문자열 복사: 저장된 연결의 연결 문자열을 클립보드에 복사합니다. 이는 다른 도구와 연결을 공유하거나 애플리케이션 코드에 붙여넣어야 하는 경우에 편리합니다. 암호 및 비밀은 포함되지 않습니다.
연결 제거: 저장된 목록에서 연결을 삭제합니다.

Azure SQL 대한 방화벽 규칙

서버의 방화벽에서 허용되지 않는 클라이언트 IP 주소에서 Azure SQL Database 연결하거나 Azure SQL Managed Instance 경우 MSSQL 확장을 사용하여 방화벽 규칙 추가 대화 상자를 통해 방화벽 규칙을 추가할 수 있습니다.

방화벽 규칙 추가 대화 상자에서 서버를 관리할 수 있는 권한이 있는 Microsoft 계정 로그인하고, 규칙에 이름을 지정하고, 현재 IP 주소 또는 범위만 허용할지 여부를 선택합니다. 규칙을 저장하면 연결이 자동으로 다시 시도됩니다.

작업공간 연결

저장된 연결 및 연결 그룹은 Visual Studio Code settings.json에 저장됩니다. 확장은 다음 두 권한 범위에서 연결 정보를 읽어옵니다.

사용자(전역) 설정: 여기에 새 연결이 저장됩니다. 열려 있는 폴더에 관계없이 모든 Visual Studio Code 세션에서 사용할 수 있습니다.
작업 영역 설정: 작업 영역 수준에서 저장된 연결은 해당 작업 영역이 열려 있는 경우에만 사용할 수 있습니다. 이 범위는 작업 영역 .code-workspace 파일을 소스 제어로 확인하여 공동 작업자와 공유하려는 프로젝트별 연결에 유용합니다.

사용자 설정에서 작업 영역 설정으로 연결을 이동하려면 사용자의 JSON 항목을 작업 settings.json 영역 settings.json으로 복사한 다음 사용자 구성에서 삭제합니다.

메모

확장은 개별 작업 영역 폴더 설정(다중 루트 작업 영역 내의 폴더 .vscode/settings.json 별)에서 연결을 읽지 않습니다. 특정 프로젝트에 연결을 적용하려면 대신 작업 영역 수준에서 저장합니다.

암호 또는 secret이 포함된 연결을 저장하면 해당 연결의 암호는 settings.json에 저장되지 않습니다. 암호는 Visual Studio Code 보안 자격 증명 저장소에 별도로 유지됩니다.

새 SQL 파일 또는 편집기를 열 때 연결 선택

.sql 파일을 열거나 새 SQL 편집기를 만들 때 확장 프로그램은 편집기를 연결되지 않은 상태로 두거나 자동으로 연결할 수 있습니다.

이 동작은 다음 세 가지 모드를 mssql.newEditorConnectionBehavior 지원하는 설정에 의해 제어됩니다.

모드	Description
`none`	새 SQL 편집기가 연결 없이 열립니다. 쿼리를 처음 실행할 때 연결을 선택하라는 메시지가 표시되거나 SQL: 연결 명령을 사용하여 연결을 수동으로 연결할 수 있습니다.
`transferActive`(기본값)	새 SQL 편집기가 현재 활성 SQL 편집기와 동일한 데이터베이스에 자동으로 연결됩니다. 이 기능은 동일한 데이터베이스에 대해 여러 파일을 작업할 때 각 파일을 다시 연결하지 않으려는 경우에 편리합니다. 현재 활성화된 SQL 편집기가 없으면 연결 없이 새 편집기가 열립니다.
`defaultConnection`	새 SQL 편집기가 기본값으로 지정한 특정 연결에 자동으로 연결됩니다. 기본 연결은 설정으로 식별됩니다 `mssql.defaultConnectionId` . 이 모드를 사용하려면 `mssql.defaultConnectionId`도 저장해 둔 연결 중 하나의 ID로 설정해야 합니다. `settings.json`에서 저장된 연결을 확인하여 ID를 찾을 수 있습니다. 설정되지 않았거나 저장된 연결과 더 이상 일치하지 않는 경우 `mssql.defaultConnectionId` 확장은 다음에 새 SQL 편집기를 열 때 기본 연결을 선택하라는 메시지를 표시합니다.

Visual Studio Code 설정 UI에서 mssql.newEditorConnectionBehavior 또는 mssql.defaultConnectionId을 검색하여 이러한 설정을 변경할 수 있습니다.

피드백

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

Last updated on 2026-06-23