{"meta":{"title":"Diagnóstico de exportação de banco de dados","intro":"[Experimental] Exporte informações de diagnóstico de um banco de dados para uma análise com falha.","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/database-export-diagnostics","title":"Diagnóstico de exportação de banco de dados"}],"documentType":"article"},"body":"# Diagnóstico de exportação de banco de dados\n\n\\[Experimental] Exporte informações de diagnóstico de um banco de dados para uma análise com falha.\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 database export-diagnostics --format=<format> [--output=<output>] <options>... -- <database>\n```\n\n## Description\n\n```\n          \\[[Experimental] Exporte informações de diagnóstico de um banco de dados para uma análise com falha.\n```\n\nDisponível desde `v2.12.6`.\n\n## Opções\n\n### Opções principais\n\n#### `<database>`\n\n```\n          \\[Obrigatório] Caminho para o banco de dados CodeQL em construção. Isso precisa ter sido preparado para extração com [codeql database init](/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-init).\n```\n\nSe a opção `--db-cluster` for fornecida, esse não será um banco de dados propriamente dito, mas um diretório que *contém* bancos de dados, e todos esses bancos de dados serão processados juntos.\n\n#### `--format=<format>`\n\n```\n          \\[Obrigatório] O formato em que os resultados devem ser escritos. Um destes:\n\n          `raw`: uma lista de mensagens de diagnóstico brutas e não interpretadas, em formato de objetos JSON.\n\n          `sarif-latest`: o formato SARIF (Static Analysis Results Interchange Format) é um formato baseado em JSON para descrever resultados de análises estáticas. Essa opção de formato usa a versão mais recente com suporte (v2.1.0). Essa opção não é adequada para uso na automação, pois produzirá diferentes versões do SARIF entre diferentes versões do CodeQL.\n\n          `sarifv2.1.0`: SARIF v2.1.0.\n\n          `text`: lista de mensagens de diagnóstico em tópicos.\n```\n\n#### `--[no-]db-cluster`\n\nIndica que o diretório fornecido na linha de comando não é um banco de dados propriamente dito, mas um diretório que *contém* um ou mais bancos de dados em construção. Esses bancos de dados serão processados juntos.\n\n#### `-o, --output=<output>`\n\nO caminho de saída para o qual gravar informações de diagnóstico.\n\n#### `--sarif-exit-code=<sarifExitCode>`\n\n```\n          \\[Apenas formatos SARIF] Código de saída do processo com falha.\n```\n\n#### `--sarif-exit-code-description=<sarifExitCodeDescription>`\n\n```\n          \\[Apenas formatos SARIF] Motivo pelo qual o processo com falha foi encerrado.\n```\n\n#### `--sarif-category=<category>`\n\n```\n          \\[Apenas formatos SARIF] \\[Recomendado] Especifique uma categoria para esta análise incluir na saída SARIF. Uma categoria pode ser usada para distinguir várias análises executadas no mesmo commit e repositório, mas em diferentes linguagens ou partes do código.\n```\n\nSe você analisar a mesma versão de uma base de código de várias maneiras diferentes (por exemplo, para diferentes linguagens) e carregar os resultados no GitHub para apresentação na verificação de código, esse valor deverá ser diferente entre cada uma das análises, o que informa à verificação de código de que as análises *suplementam* umas às outras em vez de *substituí-las*. (Os valores devem ser consistentes entre as execuções da mesma análise para *diferentes* versões da base de código.)\n\nEsse valor aparecerá (com uma barra à direita acrescentada se ainda não estiver presente) como a propriedade `<run>.automationDetails.id`.\n\n### Opções comuns\n\n#### `-h, --help`\n\nMostre este texto de ajuda.\n\n#### `-J=<opt>`\n\n```\n          \\[Avançado] Dê opções à 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 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```\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\n#### `--logdir=<dir>`\n\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\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] 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```\n\nDisponível desde `v2.15.2`."}