Sådan konfigurerer man SQL-revisionslogs

1. I arbejdsområdet Fabric skal du vælge Indstillinger for lagervaren.

2. Vælg siden SQL-overvågningslogge .

3. Aktivér indstillingen Gem hændelser i SQL-overvågningslogge.

   

   Som standard aktiveres og bevares alle handlinger i ni år.

4. Under Events to record, vælg hvilke begivenheder SQL-revisionslogene fanger. Vælg de hændelseskategorier eller individuelle audit-handlingsgrupper, du vil fange. Vælg kun de hændelser, din organisation kræver for at optimere lager og relevans.

   

5. Valgfrit kan man indtaste et prædikatudtryk for at filtrere hændelser, såsom at udelukke aktivitet fra en kendt serviceprincipal eller automatiseringsidentitet. Brug syntaksen beskrevet i prædikatudtrykssyntaksen.

   

   Vigtig

   Predikatfiltrering gælder kun for begivenheder, der allerede er valgt under Begivenheder til registrering. For eksempel skal du også aktivere Batch Was Completed, for at filtrere SELECT sætninger.

6. Angiv en ønsket opbevaringsperiode for logfiler i År, Måneder og Dage.

   

7. Vælg Gem for at anvende dine indstillinger.

Dit lager registrerer nu de valgte revisionsbegivenheder og gemmer logs sikkert i OneLake.

1. Download og installer Visual Studio Code.

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

3. Få ihavertokenet ved at følge disse trin. Du kan finde din Power BI bærertoken i din browsers udviklerværktøjer eller via PowerShell.

   For at bruge Edge-udviklerværktøjerne til at finde dit Power BI bærertoken:

   1. Åbn dit Microsoft Fabric-arbejdsområde i en browser (Microsoft Edge).
   2. Tryk på F12 for at åbne Udviklerværktøjer.
   3. Vælg fanen Konsol . Hvis det er nødvendigt, skal du vælge Udvid Hurtig visning for at få vist konsolprompten >.
   4. Skriv kommandoen powerBIAccessToken , og tryk på Enter. Højreklik på den store entydige streng, der returneres i konsollen, og vælg Kopiér strengindhold.
   5. Indsæt den i stedet for <bearer token> i følgende scripts.

   Til at bruge PowerShell til at finde dit Power BI bærertoken:

   1. Installer MicrosoftPowerBIMgmt-modulet fra Microsoft Power BI Cmdlets til Windows PowerShell og PowerShell Core.

      Install-Module -Name MicrosoftPowerBIMgmt
      

   2. Brug Connect-PowerBIServiceAccount til at forbinde til Power BI PowerShell og hente bærertokenet.

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

4. Når du har fået Power BI bærertokenet, skal du sende en PATCH anmodning ved at bruge REST Client-udvidelsen. I VS Code skal du oprette en ny tekstfil med endelsen .http .

5. Kopiér og indsæt følgende anmodning:

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

   • Erstat <workspaceId> og <warehouseId> med de tilsvarende Fabric-arbejdsområde- og lager-id'er. Hvis du vil finde disse værdier, skal du besøge dit lager på Fabric-portalen.
     • <workspaceID>: Find arbejdsområdets GUID i URL-adressen efter /groups/ sektionen eller ved at køre SELECT @@SERVERNAME på et eksisterende lager. Eksempel 11aaa111-a11a-1111-1aaa-aa111111aaa. Medtag ikke de / tegn.
     • <warehouseID>: Find lager-GUID'et i URL-adressen efter afsnittet /warehouses/ eller ved at køre SELECT @@SERVERNAME på et eksisterende lager. Eksempel 11aaa111-a11a-1111-1aaa-aa111111aaa. Medtag ikke de / tegn.
   • Erstat <BEARER_TOKEN> med din ihændehavertoken.
     • Sæt state til Enabled for at slå auditing til (brug Disabled til at slå det fra).
     • Sæt parameteren retentionDays til 0 ubegrænset fastholdelse. Denne indstilling er standardindstillingen.

   Vigtig

   I udvidelseseksempelkoden skal du medtage en tom linje umiddelbart efter, at du har angivet ihændehavertokenet. Denne tomme linje signalerer udvidelsen, hvor HTTP-headerne slutter, og API-kommandoen begynder, så API'et korrekt kan skelne mellem de to.

6. Vælg Send anmodning.

Kontrollér status for overvågningsloggen med REST-API'en

For at verificere om SQL-revisionslogs er aktiveret, send en GET-anmodning ved at bruge den samme REST Client-udvidelse.

1. I VS Code skal du oprette en ny tekstfil med endelsen .http .
2. Kopiér og indsæt følgende anmodning med dine egne 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 aktuelle konfiguration af auditActionsAndGroups og predicateExpression.

Konfigurer overvågningshandlingsgrupper med REST-API'en

SQL-overvågningslogge er afhængige af foruddefinerede handlingsgrupper, der registrerer bestemte hændelser i databasen. For detaljer om revisionsaktionsgrupper, se SQL revisionslogs i Fabric data warehouse.

1. I VS Code skal du oprette en ny tekstfil med endelsen .http .

2. Kopiér og indsæt følgende anmodning med dine egne 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. Vælg Send anmodning.

Konfigurér et prædikatudtryk

Brug den samme PATCH API-anmodning til at konfigurere et prædikatudtryk, der udelukker specifikke hændelser fra at blive genereret, såsom aktivitet fra en kendt serviceprincipal eller automatiseringsidentitet. For den fulde prædikatsyntaks, se Prædikatudtrykssyntaks.

1. I VS Code skal du oprette en ny tekstfil med endelsen .http .

2. Kopiér og indsæt følgende anmodning med dine egne 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 eksempel udelukker SELECT udsagn fra at blive revideret ved at filtrere på statement feltet.
   • Når du aktiverer SQL-revision for første gang, gælder udeladelse predicateExpression ikke noget prædikat. Ved senere opdateringer forbliver det eksisterende prædikat uændret ved udeladelse. Angiv en tom streng ("") for at fjerne et eksisterende prædikat.

   Vigtig

   Prædikatfiltrering evaluerer kun begivenheder, der allerede er konfigureret til at blive fanget. For at filtrere SELECT sætninger som vist i dette eksempel, skal du også aktivere handlingsgruppen Batch Was Completed.BATCH_COMPLETED_GROUP For mere information, se Database-niveau audit action groups and actions.

3. Vælg Send anmodning.