Überwachungsdaten löschen

Möglicherweise müssen Sie Überwachungsdaten löschen, um der Anfrage eines Kunden, ihren Verlauf zu löschen, nachzukommen oder um Protokollspeicherplatz freizugeben. Datensätze können nicht direkt in der Überwachungstabelle (Überwachung) gelöscht werden. Stattdessen stellt Dataverse die folgenden Meldungen zum Löschen von Überwachungsverlaufsdaten bereit:

Nachricht	Description
`DeleteRecordChangeHistory`	Löscht alle Überwachungsänderungsverlaufsdatensätze für einen bestimmten Datensatz.
`BulkDelete`	Löscht asynchron Datensätze, die durch eine Abfrage identifiziert werden. 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 Überwachungsdatensä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, Ihre Verpflichtungen gemäß der DSGVO zu erfüllen. Allgemeine Informationen zur DSGVO finden Sie im Abschnitt zur DSGVO im Microsoft Trust Center und im Abschnitt zur DSGVO im Service Trust Portal.

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 "Systemadministrator" oder eine Sicherheitsrolle mit den prvDeleteRecordChangeHistory Berechtigungen verfügen.

DeleteRecordChangeHistoryRequest-Nachricht (Nachricht zur Löschung des Änderungshistorieneintrags)

Verwenden Sie den Target Parameter, um den Datensatz anzugeben. Die DeletedEntriesCount Eigenschaft der Antwort teilt Ihnen mit, wie viele Überwachungsdatensätze gelöscht wurden.

Web-API
SDK für .NET

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:

/// <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:

Verwenden von BulkDelete zum Löschen von Überwachungsdaten

Verwenden Sie die BulkDelete Nachricht, um Überwachungsdatensätze zu löschen, die Ihre Organisation nicht mehr aufbewahren muss, um interne und externe Überwachungsanforderungen einzuhalten. Der Massenlöschvorgang wird im Hintergrund ausgeführt und ermöglicht es Ihnen, Serienmuster, Startzeit und andere Parameter zu definieren.

BulkDelete-Nachricht

Im folgenden Beispiel werden Überwachungsdatensätze mit dem Aktionswert 64 (Benutzerzugriff über Web) gelöscht.

Web-API
SDK für .NET

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:

/// <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:

Überwachungsdatensatz-Änderungsverlauf löschen

Wenn Sie vom Kunden verwaltete Verschlüsselungsschlüssel verwenden, können Sie die DeleteAuditData Nachricht verwenden, um Überwachungsdatensätze für einen Datumsbereich zu löschen. Überwachungsdatensätze werden sequenziell von der ältesten zur neuesten 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, in denen das Enddatum vor dem in der EndDate Eigenschaft angegebenen Datum liegt. Alle leeren Partitionen werden ebenfalls gelöscht. Die aktuelle (aktive) Partition und die darin enthaltenen Überwachungsdatensätze können nicht mithilfe dieser Anforderung oder einer anderen Anforderung gelöscht werden.

Dataverse erstellt automatisch Partitionen in jedem Quartal. Sie können dieses Verhalten nicht ändern oder beenden. Sie können die RetrieveAuditPartitionList Nachricht verwenden, um die Liste der Partitionen abzurufen. Wenn das Enddatum einer Partition später als das aktuelle Datum ist, können Sie diese Partition oder überwachungsdatensätze darin nicht löschen.

Siehe auch

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

Feedback

War diese Seite hilfreich?

Last updated on 2025-10-23

Freigeben über

Überwachungsdaten löschen

Den Änderungsverlauf für einen Datensatz löschen

DeleteRecordChangeHistoryRequest-Nachricht (Nachricht zur Löschung des Änderungshistorieneintrags)

Verwenden von BulkDelete zum Löschen von Überwachungsdaten

BulkDelete-Nachricht

Überwachungsdatensatz-Änderungsverlauf löschen

Siehe auch

Feedback

Zusätzliche Ressourcen