创建和管理仓库快照（预览版）

2025-05-20

本文包含使用 Fabric 门户、T-SQL 查询或 Fabric API 创建和管理仓库快照的步骤。

注释

仓库快照目前是预览功能。

先决条件

具有激活容量或试用容量的 Fabric 工作区。
Fabric 仓库。
验证所需的用户权限。

创建

可以为同一父仓库创建多个快照。创建仓库快照后，它们将在工作区视图中显示为父仓库的子项。

在 Fabric 门户中创建仓库快照
使用 REST API 创建仓库快照

可以通过 Fabric 门户创建仓库快照。在功能区中的 “管理”下，选择“ 新建仓库快照”。

通过 REST API 创建仓库快照的示例 JSON 请求：

POST https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items
Authorization: Bearer <bearer token>
Content-Type: application/json

{ 
 "type": "WarehouseSnapshot",
  "displayName": "<snapshot item display name>", 
  "description": "<helpful description of snapshot item>", 
  "creationPayload": { 
    "parentWarehouseId": "<parent warehouse ID>", 
    "snapshotDateTime": "<YYYY-MM-DDTHH:SS:SSZ>" //Enter UTC time
  } 
}

将 <workspace ID> 和 <parent warehouse ID> 替换为相应的 Fabric 工作区 ID 和仓库 ID。若要查找这些值，请通过 Fabric 门户访问你的仓库。
- <workspace ID>：在 /groups/ 节后的 URL 中查找工作区 GUID，或者通过在现有仓库中运行 SELECT @@SERVERNAME 来查找。例如，11aaa111-a11a-1111-1aaa-aa111111aaa。不要包含 / 字符。
- <parent warehouse ID>：在 /warehouses/ 部分后的 URL 中查找仓库 GUID，或者通过在现有仓库中运行 SELECT @@SERVERNAME 来查找。例如，11aaa111-a11a-1111-1aaa-aa111111aaa。不要包含 / 字符。
<bearer token>：请按以下步骤获取该内容：
1. 在浏览器（Microsoft Edge 或 Google Chrome）中打开 Microsoft Fabric 工作区。
2. 按 F12 打开开发人员工具。
3. 选择“控制台”选项卡。如有必要，选择“展开快速视图”以显示控制台提示符 >。
4. 输入命令 powerBIAccessToken，然后按 Enter。右键单击控制台中返回的大型唯一字符串，然后选择 “复制字符串内容”。
5. 将其粘贴到 <bearer token> 的位置。
为和<helpful description of snapshot item>提供自解值<snapshot item display name>。
提供要基于的快照的时间。时间戳可以设置为保留期内的任何点（在过去 30 天内）。如果未 snapshotDateTime 提供，快照将使用当前时间。

返回指定快照的属性：

GET https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>

替换 <workspace ID> 并 <warehouse snapshot ID> 替换为相应的 Fabric 工作区 ID 和仓库 snapshotId。若要查找这些值，请访问 Fabric 门户中的仓库快照。
- <workspace ID>：在 /groups/ 节后的 URL 中查找工作区 GUID，或者通过在现有仓库中运行 SELECT @@SERVERNAME 来查找。例如，11aaa111-a11a-1111-1aaa-aa111111aaa。不要包含 / 字符。
- <warehouse snapshot ID>：在节后的 /warehousesnapshots/ URL 中查找仓库快照 GUID。

查询快照

创建后，仓库快照会显示为工作区中的子项。

像仓库一样连接到快照。在仓库快照的设置中，访问 SQL 终结点 以查看和复制 SQL 连接字符串。连接字符串如下所示： <server-name>.datawarehouse.fabric.microsoft.com. 具有适当权限（管理员、成员、参与者或查看器）的用户可以像仓库一样查询快照。有关详细信息，请参阅 Microsoft Fabric 中的仓库连接。

查看快照时间戳

运行 T-SQL 查询时，将包含有关所访问数据的当前版本的信息。例如，可以在 Fabric 门户查询编辑器的消息中看到时间戳：

若要查看仓库的快照及其当前时间戳，请使用以下 T-SQL 查询，通过 sys.databases 和 TIMESTAMP 的扩展属性来呈现属性：

SELECT snapshot_name = v.name
, source_warehouse_name = s.name
, snapshot_timestamp = DATABASEPROPERTYEX(v.name,'TIMESTAMP')
FROM sys.databases AS v 
INNER JOIN sys.databases AS s ON v.source_database_id=s.database_id;

更新快照时间戳

可以随时更新现有仓库快照的时间戳。

可以在父仓库的上下文中或通过 Fabric 门户使用 T-SQL 命令来实现此目的。有关详细信息，请参阅更新快照时间戳。

