Konfigurieren von SQL-Überwachungsprotokollen in Fabric Data Warehouse (Vorschau)

1. Wählen Sie im Fabric-Arbeitsbereich die Einstellungen Ihres Lagerelements aus.

2. Wählen Sie die Seite "SQL-Überwachungsprotokolle" aus .

3. Aktivieren Sie die Einstellung "Ereignisse speichern" in SQL-Überwachungsprotokollen.

   

   Standardmäßig werden alle Aktionen für neun Jahre aktiviert und aufbewahrt.

4. Sie können konfigurieren, welche Ereignisse von SQL-Überwachungsprotokollen unter "Ereignisse" erfasst werden sollen. Wählen Sie aus, welche Ereigniskategorien oder einzelne Überwachungsaktionsgruppen Sie erfassen möchten. Wählen Sie nur die Ereignisse aus, die Ihre Organisation benötigt, um Speicher und Relevanz zu optimieren.

   

5. Geben Sie einen gewünschten Aufbewahrungszeitraum für Protokolle in Jahren, Monaten und Tagen an.

   

6. Wählen Sie "Speichern " aus, um Ihre Einstellungen anzuwenden.

Ihr Lager zeichnet nun die ausgewählten Überwachungsereignisse auf und speichert die Protokolle sicher in OneLake.

1. Laden Sie Visual Studio Code herunter, und installieren Sie sie.

2. Installieren Sie die REST-Clienterweiterung aus dem Visual Studio Marketplace.

3. Rufen Sie das Bearertoken mithilfe der folgenden Schritte ab. Sie finden Ihr Power BI Bearertoken in your-Browser-Entwicklertools oder über PowerShell.

   Um die Edge-Entwicklertools zu verwenden, um Ihr Power BI-Bearer-Token zu finden:

   1. Öffnen Sie Ihren Microsoft Fabric Arbeitsbereich in einem Browser (Microsoft Edge).
   2. Drücken Sie F12, um die Entwicklungstools zu öffnen.
   3. Klicken Sie auf die Registerkarte Konsole. Wählen Sie bei Bedarf Schnellansicht erweitern aus, um die Konsoleneingabeaufforderung > anzuzeigen.
   4. Geben Sie den Befehl powerBIAccessToken ein, und drücken Sie die EINGABETASTE. Klicken Sie mit der rechten Maustaste auf die große eindeutige Zeichenfolge, die in der Konsole zurückgegeben wird, und wählen Sie "Zeichenfolgeninhalt kopieren" aus.
   5. Fügen Sie ihn anstelle der <bearer token> in die folgenden Skripts ein.

   Verwenden Sie PowerShell, um Ihr Power BI-Trägertoken zu finden:

   1. Installieren Sie das modul MicrosoftPowerBIMgmt aus Microsoft Power BI Cmdlets für Windows PowerShell und PowerShell Core.

      Install-Module -Name MicrosoftPowerBIMgmt
      

   2. Verwenden Sie Connect-PowerBIServiceAccount, um eine Verbindung mit Power BI PowerShell herzustellen und das Bearertoken abzurufen.

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

4. Nachdem Sie das Power BI Bearertoken abgerufen haben, können Sie eine PATCH-Anforderung mithilfe der REST-Clienterweiterung senden. Erstellen Sie in VS Code eine neue Textdatei mit der Erweiterung .http.

5. Kopieren Sie die folgende Abfrage und fügen sie ein:

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

   • Ersetzen <workspaceId> und <warehouseId> durch die entsprechenden Fabric-Arbeitsbereichs- und Warehouse-IDs. Um diese Werte zu finden, besuchen Sie Ihr Warehouse im Fabric-Portal.
     • <workspaceID>: Suchen Sie die Arbeitsbereich-GUID in der URL nach dem Abschnitt /groups/ oder führen Sie dazu SELECT @@SERVERNAME in einem vorhandenen Warehouse aus. Beispiel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Schließen Sie die / Zeichen nicht ein.
     • <warehouseID>: Suchen Sie die Warehouse-GUID in der URL nach dem Abschnitt /warehouses/ oder führen Sie dazu SELECT @@SERVERNAME in einem vorhandenen Warehouse aus. Beispiel: 11aaa111-a11a-1111-1aaa-aa111111aaa. Schließen Sie die / Zeichen nicht ein.
   • Ersetzen Sie <BEARER_TOKEN> durch das Bearer-Token.
   • Wenn Sie die Einstellung state auf „Aktiviert“ festlegen, wird die Überwachung aktiviert (verwenden Sie „Deaktiviert“, um sie zu deaktivieren).
   • Der retentionDays-Parameter ist standardmäßig auf 0 für eine unbegrenzte Aufbewahrung festgelegt.

   Von Bedeutung

   Im Erweiterungsbeispielcode müssen Sie unmittelbar nach dem Bereitstellen des Bearertokens eine leere Zeile einfügen. Diese leere Zeile signalisiert den Übergang, bei dem die HTTP-Header enden und der API-Befehlsrumpf beginnt, sodass korrekt zwischen den beiden unterschieden werden kann.

6. Wählen Sie Anforderung senden aus.

Überprüfen des Überwachungsprotokollstatus mit der REST-API

Um zu überprüfen, ob die SQL-Überwachungsprotokolle aktiviert sind, senden Sie eine GET-Anforderung mit derselben REST-Clienterweiterung.

1. Erstellen Sie in VS Code eine neue Textdatei mit der Erweiterung .http.
2. Kopieren Sie die folgende Anforderung, fügen Sie sie ein, und stellen Sie Ihre eigene workspaceId, <warehouseId> und <BEARER_TOKEN> bereit.

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

Die Antwort gibt ENABLED oder DISABLED und die aktuelle Konfiguration von auditActionsAndGroups zurück.

Konfigurieren von Überwachungsaktionsgruppen mit der REST-API

SQL-Überwachungsprotokolle basieren auf vordefinierten Aktionsgruppen, die bestimmte Ereignisse innerhalb der Datenbank erfassen. Ausführliche Informationen zu Überwachungsaktionsgruppen finden Sie unter SQL-Überwachungsprotokolle in Fabric Data Warehouse.

1. Erstellen Sie in VS Code eine neue Textdatei mit der Erweiterung .http.

2. Kopieren Sie die folgende Anforderung, fügen Sie sie ein, und stellen Sie Ihre eigene workspaceId, <warehouseId> und <BEARER_TOKEN> bereit.

   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. Wählen Sie Anforderung senden aus.