Überwachungsdaten löschen

Möglicherweise müssen Sie Überwachungsdaten löschen, um der Anforderung eines Kunden nachzukommen, seinen Verlauf zu löschen oder Protokollkapazität freizugeben. Sie können Datensätze in der Überwachungs- (Audit)-Tabelle nicht direkt löschen. Dataverse bietet stattdessen die folgenden Meldungen zum Löschen von Überwachungsverlaufsdaten:

Nachricht	Beschreibung
DeleteRecordChangeHistory	Löscht alle Überwachungsänderungsverlaufsdatensätze für einen bestimmten Datensatz.
BulkDelete	Löscht asynchron Datensätze, die durch eine Abfrage identifiziert wurden. Verwenden Sie diese Nachricht, um eine große Anzahl von Überwachungsdatensätzen zu löschen, ohne andere Aktivitäten zu blockieren.
DeleteAuditData	Für Kunden, die vom Kunden verwaltete Verschlüsselungsschlüssel verwenden, werden alle Überwachungsdaten-Datensätze bis zu einem bestimmten Enddatum gelöscht.

Hinweis

Dieser Artikel enthält Anweisungen zum Löschen personenbezogener Daten vom Gerät oder Dienst und kann Ihnen dabei helfen, Ihren Verpflichtungen gemäß der DSGVO nachzukommen. Allgemeine Informationen zur DSGVO finden Sie im DSGVO-Abschnitt des Microsoft Trust Centers und im DSGVO-Abschnitt des Service Trust Portals.

Den Änderungsverlauf für einen Datensatz löschen

Verwenden Sie die Meldung DeleteRecordChangeHistoryRequest, um alle Überwachungsänderungsverlaufsdatensätze für einen bestimmten Datensatz zu löschen, und nicht alle Überwachungsdatensätze für einen Datumsbereich.

Um den Überwachungsänderungsverlauf für einen Datensatz zu löschen, stellen Sie sicher, dass Sie über die Sicherheitsrolle des Systemadministrators oder eine Sicherheitsrolle mit dem Recht prvDeleteRecordChangeHistory verfügen.

DeleteRecordChangeHistoryRequest-Nachricht

Verwenden Sie den Target-Parameter, um den Datensatz anzugeben. Die DeletedEntriesCount Eigenschaft der Antwort gibt an, wie viele Audit-Datensätze gelöscht wurden.

Web-API

Im folgenden Beispiel wird die DeleteRecordChangeHistory-Aktion verwendet, um die überwachten Datenänderungen für einen Kontodatensatz zu löschen.

Anforderung:

POST [Organization URI]/api/data/v9.2/DeleteRecordChangeHistory HTTP/1.1
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0
If-None-Match: null

{
 "Target": {
  "@odata.type": "Microsoft.Dynamics.CRM.account",
  "accountid": "611e7713-68d7-4622-b552-85060af450bc"
 }
}

Antwort:

HTTP/1.1 200 OK
OData-Version: 4.0

{
 "@odata.context": "[Organization URI]/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.DeleteRecordChangeHistoryResponse",
 "DeletedEntriesCount": 4
}

Weitere Informationen zu:

• Verwenden von Web-API-Aktionen.
• DeleteRecordChangeHistory-Aktion
• DeleteRecordChangeHistoryResponse ComplexType

SDK für .NET

/// <summary>
/// Deletes record change history for a specific record and shows
/// how many records were deleted.
/// </summary>
/// <param name="svc">The IOrganizationService instance to use.</param>
/// <param name="target">The specified record.</param>
static void ShowDeleteRecordChangeHistory(
IOrganizationService svc, 
EntityReference target) 
{
    var req = new DeleteRecordChangeHistoryRequest { 
        Target = target
    };

    var resp = (DeleteRecordChangeHistoryResponse)
               svc.Execute(req);

    Console.WriteLine($"Audit records deleted:{resp.DeletedEntriesCount}");
}

Weitere Informationen zu:

• DeleteRecordChangeHistoryRequest-Klasse
• DeleteRecordChangeHistoryResponse-Klasse
• IOrganizationService.Execute Method

Verwenden Sie BulkDelete, um Überwachungsdaten zu löschen

Verwenden Sie die BulkDelete-Meldung, um Überwachungsdatensätze zu löschen, die Ihr Unternehmen nicht mehr aufbewahren muss, um interne und externe Überwachungsanforderungen zu erfüllen. Der Massenlöschvorgang wird im Hintergrund ausgeführt und ermöglicht Ihnen die Definition von Wiederholungsmustern, Startzeiten und anderen Parametern.

BulkDelete-Nachricht

Das folgende Beispiel löscht Überwachungsdatensätze mit einem Aktionswert von 64 (Benutzerzugriff über das Web).

