Jak skonfigurować dzienniki inspekcji SQL

1. W obszarze roboczym platformy Fabric wybierz Ustawienia elementu hurtowni danych.

2. Wybierz stronę Dzienniki inspekcji SQL .

3. Włącz ustawienie Zapisz zdarzenia w dziennikach inspekcji SQL.

   

   Domyślnie wszystkie akcje są włączone i przechowywane przez dziewięć lat.

4. W sekcji Zdarzenia do zapisania wybierz zdarzenia, które rejestrują logi audytu SQL. Wybierz kategorie zdarzeń lub poszczególne grupy akcji audytu, które chcesz uchwycić. Wybierz tylko te zdarzenia, których wymaga Twoja organizacja, aby zoptymalizować przechowywanie danych i relewantność.

   

5. Opcjonalnie należy wpisać Wyrażenie Predykatu do filtrowania zdarzeń, na przykład wykluczając aktywność z znanego principu usługi lub tożsamości automatyzacji. Użyj składni opisanej w składni wyrażenia predykatów.

   

   Ważne

   Filtrowanie predykatów dotyczy tylko zdarzeń już wybranych w sekcji Zdarzenia do zapisu. Na przykład, aby filtrować SELECT instrukcje, musisz również włączyć opcję Batch Was Completed.

6. Określ żądany okres przechowywania dziennika w obszarze Lata, Miesiące i Dni.

   

7. Wybierz pozycję Zapisz , aby zastosować ustawienia.

Twój magazyn rejestruje teraz wybrane zdarzenia audytowe i bezpiecznie przechowuje logi w OneLake.

1. Pobierz i zainstaluj Visual Studio Code.

2. Zainstaluj rozszerzenie klienta REST z witryny Visual Studio Marketplace.

3. Zdobądź token na okaziciela, wykonując te kroki. Token nosiciela Power BI znajdziesz w narzędziach deweloperskich przeglądarki lub przez PowerShell.

   Aby użyć narzędzi deweloperskich przeglądarki Edge do znalezienia tokenu dostępu Power BI:

   1. Otwórz obszar roboczy Microsoft Fabric w przeglądarce (Microsoft Edge).
   2. Naciśnij F12 , aby otworzyć narzędzia deweloperskie.
   3. Wybierz kartę Konsola. W razie potrzeby wybierz pozycję Rozwiń szybki widok, aby wyświetlić monit >konsoli .
   4. 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.
   5. Wklej go zamiast <bearer token> w poniższych skryptach.

   Aby użyć programu PowerShell do znalezienia tokenu uwierzytelniającego Power BI:

   1. Zainstaluj moduł MicrosoftPowerBIMgmt z Cmdletów Microsoft Power BI dla Windows PowerShell i PowerShell Core.

      Install-Module -Name MicrosoftPowerBIMgmt
      

   2. Użyj Connect-PowerBIServiceAccount aby nawiązać połączenie z programem Power BI PowerShell i pobrać token elementu nośnego.

      Connect-PowerBIServiceAccount
      $token = (Get-PowerBIAccessToken).Authorization
      Write-Output "Bearer $token"
      

4. Po otrzymaniu tokena nosiciela Power BI, wyślij żądanie PATCH za pomocą rozszerzenia klienta REST. W VS Code utworz nowy plik tekstowy z tym rozszerzeniem .http .

5. Skopiuj i wklej następujące żądanie:

   PATCH https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/warehouses/<warehouseId>/settings/sqlAudit
   content-type: application/json
   Authorization: Bearer <BEARER_TOKEN>
   
   {
       "state": "Enabled",
       "retentionDays": "0"
   }
   

   • Zastąp <workspaceId> i <warehouseId> odpowiednimi identyfikatorami obszaru roboczego i magazynu Fabric. Aby znaleźć te wartości, odwiedź magazyn w portalu Fabric.
     • <workspaceID>: 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 /.
     • <warehouseID>: 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 /.
   • Zamień <BEARER_TOKEN> na swój token dostępu .
     • Ustaw state na Enabled, aby włączyć inspekcję (aby ją wyłączyć, użyj Disabled).
     • Ustaw parametr retentionDays na 0, aby włączyć nieograniczoną retencję. Jest to ustawienie domyślne.

   Ważne

   W przykładowym kodzie rozszerzenia należy dołączyć pusty wiersz natychmiast po podaniu tokenu elementu nośnego. Ta pusta linia sygnalizuje rozszerzenie, gdzie kończą się nagłówki HTTP, a zaczyna się ciało poleceń API, dzięki czemu API może poprawnie rozróżnić te dwa elementy.

