Fehlerkonfiguration für Cube-, Partitions- und Dimensionsverarbeitung
Gilt für:
SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium
Anhand von Fehlerkonfigurationseigenschaften für Cube-, Partitions- oder Dimensionsobjekte wird bestimmt, wie der Server während der Verarbeitung auf Datenintegritätsfehler reagiert. Diese Fehler werden normalerweise durch doppelte Schlüssel, fehlende Schlüssel und NULL-Werte in einer Schlüsselspalte ausgelöst. Dabei wird der Datensatz, der den Fehler verursacht hat, der Datenbank nicht hinzugefügt. Mithilfe von Eigenschaften können Sie die nächsten auszuführenden Schritte festlegen. Standardmäßig wird die Verarbeitung beendet. Manchmal ist es während der Cubeentwicklung jedoch erwünscht, dass die Verarbeitung bei Fehlern fortgesetzt wird, z. B. um das Cubeverhalten mit importierten und sogar unvollständigen Daten zu testen.
Dieses Thema enthält die folgenden Abschnitte:
Ausführungsreihenfolge
Der Server führt für jeden Datensatz immer NullProcessing -Regeln vor ErrorConfiguration -Regeln aus. Dieses Verhalten sollte berücksichtigt werden, da Eigenschaften für das Verarbeiten von NULL-Werten, durch die NULL-Werte in Nullen (0) konvertiert werden, Fehler aufgrund doppelter Schlüssel verursachen können, wenn mindestens zwei Fehlerdatensätze in einer Schlüsselspalte den Wert 0 aufweisen.
Standardverhalten
Standardmäßig wird die Verarbeitung beim ersten Fehler beendet, der eine Schlüsselspalte betrifft. Dieses Verhalten wird durch eine Fehlergrenze gesteuert, für die die Anzahl zulässiger Fehler auf 0 (null) festgelegt ist, sowie durch die Direktive Verarbeitung beenden, die den Server anweist, die Verarbeitung bei Erreichen der Fehlergrenze zu beenden.
Datensätze, die einen Fehler aufgrund von fehlenden, doppelten oder NULL-Werten auslösen, werden entweder in das unbekannte Element konvertiert oder verworfen. SQL Server Analysis Services importiert keine Daten, die gegen Datenintegritätseinschränkungen verstoßen.
Aufgrund der ConvertToUnknown -Einstellung für KeyErrorActionerfolgt standardmäßig eine Konvertierung in das unbekannte Element. Datensätze, die dem unbekannten Element zugeordnet sind und auf ein potenzielles Problem hindeuten, werden in der Datenbank unter Quarantäne gestellt und können nach Abschluss der Verarbeitung untersucht werden.
Unbekannte Elemente werden aus Abfragearbeitsauslastungen ausgeschlossen, sind in einigen Clientanwendungen jedoch sichtbar, wenn UnknownMember auf Visiblefestgelegt ist.
Wenn Sie nachverfolgen möchten, wie viele NULL-Werte in das unbekannte Element konvertiert wurden, können Sie die NullKeyConvertedToUnknown -Eigenschaft so konfigurieren, dass diese Fehler im Protokoll oder im Verarbeitungsfenster gemeldet werden.
Wenn Sie die KeyErrorAction -Eigenschaft manuell auf DiscardRecordfestlegen, wird der Datensatz verworfen.
Mithilfe von Fehlerkonfigurationseigenschaften können Sie bestimmen, wie der Server bei Auftreten eines Fehlers reagiert. Sie können beispielsweise die Verarbeitung sofort beenden, die Verarbeitung fortsetzen und gleichzeitig die Protokollierung beenden oder sowohl die Verarbeitung als auch die Fehlerprotokollierung fortsetzen. Die Standardwerte variieren abhängig vom Schweregrad des Fehlers.
Mit dem Fehlerzähler wird die Anzahl der aufgetretenen Fehler verfolgt. Wenn Sie eine Obergrenze festlegen, ändert sich bei Erreichen des Grenzwerts die Reaktion des Servers. Standardmäßig wird die Verarbeitung vom Server beendet, sobald der Grenzwert erreicht wurde. Der Standardgrenzwert ist 0 und bewirkt, dass die Verarbeitung beim ersten aufgezeichneten Fehler beendet wird.
Schwerwiegende Fehler, wie ein fehlender Schlüssel oder NULL-Wert in einem Schlüsselfeld, sollten umgehend behandelt werden. Bei diesen Fehlern wird standardmäßig das Serververhalten ReportAndContinue angewendet, d.h., der Fehler wird vom Server abgefangen, zur Fehleranzahl hinzuaddiert und die Verarbeitung fortgesetzt (es sei denn, die Fehlergrenze ist 0; dann wird die Verarbeitung sofort beendet).
Andere Fehler werden zwar generiert, aber nicht standardmäßig gezählt oder protokolliert (aufgrund der IgnoreError -Einstellung), da der Fehler nicht unbedingt ein Problem für die Datenintegrität darstellt.
Die Fehleranzahl wird durch Einstellungen für die Verarbeitung von NULL-Werten beeinflusst. Bei Dimensionsattributen bestimmen die Optionen für die Verarbeitung von NULL-Werten, wie der Server reagiert, wenn NULL-Werte gefunden werden. NULL-Werte in einer numerischen Spalte werden standardmäßig in Nullen (0) konvertiert, während NULL-Werte in einer Zeichenfolgenspalte als leere Zeichenfolgen verarbeitet werden. Sie können NullProcessing -Eigenschaften überschreiben, um NULL-Werte abzufangen, bevor sie zu einem KeyNotFound -Fehler oder KeyDuplicate -Fehler werden. Einzelheiten dazu finden Sie unter NULL-Schlüssel in einer Dimension .
Fehler werden im Dialogfeld Verarbeiten protokolliert, aber nicht gespeichert. Sie können eine Protokolldatei für Schlüsselfehler benennen, um Fehler in einer Textdatei zu sammeln.
Fehlerkonfigurationseigenschaften
Es gibt neun Fehlerkonfigurationseigenschaften. Mithilfe von fünf Eigenschaften wird bestimmt, wie der Server auf bestimmte Fehler reagiert. Die übrigen vier Eigenschaften beziehen sich auf Arbeitsauslastungen im Rahmen der Fehlerkonfiguration, also beispielsweise darauf, wie viele Fehler zulässig sind, welche Maßnahmen bei Erreichen des Grenzwerts getroffen werden und ob Fehler in einer Protokolldatei gesammelt werden.
Reaktion des Servers auf bestimmte Fehler
| Eigenschaft | Standard | Andere Werte |
|---|---|---|
| CalculationError Tritt auf, wenn die Fehlerkonfiguration initialisiert wird. |
BeiIgnoreError wird der Fehler weder protokolliert noch gezählt. Die Verarbeitung wird fortgesetzt, solange die Fehleranzahl unter dem Grenzwert liegt. | BeiReportAndContinue wird der Fehler protokolliert und gezählt. BeiReportAndStop wird der Fehler gemeldet, und die Verarbeitung wird unabhängig von der Fehlergrenze umgehend beendet. |
| KeyNotFound Tritt auf, wenn ein Fremdschlüssel in einer Faktentabelle keinen übereinstimmenden Primärschlüssel in einer verknüpften Dimensionstabelle aufweist (beispielsweise, wenn eine Faktentabelle für Umsatzwerte einen Datensatz mit einer Produkt-ID enthält, die in der Produktdimensionstabelle nicht vorhanden ist). Dieser Fehler kann bei der Verarbeitung von Partitionen oder von Schneeflockendimensionen auftreten. |
BeiReportAndContinue wird der Fehler protokolliert und gezählt. | BeiReportAndStop wird der Fehler gemeldet, und die Verarbeitung wird unabhängig von der Fehlergrenze umgehend beendet. BeiIgnoreError wird der Fehler weder protokolliert noch gezählt. Die Verarbeitung wird fortgesetzt, solange die Fehleranzahl unter dem Grenzwert liegt. Datensätze, durch die dieser Fehler ausgelöst wird, werden standardmäßig in das unbekannte Element konvertiert, Sie können die KeyErrorAction -Eigenschaft jedoch auch so ändern, dass die Datensätze stattdessen verworfen werden. |
| KeyDuplicate Tritt auf, wenn in einer Dimension doppelte Attributschlüssel gefunden werden. In den meisten Fällen sind doppelte Attributschlüssel zulässig. Durch diesen Fehler werden Sie jedoch auf die Duplikate hingewiesen, damit Sie den Dimensionsentwurf auf Fehler überprüfen können, die inkonsistente Beziehungen zwischen Attributen verursachen könnten. |
BeiIgnoreError wird der Fehler weder protokolliert noch gezählt. Die Verarbeitung wird fortgesetzt, solange die Fehleranzahl unter dem Grenzwert liegt. | BeiReportAndContinue wird der Fehler protokolliert und gezählt. BeiReportAndStop wird der Fehler gemeldet, und die Verarbeitung wird unabhängig von der Fehlergrenze umgehend beendet. |
| NullKeyNotAllowed Tritt auf, wenn NullProcessing = Error für ein Dimensionssattribut festgelegt wird oder wenn NULL-Werte in einer Attributschlüsselspalte vorhanden sind, die zur eindeutigen Identifizierung eines Elements verwendet wird. |
BeiReportAndContinue wird der Fehler protokolliert und gezählt. | BeiReportAndStop wird der Fehler gemeldet, und die Verarbeitung wird unabhängig von der Fehlergrenze umgehend beendet. BeiIgnoreError wird der Fehler weder protokolliert noch gezählt. Die Verarbeitung wird fortgesetzt, solange die Fehleranzahl unter dem Grenzwert liegt. Datensätze, durch die dieser Fehler ausgelöst wird, werden standardmäßig in das unbekannte Element konvertiert, Sie können die KeyErrorAction -Eigenschaft jedoch auch so festlegen, dass die Datensätze stattdessen verworfen werden. |
| NullKeyConvertedToUnknown Tritt auf, wenn NULL-Werte nachfolgend in das unbekannte Element konvertiert werden. Wenn Sie NullProcessing = ConvertToUnknown für ein Dimensionsattribute festlegen, wird dieser Fehler ausgelöst. |
BeiIgnoreError wird der Fehler weder protokolliert noch gezählt. Die Verarbeitung wird fortgesetzt, solange die Fehleranzahl unter dem Grenzwert liegt. | Wenn dieser Fehler nur zu Informationszwecken gemeldet werden soll, behalten Sie den Standardwert bei. Andernfalls können Sie ReportAndContinue auswählen, damit der Fehler im Verarbeitungsfenster gemeldet und bei der Fehlerzählung berücksichtigt wird. BeiReportAndStop wird der Fehler gemeldet, und die Verarbeitung wird unabhängig von der Fehlergrenze umgehend beendet. |
Allgemeine Eigenschaften
| Eigenschaft | Werte |
|---|---|
| KeyErrorAction | Dies ist die Aktion, die bei Auftreten eines KeyNotFound -Fehlers vom Server ausgeführt wird. Gültige Serverreaktionen auf diesen Fehler sind ConvertToUnknown oder DiscardRecord. |
| KeyErrorLogFile | Dies ist ein benutzerdefinierter Dateiname, der über die Dateierweiterung .log verfügen und in einem Ordner gespeichert sein muss, für den das Dienstkonto Lese-/Schreibberechtigungen besitzt. Die Protokolldatei enthält nur Fehler, die während der Verarbeitung generiert wurden. Verwenden Sie Flight Recorder, wenn Sie ausführlichere Informationen benötigen. |
| KeyErrorLimit | Dies ist die maximale Anzahl von Datenintegritätsfehlern, die der Server toleriert, bevor die Verarbeitung fehlschlägt. Der Wert -1 steht für eine unbegrenzte Anzahl. Der Standardwert ist 0 und bewirkt, dass die Verarbeitung nach Auftreten des ersten Fehlers beendet wird. Sie können ihn auch auf eine ganze Zahl festlegen. |
| KeyErrorLimitAction | Dies ist die Aktion, die vom Server ausgeführt wird, nachdem die Obergrenze von Schlüsselfehlern erreicht wurde. Bei Verarbeitung beendenwird die Verarbeitung sofort beendet. Mit Protokollierung beendenwird der Verarbeitungsvorgang weiter ausgeführt; allerdings werden keine Fehler mehr gemeldet oder gezählt. |
Wo Fehlerkonfigurationseigenschaften festgelegt werden
Verwenden Sie die Eigenschaftenseiten entweder in SQL Server Management Studio nach der Bereitstellung der Datenbank oder im Modellprojekt in SQL Server Data Tools. Beide Tools enthalten dieselben Eigenschaften. Sie können Fehlerkonfigurationseigenschaften auch in der Datei msmdrsrv.ini festlegen, um Serverstandardeinstellungen für die Fehlerkonfiguration zu ändern, sowie im Batch -Befehl und im Process -Befehl, wenn die Verarbeitung skriptbasiert ausgeführt wird.
Sie können die Fehlerkonfiguration für jedes Objekt festlegen, das in einem eigenständigen Vorgang verarbeitet werden kann.
SQL Server Management Studio
Klicken Sie im Objekt-Explorer mit der rechten Maustaste für eines der folgenden Objekte auf Eigenschaften : Dimension, Cube oder Partition.
Klicken Sie in den Eigenschaften auf Fehlerkonfiguration.
SQL Server-Datentools
Doppelklicken Sie im Projektmappen-Explorer auf eine Dimension oder einen Cube. In den Eigenschaften wird im unteren BereichErrorConfiguration angezeigt.
Bei einer einzelnen Dimension können Sie alternativ im Projektmappen-Explorer mit der rechten Maustaste auf die Dimension klicken, Verarbeitenauswählen und anschließend im Dialogfeld „Dimension aufbereiten“ die Option Einstellungen ändern auswählen. Optionen für die Fehlerkonfiguration werden auf der Registerkarte Dimensionsschlüsselfehler angezeigt.
Fehlende Schlüssel (KeyNotFound)
Datensätze mit einem fehlenden Schlüsselwert können der Datenbank auch dann nicht hinzugefügt werden, wenn Fehler ignoriert werden oder eine unbegrenzte Fehleranzahl festgelegt wurde.
Der Server generiert den KeyNotFound -Fehler während der Partitionsverarbeitung, wenn eine Tabelle in einem Faktendatensatz einen Fremdschlüsselwert enthält, der Fremdschlüssel aber keinen entsprechenden Datensatz in einer verknüpften Dimensionstabelle aufweist. Dieser Fehler tritt auch bei der Verarbeitung von verknüpften oder Schneeflocken-Dimensionstabellen auf, wenn von einem Datensatz in einer Dimension ein Fremdschlüssel angegeben wird, der in der verknüpften Dimension nicht vorhanden ist.
Wenn ein KeyNotFound -Fehler auftritt, wird der problematische Datensatz dem unbekannten Element zugeordnet. Dieses Verhalten wird durch die Schlüsselaktion gesteuert, die auf ConvertToUnknownfestgelegt wurde. Das heißt, Sie können die zugeordneten Datensätze anzeigen und näher untersuchen.
NULL-Fremdschlüssel in einer Faktentabelle (KeyNotFound)
Ein NULL-Wert in einer Fremdschlüsselspalte einer Faktentabelle wird standardmäßig in 0 konvertiert. In der Annahme, dass 0 kein gültiger Fremdschlüsselwert ist, wird der KeyNotFound -Fehler protokolliert und auf die Fehlergrenze, die standardmäßig 0 ist, angerechnet.
Damit die Verarbeitung fortgesetzt werden kann, können Sie den NULL-Wert behandeln, bevor er konvertiert und auf Fehler überprüft wird. Legen Sie dazu NullProcessing auf Errorfest.
Festlegen der NullProcessing-Eigenschaft für ein Measure
Doppelklicken Sie im Projektmappen-Explorer von SQL Server Data Tools auf den Cube, um ihn im Cube-Designer zu öffnen.
Klicken Sie im Bereich „Measures“ mit der rechten Maustaste auf ein Measure, und wählen Sie Eigenschaftenaus.
Erweitern Sie in den Eigenschaften Source , um die Eigenschaft NullProcessing anzuzeigen. Die Eigenschaft ist standardmäßig auf Automatic festgelegt. Bei OLAP-Elementen bewirkt diese Einstellung, dass NULL-Werte für Felder mit numerischen Daten in Nullen (0) konvertiert werden.
Ändern Sie den Wert auf Error , um alle Datensätze mit einem NULL-Wert auszuschließen und die Konvertierung von NULL- in numerische Werte (0) zu unterbinden. Durch diese Änderung können Fehler aufgrund doppelter Schlüssel vermieden werden, die auftreten, wenn mehrere Datensätze in der Schlüsselspalte den Wert 0 aufweisen, sowie KeyNotFound -Fehler, die auftreten, wenn ein Fremdschlüssel mit dem Wert 0 (null) in einer verknüpften Dimensionstabelle keinen entsprechenden Primärschlüssel aufweist.
NULL-Schlüssel in einer Dimension
Um die Verarbeitung fortzusetzen, wenn in Fremdschlüsseln in einer Schneeflockendimension NULL-Werte gefunden werden, behandeln Sie zunächst die NULL-Werte, indem Sie für die NullProcessing des Dimensionsattributs KeyColumn festlegen. Dadurch wird der Datensatz verworfen oder konvertiert, bevor der KeyNotFound -Fehler auftreten kann.
NULL-Werte können für das Dimensionsattribut auf zwei Weisen behandelt werden:
Legen Sie NullProcessing=UnknownMember fest, um Dem unbekannten Member Datensätze mit NULL-Werten zuzuweisen. Dadurch wird der NullKeyConvertedToUnknown -Fehler erzeugt, der standardmäßig ignoriert wird.
Legen Sie NullProcessing=Error fest, um Datensätze mit NULL-Werten auszuschließen. Dadurch wird der NullKeyNotAllowed -Fehler erzeugt, der protokolliert und auf den Grenzwert für Schlüsselfehler angerechnet wird. Sie können die Fehlerkonfigurationseigenschaft für NULL-Schlüssel nicht zulässig auf IgnoreError festlegen, damit die Verarbeitung fortgesetzt werden kann.
NULL-Werte können für Nichtschlüsselfelder insofern problematisch sein, als MDX-Abfragen unterschiedliche Werte zurückgeben können. Das ist abhängig davon, ob NULL als 0 oder leerer Wert interpretiert wird. Aus diesem Grund bietet SQL Server Analysis Services NULL-Verarbeitungsoptionen, mit denen Sie das gewünschte Konvertierungsverhalten vordefinieren können.
Festlegen der NullProcessing-Eigenschaft für ein Dimensionsattribut
Doppelklicken Sie im Projektmappen-Explorer von SQL Server Data Tools auf die Dimension, um sie im Dimensions-Designer zu öffnen.
Klicken Sie im Bereich „Attribute“ mit der rechten Maustaste auf ein Attribut, und wählen Sie Eigenschaftenaus.
Erweitern Sie in den Eigenschaften KeyColumns , um die Eigenschaft NullProcessing anzuzeigen. Die Eigenschaft ist standardmäßig auf Automatic festgelegt, wodurch NULL-Werte für Felder mit numerischen Daten in Nullen (0) konvertiert werden. Ändern Sie den Wert entweder in Error oder UnknownMember.
Mit dieser Änderung werden die zugrunde liegenden Bedingungen entfernt, durch die KeyNotFound ausgelöst wird. Dies geschieht, indem der Datensatz entweder verworfen oder konvertiert wird, bevor er auf Fehler überprüft wird.
Abhängig von der Fehlerkonfiguration kann eine dieser Aktionen zu einem Fehler führen, der gemeldet und gezählt wird. Möglicherweise müssen Sie zusätzliche Eigenschaften anpassen. Legen Sie z.B. KeyNotFound auf ReportAndContinue oder KeyErrorLimit auf einen Wert ungleich 0 fest, damit die Verarbeitung fortgesetzt werden kann, wenn diese Fehler gemeldet und gezählt werden.
Doppelte Schlüssel, die zu inkonsistenten Beziehungen führen (KeyDuplicate)
Standardmäßig führt ein doppelter Schlüssel nicht dazu, dass die Verarbeitung beendet wird; allerdings wird der Fehler ignoriert und der doppelte Datensatz aus der Datenbank ausgeschlossen.
Um dieses Verhalten zu ändern, legen Sie KeyDuplicate auf ReportAndContinue oder auf ReportAndStop fest, damit der Fehler gemeldet wird. Anschließend können Sie den Fehler untersuchen, um mögliche Fehler im Dimensionsentwurf zu ermitteln.
Ändern der Fehlergrenze oder der Aktion, die bei Erreichen der Fehlergrenze ausgeführt wird
Sie können die Fehlergrenze heraufsetzen, damit während der Verarbeitung mehr Fehler toleriert werden. Es gibt keine allgemeinen Vorgaben zum Erhöhen der Fehlergrenze, da sich der geeignete Wert nach dem jeweiligen Szenario richtet. Fehlergrenzwerte werden als KeyErrorLimit in den ErrorConfiguration-Eigenschaften in SQL Server Data Tools oder als Anzahl von Fehlern auf der Registerkarte Fehlerkonfiguration für Eigenschaften von Dimensionen, Cubes oder Measuregruppen in SQL Server Management Studio angegeben.
Sie können festlegen, dass die Verarbeitung oder Protokollierung bei Erreichen der Fehlergrenze beendet wird. Gehen wir z. B. davon aus, dass bei einer Fehlergrenze von 100 die Aktion StopLogging ausgeführt wird. Bei Fehler Nummer 101 wird die Verarbeitung fortgesetzt, während Fehler jedoch nicht mehr protokolliert oder gezählt werden. Fehlerlimitaktionen werden als KeyErrorLimitAction in den ErrorConfiguration-Eigenschaften in SQL Server Data Tools oder als Bei-Fehleraktion auf der Registerkarte Fehlerkonfiguration für Eigenschaften von Dimensionen, Cubes oder Measuregruppen in SQL Server Management Studio angegeben.
Festlegen des Fehlerprotokollpfads
Sie können eine Datei angeben, in der schlüsselspezifische Fehlermeldungen gespeichert werden, die während der Verarbeitung gemeldet werden. Fehler werden während der interaktiven Verarbeitung standardmäßig im Verarbeitungsfenster angezeigt und verworfen, wenn Sie das Fenster oder die Sitzung schließen. Das Protokoll enthält nur Fehlerinformationen zu Schlüsseln, die sich direkt auf die Fehler beziehen, die in den Verarbeitungsdialogfeldern angezeigt werden.
Fehler werden in einer Textdatei mit der Dateierweiterung .log protokolliert. Die Datei ist leer, bis Fehler auftreten. Standardmäßig wird eine Datei im Ordner DATA erstellt. Sie können einen anderen Ordner angeben, solange das Analysis Services-Dienstkonto eine Schreibberechtigung für diesen Speicherort besitzt.
Nächster Schritt
Entscheiden Sie, ob Fehler zu einer Beendigung der Verarbeitung führen oder ignoriert werden. Beachten Sie, dass nur der Fehler ignoriert wird. Der Datensatz, der den Fehler verursacht hat, wird nicht ignoriert und entweder verworfen oder in ein unbekanntes Element konvertiert. Datensätze, die gegen die Regeln der Datenintegrität verstoßen, werden der Datenbank niemals hinzugefügt. Die Verarbeitung wird standardmäßig beim ersten Fehler beendet. Sie können diese Einstellung jedoch ändern, indem Sie die Fehlergrenze heraufsetzen. Bei der Cubeentwicklung kann es von Nutzen sein, die Regeln für die Fehlerkonfiguration zu lockern und die Verarbeitung fortzusetzen, um Testdaten zu sammeln.
Entscheiden Sie, ob das Standardverhalten für die Verarbeitung von NULL-Werten geändert werden soll. NULL-Werte in einer Zeichenfolgenspalte werden standardmäßig als leere Werte verarbeitet, während NULL-Werte in einer numerischen Spalte als Nullen (0) verarbeitet werden.
Weitere Informationen
Protokolleigenschaften
Definieren von unbekannten Elementen und Eigenschaften für das Verarbeiten von NULL-Werten
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für