在 KQL 資料庫中建立 OneLake 快捷方式

OneLake 是單一、統一的邏輯資料湖，用於 Microsoft Fabric 以儲存 Lakehouse、倉儲、KQL 資料庫和其他項目。 快捷方式是 OneLake 中的內嵌參考，指向其他檔案的存放區位置，而不需要移動原始資料。 內嵌參考會顯示為檔案和資料夾儲存在本機，但實際上為 ：它們存在於另一個儲存位置。 您可以更新或移除項目的快捷方式，但這些變更不會影響原始資料及其來源。

在本文章中您將瞭解如何在指向內部 Fabric 或外部來源的 KQL 資料庫中，建立 OneLake 捷徑。 稍後會使用 external_table()函式，在 KQL 查詢集中存取這類的查詢快捷方式。 無法在 KQL 資料庫中建立的快捷方式重新命名，而且一次只能建立一個快捷方式。

除了從 KQL 資料庫建立捷徑之外，也可以從其他 Fabric 項目建立捷徑。 這些捷徑也會指向儲存在內部 Fabric 或外部來源中儲存的資料，但有不同的限制且存取方式不同。 如需詳細資訊，請參閱 OneLake 捷徑。

注意

當您想要不常在歷程記錄資料上執行查詢，而不需分割或編製資料索引時，請使用 OneLake 快捷方式。 如果您想要經常執行查詢並加速效能，請將資料直接匯入 KQL 資料庫。

選取對應至您要建立之快捷方式的索引標籤：

OneLake 快捷方式

必要條件

• 工作區，具有已啟用 Microsoft Fabric 的容量
• 具有編輯權限的 KQL 資料庫
• Lakehouse

若要在其他 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. 根據下表輸入 [ 連線] 設定 ：

   

   欄位	描述	值
   URL	差異容器的 連接字串。	https://StorageAccountName.dfs.core.windows.net
   [連接]	先前為指定儲存位置定義的聯機會出現在下拉式清單中。 如果沒有連線，請建立新的連線。	建立新連線。
   連線名稱	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. 根據下表輸入 [ 連線] 設定 ：

   

   欄位	描述	值
   URL	Amazon S3 貯體 連接字串。	https://BucketName.s3.RegionCode.amazonaws.com
   [連接]	先前為指定儲存位置定義的聯機會出現在下拉式清單中。 如果沒有連線，請建立新的連線。	建立新連線
   連線名稱	Amazon S3 連線名稱。	您的連線名稱
   驗證種類	身分識別和存取權管理 (IAM) 原則。 原則必須具有讀取和清單權限。 如需詳細資訊，請參閱 IAM 使用者。	相依於貯體原則。
   存取金鑰 ID	身分識別和存取權管理 (IAM) 使用者金鑰。 如需詳細資訊，請參閱為 IAM 使用者管理存取金鑰。	您的存取金鑰。
   祕密存取金鑰	身分識別和存取權管理 (IAM) 祕密金鑰。	您的祕密金鑰。

選取 [下一步]。

1. 流覽至快捷方式的目標位置。

   

   如果您在連線 URL 中使用全域端點，則所有可用的貯體都會出現在左側導覽檢視中。 如果您在連線 URL 中使用貯體特定端點，則導覽檢視中只會顯示指定的貯體及其內容。

   選取資料夾或按兩下資料夾旁邊的展開箭號，以瀏覽儲存體帳戶。

   在此檢視中，您可以選取一或多個快捷方式目標位置。 按兩下左側導覽檢視中資料夾旁的複選框，選擇目標位置。

2. 選取 [下一步]。

   

   [檢閱] 頁面可讓您驗證所有選取專案。 您可以在這裡看到將建立的每個快捷方式。 在動作資料行中，您可以按下鉛筆圖示來編輯快捷方式名稱。 您可以按下垃圾桶圖示來刪除快捷方式。

3. 選取 建立。

資料庫會自動重新整理。 快捷方式會出現在 [總管] 窗格中的 [快捷方式] 底下。

OneLake 快捷方式已建立。 您現在可以查詢此資料。

查詢資料

若要從 OneLake 快捷方式查詢資料，請使用 函 external_table() 式。

1. 在資料庫最右邊，選取 [ 探索您的資料]。 視窗隨即開啟，其中包含幾個您可以執行的範例查詢，以取得資料的初始外觀。
2. 將資料表名稱佔位元取代為external_table('快捷方式名稱')。
3. 選擇 執行 或按 Shift + Enter 執行選取查詢。

資料類型對應

Delta parquet 至 Eventhouse 資料類型對應

差異基本資料類型會使用下列規則對應至 Eventhouse 純量資料類型。 如需 Eventhouse 資料類型的詳細資訊，請參閱 純量資料類型。

差異類型	Eventhouse Scalar 資料類型
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()函式