Web-API

Anforderung:

POST [Organization URI]/api/data/v9.1/BulkDelete
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0  

{
 "QuerySet": [
  {
   "EntityName": "audit",
   "Criteria": {
    "FilterOperator": "And",
    "Conditions": [
     {
      "AttributeName": "action",
      "Operator": "Equal",
      "Values": [
       {
        "Type": "System.String",
        "Value": "64"
       }
      ]
     }
    ],
    "Filters": []
   }
  }
 ],
 "JobName": "Bulk Delete of audit records with action = 64",
 "SendEmailNotification": false,
 "ToRecipients": [],
 "CCRecipients": [],
 "RecurrencePattern": "",
 "StartDateTime": "2022-02-02T10:00:00.000Z"
}

Antwort:

HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0

{
 "@odata.context": "[Organization URI]/api/data/v9.0/$metadata#Microsoft.Dynamics.CRM.BulkDeleteResponse",
 "JobId": "[Job Id]"
}

Weitere Informationen zu:

• BulkDelete-Aktion
• BulkDeleteResponse ComplexType
• QueryExpression ComplexType

SDK für .NET

/// <summary>
/// Creates a BulkDelete job to delete audit record history for a 
/// specific action and shows the job created.
/// </summary>
/// <param name="svc">IOrganizationService to use</param>
/// <param name="actionValue">The audit action value</param>
static void BulkDeleteAuditHistoryByAction(IOrganizationService svc, int actionValue)
{
    Guid jobId;

    var querySet = new QueryExpression(entityName: "audit");
    querySet.Criteria.AddCondition(
        attributeName: "action",
        conditionOperator: ConditionOperator.Equal,
        values: actionValue);

    var req = new BulkDeleteRequest
    {
        QuerySet = new QueryExpression[] { querySet },
        JobName = $"Bulk Delete of audit records with action = {actionValue}",
        SendEmailNotification = false,
        ToRecipients = new Guid[] { },
        CCRecipients = new Guid[] { },
        RecurrencePattern = string.Empty,
        StartDateTime = DateTime.UtcNow
    };

    try
    {
        var resp = (BulkDeleteResponse)svc.Execute(req);
        jobId = resp.JobId;

        Entity bulkDeleteJob =
            svc.Retrieve(
                entityName: "asyncoperation",
                id: jobId,
                columnSet: new ColumnSet("name", "statecode", "statuscode"));

        Console.WriteLine($"Job Name: {bulkDeleteJob["name"]}");
        Console.WriteLine($"Job Id: {bulkDeleteJob.Id}");
        Console.WriteLine($"State: {bulkDeleteJob.FormattedValues["statecode"]}");
        Console.WriteLine($"Status: {bulkDeleteJob.FormattedValues["statuscode"]}");

    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);
    }
}

Weitere Informationen zu:

• BulkDeleteRequest-Klasse
• BulkDeleteResponse-Klasse
• IOrganizationService.Execute Method
• IOrganizationService.Retrieve Method

Überwachungsdatensatz-Änderungsverlauf löschen

Wenn Sie vom Kunden verwaltete Verschlüsselungsschlüssel verwenden, können Sie die DeleteAuditData-Meldung verwenden, um Überwachungsdatensätze für einen Datumsbereich zu löschen. Überwachungsdaten-Datensätze werden sequentiell absteigend nach Alter gelöscht.

Hinweis

Auch wenn Sie vom Kunden verwaltete Verschlüsselungsschlüssel verwenden, sollten Sie lieber BulkDelete statt der DeleteAuditData-Nachricht verwenden.

Die DeleteAuditData-Nachricht löscht alle Überwachungsdaten in Partitionen, deren Enddatum vor dem Datum liegt, das in der EndDate-Eigenschaft angegeben ist. Alle leeren Partitionen werden ebenfalls gelöscht. Es können weder die aktuelle (aktive) Partition noch die Überwachungsdatensätze darin mit dieser Anforderung oder einer anderen gelöscht werden.

Dataverse erstellt vierteljährlich automatisch Partitionen. Dieses Verhalten kann nicht geändert oder gestoppt werden. Sie können die Liste der Partitionen mithilfe der RetrieveAuditPartitionList-Nachricht abrufen. Wenn das Enddatum einer Partition nach dem aktuellen Datum liegt, können Sie diese Partition oder darin enthaltene Überwachungsdatensätze nicht löschen.

Siehe auch

Überwachungsübersicht
Überwachung konfigurieren
Abrufen des Verlaufs von überwachten Datenänderungen
Administratoranleitung: Datenbankspeicherplatz durch Löschen von Überwachungsprotokollen freigeben

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).