В этой статье описаны действия по созданию моментальных снимков хранилища и управлению ими с помощью портала Fabric, запросов T-SQL или API Fabric.
Предпосылки
- Рабочая область Fabric с активной мощностью или пробной вместимостью.
- Склад тканей.
- Проверьте необходимые разрешения пользователя.
Создайте
Для одного родительского хранилища можно создать несколько моментальных снимков. После создания моментальных снимков хранилища они отображаются как дочерние элементы родительского хранилища в представлении рабочей области.
Моментальные снимки хранилища можно создавать с помощью портала Fabric. На ленте в разделе "Управление" выберите "Создать моментальный снимок хранилища".
Пример запроса JSON для создания моментального снимка хранилища с помощью REST API:
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 и склада. Чтобы найти эти значения, посетите склад на портале Fabric.
-
<workspace ID>: найдите GUID рабочей области в URL-адресе после раздела /groups/ или выполните команду SELECT @@SERVERNAME в существующем хранилище. Например: 11aaa111-a11a-1111-1aaa-aa111111aaa. Не добавляйте символы /.
-
<parent warehouse ID>: Найдите GUID-идентификатор хранилища в URL после секции /warehouses/ или выполните SELECT @@SERVERNAME, чтобы найти его в существующем хранилище. Например: 11aaa111-a11a-1111-1aaa-aa111111aaa. Не добавляйте символы /.
<bearer token>. Получите это, выполнив следующие действия.
- Откройте рабочую область Microsoft Fabric в браузере (Microsoft Edge или Google Chrome).
- Нажмите клавишу F12 , чтобы открыть средства разработчика.
- Перейдите на вкладку "Консоль ". При необходимости выберите "Развернуть быстрое представление ", чтобы открыть запрос
>консоли.
- Введите команду
powerBIAccessToken и нажмите клавишу Enter. Щелкните правой кнопкой мыши большую уникальную строку, возвращенную в консоли, и выберите " Копировать содержимое строки".
- Вставьте его вместо
<bearer token>.
Предоставьте самоочевидные значения для <snapshot item display name> и <helpful description of snapshot item>.
Укажите время для создания моментального снимка. Метка времени может быть задана в любой момент в течение настроенного периода хранения. Если 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 и идентификатор моментального снимка хранилища. Чтобы найти эти значения, посетите моментальный снимок хранилища на портале Fabric.
-
<workspace ID>: найдите GUID рабочей области в URL-адресе после раздела /groups/ или выполните команду SELECT @@SERVERNAME в существующем хранилище. Например: 11aaa111-a11a-1111-1aaa-aa111111aaa. Не добавляйте символы /.
-
<warehouse snapshot ID>: найдите GUID моментального снимка хранилища в URL-адресе после секции /warehousesnapshots/.
Запрос моментального снимка
После создания моментальные снимки хранилища отображаются как дочерние элементы в рабочей области.
Подключитесь к снимку состояния в том же стиле, как к хранилищу. В параметрах моментального снимка хранилища выберите страницу конечной точки 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;
Обновите метку времени моментального снимка
Может быть обновлена метка времени существующего моментального снимка хранилища в любое время.
Это можно сделать с помощью команд T-SQL в контексте родительского хранилища или на портале Fabric. Дополнительные сведения см. в разделе "Обновление метки времени моментального снимка".
На портале Fabric выберите "Записать новое состояние " в контекстном меню, а затем выберите метку времени для моментального снимка. Вы можете выбрать Текущий или любую точку в пределах настроенного периода хранения.
Инструкция ALTER DATABASE SQL использует системное время хранилища в качестве новой точки во времени, в которой исходные данные хранилища будут отражены в моментальном снимке.
Чтобы обновить моментальный снимок до текущего состояния хранилища, используйте CURRENT_TIMESTAMP.
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = CURRENT_TIMESTAMP;
Метка времени также может быть задана на любой момент в пределах настроенного периода хранения. Формат аргумента TIMESTAMP .YYYY-MM-DDTHH:MM:SS.SS Например, чтобы задать метку времени 27 апреля 2025 г. в 18:10 UTC:
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = '2025-04-27T18:10:00.00';
Снимки состояния хранилища также можно обновить с помощью портала Fabric. На ленте в группе "Управление" выберите "Управление снимком состояния хранилища".
Note
При изменении настраиваемого периода хранения, если уменьшение срока хранения приведет к недопустимости одного или нескольких существующих моментальных снимков хранилища (так как метка времени их моментальных снимков выходит за пределы нового периода хранения), изменение хранения блокируется. Чтобы продолжить, сначала перенесите затронутые моментальные снимки на более поздние метки времени или удалите их, а затем обновите период хранения.
Переименовать
Вы можете переименовать элемент снимка хранилища с помощью REST API и на портале Fabric.
Моментальные снимки хранилища можно переименовать с помощью портала Fabric. Откройте снимок состояния хранилища. Нажмите кнопку "Параметры", укажите новое имя.
Пример запроса JSON для переименования моментального снимка хранилища с помощью REST API:
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 и склада. Чтобы найти эти значения, посетите моментальный снимок хранилища на портале Fabric.
-
<workspace ID>: найдите GUID рабочей области в URL-адресе после раздела /groups/ или выполните команду SELECT @@SERVERNAME в существующем хранилище. Например: 11aaa111-a11a-1111-1aaa-aa111111aaa. Не добавляйте символы /.
-
<warehouse snapshot ID>: найдите GUID моментального снимка хранилища в URL-адресе после секции /warehousesnapshots/.
-
<parent warehouse ID>: Найдите GUID-идентификатор хранилища в URL после секции /warehouses/ или выполните SELECT @@SERVERNAME, чтобы найти его в существующем хранилище. Например: 11aaa111-a11a-1111-1aaa-aa111111aaa. Не добавляйте символы /.
<bearer token>. Получите это, выполнив следующие действия.
- Откройте рабочую область Microsoft Fabric в браузере (Microsoft Edge или Google Chrome).
- Нажмите клавишу F12 , чтобы открыть средства разработчика.
- Перейдите на вкладку "Консоль ". При необходимости выберите "Развернуть быстрое представление ", чтобы открыть запрос
>консоли.
- Введите команду
powerBIAccessToken и нажмите клавишу Enter. Щелкните правой кнопкой мыши большую уникальную строку, возвращенную в консоли, и выберите " Копировать содержимое строки".
- Вставьте его вместо
<bearer token>.
Предоставьте самоочевидные значения для <snapshot item new display name> и <helpful description of snapshot item>.
Укажите время для создания моментального снимка. Метка времени может быть задана в любое время в пределах настроенного периода хранения. Если snapshotDateTime он не указан, моментальный снимок использует текущее время.
Удалить
Моментальный снимок хранилища можно удалить на портале 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 и склада. Чтобы найти эти значения, посетите моментальный снимок хранилища на портале Fabric.
-
<workspace ID>: найдите GUID рабочей области в URL-адресе после раздела /groups/ или выполните команду SELECT @@SERVERNAME в существующем хранилище. Например: 11aaa111-a11a-1111-1aaa-aa111111aaa. Не добавляйте символы /.
-
<warehouse snapshot ID>: найдите GUID моментального снимка хранилища в URL-адресе после секции /warehousesnapshots/.
-
<bearer token>: Получите это, выполнив следующие действия:
- Откройте рабочую область Microsoft Fabric в браузере (Microsoft Edge или Google Chrome).
- Нажмите клавишу F12 , чтобы открыть средства разработчика.
- Перейдите на вкладку "Консоль ". При необходимости выберите "Развернуть быстрое представление ", чтобы открыть запрос
>консоли.
- Введите команду
powerBIAccessToken и нажмите клавишу Enter. Щелкните правой кнопкой мыши большую уникальную строку, возвращенную в консоли, и выберите " Копировать содержимое строки".
- Вставьте его вместо
<bearer token>.
Связанный контент