KQL 데이터베이스에서 OneLake 바로 가기 만들기

OneLake는 Microsoft Fabric이 레이크하우스, 웨어하우스, KQL 데이터베이스 및 기타 항목을 저장할 수 있는 단일 통합 논리 데이터 레이크입니다. 바로 가기는 원래 데이터를 이동하지 않고 다른 파일의 저장소 위치를 가리키는 OneLake 내에 포함된 참조입니다. 포함된 참조는 파일 및 폴더가 로컬로 저장되지만 실제로는 표시되는 것처럼 표시됩니다. 다른 스토리지 위치에 존재합니다. 항목에서 바로 가기를 업데이트하거나 제거할 수 있지만 이러한 변경 내용은 원래 데이터와 원본에 영향을 주지 않습니다.

이 문서에서는 내부 패브릭 또는 외부 원본을 가리키는 KQL 데이터베이스에서 OneLake 바로 가기를 만드는 방법을 알아봅니다. 이러한 종류의 바로 가기는 나중에 함수를 사용하여 KQL 쿼리 세트의 쿼리에 액세스합니다.external_table() KQL 데이터베이스에서 만든 바로 가기는 이름을 바꿀 수 없으며 한 번에 하나의 바로 가기만 만들 수 있습니다.

KQL 데이터베이스에서 바로 가기를 만드는 것 외에도 다른 패브릭 항목에서 바로 가기를 만들 수 있습니다. 또한 이러한 바로 가기는 내부 패브릭 또는 외부 원본에 저장된 데이터를 가리키지만 제한 사항이 다르며 다르게 액세스됩니다. 자세한 내용은 OneLake 바로 가기를 참조 하세요.

참고 항목

데이터를 분할하거나 인덱싱하지 않고 기록 데이터에 대해 쿼리를 자주 실행하지 않으려면 OneLake 바로 가기를 사용합니다. 쿼리를 자주 실행하고 성능을 가속화하려면 데이터를 KQL 데이터베이스로 직접 가져옵니다.

만들려는 바로 가기에 해당하는 탭을 선택합니다.

OneLake 바로 가기

필수 조건

• Microsoft Fabric 사용 용량이 있는 작업 영역
• 편집 권한이 있는 KQL 데이터베이스
• 레이크 하우스

다른 Microsoft Fabric 환경에서 KQL 데이터베이스의 데이터에 액세스하려면 하나의 논리 복사본을 참조하세요.

바로 가기 만들기

참고 항목

다음 흐름에서는 Fabric의 Lakehouse에서 데이터를 가리키는 바로 가기를 만드는 방법을 보여 줍니다. 마찬가지로 데이터 웨어하우스 또는 다른 KQL 데이터베이스를 가리키는 바로 가기를 만들 수 있습니다.

1. 기존 KQL 데이터베이스로 찾습니다.

2. 새>OneLake 바로 가기를 선택합니다.

   

원본 선택

1. 내부 원본에서 Microsoft OneLake를 선택합니다.

   

2. 연결할 데이터 원본을 선택한 다음, 다음을 선택합니다.

   

3. 테이블을 확장하고 연결할 특정 테이블을 선택합니다.

   

4. 만들기를 선택합니다.

참고 항목

바로 가기당 하나의 하위 폴더 또는 테이블에만 연결할 수 있습니다. 더 많은 데이터에 연결하려면 다음 단계를 반복하고 추가 바로 가기를 만듭니다.

Azure Data Lake Storage Gen2

필수 조건

• Microsoft Fabric 사용 용량이 있는 작업 영역
• 편집 권한이 있는 KQL 데이터베이스
• Azure Data Lake Storage Gen2 계정.

바로 가기 만들기

1. 기존 KQL 데이터베이스로 찾습니다.

2. 새>OneLake 바로 가기를 선택합니다.

   

원본 선택

1. 외부 원본에서 Azure Data Lake Storage Gen2를 선택합니다.

2. 다음 표에 따라 커넥트ion 설정을 입력합니다.

   

   필드	설명	값
   URL	델타 컨테이너에 대한 연결 문자열.	https://StorageAccountName.dfs.core.windows.net
   Connection	지정된 스토리지 위치에 대해 이전에 정의된 연결이 드롭다운에 표시됩니다. 연결이 없으면 새 연결을 만듭니다.	새 연결을 만듭니다.
   연결 이름	Azure Data Lake Storage Gen2 연결 이름입니다.	연결의 이름입니다.
   인증 종류	권한 부여 모델입니다. 지원되는 모델은 조직 계정, 계정 키, SAS(공유 액세스 서명) 및 서비스 주체입니다. 자세한 내용은 ADLS 바로 가기를 참조 하세요.	권한 부여 모델에 종속됩니다. 인증 종류를 선택하면 필요한 자격 증명을 입력합니다.

3. 다음을 선택합니다.

