共用方式為


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

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

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

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

注意

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

必要條件

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

建立捷徑

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

  2. 選擇 +>New>OneLake 捷徑

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

選取來源

OneLake 支援對內部 OneLake 資源(如 KQL 資料庫、湖屋和倉庫)及外部資源(如 Azure Data Lake Storage、Amazon S3 或 Google Cloud Storage)的捷徑。 關於所有支援的捷徑類型及其特定設定指示的連結,請參見 OneLake 捷徑 > 捷徑類型

KQL 資料庫中的捷徑支援 查詢加速。 若要在新快捷方式上啟用查詢加速,請將 [ 加速 ] 按鈕切換為 [開啟]。

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

注意

  1. 每個快捷方式只能連線到一個子資料夾或資料表。 為了連接更多資料,可以建立額外的捷徑。
  2. 你不能在任何包含星號(*)的欄位名稱的表格上建立捷徑。 在建立捷徑前,先重新命名欄位。

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

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

查詢資料

若要從 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