Hvordan konfigurere SQL-revisjonslogger

1. I Fabric-arbeidsområdet velger du Innstillinger for lagervaren.

2. Velg siden for SQL-overvåkingslogger .

3. Aktiver innstillingen Lagre hendelser i SQL-overvåkingslogger.

   

   Som standard er alle handlinger aktivert og beholdt i ni år.

4. Under Hendelser for å registrere, velg hvilke hendelser SQL-revisjonsloggene fanger opp. Velg hendelseskategoriene eller individuelle revisjonsaksjonsgrupper du ønsker å fange. Velg bare hendelsene organisasjonen krever for å optimalisere lagring og relevans.

   

5. Valgfritt kan du skrive inn et predikatuttrykk for å filtrere hendelser, for eksempel å utelate aktivitet fra en kjent tjenesteprincipal eller automatiseringsidentitet. Bruk syntaksen beskrevet i predikatuttrykkssyntaks.

   

   Viktig!

   Predikatfiltrering gjelder kun for hendelser som allerede er valgt under Hendelser for å registrere dem. For eksempel, for å filtrere SELECT setninger, må du også aktivere Batch Was Completed.

6. Angi en ønsket loggoppbevaringsperiode i År, Måneder og Dager.

   

7. Velg Lagre for å bruke innstillingene.

Lageret ditt registrerer nå de valgte revisjonshendelsene og lagrer loggene sikkert i OneLake.

1. Last ned og installer Visual Studio Code.

2. Installer REST Client-utvidelsen fra Visual Studio Marketplace.

3. Få bærertokenet ved å følge disse trinnene. Du kan finne din Power BI bearer-token i nettleserens utviklerverktøy eller via PowerShell.

   For å bruke Edge-utviklerverktøyene for å finne ditt Power BI bærertoken:

   1. Åpne Microsoft Fabric-arbeidsområdet ditt i en nettleser (Microsoft Edge).
   2. Trykk F12 for å åpne Utviklerverktøy.
   3. Velg Konsoll-fanen. Hvis det er nødvendig, velger du Utvid hurtigvisning for å vise konsollledeteksten>.
   4. Skriv inn kommandoen powerBIAccessToken , og trykk ENTER. Høyreklikk på den store unike strengen som returneres i konsollen, og velg Kopier strenginnhold.
   5. Lim det inn i stedet <bearer token> for i følgende skript.

   For å bruke PowerShell for å finne din Power BI bærertoken:

   1. Installer modulen MicrosoftPowerBIMgmt fra Microsoft Power BI Cmdlets for Windows PowerShell og PowerShell Core.

      Install-Module -Name MicrosoftPowerBIMgmt
      

   2. Bruk Connect-PowerBIServiceAccount for å koble til Power BI PowerShell, og hent bærertokenet.

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

4. Etter at du har fått Power BI-bærertokenet, send en PATCH forespørsel ved å bruke REST Client-utvidelsen. I VS Code, opprett en ny tekstfil med endelsen..http

5. Kopier og lim inn følgende forespørsel:

   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"
   }
   

   • Erstatt <workspaceId> og <warehouseId> med tilsvarende stoffarbeidsområde og lager-ID-er. Hvis du vil finne disse verdiene, kan du gå til lageret i Fabric-portalen.
     • <workspaceID>: Finn GUID-en for arbeidsområdet i nettadressen etter inndelingen /groups/ , eller ved å kjøre SELECT @@SERVERNAME i et eksisterende lager. Eksempel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Ikke ta med tegnene / .
     • <warehouseID>: Finn lager-GUID-en i nettadressen etter inndelingen /warehouses/ , eller ved å kjøre SELECT @@SERVERNAME i et eksisterende lager. Eksempel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Ikke ta med tegnene / .
   • Erstatt <BEARER_TOKEN> med ihendehaverbrikken din.
     • Sett state til Enabled for å slå på revisjon (bruk Disabled for å slå det av).
     • Sett parameteren retentionDays til 0 for ubegrenset beholdning. Dette er standardinnstillingen.

   Viktig!

   I eksempelkoden for utvidelsen må du inkludere en tom linje umiddelbart etter at du har angitt bærertokenet. Denne tomme linjen signaliserer utvidelsen der HTTP-headerne slutter og API-kommandoen starter, slik at API-et kan skille mellom de to korrekt.

6. Velg Send forespørsel.

Kontroller statusen for overvåkingsloggen med REST-API-en

For å verifisere om SQL-revisjonslogger er aktivert, send en GET-forespørsel ved å bruke samme REST Client-utvidelse.

1. I VS Code, opprett en ny tekstfil med endelsen..http
2. Kopier og lim inn følgende forespørsel, og oppgi din egen workspaceId, <warehouseId>og <BEARER_TOKEN>.

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

Responsen returnerer ENABLED eller DISABLED og den nåværende konfigurasjonen av auditActionsAndGroups og predicateExpression.

Konfigurer overvåkingshandlingsgrupper med REST-API-en

SQL-overvåkingslogger er avhengige av forhåndsdefinerte handlingsgrupper som registrerer bestemte hendelser i databasen. For detaljer om revisjonsaksjonsgrupper, se SQL-revisjonslogger i Fabric datalager.

1. I VS Code, opprett en ny tekstfil med endelsen..http

2. Kopier og lim inn følgende forespørsel, og oppgi din egen workspaceId, <warehouseId>og <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. Velg Send forespørsel.

Konfigurer et predikatuttrykk

Bruk samme PATCH API-forespørsel for å konfigurere et predikatuttrykk som utelukker spesifikke hendelser fra å bli generert, som aktivitet fra en kjent tjenesteprincipal eller automatiseringsidentitet. For full predikatsyntaks, se predikatuttrykkssyntaks.

1. I VS Code, opprett en ny tekstfil med endelsen..http

2. Kopier og lim inn følgende forespørsel, og oppgi din egen workspaceId, <warehouseId>og <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 %'"
   }
   

   • Dette eksempelet utelukker SELECT kontoutskrifter fra å bli revidert ved å filtrere på statement feltet.
   • Når du aktiverer SQL-revisjon for første gang, gjelder det ingen predikat å predicateExpression utelate. Ved senere oppdateringer forblir det eksisterende predikatet uendret ved å utelate det. Spesifiser en tom streng ("") for å fjerne et eksisterende predikat.

   Viktig!

   Predikatfiltrering evaluerer kun hendelser som allerede er konfigurert til å fanges opp. For å filtrere SELECT setninger som vist i dette eksempelet, må du også aktivere handlingsgruppen Batch Was Completed.BATCH_COMPLETED_GROUP For mer informasjon, se Database-level audit action groups and actions.

3. Velg Send forespørsel.