{"meta":{"title":"importação de conjunto de dados","intro":"[Conexão] Importe um conjunto de arquivos TRAP para um conjunto de dados bruto.","product":"Qualidade de segurança e código","breadcrumbs":[{"href":"/pt/code-security","title":"Qualidade de segurança e código"},{"href":"/pt/code-security/reference","title":"Referência"},{"href":"/pt/code-security/reference/code-scanning","title":"Varredura de código"},{"href":"/pt/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/pt/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"Manual da CLI do CodeQL"},{"href":"/pt/code-security/reference/code-scanning/codeql/codeql-cli-manual/dataset-import","title":"importação de conjunto de dados"}],"documentType":"article"},"body":"# importação de conjunto de dados\n\n[Conexão] Importe um conjunto de arquivos TRAP para um conjunto de dados bruto.\n\n> [!NOTE]\n> Este conteúdo descreve a versão mais recente do CodeQL CLI. Para obter mais informações sobre essa versão, confira https://github.com/github/codeql-cli-binaries/releases.\n>\n> Para ver os detalhes das opções disponíveis para esse comando em uma versão anterior, execute o comando com a opção <span style=\"white-space: nowrap;\">`--help`</span> no terminal.\n\n## Sinopse\n\n```shell copy\ncodeql dataset import --dbscheme=<file> [--threads=<num>] <options>... -- <dataset> <trap>...\n```\n\n## Description\n\n              \\[Conexão] Importe um conjunto de arquivos TRAP para um conjunto de dados bruto.\n\nCrie um conjunto de dados preenchendo-o com arquivos TRAP ou adicione dados de arquivos TRAP a um conjunto de dados existente. A atualização de um conjunto de dados só será possível se ele tiver o dbscheme correto _e_ se o pool de IDs tiver sido preservado da importação inicial.\n\n## Opções\n\n### Opções principais\n\n#### `<dataset>`\n\n              \\[Obrigatório] Caminho para o conjunto de dados QL bruto a ser criado ou atualizado. O diretório será criado se ele ainda não existir.\n\n#### `<trap>...`\n\nCaminhos para arquivos .trap(.gz) a serem importados ou para diretórios que serão verificados recursivamente em busca de arquivos .trap(.gz). Se nenhum arquivo for fornecido, um conjunto de dados vazio será criado.\n\n#### `-S, --dbscheme=<file>`\n\n              \\[Obrigatório] A definição de dbscheme que descreve os arquivos TRAP que você deseja importar.\n\n#### `-j, --threads=<num>`\n\nUse esse número de threads para a operação de importação.\n\nO valor padrão é 1. Você pode transmitir 0 para usar um thread por núcleo no computador ou -_N_ para manter _N_ núcleos não utilizados (com a exceção de que ainda será usado, pelo menos, um thread).\n\n#### `--[no-]check-undefined-labels`\n\n              \\[Avançado] Reportar erros para rótulos não definidos.\n\n#### `--[no-]check-unused-labels`\n\n              \\[Avançado] Reportar erros para rótulos não utilizados.\n\n#### `--[no-]check-repeated-labels`\n\n              \\[Avançado] Reportar erros para rótulos repetidos.\n\n#### `--[no-]check-redefined-labels`\n\n              \\[Avançado] Reportar erros para rótulos redefinidos.\n\n#### `--[no-]check-use-before-definition`\n\n              \\[Avançado] Reportar erros para rótulos usados​antes de serem definidos.\n\n#### `--[no-]fail-on-trap-errors`\n\n              \\[Avançado] Saída com código diferente de zero se ocorrer um erro durante a importação de traps.\n\n#### `--[no-]include-location-in-star`\n\n              \\[Avançado] Construir IDs de entidade que codificam a localização no arquivo TRAP de onde vieram. Pode ser útil para a depuração de geradores TRAP, mas ocupa muito espaço no conjunto de dados.\n\n#### `--[no-]linkage-aware-import`\n\n              \\[Avançado] Controla se a importação do conjunto de dados do codeql é compatível com vinculação _(padrão)_ ou não. Em projetos em que essa parte da criação de banco de dados consome muita memória, desabilitar essa opção pode ajudá-los a progredir às custas da integridade do banco de dados.\n\nDisponível desde `v2.15.3`.\n\n### Opções comuns\n\n#### `-h, --help`\n\nMostre este texto de ajuda.\n\n#### `-J=<opt>`\n\n              \\[Avançado] Dê opções à JVM que executa o comando.\n\n(Use-a com cautela, pois as opções que contêm espaços não serão tratadas corretamente.)\n\n#### `-v, --verbose`\n\nAumente incrementalmente o número de mensagens de progresso impressas.\n\n#### `-q, --quiet`\n\nDiminua incrementalmente o número de mensagens de progresso impressas.\n\n#### `--verbosity=<level>`\n\n              \\[Avançado] Defina explicitamente o nível de detalhamento para um dos seguintes: erros, avisos, progresso, progresso+, progresso++, progresso+++. Substitui `-v` e `-q`.\n\n#### `--logdir=<dir>`\n\n              \\[Avançado] Grava registros detalhados em um ou mais arquivos no diretório especificado, com nomes gerados que incluem carimbos de data/hora e o nome do subcomando em execução.\n\n(Para gravar um arquivo de log com um nome sobre o qual você tem controle completo, forneça `--log-to-stderr` e redirecione stderr conforme desejado.)\n\n#### `--common-caches=<dir>`\n\n              \\[Avançado] Controla a localização dos dados em cache no disco que persistirão entre várias execuções da CLI, como pacotes QL baixados e planos de consulta compilados. Se não for definido explicitamente, o padrão corresponde a um diretório intitulado `.codeql` no diretório inicial do usuário; que será criado se ainda não existir.\n\nDisponível desde `v2.15.2`."}