{"meta":{"title":"Testextrakt","intro":"[Plumbing] Erstellt ein Dataset für ein Testverzeichnis.","product":"Sicherheit und Codequalität","breadcrumbs":[{"href":"/de/code-security","title":"Sicherheit und Codequalität"},{"href":"/de/code-security/reference","title":"Reference"},{"href":"/de/code-security/reference/code-scanning","title":"Codeüberprüfung"},{"href":"/de/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/de/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"CodeQL CLI-Leitfaden"},{"href":"/de/code-security/reference/code-scanning/codeql/codeql-cli-manual/test-extract","title":"Testextrakt"}],"documentType":"article"},"body":"# Testextrakt\n\n\\[Plumbing] Erstellt ein Dataset für ein Testverzeichnis.\n\n> \\[!NOTE]\n> In diesem Inhalt wird die neueste Version von CodeQL CLI beschrieben. Weitere Informationen zu diesem Thema findest du unter <https://github.com/github/codeql-cli-binaries/releases>.\n>\n> Um Details zu den Optionen anzuzeigen, die für diesen Befehl in früheren Releases verfügbar sind, führe den Befehl mit der Option <span style=\"white-space: nowrap;\">`--help`</span> im Terminal aus.\n\n## Zusammenfassung\n\n```shell copy\ncodeql test extract [--print-database] [--source-root=<dir>] <options>... -- <testDirectory>\n```\n\n## Description\n\n```\n          \\[Plumbing] Erstelle ein Dataset für ein Testverzeichnis.\n```\n\nErstellt eine Datenbank für ein angegebenes Testverzeichnis, ohne die Testabfragen tatsächlich auszuführen. Gibt den Pfad zum unformatierten QL-Dataset aus, für das Testabfragen ausgeführt werden sollen.\n\n## Options\n\n### Primäre Optionen\n\n#### `<testDirectory>`\n\n```\n          \\[Erforderlich] Der Pfad zum Testverzeichnis.\n```\n\n#### `--database=<dir>`\n\nÜberschreibt den Speicherort der Datenbank, die erstellt wird. Standardmäßig handelt es sich um ein Unterverzeichnis, dessen Name vom Namen des Testverzeichnisses selbst abgeleitet wird, an den „.testproj“ angefügt wird.\n\n#### `-D, --print-database`\n\nGibt den Pfad zur Datenbank, die erstellt wird, anstelle des darin enthaltenen Datasets aus.\n\n#### `-s, --source-root=<dir>`\n\n```\n          \\[Erweitert] Das Stammverzeichnis für den Quellcode, wenn es sich vom Testverzeichnis unterscheidet.\n```\n\n#### `--search-path=<dir>[:<dir>...]`\n\nEine Liste der Verzeichnisse, in denen Extraktorpakete gefunden werden können. Bei den Verzeichnissen handelt es sich entweder um die Extraktorpakete selbst oder um Verzeichnisse, die Extraktoren als unmittelbare Unterverzeichnisse enthalten.\n\nEnthält der Pfad mehrere Verzeichnisstrukturen, bestimmt ihre Reihenfolge den Vorrang zwischen ihnen: Wenn die Zielsprache in mehr als einer der Verzeichnisstrukturen vorkommt, gilt die zuerst angegebene.\n\nDie Extraktoren, die mit der CodeQL-Toolkette selbst gebündelt sind, werden immer gefunden. Wenn du jedoch separat verteilte Extraktoren verwenden musst, musst du diese Option angeben (oder, noch besser, `--search-path` in einer Konfigurationsdatei pro Benutzer\\*in einrichten).\n\n(Hinweis: Unter Windows wird `;` als Pfadtrennzeichen verwendet.)\n\n#### `--cleanup`\n\nEntfernt die Testdatenbank, anstatt sie zu erstellen.\n\n#### `--[no-]show-extractor-output`\n\n```\n          \\[Erweitert] Zeigt die Ausgabe von Extraktionsskripten an, die Testdatenbanken erstellen. Dies kann beim Entwickeln oder Bearbeiten von Testfällen hilfreich sein.\n```\n\nBeachte jedoch, dass dies bei der Verwendung mit mehreren Threads zu doppelten oder fehlerhaften Ausgaben führen kann!\n\n#### `--[no-]check-undefined-labels`\n\n```\n          \\[Erweitert] Fehler für undefinierte Bezeichnungen liefern.\n```\n\n#### `--[no-]check-unused-labels`\n\n```\n          \\[Erweitert] Fehler für nicht verwendete Kennzeichnungen liefern.\n```\n\n#### `--[no-]check-repeated-labels`\n\n```\n          \\[Erweitert] Fehler für wiederholte Kennzeichnungen liefern.\n```\n\n#### `--[no-]check-redefined-labels`\n\n```\n          \\[Erweitert] Fehler für neu definierte Kennzeichnungen liefern.\n```\n\n#### `--[no-]check-use-before-definition`\n\n```\n          \\[Erweitert] Reporting von Fehlern für Kennzeichnungen, die verwendet werden, bevor sie definiert sind.\n```\n\n#### `--[no-]fail-on-trap-errors`\n\n```\n          \\[Erweitert] Beende das Programm mit einem Wert ungleich Null, wenn beim Trap-Import ein Fehler auftritt.\n```\n\n#### `--[no-]include-location-in-star`\n\n```\n          \\[Erweitert] Entitäten-IDs konstruieren, die den Ort in der TRAP-Datei kodieren, aus der sie stammen. Kann für das Debuggen von TRAP-Generatoren nützlich sein, nimmt aber viel Platz im Dataset ein.\n```\n\n#### `--[no-]linkage-aware-import`\n\n```\n          \\[Erweitert] Steuert, ob [codeql dataset import](/code-security/reference/code-scanning/codeql/codeql-cli-manual/dataset-import) linkage-aware _(Standard)_ ist oder nicht. Bei Projekten, bei denen dieser Teil der Datenbankerstellung zu viel Arbeitsspeicher verbraucht, kann die Deaktivierung dieser Option den Fortschritt auf Kosten der Vollständigkeit der Datenbank fördern.\n```\n\nVerfügbar seit `v2.15.3`.\n\n#### `--format=<fmt>`\n\nWähle das Ausgabeformat, entweder `text`*(Standard)* oder `json`.\n\n### Allgemeine Optionen\n\n#### `-h, --help`\n\nZeigt diesen Hilfetext an.\n\n#### `-J=<opt>`\n\n```\n          \\[Erweitert] Gib der JVM, die den Befehl ausführt, eine Option.\n```\n\n(Beachte, dass Optionen, die Leerzeichen enthalten, nicht ordnungsgemäß verarbeitet werden.)\n\n#### `-v, --verbose`\n\nErmöglicht die inkrementelle Erhöhung der Anzahl ausgegebener Statusmeldungen.\n\n#### `-q, --quiet`\n\nErmöglicht die inkrementelle Verringerung der Anzahl ausgegebener Statusmeldungen.\n\n#### `--verbosity=<level>`\n\n```\n          \\[Erweitert] Lege die Ausführlichkeitsstufe explizit auf einen der Werte Fehler, Warnungen, Fortschritt, Fortschritt+, Fortschritt++, Fortschritt+++ fest. Überschreibt `-v` und `-q`:\n```\n\n#### `--logdir=<dir>`\n\n```\n          \\[Erweitert] Detaillierte Protokolle in eine oder mehrere Dateien im angegebenen Verzeichnis schreiben, mit generierten Namen, die Zeitstempel und den Namen des ausgeführten Unterbefehls enthalten.\n```\n\n(Um eine Protokolldatei mit einem Namen zu schreiben, über den du die volle Kontrolle hast, gib stattdessen `--log-to-stderr` an, und leite stderr wie gewünscht um.)\n\n#### `--common-caches=<dir>`\n\n```\n          \\[Erweitert] Steuert den Zwischenspeicherort von Datenträgern wie z. B. heruntergeladene LQ-Pakete und kompilierte Abfragepläne, die zwischen mehreren Ausführen des CLI erhalten bleiben sollen. Wenn dies nicht explizit festgelegt ist, wird dieses Verzeichnis standardmäßig auf ein Verzeichnis mit dem Namen `.codeql` festgelegt, das sich im Startverzeichnis des Benutzer. Es wird erstellt, wenn es noch nicht vorhanden ist.\n```\n\nVerfügbar seit `v2.15.2`."}