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

KQL 資料庫中的 OneLake 捷徑讓你可以在不移動資料的情況下查詢內部 Fabric 項目和外部儲存裝置的資料。 在 KQL 資料庫中，每個捷徑都會顯示在 Shortcuts 底下，並可在 KQL 查詢集中使用 external_table() 函式作為外部資料表進行查詢。

在本文中，您將瞭解如何在 KQL 資料庫中建立 OneLake 捷徑，此捷徑可以指向內部的 Fabric 或外部來源。 你無法重新命名在 KQL 資料庫中建立的捷徑，而且一次只能建立一個捷徑。

關於捷徑類型、特定來源指令及更廣泛限制的一般資訊，請參見 OneLake 捷徑。

注意

為了提升支援捷徑的查詢效能，請參見 OneLake 捷徑上的查詢加速。

必要條件

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

建立捷徑

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

  2. 選擇 +>New>OneLake 捷徑。

    [首頁] 索引標籤的螢幕擷取畫面，顯示 [新增] 按鈕的下拉式清單，其中 OneLake 快捷方式的選項被突出顯示。

選取來源

KQL 資料庫支援捷徑連接內部 OneLake 資源，如 KQL 資料庫、湖屋與倉庫，以及外部資源，如 Azure Data Lake Storage、Amazon S3 和 Google Cloud Storage。 有關支援的捷徑類型及特定來源的設定指引完整清單，請參見 捷徑類型。

  1. 在 新快捷鍵 視窗中，選擇你想連接的來源類型。
  2. 完成來源所需的連線細節，然後選擇你想在 KQL 資料庫中暴露的資料夾或資料表。
  3. 可選：若要啟用新捷徑的查詢加速，請將 加速 設定為 開啟。
  4. 選取 ，創建。

關於支援的情境與限制，請參閱 OneLake 捷徑查詢加速 - 概述。

新捷徑視窗的截圖，顯示捷徑細節。加速切換開關會被高亮亮起。

注意

  1. 每個快捷方式只能連線到一個子資料夾或資料表。 為了連接更多資料，可以建立額外的捷徑。
  2. 你不能在欄位名稱中帶有星號（*）的表格上建立捷徑。 在建立捷徑之前，先把欄位重新命名。

建立捷徑後，資料庫會自動重新整理。 快捷方式會出現在 快捷方式下的 文件瀏覽器窗格中。 你現在可以查詢資料了。

檔案總管窗格的擷取畫面，其中顯示新的捷徑。

用資料夾組織捷徑

要建立子資料夾或移動到現有資料夾：

  1. 在檔案總覽視窗中，可以選擇：
    • 右鍵點擊捷徑，選擇 移動到資料夾>+新資料夾。
      顯示可為捷徑建立新資料夾選項的快顯選單截圖。
    • 或者，選擇特定捷徑旁的省略號（...），選擇 移動到資料夾>+新資料夾 ，或選擇現有資料夾。
      彈出選單的截圖，顯示將捷徑移到現有資料夾或建立新資料夾的選項。
  2. 要建立資料夾，輸入資料夾名稱並選擇 「建立」。 捷徑會移到新資料夾。
    新資料夾建立的截圖。
  3. 要移動多個捷徑，請輸入另一個資料夾名稱，或選擇下拉選單，勾選你想移到同一資料夾的捷徑旁的方框。
    彈出選單的截圖，顯示可將多個捷徑移到同一資料夾的選項。
  4. 你也可以把捷徑移到現有資料夾。 要做到這點，請選擇 「移動到資料夾 」，然後選擇你想移動捷徑到的資料夾，或是將捷徑拖曳到資料夾裡。

注意

  • 如果你刪除子資料夾，資料夾內的捷徑不會被刪除，而是會被移回父資料夾。
  • 當子資料夾內沒有任何捷徑時，子資料夾就會自動刪除。
  • 資料夾可以依資產類型建立，且名稱必須是唯一。 例如，你可以有一個同名的 table 資料夾和一個快捷鍵資料夾，但不能同時有兩個同名的快捷鍵資料夾。

查詢資料

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

  1. 在資料庫右側，選擇 「探索你的資料」。 視窗會開啟，其中有幾個範例查詢可供您執行，以初步了解您的資料。
  2. 將資料表名稱的佔位符替換為 external_table('<shortcut-name>')。
  3. 選擇 執行 或按 Shift + Enter 執行選取查詢。

[探索資料] 視窗的螢幕擷取畫面，其中顯示範例查詢的結果。

數據類型映射

Delta Parquet 與 Eventhouse 之間的資料類型對應

Delta 原始資料型態對應到 Eventhouse 的純量資料型態，如下表所示。 欲了解更多資訊，請參閱 標量資料型別。

Delta 型 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

自動結構同步

捷徑表的結構會自動同步，因此欄位的新增、刪除、重命名及來源表的型別變更都能反映在捷徑中，無需手動更新。 此行為預設為啟用。 要停用它，請在原始資料庫中執行以下指令：

.create-or-alter external table ExternalTable
kind=delta
(
   h@'https://storageaccount.blob.core.windows.net/container1;secretKey'
) with (AutoUpdateSchema=false)

欲了解更多關於結構同步行為的資訊，請參見 自動結構同步。

相關內容

  • Last updated on