{"meta":{"title":"Datenbankimport","intro":"[Erweitert] [Plumbing] Importieren nicht abgeschlossener Datenbanken in eine andere nicht definierte Datenbank.","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/database-import","title":"Datenbankimport"}],"documentType":"article"},"body":"# Datenbankimport\n\n\\[Erweitert] \\[Plumbing] Importieren nicht abgeschlossener Datenbanken in eine andere nicht definierte Datenbank.\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 database import [--dbscheme=<file>] [--threads=<num>] [--ram=<MB>] <options>... -- <database> <additionalDbs>...\n```\n\n## Description\n\n```\n          \\[Erweitert] \\[Plumbing] Importieren nicht abgeschlossener Datenbanken in eine andere nicht definierte Datenbank.\n```\n\nDas Ergebnis dieses Befehls ist, dass die Zieldatenbank (die im *ersten* Argument) mit den Daten aus allen anderen übergebenen Datenbanken ergänzt wird. Insbesondere werden TRAP-Dateien aus den anderen Datenbanken importiert und die darin enthaltenen Quellen kopiert.\n\nBeachte, dass dieser Befehl in den meisten Fällen wahrscheinlich nicht die gewünschte Wirkung hat. Insbesondere kann die resultierende Datenbank den Dataflow zwischen den kombinierten Teildatenbanken nicht ordnungsgemäß nachverfolgen. Er ist nur für bestimmte erweiterte Szenarien mit verteilten Build-Systemen vorgesehen, in denen besondere Sorgfalt darauf gelegt wurde, wie der Build getrennt wurde. So soll sichergestellt werden, dass daraus eine sinnvolle, endgültige Datenbank resultiert.\n\n## Options\n\n### Primäre Optionen\n\n#### `<database>`\n\n```\n          \\[Obligatorisch] Pfad zur CodeQL-Datenbank, die sich im Aufbau befindet. Dieser muss für die Extraktion mit [codeql database init](/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-init) vorbereitet sein.\n```\n\nWenn die Option `--db-cluster` angegeben ist, handelt es sich nicht um eine Datenbank als solches, sondern um ein Verzeichnis, das Datenbanken *enthält*. Es werden dann alle diese Datenbanken zusammen verarbeitet.\n\n#### `<additionalDbs>...`\n\n```\n          \\[Obligatorisch] Pfade zu den nicht abgeschlossenen Datenbanken, die in die erste Datenbank importiert werden sollen.\n```\n\nWenn die Option `--db-cluster` angegeben ist, wird erwartet, dass es sich dabei um Datenbankcluster und nicht um einzelne CodeQL-Datenbanken handelt.\n\n#### `--[no-]db-cluster`\n\nGibt an, dass es sich bei dem in der Befehlszeile angegebenen Verzeichnis nicht um eine Datenbank als solches handelt, sondern um ein Verzeichnis, das eine oder mehrere Datenbanken *enthält*, die sich im Aufbau befinden. Diese Datenbanken werden zusammen verarbeitet.\n\n### Optionen zum Steuern des TRAP-Importvorgangs\n\n#### `-S, --dbscheme=<file>`\n\n```\n          \\[Erweitert] Überschreiben der automatisch erkannten dbscheme-Definition, die die TRAP-Dateien voraussichtlich befolgen werden. Normalerweise wird diese aus dem Extraktor der Datenbank übernommen.\n```\n\n#### `-j, --threads=<num>`\n\nDient zum Festlegen, wie viele Threads für den Importvorgang verwendet werden sollen.\n\nDer Standardwert lautet 1. Du kannst 0 übergeben, um jeweils einen Thread pro Kern auf dem Computer zu verwenden, oder -*N*, um *N* Kerne ungenutzt zu lassen. (Es wird allerdings immer noch mindestens ein Thread verwendet.)\n\n#### `-M, --ram=<MB>`\n\nVerwende so viel Arbeitsspeicher für den Importvorgang.\n\n### Optionen zum Überprüfen importierter TRAP-Dateien\n\n#### `--[no-]check-undefined-labels`\n\n```\n          \\[Erweitert] Meldet Fehler für nicht definierte Bezeichnungen.\n```\n\n#### `--[no-]check-unused-labels`\n\n```\n          \\[Erweitert] Meldet Fehler für nicht genutzte Bezeichnungen.\n```\n\n#### `--[no-]check-repeated-labels`\n\n```\n          \\[Erweitert] Meldet Fehler für wiederholte Bezeichnungen.\n```\n\n#### `--[no-]check-redefined-labels`\n\n```\n          \\[Erweitert] Meldet Fehler für neu definierte Bezeichnungen.\n```\n\n#### `--[no-]check-use-before-definition`\n\n```\n          \\[Erweitert] Meldet Fehler für Bezeichnungen, die verwendet werden, bevor sie definiert wurden.\n```\n\n#### `--[no-]fail-on-trap-errors`\n\n```\n          \\[Erweitert] Führt zu einer Beendigung ungleich null, wenn beim TRAP-Import ein Fehler auftritt.\n```\n\n#### `--[no-]include-location-in-star`\n\n```\n          \\[Erweitert] Erstellt Entitäts-IDs, die den Speicherort in der TRAP-Datei codieren, 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 [der Import von Codeql-Datasets](/code-security/reference/code-scanning/codeql/codeql-cli-manual/dataset-import) verknüpfungsfähig _(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### Allgemeine Optionen\n\n#### `-h, --help`\n\nZeigt diesen Hilfetext an.\n\n#### `-J=<opt>`\n\n```\n          \\[Erweitert] Dient zum Angeben einer Option für die JVM-Instanz, die den Befehl ausführt.\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] Dient zum expliziten Festlegen des Ausführlichkeitsgrads auf „errors“, „warnings“, „progress“, „progress+“, „progress++“ oder „progress+++“. Überschreibt `-v` und `-q`:\n```\n\n#### `--logdir=<dir>`\n\n```\n          \\[Erweitert] Ermöglicht das Schreiben detaillierter Protokolle in eine oder mehrere Dateien im angegebenen Verzeichnis 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 Speicherort zwischengespeicherter Daten auf dem Datenträger, der zwischen mehreren Ausführungsvorgängen der CLI beibehalten wird, 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```\n\nVerfügbar seit `v2.15.2`."}