В этой статье описаны действия по созданию моментальных снимков хранилища и управлению ими с помощью портала 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>
.
Укажите время для создания моментального снимка. Метка времени может быть задана в любой точке в течение периода хранения (за последние 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 и идентификатор моментального снимка хранилища. Чтобы найти эти значения, посетите моментальный снимок хранилища на портале 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 выберите "Записать новое состояние " в контекстном меню, а затем выберите метку времени для моментального снимка. Вы можете выбрать текущую или любую точку в течение периода хранения (за последние 30 дней).
Инструкция ALTER DATABASE
SQL использует системное время хранилища в качестве новой точки во времени, в которой исходные данные хранилища будут отражены в моментальном снимке.
Чтобы обновить моментальный снимок до текущего состояния хранилища, используйте CURRENT_TIMESTAMP
.
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = CURRENT_TIMESTAMP;
Метка времени также может быть задана в любой точке в течение периода хранения (за последние 30 дней). Формат аргумента TIMESTAMP
.YYYY-MM-DDTHH:MM:SS.SS
Например, чтобы задать метку времени 27 апреля 2025 г. в 18:10 UTC:
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = '2025-04-27T18:10:00.00';
Переименовать
Вы можете переименовать элемент снимка хранилища с помощью 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>
.
Укажите время для создания моментального снимка. Метка времени может быть задана в любой точке в течение периода хранения (за последние 30 дней). Если 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>
.
Связанный контент