다음을 통해 공유


빠른 시작: SSMS(SQL Server Management Studio)를 사용하여 Fabric에서 SQL 데이터베이스 연결 및 쿼리

적용 대상:Microsoft Fabric의 SQL 데이터베이스

SSMS(SQL Server Management Studio)를 사용하여 Microsoft Fabric의 SQL 데이터베이스에 연결하고 일부 Transact-SQL(T-SQL) 명령을 실행합니다.

비고

Microsoft Entra ID는 Azure AD(Azure Active Directory)의 새 이름이지만, 기존 환경의 중단을 방지하기 위해 UI 필드, 연결 공급자, 오류 코드 및 cmdlet과 같은 일부 하드 코딩된 요소에는 여전히 Azure AD가 남아 있습니다. 이 문서에서는 두 이름을 혼용할 수 있습니다.

이 문서에서는 다음 단계를 보여 줍니다.

  • Fabric에서 SQL 데이터베이스에 연결
  • 새 데이터베이스에 테이블 만들기
  • 새로운 테이블에 행을 삽입하십시오.
  • 새 테이블 쿼리 및 결과 보기
  • 쿼리 창 테이블을 사용하여 연결 속성 확인
  • 데이터베이스 제거

필수 조건

Fabric에서 SQL 데이터베이스에 연결

비고

18.6 이전의 SSMS 릴리스는 Microsoft Entra MFA(다단계 인증)를 통해 데이터베이스 엔진에 인증되지 않습니다. MFA를 계속 사용하려면 SSMS 18.6 이상 버전이 필요합니다.

  1. SSMS(SQL Server Management Studio)를 시작합니다. SSMS를 처음 실행할 때 서버에 연결 창이 열립니다. 열지 않으면 개체 탐색기>연결>데이터베이스 엔진을 선택하여 수동으로 열 수 있습니다.

    개체 탐색기의 연결 링크 스크린샷

  2. 패브릭 포털에서 SQL 데이터베이스의 서버 이름데이터베이스 이름을 찾습니다.

    SQL 데이터베이스의 연결 문자열은 Azure SQL Database의 연결 문자열과 유사합니다. 서버 이름은 다음과 같 <server-unique-identifer>.database.windows.net 고 데이터베이스 이름은 다음과 같습니다 <database name>-<unique identifier>.

    패브릭에서 SQL 데이터베이스에 대한 SQL 연결 문자열을 찾으려면 다음을 수행합니다.

    • SQL 데이터베이스 항목의 설정으로 이동합니다. 연결 문자열을 선택합니다. 서버 이름은Data source이고 데이터베이스 이름은 .입니다Initial Catalog.

    • 또는 작업 영역의 항목 목록에서 메뉴를 선택합니다 ... . 설정을 선택한 다음 연결 문자열을 선택합니다.

    • 또는 열기 단추 및 SQL Server Management Studio를 선택합니다. 서버 연결 정보가 표시됩니다.

      패브릭 포털의

      서버 이름 및 데이터베이스 이름을 보여 주는 SQL Server Management Studio 연결 대화 상자의 패브릭 포털 스크린샷

  3. 서버에 연결 대화 상자가 나타납니다. 다음 정보를 입력합니다. 다른 모든 설정은 기본값으로 남을 수 있습니다.

    Setting 제안된 값 세부 정보
    서버 유형 데이터베이스 엔진 데이터베이스 엔진(일반적으로 기본 옵션)을 선택합니다.
    서버 이름 정규화된 서버 이름 를 포함하여 .database.fabric.microsoft.com,1433 입력합니다.
    인증 Microsoft Entra MFA를 선택합니다. 자세한 내용은 Microsoft Fabric의 SQL 데이터베이스 인증을 참조 하세요.
    데이터베이스 이름 SQL 데이터베이스의 데이터베이스 이름을 제공합니다.

    옵션을 선택하여 추가 연결 옵션을 수정할 수도 있습니다. 연결 옵션의 예로는 연결하려는 데이터베이스, 연결 제한 시간 값 및 네트워크 프로토콜이 있습니다. 이 문서에서는 모든 옵션에 기본값을 사용합니다.

  4. 연결을 선택합니다.

  5. 패브릭 연결의 SQL 데이터베이스가 성공했는지 확인하려면 서버 이름, SQL Server 버전 및 사용자 이름이 표시되는 개체 탐색기 내의 개체를 확장하고 탐색합니다. 이러한 개체는 서버 유형에 따라 다릅니다.

연결 문제 해결

  • MFA에서 Microsoft Entra를 사용할 때 브라우저가 SQL Database에 연결하지 못하는 경우 도구>옵션>Azure Services>Azure Cloud로 이동하여 시스템 기본 웹 브라우저 사용 또는 웹 계정 관리자 사용 값을 변경할 수 있습니다. 자세한 내용은 옵션(Azure 서비스)을 참조하세요.

  • Fabric에서 SQL 데이터베이스에 연결 문제가 발생하는 경우 Microsoft Fabric의 네트워크 보안 이해를 참조하세요.