4. 바로 가기의 대상 위치로 찾습니다.

   

   연결 URL에서 스토리지 계정을 사용한 경우 사용 가능한 모든 컨테이너가 왼쪽 탐색 보기에 표시됩니다. 연결 URL에 컨테이너를 지정한 경우 지정된 컨테이너와 해당 내용만 탐색 보기에 표시됩니다.

   폴더를 선택하거나 폴더 옆에 있는 확장 당근을 클릭하여 스토리지 계정을 탐색합니다.

   이 보기에서는 하나 이상의 바로 가기 대상 위치를 선택할 수 있습니다. 왼쪽 탐색 보기의 폴더 옆에 있는 검사 상자를 클릭하여 대상 위치를 선택합니다.

5. 다음을 선택합니다.

   

   검토 페이지에서는 모든 선택 항목을 확인할 수 있습니다. 여기에서 만들 각 바로 가기를 볼 수 있습니다. 작업 열에서 연필 아이콘을 클릭하여 바로 가기 이름을 편집할 수 있습니다. 휴지통 아이콘을 클릭하여 바로 가기를 삭제할 수 있습니다.

6. 만들기를 실행합니다.

Amazon S3

필수 조건

• Microsoft Fabric 사용 용량이 있는 작업 영역
• 편집 권한이 있는 KQL 데이터베이스
• Amazon S3 계정. 자세한 내용은 Amazon S3란?을 참조하세요 .

바로 가기 만들기

1. 기존 KQL 데이터베이스로 찾습니다.

2. 새>OneLake 바로 가기를 선택합니다.

   

원본 선택

1. 외부 원본에서 Amazon S3을 선택합니다.

2. 다음 표에 따라 커넥트ion 설정을 입력합니다.

   

   필드	설명	값
   URL	Amazon S3 버킷의 연결 문자열.	https://BucketName.s3.RegionCode.amazonaws.com
   Connection	지정된 스토리지 위치에 대해 이전에 정의된 연결이 드롭다운에 표시됩니다. 연결이 없으면 새 연결을 만듭니다.	새 연결 만들기
   연결 이름	Amazon S3 연결 이름입니다.	연결의 이름입니다.
   인증 종류	IAM(ID 및 액세스 관리) 정책입니다. 정책에 읽기 및 목록 권한이 있어야 합니다. 자세한 내용은 IAM 사용자를 참조 하세요.	버킷 정책에 따라 다릅니다.
   액세스 키 ID	IAM(ID 및 액세스 관리) 사용자 키입니다. 자세한 내용은 IAM 사용자의 액세스 키 관리를 참조 하세요.	액세스 키입니다.
   비밀 액세스 키	IAM(ID 및 액세스 관리) 비밀 키입니다.	비밀 키.

다음을 선택합니다.

1. 바로 가기의 대상 위치로 찾습니다.

   

   연결 URL에서 전역 엔드포인트를 사용한 경우 사용 가능한 모든 버킷이 왼쪽 탐색 보기에 표시됩니다. 연결 URL에서 버킷 특정 엔드포인트를 사용한 경우 지정된 버킷과 해당 내용만 탐색 보기에 표시됩니다.

   폴더를 선택하거나 폴더 옆에 있는 확장 당근을 클릭하여 스토리지 계정을 탐색합니다.

   이 보기에서는 하나 이상의 바로 가기 대상 위치를 선택할 수 있습니다. 왼쪽 탐색 보기의 폴더 옆에 있는 검사 상자를 클릭하여 대상 위치를 선택합니다.

2. 다음을 선택합니다.

   

   검토 페이지에서는 모든 선택 항목을 확인할 수 있습니다. 여기에서 만들 각 바로 가기를 볼 수 있습니다. 작업 열에서 연필 아이콘을 클릭하여 바로 가기 이름을 편집할 수 있습니다. 휴지통 아이콘을 클릭하여 바로 가기를 삭제할 수 있습니다.

3. 만들기를 실행합니다.

데이터베이스가 자동으로 새로 고쳐집니다. 바로 가기는 탐색기 창의바로 가기 아래에 나타납니다.

OneLake 바로 가기가 만들어졌습니다. 이제 이 데이터를 쿼리할 수 있습니다.

쿼리 데이터

OneLake 바로 가기에서 데이터를 쿼리하려면 함수를 external_table() 사용합니다.

1. 데이터베이스의 오른쪽에서 데이터 탐색을 선택합니다. 데이터를 처음 살펴보기 위해 실행할 수 있는 몇 가지 예제 쿼리가 포함된 창이 열립니다.
2. 테이블 이름 자리 표시자를 external_table('바로 가기 이름으로') 바꿉다.
3. 실행을 선택하거나 Shift + Enter를 눌러 선택한 쿼리를 실행합니다.

데이터 형식 매핑

이벤트 하우스 데이터 형식 매핑에 대한 델타 parquet

델타 기본 데이터 형식은 다음 규칙을 사용하여 Event house 스칼라 데이터 형식에 매핑됩니다. 이벤트 하우스 데이터 형식에 대한 자세한 내용은 스칼라 데이터 형식을 참조 하세요.

델타 형식	Eventhouse 스칼라 데이터 형식
string	string
long	long
integer	int
short	int
byte	real
float	real
double	real
decimal	decimal
boolean	bool
binary	string
date	datetime
timestamp_ntz (표준 시간대 제외)	datetime
struct	dynamic
array	dynamic
map	dynamic

관련 콘텐츠

• KQL 쿼리 세트의 데이터 쿼리
• external_table() 함수