{"meta":{"title":"extrato de teste","intro":"[Conexão] Crie um conjunto de dados para um diretório de teste.","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/test-extract","title":"extrato de teste"}],"documentType":"article"},"body":"# extrato de teste\n\n\\[Conexão] Crie um conjunto de dados para um diretório de teste.\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 test extract [--print-database] [--source-root=<dir>] <options>... -- <testDirectory>\n```\n\n## Description\n\n```\n          \\[Conexão] Crie um conjunto de dados para um diretório de teste.\n```\n\nCrie um banco de dados para um diretório de teste especificado, sem realmente executar nenhuma consulta de teste. Gera o caminho para o conjunto de dados QL bruto no qual as consultas de teste serão executadas.\n\n## Opções\n\n### Opções principais\n\n#### `<testDirectory>`\n\n```\n          \\[Obrigatório] O caminho para o diretório de teste.\n```\n\n#### `--database=<dir>`\n\nSubstitua o local do banco de dados que está sendo criado. Por padrão, ele será um subdiretório cujo nome é derivado do nome do próprio diretório de teste com '.testproj' acrescentado.\n\n#### `-D, --print-database`\n\nImprima o caminho para o banco de dados que está sendo criado, em vez do conjunto de dados dentro dele.\n\n#### `-s, --source-root=<dir>`\n\n```\n          \\[Avançado] O diretório de código-fonte raiz, se for diferente do diretório de teste.\n```\n\n#### `--search-path=<dir>[:<dir>...]`\n\nUma lista de diretórios nos quais os pacotes de extratores podem ser encontrados. Os diretórios podem ser os próprios pacotes extratores ou diretórios que contenham extratores como subdiretórios imediatos.\n\nSe o caminho contiver várias árvores de diretório, a ordem delas definirá a precedência entre elas: se for encontrada uma correspondência da linguagem de destino em mais de uma das árvores de diretório, a primeira fornecida vencerá.\n\nOs extratores empacotados com a própria cadeia de ferramentas CodeQL sempre serão encontrados, mas se você precisar usar extratores distribuídos separadamente, forneça essa opção (ou, melhor ainda, configure `--search-path` em um arquivo de configuração por usuário).\n\n(Observação: no Windows, o separador de caminho é `;`).\n\n#### `--cleanup`\n\nRemova o banco de dados de teste em vez de criá-lo.\n\n#### `--[no-]show-extractor-output`\n\n```\n          \\[Avançado] Mostre a saída de scripts de extratores que criam bancos de dados de teste. Isso pode ser útil ao desenvolver ou editar casos de teste.\n```\n\nUse-a com cautela, pois ela pode causar uma saída duplicada ou malformada caso seja usada com vários threads.\n\n#### `--[no-]check-undefined-labels`\n\n```\n          \\[Avançado] Relate os erros de rótulos indefinidos.\n```\n\n#### `--[no-]check-unused-labels`\n\n```\n          \\[Avançado] Relate os erros de rótulos não utilizados.\n```\n\n#### `--[no-]check-repeated-labels`\n\n```\n          \\[Avançado] Relate os erros de rótulos repetidos.\n```\n\n#### `--[no-]check-redefined-labels`\n\n```\n          \\[Avançado] Relate os erros de rótulos redefinidos.\n```\n\n#### `--[no-]check-use-before-definition`\n\n```\n          \\[Avançado] Relate os erros de rótulos usados antes de serem definidos.\n```\n\n#### `--[no-]fail-on-trap-errors`\n\n```\n          \\[Avançado] Gere uma saída diferente de zero se ocorrer um erro durante a importação do TRAP.\n```\n\n#### `--[no-]include-location-in-star`\n\n```\n          \\[Avançado] Construa IDs de entidade que codificam o local no arquivo TRAP de origem. Pode ser útil para a depuração de geradores TRAP, mas ocupa muito espaço no conjunto de dados.\n```\n\n#### `--[no-]linkage-aware-import`\n\n```\n          \\[Avançado] Controla se a [importação do conjunto de dados codeql](/code-security/reference/code-scanning/codeql/codeql-cli-manual/dataset-import) é 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```\n\nDisponível desde `v2.15.3`.\n\n#### `--format=<fmt>`\n\nSelecione o formato de saída, `text`*(padrão)* ou `json`.\n\n### Opções comuns\n\n#### `-h, --help`\n\nMostre este texto de ajuda.\n\n#### `-J=<opt>`\n\n```\n          \\[Avançado] Forneça a opção para a JVM que executa o comando.\n```\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 de forma incremental 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```\n          \\[Avançado] Defina explicitamente o nível de detalhamento como erros, avisos, progresso, progresso+, progresso++ ou progresso+++. Substitui `-v` e `-q`.\n```\n\n#### `--logdir=<dir>`\n\n```\n          \\[Avançado] Escreva logs detalhados em um ou mais arquivos no diretório fornecido, com nomes gerados que incluem carimbos de data/hora e o nome do subcomando em execução.\n```\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```\n          \\[Avançado] Controle a localização dos dados armazenados em cache no disco que persistirão entre várias execuções da CLI, como pacotes QL baixados e planos de consulta compilada. 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```\n\nDisponível desde `v2.15.2`."}