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

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

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

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

注意

若要加速對 OneLake 捷徑的查詢，請參閱 加速透過 OneLake 捷徑的查詢。

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

OneLake 快捷方式

必要條件

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

若要在其他 Microsoft Fabric 體驗中存取 KQL 資料庫的資料，請參閱一個邏輯複本。

建立捷徑

注意

下列流程示範如何建立指向 Fabric 中 Lakehouse 資料的捷徑。 同樣地，您可以建立指向資料倉儲或其他 KQL 資料庫的快捷方式。

1. 流覽至現有的 KQL 資料庫。

2. 選取 新增>OneLake 快捷方式。

   

選取來源

1. 在內部來源中，選取Microsoft OneLake。

   

2. 選取要連接的資料來源，然後選取下一步。

   

3. 展開 [ 資料表]，然後選取要連線的特定資料表。

   

4. 選取 [下一步]。

注意

若要在新快捷方式上啟用查詢加速，請將 [ 加速 ] 按鈕切換為 [開啟]。 如需詳細資訊，請參閱 透過 OneLake 快捷方式加速查詢。

5. 選取 建立。

注意

每個快捷方式只能連線到一個子資料夾或資料表。 若要連線到更多資料，請重複這些步驟並建立其他快捷方式。

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	Delta 容器的連接字串。	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) 祕密金鑰。	您的祕密金鑰。

3. 選取 [下一步]。

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

   

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

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

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

5. 選取 [下一步]。

   

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

6. 選取 建立。

資料庫會自動重新整理。 快捷方式會出現在 快捷方式下的 文件瀏覽器窗格中。

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

查詢資料

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

1. 在資料庫最右邊，選取 [ 探索您的資料]。 視窗會開啟，其中有幾個範例查詢可供您執行，以初步了解您的資料。
2. 將資料表名稱佔位元取代為external_table('快捷名稱')。
3. 選擇 執行 或按 Shift + Enter 執行選取查詢。

資料類型對應

Delta parquet 至 Eventhouse 資料類型對應

Delta 基本資料類型會根據以下規則映射到 Eventhouse 純量資料類型。 如需 Eventhouse 資料類型的詳細資訊，請參閱 純量資料類型。

Delta類型	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()函式
• 加快對 OneLake 快捷方式的查詢