Configuration d’erreur pour le traitement du cube, de la partition et de la dimension
S’applique à :
SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium
Les propriétés de configuration d'erreur sur les objets cube, partition ou de dimension déterminent le mode de réponse du serveur lorsqu'une erreur d'intégrité des données se produit pendant le traitement. Les clés dupliquées, manquantes et les valeurs NULL dans une colonne clé déclenchent généralement ces erreurs, et comme l'enregistrement à l'origine de l'erreur n'est pas ajouté à la base de données, vous pouvez définir des propriétés qui déterminent ce qui se produit après. Par défaut, le traitement s'arrête. Cependant, lorsque vous développez le cube, vous pouvez souhaiter que le traitement continue lorsque des erreurs se produisent afin de tester le comportement du cube avec des données importées, même si elles sont incomplètes.
Cette rubrique contient les sections suivantes :
Dupliquer des clés résultant de relations incohérentes (KeyDuplicate)
Modifier la limite d’erreurs ou l’action de limite d’erreurs
Ordre d’exécution
Le serveur exécute toujours les règles NullProcessing avant les règles ErrorConfiguration pour chaque enregistrement. Il est important de comprendre cela, car les propriétés de traitement Null qui convertissent les valeurs Null en zéros peuvent introduire des erreurs de clé dupliquée lorsque plusieurs enregistrements d'erreur contiennent un zéro dans une colonne clé.
Comportements par défaut
Par défaut, le traitement s'arrête à la première erreur impliquant une colonne clé. Ce comportement est contrôlé par un nombre maximal d'erreurs qui spécifie zéro comme nombre d'erreurs autorisées et la directive Arrêter le traitement qui indique au serveur d'arrêter le traitement lorsque le nombre d'erreurs est atteint.
Les enregistrements qui déclenchent une erreur, en raison de valeurs NULL, manquantes ou dupliquées, sont convertis en membre inconnu ou ignorés. SQL Server Analysis Services n’importe pas les données qui enfreignent les contraintes d’intégrité des données.
La conversion en membre inconnu se produit par défaut, en raison du paramètre ConvertToUnknown de KeyErrorAction. Les enregistrements alloués à un membre inconnu sont mis en quarantaine dans la base de données en tant que preuve d'un problème que vous pouvez examiner une fois le traitement terminé.
Les membres inconnus sont exclus des charges de travail de requêtes, mais ils sont visibles dans certaines applications clientes si UnknownMember a la valeur Visible.
Pour effectuer le suivi du nombre de valeurs NULL converties en membre inconnu, modifiez la propriété NullKeyConvertedToUnknown de façon à consigner ces erreurs dans le journal ou dans la fenêtre de traitement.
La suppression se produit quand vous affectez manuellement la valeur DiscardRecord à la propriété KeyErrorAction.
Les propriétés de configuration d'erreur permettent de déterminer le mode de réponse du serveur lorsqu'une erreur se produit. Les options sont l'arrêt immédiat du traitement, la poursuite du traitement mais l'arrêt de la journalisation ou la poursuite du traitement et de la journalisation des erreurs. Les valeurs par défaut varient en fonction de la gravité de l'erreur.
Le nombre d'erreurs assure le suivi du nombre d'erreurs qui se produisent. Lorsque vous définissez une limite supérieure, la réponse du serveur change lorsque cette limite est atteinte. Par défaut, le serveur arrête le traitement une fois la limite atteinte. Le nombre maximal par défaut est 0, ce qui entraîne l'arrêt du traitement lors de la première erreur.
Les erreurs ayant un impact élevé, notamment une clé manquante ou une valeur NULL dans un champ clé, doivent être traitées rapidement. Par défaut, ces erreurs adhèrent aux comportements de serveur ReportAndContinue , où le serveur intercepte l’erreur, l’ajoute au nombre d’erreurs, puis continue le traitement (sauf si le nombre maximal d’erreurs est zéro, et le traitement s’arrête immédiatement).
D’autres erreurs sont générées, mais pas comptabilisées ou consignées par défaut (paramètre IgnoreError ), car l’erreur ne pose pas nécessairement de problème d’intégrité des données.
Le nombre d'erreurs est attribué par les paramètres de traitement des valeurs NULL. Pour les attributs de dimension, les options de traitement des valeurs NULL déterminent le mode de réponse du serveur lorsqu'aucune valeur NULL n'est rencontrée. Par défaut, les valeurs NULL dans une colonne numérique sont converties en zéros, tandis que les valeurs NULL dans une colonne de chaîne sont traitées en tant que chaînes vides. Vous pouvez remplacer les propriétés NullProcessing pour intercepter les valeurs null avant qu’elles ne provoquent des erreurs KeyNotFound ou KeyDuplicate . Pour plus d’informations, consultez Clés NULL dans une dimension .
Les erreurs sont consignées dans la boîte de dialogue Traiter, mais ne sont pas enregistrées. Vous pouvez spécifier un nom de fichier journal d'erreurs de clé pour collecter les erreurs dans un fichier texte.
Propriétés de configuration d'erreur
Il existe neuf propriétés de configuration d'erreur. Cinq sont utilisées pour déterminer la réponse du serveur lorsqu'une erreur spécifique se produit. Les quatre autres concernent les charges de travail de configuration d'erreur, telles que le nombre d'erreurs à autoriser, l'action à entreprendre lorsque le nombre maximal d'erreurs est atteint et s'il faut collecter les erreurs dans un fichier journal.
Réponse du serveur à des erreurs spécifiques
| Propriété | Default | Autres valeurs |
|---|---|---|
| CalculationError Se produit lors de l'initialisation de la configuration d'erreur. |
IgnoreError ne consigne pas ou ne comptabilise pas l’erreur. Le traitement continue tant que le nombre d’erreurs est inférieur au nombre maximal. | ReportAndContinue consigne et comptabilise l’erreur. ReportAndStop signale l’erreur et arrête le traitement immédiatement, indépendamment du nombre maximal d’erreurs. |
| KeyNotFound Se produit lorsqu'une clé étrangère dans une table de faits n'a pas de clé primaire correspondante dans une table de dimension associée (par exemple, une table de faits Sales contient in enregistrement avec un ID de produit qui n'existe pas dans la table de dimension Product). Cette erreur se produit lors du traitement des partitions, ou du traitement des dimensions en flocons. |
ReportAndContinue consigne et comptabilise l’erreur. | ReportAndStop signale l’erreur et arrête le traitement immédiatement, indépendamment du nombre maximal d’erreurs. IgnoreError ne consigne pas ou ne comptabilise pas l’erreur. Le traitement continue tant que le nombre d’erreurs est inférieur au nombre maximal. Les enregistrements qui déclenchent cette erreur sont convertis en membre inconnu par défaut, mais vous pouvez modifier la propriété KeyErrorAction de façon à les ignorer. |
| KeyDuplicate Se produit lorsque des clés d'attribut en double sont détectées dans une dimension. Dans la plupart des cas, il est possible de disposer de clés d'attribut dupliquées, mais cette erreur vous informe des doublons afin que vous puissiez rechercher dans la dimension les erreurs de conception qui peuvent entraîner des relations incohérentes entre les attributs. |
IgnoreError ne consigne pas ou ne comptabilise pas l’erreur. Le traitement continue tant que le nombre d’erreurs est inférieur au nombre maximal. | ReportAndContinue consigne et comptabilise l’erreur. ReportAndStop signale l’erreur et arrête le traitement immédiatement, indépendamment du nombre maximal d’erreurs. |
| NullKeyNotAllowed Se produit lorsque NullProcessing = Error est défini sur un attribut de dimension ou lorsque des valeurs null existent dans une colonne de clé d’attribut utilisée pour identifier un membre de manière unique. |
ReportAndContinue consigne et comptabilise l’erreur. | ReportAndStop signale l’erreur et arrête le traitement immédiatement, indépendamment du nombre maximal d’erreurs. IgnoreError ne consigne pas ou ne comptabilise pas l’erreur. Le traitement continue tant que le nombre d’erreurs est inférieur au nombre maximal. Les enregistrements qui déclenchent cette erreur sont convertis en membre inconnu par défaut, mais vous pouvez définir la propriété KeyErrorAction de façon à les ignorer. |
| NullKeyConvertedToUnknown Se produit lorsque des valeurs NULL sont, par la suite, converties en membre inconnu. La définition de NullProcessing = ConvertToUnknown sur un attribut de dimension déclenche cette erreur. |
IgnoreError ne consigne pas ou ne comptabilise pas l’erreur. Le traitement continue tant que le nombre d’erreurs est inférieur au nombre maximal. | Pour afficher cette erreur à titre d'information, conservez la valeur par défaut. Sinon, vous pouvez choisir ReportAndContinue pour signaler l’erreur dans la fenêtre de traitement et la comptabiliser dans le nombre maximal d’erreurs. ReportAndStop signale l’erreur et arrête le traitement immédiatement, indépendamment du nombre maximal d’erreurs. |
Propriétés générales
| Propriété | Valeurs |
|---|---|
| KeyErrorAction | Il s’agit de l’action entreprise par le serveur quand une erreur KeyNotFound se produit. Les réponses valides pour cette erreur sont ConvertToUnknown et DiscardRecord. |
| KeyErrorLogFile | Il s'agit d'un nom de fichier défini par l'utilisateur qui doit avoir une extension de fichier .log, situé dans un dossier sur lequel le compte de services dispose des autorisations d'accès en lecture/écriture. Ce fichier journal contient uniquement les erreurs générées lors du traitement. Utilisez la Boîte noire si vous avez besoin de plus d'informations. |
| KeyErrorLimit | Il s'agit du nombre maximal d'erreurs d'intégrité des données que le serveur autorise avant que le traitement échoue. Une valeur égale à -1 indique un nombre illimité. La valeur par défaut est 0, ce qui signifie que le traitement s'arrête après la première erreur. Vous pouvez également définir un nombre entier. |
| KeyErrorLimitAction | Il s'agit de l'action entreprise par le serveur lorsque le nombre maximal d'erreurs de clé est atteint. Avec Arrêter le traitement, le traitement se termine immédiatement. Avec Arrêter l’enregistrement dans le journal, le traitement continue, mais les erreurs ne sont plus signalées ou comptabilisées. |
Emplacement de définition des propriétés de configuration d'erreur
Utilisez les pages de propriétés dans SQL Server Management Studio après le déploiement de la base de données ou dans le projet de modèle dans SQL Server Data Tools. Les mêmes propriétés sont disponibles dans les deux outils. Vous pouvez également définir les propriétés de configuration d’erreur dans le fichier msmdrsrv.ini pour modifier les valeurs par défaut du serveur pour la configuration d’erreur, et dans les commandes Batch et Process si le traitement s’exécute en tant qu’opération faisant l’objet d’un script.
Vous pouvez définir la configuration d'erreur sur n'importe quel objet pouvant être traité en tant qu'opération autonome.
SQL Server Management Studio
Dans l’Explorateur d’objets, cliquez sur Propriétés , puis sur l’un de ces objets : dimension, cube ou partition.
Dans Propriétés, cliquez sur Configuration d’erreur.
SQL Server Data Tools
Dans l'Explorateur de solutions, double-cliquez sur une dimension ou sur un cube. ErrorConfiguration s’affiche dans Propriétés dans le volet au-dessous.
Sinon, pour une seule dimension, cliquez avec le bouton droit sur la dimension dans l’Explorateur de solutions, sélectionnez Traiter, puis choisissez Modifier les paramètres dans la boîte de dialogue Traiter la dimension. Les options de configuration d'erreur s'affichent dans l'onglet Erreurs de clé de dimension.
Clés manquantes (KeyNotFound)
Les enregistrements avec une valeur de clé manquante ne sont pas ajoutés à la base de données, même lorsque les erreurs sont ignorées ou le nombre d'erreurs est illimité.
Le serveur génère l’erreur KeyNotFound lors du traitement des partitions, quand un enregistrement de table de faits contient une valeur de clé étrangère, mais la clé étrangère n’a aucun enregistrement correspondant dans une table de dimension associée. Cette erreur se produit également lors du traitement des tables de dimension associées ou en flocons, où un enregistrement dans une dimension spécifie une clé étrangère qui n'existe pas dans la dimension associée.
Quand une erreur KeyNotFound se produit, l’enregistrement incriminé est alloué au membre inconnu. Ce comportement est contrôlé par Action clé, dont la valeur est ConvertToUnknown, pour que vous puissiez afficher les enregistrements alloués qui doivent donner lieu à un examen approfondi.
Clés étrangères NULL dans une table de faits (KeyNotFound)
Par défaut, une valeur NULL dans une colonne clé étrangère d'une table de faits est convertie en zéro. En supposant que zéro n’est pas une valeur de clé étrangère valide, une erreur KeyNotFound est consignée et comptabilisée dans le nombre maximal d’erreurs qui est zéro par défaut.
Pour autoriser la poursuite du traitement, vous pouvez gérer la valeur NULL avant conversion et recherche des erreurs. Pour ce faire, affectez à NullProcessing la valeur Error.
Définir la propriété NullProcessing sur une mesure
Dans SQL Server Data Tools, dans l'Explorateur de solutions, double-cliquez sur un cube pour l'ouvrir dans le Concepteur de cube.
Cliquez avec le bouton droit sur une mesure dans le volet Mesures et choisissez Propriétés.
Dans Propriétés, développez Source pour afficher la propriété NullProcessing . Elle a la valeur Automatic par défaut qui, pour les éléments OLAP, convertit les valeurs NULL en zéros pour les champs contenant des données numériques.
Remplacez la valeur par Error pour exclure tous les enregistrements ayant une valeur NULL, ce qui évite la conversion des valeurs NULL en valeurs numériques (zéros). Cette modification vous permet d’éviter des erreurs de clé dupliquée relatives à plusieurs enregistrements contenant un zéro dans la colonne clé, et également d’éviter les erreurs KeyNotFound quand une clé étrangère de valeur zéro n’a pas de clé primaire équivalente dans une table de dimension associée.
Clés NULL dans une dimension
Pour continuer le traitement quand des valeurs NULL sont détectées dans les clés étrangères d’une dimension en flocons, dans un premier temps gérez les valeurs NULL en définissant NullProcessing sur KeyColumn de l’attribut de dimension. Cela permet d’ignorer ou de convertir l’enregistrement, avant que l’erreur KeyNotFound ne se produise.
Vous avez deux options de gestion des valeurs NULL sur l'attribut de dimension :
Définissez NullProcessing=UnknownMember pour allouer des enregistrements avec des valeurs Null au membre inconnu. Cette opération génère l’erreur NullKeyConvertedToUnknown , qui est ignorée par défaut.
Définissez NullProcessing=Error pour exclure les enregistrements avec des valeurs Null. Cela génère l’erreur NullKeyNotAllowed , qui est consignée et comptabilisée dans le nombre maximal d’erreurs. Vous pouvez affecter à la propriété de configuration d’erreur Clé Null non autorisée la valeur IgnoreError pour permettre au traitement de continuer.
Les valeurs NULL peuvent poser des problèmes pour les champs non-clé. De fait, les requêtes MDX retournent un résultat différent si la valeur NULL est interprétée en tant que zéro ou chaîne vide. Pour cette raison, SQL Server Analysis Services fournit des options de traitement null qui vous permettent de prédéfinir le comportement de conversion souhaité.
Définir la propriété NullProcessing sur un attribut de dimension
Dans SQL Server Data Tools, dans l'Explorateur de solutions, double-cliquez sur une dimension pour l'ouvrir dans le Concepteur de dimension.
Cliquez avec le bouton droit sur un attribut dans le volet Attributs et choisissez Propriétés.
Dans Propriétés, développez KeyColumns pour afficher la propriété NullProcessing . Elle a la valeur Automatic par défaut, qui convertit les valeurs NULL en zéros pour les champs contenant des données numériques. Remplacez la valeur par Error ou UnknownMember.
Cette modification supprime les conditions sous-jacentes qui déclenchent l’erreur KeyNotFound en ignorant ou en convertissant l’enregistrement avant qu’il ne soit vérifié pour déceler les erreurs.
Selon la configuration d'erreur, ces actions entraînent une erreur qui est signalée et comptabilisée. Vous devrez peut-être modifier d’autres propriétés, par exemple affecter à KeyNotFound la valeur ReportAndContinue ou à KeyErrorLimit une valeur différente de zéro, pour permettre au traitement de continuer quand ces erreurs sont signalées et comptabilisées.
Clés dupliquées résultant de relations incohérentes (KeyDuplicate)
Par défaut, la présence d'une valeur de clé dupliquée n'arrête pas le traitement, mais l'erreur est ignorée et l'enregistrement en double est exclu de la base de données.
Pour modifier ce comportement, affectez à KeyDuplicate la valeur ReportAndContinue ou ReportAndStop pour signaler l’erreur. Vous pourrez ensuite examiner l'erreur pour déterminer les failles potentielles dans la conception de la dimension.
Modifier le nombre maximal d'erreurs ou l'action lorsque le nombre maximal d'erreurs est atteint
Vous pouvez augmenter le nombre maximal d'erreurs pour permettre plus d'erreurs lors du traitement. Il n'y a aucune indication pour augmenter le nombre maximal d'erreurs ; la valeur appropriée varie selon votre scénario. Les limites d’erreur sont spécifiées en tant que KeyErrorLimit dans les propriétés ErrorConfiguration dans SQL Server Data Tools, ou en tant que Nombre d’erreurs dans l’onglet Configuration des erreurs pour les propriétés des dimensions, des cubes ou des groupes de mesures dans SQL Server Management Studio.
Une fois le nombre maximal d'erreurs atteint, spécifiez que le traitement s'arrête ou que l'enregistrement dans le journal s'arrête. Par exemple, supposons que vous affectez à l’action la valeur StopLogging avec un nombre maximal d’erreurs de 100. À la 101è erreur, le traitement continue, mais les erreurs ne sont plus consignées ou comptabilisées. Les actions de limite d’erreur sont spécifiées en tant que KeyErrorLimitAction dans les propriétés ErrorConfiguration dans SQL Server Data Tools, ou action Sur l’erreur sous l’onglet Configuration de l’erreur pour les propriétés des dimensions, des cubes ou des groupes de mesures dans SQL Server Management Studio.
Définir le chemin d'accès du journal des erreurs
Vous pouvez spécifier un fichier pour stocker les messages d'erreur associés aux clés qui sont signalés lors du traitement. Par défaut, les erreurs sont visibles pendant le traitement interactif dans la fenêtre Traiter, puis ignorées si vous fermez la fenêtre ou la session. Le journal contient uniquement les informations d'erreur associées aux clés, identiques aux erreurs signalées dans les boîtes de dialogue de traitement.
Les erreurs sont enregistrées dans un fichier texte et il doit avoir une extension de fichier .log. Le fichier est vide sauf si des erreurs se produisent. Par défaut, un fichier est créé dans le dossier DATA. Vous pouvez spécifier un autre dossier tant que le compte de service Analysis Services peut écrire à cet emplacement.
Étape suivante
Décidez si les erreurs arrêtent le traitement ou sont ignorées. N'oubliez pas que seule l'erreur est ignorée. L'enregistrement ayant provoqué l'erreur n'est pas ignoré ; il est annulé ou converti en membre inconnu. Les enregistrements qui ne sont pas conformes aux règles d'intégrité des données ne sont jamais ajoutés à la base de données. Par défaut, le traitement s'arrête lorsqu'la première erreur se produit, mais vous pouvez modifier ce comportement en augmentant le nombre maximal d'erreurs. Dans le développement de cube, il peut être utile d'abaisser les règles de configuration d'erreur, ce qui autorise la poursuite du traitement, de façon à ce qu'il y ait des données à tester.
Décidez s'il faut modifier les comportements de traitement des valeurs NULL par défaut. Par défaut, les valeurs NULL dans une colonne de chaîne sont traitées en tant que valeurs vides, alors que les valeurs NULL dans une colonne numérique sont traitées en tant que zéro.
Voir aussi
Propriétés du journal
Définition du membre inconnu et des propriétés de traitement Null