Microsoft Entra ID 토큰 캐시 지우기

SSMS(SQL Server Management Studio)는 Microsoft Entra ID 토큰을 간략하게 캐시합니다. 사용자가 Microsoft Entra ID 그룹에 추가되고 SSMS에서 즉시 인증을 시도하면 다음 오류 메시지가 throw됩니다.

Login failed for user '<token-identified principal>'.
(Microsoft SQL Server, Error: 18456)

최근에 서버에 대한 액세스 권한을 얻은 경우 Help>Clear Entra ID 토큰 캐시에서 Microsoft Entra ID 토큰 캐시를 지울 수 있습니다.

도움말 메뉴의 스크린샷으로, 빨간색으로 강조된 Entra ID 토큰 캐시 지우기 옵션.

다음 대화 상자에서는 최근에 서버에 대한 액세스 권한을 받고 다시 인증을 요구하는 경우 이 옵션이 유용한 이유를 설명합니다.

Microsoft Entra ID 사용자 토큰 캐시를 지우기 위한 확인을 요청하는 대화 상자의 스크린샷

새 데이터베이스에서 테이블 만들기

이 섹션에서는 데이터베이스에 테이블을 만듭니다.

  1. 개체 탐색기의데이터베이스 목록에서 데이터베이스를 마우스 오른쪽 단추로 클릭하고 새 쿼리를 선택합니다.

    새 쿼리를 만드는 방법을 보여 주는 스크린샷

  2. 다음 T-SQL 코드 조각을 쿼리 창에 붙여넣습니다.

    -- Create a new table called 'Customers' in schema 'dbo'
    -- Drop the table if it already exists
    IF OBJECT_ID('dbo.Customers', 'U') IS NOT NULL
        DROP TABLE dbo.Customers;
    GO
    
    -- Create the table in the specified schema
    CREATE TABLE dbo.Customers
    (
        CustomerId INT NOT NULL PRIMARY KEY, -- primary key column
        Name NVARCHAR (50) NOT NULL,
        Location NVARCHAR (50) NOT NULL,
        Email NVARCHAR (50) NOT NULL
    );
    GO
    
  3. 키보드에서 실행을 선택하거나 F5 키를 선택하여 쿼리를 실행합니다.

쿼리가 완료되면 Customers 테이블 목록에 새 테이블이 표시됩니다. 테이블이 표시되지 않으면 개체 탐색기에서 >테이블 노드를 마우스 오른쪽 단추로 클릭한 다음 새로 고침을 선택합니다.

새 테이블을 보여 주는 스크린샷

새 테이블에 행 삽입

이제 만든 테이블에 일부 행을 Customers 삽입해 보겠습니다. 다음 T-SQL 코드 조각을 쿼리 창에 붙여넣은 다음 실행을 선택합니다.

-- Insert rows into table 'Customers'
INSERT INTO dbo.Customers (
    [CustomerId],
    [Name],
    [Location],
    [Email]
)
VALUES
    (1, N'Orlando', N'Australia', N''),
    (2, N'Keith', N'India', N'keith0@adventure-works.com'),
    (3, N'Donna', N'Germany', N'donna0@adventure-works.com'),
    (4, N'Janet', N'United States', N'janet1@adventure-works.com');
GO

테이블 쿼리 및 결과 보기

쿼리 결과는 쿼리 텍스트 창 아래에 표시됩니다. 테이블을 쿼리 Customers 하고 삽입된 행을 보려면 다음 T-SQL 코드 조각을 쿼리 창에 붙여넣은 다음 실행을 선택합니다.

-- Select rows from table 'Customers'
SELECT * FROM dbo.Customers;

쿼리 결과는 텍스트가 입력된 영역 아래에 표시됩니다.

결과 목록을 보여 주는 스크린샷.

다음 옵션 중 하나를 선택하여 결과가 표시되는 방식을 수정할 수도 있습니다.

쿼리 결과를 표시하기 위한 세 가지 옵션의 스크린샷

  • 첫 번째 단추는 다음 섹션의 이미지와 같이 텍스트 보기에 결과를 표시합니다.
  • 가운데 단추는 기본 옵션인 그리드 보기에 결과를 표시합니다.
  • 세 번째 단추를 사용하면 기본적으로 확장명이 있는 파일에 결과를 저장할 수 있습니다 .rpt .

쿼리 창 테이블을 사용하여 연결 속성 확인

쿼리 결과에서 연결 속성에 대한 정보를 찾을 수 있습니다. 이전 단계에서 앞에서 언급한 쿼리를 실행한 후 쿼리 창 아래쪽에 있는 연결 속성을 검토합니다.

  • 연결된 서버 및 데이터베이스와 사용자 이름을 확인할 수 있습니다.

  • 이전에 실행한 쿼리에서 반환된 쿼리 기간 및 행 수를 볼 수도 있습니다.

    연결 속성의 스크린샷.

자원을 정리하세요

이 빠른 시작에서 만든 샘플 테이블을 제거합니다. 다음 T-SQL 코드를 붙여넣고 실행합니다.

DROP TABLE dbo.Customers;