6. Wybierz pozycję Wyślij żądanie.

Sprawdzanie stanu dziennika inspekcji za pomocą interfejsu API REST

Aby zweryfikować, czy logi audytowe SQL są włączone, wyślij żądanie GET, używając tego samego rozszerzenia klienta REST.

1. W VS Code utworz nowy plik tekstowy z tym rozszerzeniem .http .
2. Skopiuj i wklej następujące żądanie, podając własne workspaceId, <warehouseId>i <BEARER_TOKEN>.

GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/warehouses/<warehouseId>/settings/sqlAudit
content-type: application/json
Authorization: Bearer <BEARER_TOKEN>

Odpowiedź zwraca ENABLED lub DISABLED oraz bieżącą konfigurację auditActionsAndGroups i predicateExpression.

Konfigurowanie grup akcji inspekcji przy użyciu interfejsu API REST

Dzienniki inspekcji SQL opierają się na wstępnie zdefiniowanych grupach akcji, które przechwytują określone zdarzenia w bazie danych. Aby uzyskać szczegółowe informacje na temat grup akcji inspekcji, zobacz dzienniki inspekcji SQL w usłudze Fabric Data Warehouse.

1. W VS Code utworz nowy plik tekstowy z tym rozszerzeniem .http .

2. Skopiuj i wklej następujące żądanie, podając własne workspaceId, <warehouseId>i <BEARER_TOKEN>.

   POST https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/warehouses/<warehouseId>/settings/sqlAudit
   content-type: application/json
   Authorization: Bearer <BEARER_TOKEN>
   [  "DATABASE_OBJECT_PERMISSION_CHANGE_GROUP" ]
   

3. Wybierz pozycję Wyślij żądanie.

Konfiguruj wyrażenie predykatowe

Użyj tego samego PATCH żądania API do skonfigurowania wyrażenia predykatowego, które wyklucza generowanie konkretnych zdarzeń, takich jak aktywność znanego principa usługi lub tożsamość automatyzacji. Pełną składnię predykatów można znaleźć w składni wyrażeń predykatów.

1. W VS Code utworz nowy plik tekstowy z tym rozszerzeniem .http .

2. Skopiuj i wklej następujące żądanie, podając własne workspaceId, <warehouseId>i <BEARER_TOKEN>.

   PATCH https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/warehouses/<warehouseId>/settings/sqlAudit
   content-type: application/json
   Authorization: ******
   
   {
       "state": "Enabled",
       "retentionDays": 10,
       "predicateExpression": "NOT statement LIKE 'SELECT %'"
   }
   

   • Ten przykład wyklucza instrukcje SELECT z audytu poprzez filtrowanie względem pola statement.
   • Gdy po raz pierwszy włączasz audyt SQL, pominięcie predicateExpression nie stosuje żadnego predykatu. W późniejszych aktualizacjach pominięcie tego pozostawia istniejący predykat bez zmian. Określ pusty ciąg (""), aby usunąć istniejący predykat.

   Ważne

   Filtrowanie predykatów ocenia tylko zdarzenia, które są już skonfigurowane do przechwycenia. Aby filtrować SELECT instrukcje, jak pokazano w tym przykładzie, należy również włączyć grupę akcji Batch Was Completed (BATCH_COMPLETED_GROUP). Więcej informacji można znaleźć w artykule Grupy i działania audytowe na poziomie bazy danych.

3. Wybierz pozycję Wyślij żądanie.