다음을 통해 공유

방법: CI(대/소문자 구분 안 됨) 데이터 정렬을 사용하여 웨어하우스 만들기

  • 아티클

적용 대상:✅ Microsoft Fabric 내 웨어하우스

기본적으로 모든 패브릭 웨어하우스는 CS(대/소문자 구분) 데이터 정렬 Latin1_General_100_BIN2_UTF8 구성됩니다. CI(대/소문자 구분 안 됨) 데이터 정렬 을 사용하여 Latin1_General_100_CI_AS_KS_WS_SC_UTF8 웨어하우스를 만들 수도 있습니다.

현재 대/소문자를 구분하지 않는 데이터 웨어하우스를 만드는 데 사용할 수 있는 유일한 방법은 REST API를 사용하는 것입니다. 이 문서에서는 REST API를 통해 대/소문자를 구분하지 않는 데이터 정렬을 사용하여 웨어하우스를 만드는 방법에 대한 단계별 가이드를 제공합니다. 또한 REST 클라이언트 확장과 함께 Visual Studio Code를 사용하여 프로세스를 용이하게 하는 방법을 설명합니다.

Important

웨어하우스가 만들어지면 데이터 정렬 설정을 변경할 수 없습니다. 만들기 프로세스를 시작하기 전에 요구 사항을 신중하게 고려합니다.

필수 조건

  • 활성 용량 또는 평가판 용량이 있는 Fabric 작업 영역.
  • Visual Studio Code를 다운로드하여 설치하여 애플리케이션을 다운로드하고 설치합니다.
  • REST 클라이언트 - Visual Studio Marketplace를 설치합니다.

API 엔드포인트

REST API를 사용하여 웨어하우스를 만들려면 API 엔드포인트를 사용합니다. POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

다음은 웨어하우스를 만들기 위한 샘플 JSON 요청 본문입니다.

{ 
  "type": "Warehouse", 
  "displayName": "CaseInsensitiveAPIDemo", 
  "description": "New warehouse with case-insensitive collation", 
  "creationPayload": { 
    "defaultCollation": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8" 
  } 
}

Visual Studio Code를 사용하여 REST API 호출

VS Code(Visual Studio Code) 및 REST 클라이언트 확장을 사용하여 대/소문자를 구분하지 않는 데이터 정렬을 사용하여 새 웨어하우스를 쉽게 만들 수 있습니다. 다음 단계를 수행합니다.

  1. 확장자를 사용하여 VS Code에서 새 텍스트 파일을 만듭니다 .http .

  2. 파일 본문에 요청 세부 정보를 입력합니다. 머리글과 본문 사이에는 "권한 부여" 줄 뒤의 빈 공간이 있어야 합니다.

      POST https://api.fabric.microsoft.com/v1/workspaces/<workspaceID>/items HTTP/1.1
  Content-Type: application/json
  Authorization: Bearer <bearer token>

{ 
   "type": "Warehouse", 
   "displayName": "<Warehouse name here>", 
   "description": "<Warehouse description here>", 
   "creationPayload": { 
     "defaultCollation": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8" 
   } 
 }

  3. 자리 표시자 값을 바꿉니다.

    • <workspaceID>: 섹션 뒤 /groups/ 의 URL에서 또는 기존 웨어하우스에서 실행 SELECT @@SERVERNAME 하여 작업 영역 GUID를 찾습니다.

    • <bearer token>: 다음 단계를 수행하여 이를 가져옵니다.

      1. 브라우저(Microsoft Edge 또는 Google Chrome)에서 Microsoft Fabric 작업 영역을 엽니다.
      2. F12 키를 눌러 개발자 도구를 엽니다.
      3. 콘솔 탭을 선택합니다. 필요한 경우 빠른 보기 확장을 선택하여 콘솔 프롬프트>를 표시합니다.
      4. 명령을 copy(powerBIAccessToken) 입력하고 Enter 키를 누릅니 다. 콘솔이 정의되지 않은 상태로 응답하는 동안 전달자 토큰이 클립보드에 복사됩니다.
      5. 대신 붙여넣습니다 <bearer token>.

      메모

      일부 시나리오에서는 페이지에 "copy"라는 요소 ID가 있을 경우 copy(powerBIAccessToken)이 오류 uncaught TypeError: copy is not a function로 인해 실패할 수 있습니다. 이러한 경우 "copy" 함수를 사용하기 전에 다음 명령을 사용하여 요소 ID를 수동으로 제거합니다. document.querySelector('#copy').remove().

    • <Warehouse name here>: 원하는 웨어하우스 이름을 입력합니다.

    • <Warehouse description here>: 원하는 웨어하우스 설명을 입력합니다.

  4. VS Code 편집기 에서 POST 명령에 표시되는 요청 보내기 링크를 선택합니다.

  5. POST 요청에 대한 추가 세부 정보와 함께 상태 코드 202 수락됨이 포함된 응답을 받아야 합니다.

  6. 패브릭 포털에서 새로 만든 웨어하우스로 이동합니다.

  7. 쿼리 편집기에서 다음 T-SQL 문을 실행하여 웨어하우스의 데이터 정렬이 위의 JSON에서 지정한 것과 일치하는지 확인합니다.

    SELECT name, collation_name FROM sys.databases;

관련 콘텐츠