적용 대상:✅ Microsoft Fabric 내 웨어하우스
Fabric Data Warehouse는 대/소문자를 구분하지 않는 데이터 정렬과 대/소문자를 구분하지 않는 데이터 정렬을 모두 지원합니다. 지원되는 웨어하우스 데이터 정렬은 다음과 같습니다.
-
Latin1_General_100_BIN2_UTF8(기본값) (대/소문자 구분) -
Latin1_General_100_CI_AS_KS_WS_SC_UTF8(대/소문자를 구분하지 않습니다.)
새 웨어하우스 및 모든 SQL 분석 엔드포인트는 기본적으로 대/소문자를 구분하는 데이터 정렬인 작업 영역의 데이터 웨어하우스 기본 데이터 정렬 설정에 따라 구성됩니다 Latin1_General_100_BIN2_UTF8.
작업 영역 수준 데이터 정렬을 변경해도 기존 웨어하우스 또는 SQL 분석 엔드포인트에는 영향을 주지 않습니다. 웨어하우스 간 쿼리는 데이터 정렬이 다른 항목에서 오류 또는 예기치 않은 쿼리 결과를 발생시킬 수 있습니다.
대/소문자를 구분하지 않는 데이터 정렬을 사용하여 웨어하우스를 만들려면 다음을 수행합니다.
- 작업 영역 데이터 정렬 설정을 변경하고 새 웨어하우스를 만듭니다. 새 웨어하우스를 만들 때 작업 영역의 데이터 정렬이 사용됩니다.
- REST API를 사용하여 기본이 아닌 데이터 정렬을 사용하여 웨어하우스를 만들 수도 있습니다.
중요한
웨어하우스 또는 SQL 분석 엔드포인트가 만들어지면 데이터 정렬을 변경할 수 없습니다.
Fabric Data Warehouse에 대한 작업 영역 기본 데이터 정렬 수정
이 섹션에서는 작업 영역 수준에서 웨어하우스에 대한 기본 데이터 정렬을 구성하는 방법을 설명합니다. 설정은 모든 웨어하우스 및 SQL 분석 엔드포인트 항목에 영향을 줍니다.
Permissions
- 패브릭 작업 영역 역할 관리자, 멤버, 기여자 멤버: 작업 영역 설정 패널에서 작업 영역 데이터 정렬을 변경할 수 있습니다.
- 뷰어: 데이터 정렬 설정을 볼 수 있지만 수정할 수는 없습니다.
패브릭 포털에서 Fabric Data Warehouse에 대한 작업 영역 기본 데이터 정렬 변경
- Microsoft Fabric 작업 영역으로 이동합니다.
- 작업 영역 설정을 엽니다.
- 작업 영역 설정 창에서 데이터 웨어하우스 탭을 선택합니다.
- 대조 페이지를 선택합니다.
- 대/소문자 구분에서 대소문자 구분 (Latin1_General_100_BIN2_UTF8) 또는 대소문자 구분 없음 (Latin1_General_100_CI_AS_KS_WS_SC_UTF8) 중에서 기본값을 선택합니다. 이 작업 영역에서 만든 모든 새 웨어하우스 및 SQL 분석 엔드포인트 항목은 선택한 작업 영역 데이터 정렬을 사용하여 만들어집니다.
- 웨어하우스를 만든 후 패브릭 쿼리 편집기 에서 다음 T-SQL 문을 사용하여 웨어하우스의 데이터 정렬을 확인합니다.
SELECT name, collation_name FROM sys.databases;
비고
새 미러된 SQL Server 데이터베이스, 미러된 SQL Managed Instance 데이터베이스, 미러된 Azure SQL Database 또는 Fabric의 SQL 데이터베이스에 대한 새 SQL 분석 엔드포인트 항목은 부모 항목의 데이터 정렬이 아닌 패브릭 작업 영역 데이터 정렬을 사용합니다.
REST API를 사용하여 기본이 아닌 데이터 정렬을 사용하여 웨어하우스 만들기
이 섹션에서는 VISUAL Studio Code를 사용하여 REST 클라이언트 확장을 사용하여 기본이 아닌 데이터 정렬이 있는 웨어하우스를 만드는 방법을 설명합니다.
API 엔드포인트
REST API를 사용하여 웨어하우스를 만들려면 API 엔드포인트를 사용합니다. POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items
다음은 defaultCollation 매개 변수에 웨어하우스의 정렬 순서를 포함하여 웨어하우스를 생성하기 위한 샘플 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 호출
Visual Studio Code 및 REST 클라이언트 확장을 사용하여 기본이 아닌 데이터 정렬을 사용하여 새 웨어하우스를 쉽게 만들 수 있습니다. 다음 단계를 수행합니다.
아직 설치하지 않은 경우 Visual Studio Code 를 다운로드하여 설치하여 애플리케이션을 다운로드하고 설치합니다.
REST 클라이언트 - Visual Studio Marketplace를 설치합니다.
확장자를 사용하여 VS Code에서 새 텍스트 파일을 만듭니다
.http.파일 본문에 요청 세부 정보를 입력합니다. 머리글과 본문 사이에는 "권한 부여" 줄 뒤의 빈 공간이 있어야 합니다.
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" } }자리 표시자 값을 바꿉니다.
-
<workspaceID>:/groups/뒤의 URL에서 또는 기존 웨어하우스에서SELECT @@SERVERNAME를 실행하여 작업 공간 GUID를 찾습니다. -
<bearer token>: 다음 단계에 따라 전달자 토큰을 가져옵니다.- 브라우저에서 Microsoft Fabric 작업 영역을 엽니다(Microsoft Edge).
- F12 키를 눌러 개발자 도구를 엽니다.
- 콘솔 탭을 선택합니다. 필요한 경우 빠른 보기 확장을 선택하여 콘솔 프롬프트
>를 표시합니다. - 명령을
powerBIAccessToken입력하고 Enter 키를 누릅니다. 콘솔에서 반환된 큰 고유 문자열을 마우스 오른쪽 단추로 클릭하고 문자열 내용 복사를 선택합니다. -
<bearer token>자리에 붙여넣습니다.
-
<Warehouse name here>: 원하는 웨어하우스 이름을 입력합니다. -
<Warehouse description here>: 원하는 웨어하우스 설명을 입력합니다.
-
VS Code 편집기 에서 POST 명령에 표시되는 요청 보내기 링크를 선택합니다.
POST 요청에 대한 다른 세부 정보와 함께 상태 코드 202 수락됨이 포함된 응답을 받아야 합니다.
패브릭 포털에서 새로 만든 웨어하우스로 이동합니다.
쿼리 편집기에서 다음 T-SQL 문을 실행하여 웨어하우스의 데이터 정렬이 JSON에서 지정한 것과 일치하는지 확인합니다.
SELECT name, collation_name FROM sys.databases;