{"meta":{"title":"Abfrageformat","intro":"Automatische Formatierung von QL-Quellcode","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/query-format","title":"Abfrageformat"}],"documentType":"article"},"body":"# Abfrageformat\n\nAutomatische Formatierung von QL-Quellcode\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 query format [--output=<file>] [--in-place] [--backup=<ext>] <options>... -- <file>...\n```\n\n## Description\n\nAutomatische Formatierung von QL-Quellcode\n\n## Options\n\n### Primäre Optionen\n\n#### `<file>...`\n\nEine oder mehrere `.ql`- oder `.qll`-Quelldateien, die automatisch formatiert werden sollen. Ein Bindestrich kann zum Lesen aus der Standardeingabe angegeben werden.\n\n#### `-o, --output=<file>`\n\nSchreibt den formatierten QL-Code in diese Datei anstelle des Standardausgabestreams. Darf nicht angegeben werden, wenn mehrere Eingaben vorhanden sind.\n\n#### `-i, --[no-]in-place`\n\nÜberschreibt jede Eingabedatei mit einer formatierten Version des Inhalts.\n\n#### `--[no-]check-only`\n\nAnstatt die Ausgabe zu schreiben, wird die Ausführung mit dem Status 1 beendet, wenn Eingabedateien von der korrekten Formatierung _abweichen_. Eine Meldung, die angibt, welche Dateien abweichen, wird als Standardfehlermeldung ausgegeben, sofern nicht ebenfalls `-qq` angegeben ist.\n\n#### `-b, --backup=<ext>`\n\nBeim Schreiben einer bereits vorhandenen Datei wird die vorhandene Datei in eine Sicherung umbenannt, indem dem Namen die entsprechende Erweiterung angefügt wird. Wenn die Sicherungsdatei bereits vorhanden ist, wird sie automatisch gelöscht.\n\n#### `--no-syntax-errors`\n\nWenn eine QL-Eingabedatei nicht syntaktisch korrekt ist, wird vorgegeben, dass sie bereits korrekt formatiert ist. (Normalerweise führt eine solche Datei dazu, dass der Befehl mit einer Fehlermeldung beendet wird.)\n\n### Allgemeine Optionen\n\n#### `-h, --help`\n\nZeigt diesen Hilfetext an.\n\n#### `-J=<opt>`\n\n              \\[Erweitert] Option an die JVM übergeben, die den Befehl ausführt.\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              \\[Erweitert] Lege die Ausführlichkeitsstufe explizit auf einen der Werte errors, warnings, progress, progress+, progress++, progress+++ fest. Überschreibt `-v` und `-q`:\n\n#### `--logdir=<dir>`\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(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              \\[Erweitert] Steuert den Zwischenspeicherort von Datenträgern, die zwischen mehreren CLI-Ausführungen bestehen bleiben, wie z. B. heruntergeladene QL-Pakete und kompilierte Abfragepläne. 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\nVerfügbar seit `v2.15.2`."}