Ten artykuł zawiera kroki tworzenia migawek magazynu i zarządzania nimi przy użyciu portalu sieci szkieletowej, zapytań języka T-SQL lub interfejsu API sieci szkieletowej.
Wymagania wstępne
- Obszar roboczy Fabric z aktywną pojemnością lub pojemnością próbną.
- Magazyn tkanin.
- Zweryfikuj niezbędne uprawnienia użytkownika.
Utwórz
Dla tego samego nadrzędnego magazynu można utworzyć wiele migawek. Po utworzeniu migawek magazynu są one wyświetlane jako elementy podrzędne magazynu nadrzędnego w widoku obszaru roboczego.
Migawki magazynu można tworzyć za pośrednictwem portalu Fabric. Na wstążce w obszarze Zarządzanie wybierz pozycję Nowa migawka magazynu.
Przykładowe żądanie JSON dotyczące tworzenia migawki magazynu za pośrednictwem interfejsu API REST:
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
}
}
Zastąp <workspace ID> i <parent warehouse ID> odpowiednimi identyfikatorami obszaru roboczego i magazynu Fabric. Aby znaleźć te wartości, odwiedź magazyn w portalu Fabric.
-
<workspace ID>: Znajdź identyfikator GUID obszaru roboczego w adresie URL po sekcji /groups/ lub poprzez uruchomienie SELECT @@SERVERNAME w istniejącym magazynie. Na przykład 11aaa111-a11a-1111-1aaa-aa111111aaa. Nie dołączaj znaków /.
-
<parent warehouse ID>: znajdź identyfikator GUID magazynu w adresie URL po sekcji /warehouses/ lub uruchamiając SELECT @@SERVERNAME w istniejącym magazynie. Na przykład 11aaa111-a11a-1111-1aaa-aa111111aaa. Nie dołączaj znaków /.
<bearer token>: Uzyskaj to, wykonując następujące kroki:
- Otwórz obszar roboczy usługi Microsoft Fabric w przeglądarce (Microsoft Edge lub Google Chrome).
- Naciśnij F12 , aby otworzyć narzędzia deweloperskie.
- Wybierz kartę Konsola. W razie potrzeby wybierz pozycję Rozwiń szybki widok, aby wyświetlić monit
>konsoli .
- Wpisz polecenie
powerBIAccessToken i naciśnij Enter. Kliknij prawym przyciskiem myszy duży unikatowy ciąg zwrócony w konsoli i wybierz polecenie Kopiuj zawartość ciągu.
- Wklej go zamiast
<bearer token>.
Podaj objaśniające wartości dla <snapshot item display name> i <helpful description of snapshot item>.
Podaj czas, który ma być podstawą dla migawki. Znacznik czasu można ustawić na dowolny punkt w okresie przechowywania (w ciągu ostatnich 30 dni). Jeśli snapshotDateTime nie zostanie podana, migawka używa bieżącego czasu.
Aby uzyskać właściwości określonej migawki:
GET https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>
- Zastąp
<workspace ID> odpowiednim identyfikatorem obszaru roboczego Fabric i <warehouse snapshot ID> identyfikatorem snapshotId magazynu. Aby znaleźć te wartości, odwiedź migawkę magazynu w portalu Fabric.
-
<workspace ID>: Znajdź identyfikator GUID obszaru roboczego w adresie URL po sekcji /groups/ lub poprzez uruchomienie SELECT @@SERVERNAME w istniejącym magazynie. Na przykład 11aaa111-a11a-1111-1aaa-aa111111aaa. Nie dołączaj znaków /.
-
<warehouse snapshot ID>: Znajdź identyfikator GUID migawki magazynu w adresie URL po /warehousesnapshots/ sekcji.
Zapytanie o migawkę
Po utworzeniu migawki magazynu są wyświetlane jako elementy podrzędne w obszarze roboczym.
Połącz się z migawką w taki sam sposób jak do magazynu. W ustawieniach migawki magazynu odwiedź punkt końcowy SQL , aby wyświetlić i skopiować parametry połączenia SQL. Parametry połączenia wyglądają następująco: <server-name>.datawarehouse.fabric.microsoft.com. Użytkownicy z odpowiednimi uprawnieniami (Administrator, Członek, Współtwórca lub Przeglądający) mogą wykonywać zapytania dotyczące migawki tak jak magazyn danych. Aby uzyskać więcej informacji, zobacz Łączność z magazynem w usłudze Microsoft Fabric.
Wyświetl znacznik czasu migawki
Po uruchomieniu zapytania T-SQL są uwzględniane informacje o bieżącej wersji używanych danych. Na przykład można zobaczyć znacznik czasu w Komunikatach w edytorze zapytań portalu Fabric:.
Aby wyświetlić migawki magazynu i ich bieżące znaczniki czasu, użyj następującego zapytania T-SQL na sys.databases i rozszerzoną właściwość TIMESTAMP do wyświetlenia atrybutów.
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;
Aktualizuj znacznik czasu migawki
Znacznik czasu istniejącej migawki magazynu można zaktualizować w dowolnym momencie.
Można to zrobić za pomocą poleceń języka T-SQL w kontekście magazynu nadrzędnego lub za pośrednictwem Fabric portal. Aby uzyskać więcej informacji, zobacz Zaktualizuj sygnaturę czasową migawki.
W portalu Fabric wybierz pozycję Przechwyć nowy stan z menu kontekstowego, a następnie wybierz znacznik czasu migawki. Możesz wybrać pozycję Bieżący lub dowolny punkt w okresie przechowywania (w ciągu ostatnich 30 dni).
Instrukcja ALTER DATABASE SQL używa czasu systemowego magazynu jako nowego punktu, w którym dane źródłowego magazynu zostaną odzwierciedlone w migawce.
Aby zaktualizować migawkę do bieżącego stanu magazynu, użyj polecenia CURRENT_TIMESTAMP.
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = CURRENT_TIMESTAMP;
Znacznik czasu można również ustawić na dowolny punkt w okresie przechowywania (w ciągu ostatnich 30 dni). Format argumentu TIMESTAMP wynosi YYYY-MM-DDTHH:MM:SS.SS. Na przykład, aby ustawić znacznik czasu na 27 kwietnia 2025 o 18:10 UTC:
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = '2025-04-27T18:10:00.00';
Migawki magazynu można również aktualizować za pośrednictwem portalu Fabric. Na wstążce w obszarze Zarządzanie wybierz pozycję Zarządzaj migawką magazynu.
Zmień nazwę
Możesz zmienić nazwę elementu migawki magazynu za pomocą interfejsu API REST i w portalu Fabric.
Nazwy migawek magazynu można zmienić za pośrednictwem portalu sieci szkieletowej. Otwórz migawkę magazynu. Wybierz przycisk ustawień, podaj nową nazwę.
Przykładowe żądanie JSON dotyczące zmiany nazwy migawki magazynu za pośrednictwem interfejsu API REST:
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
}
}
Zastąp <workspace ID> wartości , <warehouse snapshot ID>i <parent Warehouse ID>odpowiednimi identyfikatorami obszaru roboczego sieci Szkieletowej i identyfikatorami magazynu. Aby znaleźć te wartości, odwiedź migawkę magazynu w portalu Fabric.
-
<workspace ID>: Znajdź identyfikator GUID obszaru roboczego w adresie URL po sekcji /groups/ lub poprzez uruchomienie SELECT @@SERVERNAME w istniejącym magazynie. Na przykład 11aaa111-a11a-1111-1aaa-aa111111aaa. Nie dołączaj znaków /.
-
<warehouse snapshot ID>: Znajdź identyfikator GUID migawki magazynu w adresie URL po /warehousesnapshots/ sekcji.
-
<parent warehouse ID>: znajdź identyfikator GUID magazynu w adresie URL po sekcji /warehouses/ lub uruchamiając SELECT @@SERVERNAME w istniejącym magazynie. Na przykład 11aaa111-a11a-1111-1aaa-aa111111aaa. Nie dołączaj znaków /.
<bearer token>: Uzyskaj to, wykonując następujące kroki:
- Otwórz obszar roboczy usługi Microsoft Fabric w przeglądarce (Microsoft Edge lub Google Chrome).
- Naciśnij F12 , aby otworzyć narzędzia deweloperskie.
- Wybierz kartę Konsola. W razie potrzeby wybierz pozycję Rozwiń szybki widok, aby wyświetlić monit
>konsoli .
- Wpisz polecenie
powerBIAccessToken i naciśnij Enter. Kliknij prawym przyciskiem myszy duży unikatowy ciąg zwrócony w konsoli i wybierz polecenie Kopiuj zawartość ciągu.
- Wklej go zamiast
<bearer token>.
Podaj objaśniające wartości dla <snapshot item new display name> i <helpful description of snapshot item>.
Podaj czas, który ma być podstawą dla migawki. Znacznik czasu można ustawić na dowolny punkt w okresie przechowywania (w ciągu ostatnich 30 dni). Jeśli snapshotDateTime nie zostanie podana, migawka używa bieżącego czasu.
Usuń
Migawkę magazynu można usunąć w portalu sieci szkieletowej lub przy użyciu interfejsu API REST.
Migawki magazynu można usunąć za pośrednictwem portalu Fabric. Na liście elementów obszaru roboczego wybierz menu kontekstowe elementu migawki magazynu, a następnie wybierz pozycję Usuń.
Przykładowe żądanie interfejsu API REST dotyczące usuwania migawki:
DELETE https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>
- Zastąp
<workspace ID> i <warehouse snapshot ID> odpowiednimi identyfikatorami obszaru roboczego i magazynu Fabric. Aby znaleźć te wartości, odwiedź migawkę magazynu w portalu Fabric.
-
<workspace ID>: Znajdź identyfikator GUID obszaru roboczego w adresie URL po sekcji /groups/ lub poprzez uruchomienie SELECT @@SERVERNAME w istniejącym magazynie. Na przykład 11aaa111-a11a-1111-1aaa-aa111111aaa. Nie dołączaj znaków /.
-
<warehouse snapshot ID>: Znajdź identyfikator GUID migawki magazynu w adresie URL po /warehousesnapshots/ sekcji.
-
<bearer token>: Uzyskaj to, wykonując następujące kroki:
- Otwórz obszar roboczy usługi Microsoft Fabric w przeglądarce (Microsoft Edge lub Google Chrome).
- Naciśnij F12 , aby otworzyć narzędzia deweloperskie.
- Wybierz kartę Konsola. W razie potrzeby wybierz pozycję Rozwiń szybki widok, aby wyświetlić monit
>konsoli .
- Wpisz polecenie
powerBIAccessToken i naciśnij Enter. Kliknij prawym przyciskiem myszy duży unikatowy ciąg zwrócony w konsoli i wybierz polecenie Kopiuj zawartość ciągu.
- Wklej go zamiast
<bearer token>.
Treści powiązane