在 Fabric 门户中，从上下文菜单中选择“ 捕获新状态 ”，然后选择快照的时间戳。可以选择 “当前 ”或保留期内的任何点（过去 30 天内）。

ALTER DATABASE SQL 语句使用仓库的系统时间作为源仓库数据将反映在快照中的新时间点。

若要将快照更新到仓库的当前状态，请使用 CURRENT_TIMESTAMP。
```
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = CURRENT_TIMESTAMP; 
```
时间戳还可以设置为保留期内的任何点（在过去 30 天内）。参数的格式 TIMESTAMP 为 YYYY-MM-DDTHH:MM:SS.SS. 例如，若要将时间戳设置为 2025 年 4 月 27 日，时间为 18：10 UTC：
```
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = '2025-04-27T18:10:00.00';
```

重命名

可以通过 REST API 和 Fabric 门户中重命名仓库快照项。

在 Fabric 门户中重命名仓库快照
使用 REST API 重命名仓库快照

可以通过 Fabric 门户重命名仓库快照。打开仓库快照。选择“设置”按钮，提供新的名称。

通过 REST API 重命名仓库快照的示例 JSON 请求：

PATCH https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token> 
Content-Type: application/json

{ 
  "type": "WarehouseSnapshot",
  "displayName": "<snapshot item new display name>", 
  "description": "<helpful description of snapshot item>", 
  "creationPayload": { 
    "parentWarehouseId": "<parent warehouse ID>", 
    "snapshotDateTime": "YYYY-MM-DDTHH:SS:SSZ" //Enter UTC time
  } 
}

替换<workspace ID>、<warehouse snapshot ID>和<parent Warehouse ID>为相应的 Fabric 工作区和仓库 ID。若要查找这些值，请访问 Fabric 门户中的仓库快照。
- <workspace ID>：在 /groups/ 节后的 URL 中查找工作区 GUID，或者通过在现有仓库中运行 SELECT @@SERVERNAME 来查找。例如，11aaa111-a11a-1111-1aaa-aa111111aaa。不要包含 / 字符。
- <warehouse snapshot ID>：在 /warehousesnapshots/ 部分后面的 URL 中查找仓库快照 GUID。
- <parent warehouse ID>：在 /warehouses/ 部分后的 URL 中查找仓库 GUID，或者通过在现有仓库中运行 SELECT @@SERVERNAME 来查找。例如，11aaa111-a11a-1111-1aaa-aa111111aaa。不要包含 / 字符。
<bearer token>：请按以下步骤获取该内容：
1. 在浏览器（Microsoft Edge 或 Google Chrome）中打开 Microsoft Fabric 工作区。
2. 按 F12 打开开发人员工具。
3. 选择“控制台”选项卡。如有必要，选择“展开快速视图”以显示控制台提示符 >。
4. 输入命令 powerBIAccessToken，然后按 Enter。右键单击控制台中返回的大型唯一字符串，然后选择 “复制字符串内容”。
5. 将其粘贴到 <bearer token> 的位置。
为<snapshot item new display name>和<helpful description of snapshot item>提供自解释的值。
请提供一个时间来作为快照的基准。时间戳可以设置为保留期内的任何点（在过去 30 天内）。如果没有提供 snapshotDateTime，快照将使用当前时间。

删除

可以在 Fabric 门户中或使用 REST API 删除仓库快照。

在 Fabric 门户中删除仓库快照
使用 REST API 删除仓库快照

可以通过 Fabric 门户删除仓库快照。在工作区项列表中，选择仓库快照项的上下文菜单，然后选择“ 删除”。

用于删除快照的示例 REST API 请求：

DELETE https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>

将 <workspace ID> 和 <warehouse snapshot ID> 替换为相应的 Fabric 工作区 ID 和仓库 ID。若要查找这些值，请访问 Fabric 门户中的仓库快照。
- <workspace ID>：在 /groups/ 节后的 URL 中查找工作区 GUID，或者通过在现有仓库中运行 SELECT @@SERVERNAME 来查找。例如，11aaa111-a11a-1111-1aaa-aa111111aaa。不要包含 / 字符。
- <warehouse snapshot ID>：在 /warehousesnapshots/ 部分后的 URL 中查找仓库快照 GUID。
<bearer token>：按照以下步骤获取此项：
1. 在浏览器（Microsoft Edge 或 Google Chrome）中打开 Microsoft Fabric 工作区。
2. 按 F12 打开开发人员工具。
3. 选择“控制台”选项卡。如有必要，选择“展开快速视图”以显示控制台提示符 >。
4. 输入命令 powerBIAccessToken，然后按 Enter。右键单击控制台中返回的大型唯一字符串，然后选择 “复制字符串内容”。
5. 将其粘贴到 <bearer token> 的位置。