# métrica de conjunto de dados

[Conexão] Colete estatísticas sobre as relações em um conjunto de dados específico.

> [!NOTE]
> 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.
>
> 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.

## Sinopse

```shell copy
codeql dataset measure --output=<file> [--threads=<num>] <options>... -- <dataset>
```

## Description

              \[Conexão] Colete estatísticas sobre as relações em um conjunto de dados específico.

Normalmente, esse comando só é usado durante o desenvolvimento de um extrator do CodeQL, após uma alteração que afeta o esquema de banco de dados e que, portanto, precisa ter uma alteração complementar nas estatísticas usadas pelo otimizador de consulta.

## Opções

### Opções principais

#### `<dataset>`

              \[Obrigatório] Caminho para o conjunto de dados QL bruto a ser medido.

#### `-o, --output=<file>`

              \[Obrigatório] O arquivo de saída no qual as estatísticas devem ser gravadas, normalmente com uma extensão '.dbscheme.stats'.

#### `-j, --threads=<num>`

O número de threads simultâneos a serem usados.

O 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).

### Opções comuns

#### `-h, --help`

Mostre este texto de ajuda.

#### `-J=<opt>`

              \[Avançado] Forneça a opção para a JVM que executa o comando.

(Use-a com cautela, pois as opções que contêm espaços não serão tratadas corretamente.)

#### `-v, --verbose`

Aumente de forma incremental o número de mensagens de progresso impressas.

#### `-q, --quiet`

Diminua incrementalmente o número de mensagens de progresso impressas.

#### `--verbosity=<level>`

              \[Avançado] Defina explicitamente o nível de detalhamento como erros, avisos, progresso, progresso+, progresso++ ou progresso+++. Substitui `-v` e `-q`.

#### `--logdir=<dir>`

              \[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.

(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.)

#### `--common-caches=<dir>`

              \[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.

Disponível desde `v2.15.2`.