在 KQL 数据库中创建 OneLake 快捷方式

OneLake 是 Microsoft Fabric 用于存储数据湖屋、仓库、KQL 数据库和其他项的单个统一逻辑数据湖。 快捷方式是 OneLake 中嵌入的引用，指向其他文件的存储位置，无需移动原始数据。 嵌入的引用使它看起来好像文件和文件夹存储在本地，但实际上它们存在于另一个存储位置。 可以更新或删除项中的快捷方式，但这些更改不会影响原始数据及其源。

本文介绍如何在指向内部 Fabric 或外部源的 KQL 数据库中创建 OneLake 快捷方式。 稍后使用 external_table() 函数访问这种快捷方式以在 KQL 查询集中进行查询。 在 KQL 数据库中创建的快捷方式无法重命名，并且一次只能创建一个快捷方式。

除了从 KQL 数据库创建快捷方式之外，还可以从其他 Fabric 项创建快捷方式。 这些快捷方式还指向存储在内部 Fabric 或外部源中的数据，但具有不同的限制，并且访问方式也不同。 有关详细信息，请参阅 OneLake 快捷方式。

注意

在不对数据进行分区或索引的情况下偶尔对历史数据运行查询时，请使用 OneLake 快捷方式。 如果要频繁运行查询并加快性能，请将数据直接导入 KQL 数据库。

选择与要创建的快捷方式对应的选项卡：

OneLake 快捷方式

先决条件

• 具有已启用 Microsoft Fabric 的容量的工作区
• 具有编辑权限的 KQL 数据库
• 湖屋

若要在其他 Microsoft Fabric 体验中访问 KQL 数据库的数据，请参阅一个逻辑副本。

创建快捷方式

注意

以下流程演示如何创建指向 Fabric 湖屋中的数据的快捷方式。 同样，你也可以创建指向 Data Warehouse 或其他 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
   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. 根据下表输入连接设置：

   

   字段	说明	值
   URL	Amazon S3 存储桶的连接字符串。	https://BucketName.s3.RegionCode.amazonaws.com
   Connection	以前为指定存储位置定义的连接显示在下拉列表中。 如果不存在任何连接，请创建一个新连接。	创建新连接
   连接名称	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 到 Event house 数据类型映射

Delta primitive 数据类型通过使用以下规则映射到 Eventhouse 标量数据类型。 有关 Event house 数据类型的详细信息，请参阅标量数据类型。

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

相关内容

• 在 KQL 查询集中查询数据
• external_table() 函数